1. 项目缘起从“定时器”到“提醒器”的思维跃迁很多朋友在拿到行空板这类开源硬件时第一个想到的往往是点亮一个LED或者让蜂鸣器响一下。这当然没错是经典的“Hello World”。但当我们掌握了这些基础操作后下一步该做什么是继续重复这些简单的GPIO控制还是尝试将多个功能组合起来解决一个更贴近实际生活的小问题我认为后者才是从“玩具”走向“工具”的关键一步。“多功能提醒器”这个项目就是一个绝佳的跳板。它听起来比“定时器”或“闹钟”更丰富也更有想象空间。核心需求其实很明确我们需要一个设备它能在预设的时间点通过多种感官方式比如声音、灯光、甚至屏幕显示来提醒我们。这听起来简单但当你真正动手去实现时会发现里面藏着许多值得琢磨的细节如何让时间设置更人性化如何管理多种提醒模式如何确保提醒的可靠性以及如何让代码结构清晰便于后续增加新功能这正是本课的价值所在。我们将不仅仅是用Python写几行控制硬件的代码而是要构建一个具备完整逻辑的小型应用。通过这个项目你会接触到事件驱动编程、状态管理、用户交互设计等更接近真实软件开发的概念。无论你是刚接触Python和硬件的新手还是想了解如何将软硬件结合解决实际问题这个“多功能提醒器”都能提供一个结构清晰、可扩展性强的实践范本。2. 硬件清单与核心元件功能剖析在开始写代码之前我们必须先搞清楚手头的“兵器”。对于行空板其集成的丰富外设是我们实现多功能提醒的物理基础。下面我们来逐一拆解并理解它们在本项目中的角色。行空板核心外设清单屏幕Display这是最重要的人机交互界面。我们将用它来显示当前时间、设置菜单、倒计时信息以及提醒内容。它的存在使得我们的提醒器脱离了简单的“蜂鸣器LED”组合具备了信息展示和复杂交互的能力。蜂鸣器Buzzer最直接的听觉提醒装置。我们可以通过编程控制它发出不同频率、不同节奏的声音从而实现普通提示音、急促警报音等不同级别的听觉反馈。RGB LED位于板载的通常是一个可编程的全彩LED。它是视觉提醒的重要组成部分。我们可以用红色表示紧急或错误用绿色表示就绪或成功用蓝色闪烁表示等待或运行中用彩虹色表示庆祝或完成极大地丰富了提醒的视觉语义。按键Buttons行空板通常配有多个物理按键如A、B键。它们是我们进行设置、确认、取消等操作的主要输入设备。如何设计按键逻辑使其在菜单导航、时间调整、功能切换时直观易用是交互设计的核心。实时时钟RTC 如果板载支持这是实现精准定时提醒的关键。虽然主控芯片本身可以计时但RTC模块通常有独立的电源如纽扣电池在主板断电时也能持续走时确保时间基准不丢失。如果板子没有硬件RTC我们就需要依赖网络对时如果联网或接受每次上电后手动校准时间。除了行空板自身你还可以考虑扩展振动马达通过GPIO口连接一个小型振动马达可以实现静音或增强提醒如放在口袋里的震动提醒。环境光传感器用于自动调节屏幕亮度或在检测到环境光很暗比如夜晚时自动将提醒方式切换为震动避免打扰他人。理解了硬件能力我们就能有的放矢地进行软件设计。例如一个“会议提醒”可以这样设计倒计时结束时屏幕高亮显示“会议时间到”蜂鸣器发出三声短促的“滴滴”声RGB LED快速闪烁红色。而一个“喝水提醒”则可以设计得温和一些屏幕显示“该喝水啦~”蜂鸣器播放一小段舒缓的音乐RGB LED缓慢呼吸变换蓝色。3. 软件架构设计状态机与事件驱动面对一个功能看似简单的提醒器如果将所有逻辑都塞进一个巨大的while True循环里代码很快就会变得难以阅读和维护。比如你既要检测按键、更新屏幕、检查定时、控制蜂鸣器和LED还要处理各种设置逻辑。这种“面条式”代码的典型特征是满屏的if...else和标志位改一处而动全身。一个更优雅的方案是采用“状态机State Machine”结合“事件驱动Event-Driven”的架构。听起来有点高级但其实思想很简单。3.1 核心状态定义我们的提醒器在任何时刻都处于一个明确的状态。我们可以定义以下几个主要状态主界面状态STATE_HOME显示当前时间、下一个提醒的概要信息。这是设备的常态。菜单状态STATE_MENU列出可操作的功能如“新增提醒”、“查看提醒”、“系统设置”。新增提醒状态STATE_ADD引导用户设置提醒时间、内容、重复周期和提醒方式声、光、震。提醒触发状态STATE_ALERT当到达预设时间时进入此状态执行预设的提醒动作响铃、闪灯、震动并等待用户确认。3.2 事件与状态迁移状态不会凭空改变而是由“事件”触发的。事件主要来源于硬件事件按键按下EVENT_BUTTON_A_PRESS,EVENT_BUTTON_B_PRESS、定时器到期EVENT_TIMER_ALARM。内部逻辑事件用户完成设置EVENT_SETTING_DONE、用户确认提醒EVENT_ALERT_ACK。每个状态都定义了一组“事件-响应”规则。例如在STATE_HOME状态下如果收到EVENT_BUTTON_A_PRESS事件则迁移到STATE_MENU状态。在STATE_ALERT状态下如果收到EVENT_ALERT_ACK事件则停止提醒动作并迁移回STATE_HOME状态。3.3 代码结构示例基于以上思想我们的主程序骨架会非常清晰# 状态定义 STATE_HOME 0 STATE_MENU 1 STATE_ADD 2 STATE_ALERT 3 # ... 其他状态 # 事件定义可以使用字符串或枚举 EVENT_BUTTON_A ‘btn_a‘ EVENT_BUTTON_B ‘btn_b‘ EVENT_TIMER ‘timer‘ # ... 其他事件 class MultiReminder: def __init__(self): self.current_state STATE_HOME self.reminder_list [] # 存储所有提醒任务 # 初始化屏幕、按键、蜂鸣器、LED等硬件对象 self.screen ... self.buzzer ... self.led ... self.setup_hardware() self.setup_ui() # 初始化界面 def run(self): 主事件循环 while True: # 1. 收集所有发生的事件非阻塞方式 events self.check_events() # 检测按键、定时器等 # 2. 根据当前状态处理这些事件 self.handle_state(self.current_state, events) # 3. 更新当前状态下的显示 self.update_display(self.current_state) # 4. 短暂延时避免CPU跑满 time.sleep(0.05) def handle_state(self, state, events): 状态处理机 if state STATE_HOME: self._handle_home_state(events) elif state STATE_MENU: self._handle_menu_state(events) # ... 处理其他状态 def _handle_home_state(self, events): 处理主界面状态的事件 for event in events: if event EVENT_BUTTON_A: # 按下A键进入菜单 self.current_state STATE_MENU self._draw_menu() # 绘制菜单界面 elif event EVENT_TIMER: # 定时器事件检查是否有提醒到期 self._check_reminders() def _check_reminders(self): 检查提醒列表如果有到期的触发提醒 now self.get_current_time() for reminder in self.reminder_list: if reminder[enabled] and reminder[time] now: self._trigger_alert(reminder) # 处理重复提醒逻辑 if reminder[repeat] ‘daily‘: # 将时间增加一天 reminder[time] datetime.timedelta(days1) elif reminder[repeat] ‘once‘: reminder[enabled] False这种架构的好处是显而易见的逻辑分离清晰。handle_state函数就像一个总调度中心而每个_handle_xxx_state函数只关心自己这一亩三分地的事。增加一个新状态比如“设置亮度”状态或新事件只需要新增对应的处理函数而不会影响其他状态的逻辑。这为我们的“多功能”扩展打下了坚实的基础。4. 核心功能模块实现详解有了清晰的架构我们就可以像搭积木一样逐个实现功能模块。这里我们深入两个最核心的模块提醒任务管理和提醒触发执行。4.1 提醒数据结构的定义与管理如何存储一个“提醒”它不是一个简单的时间点而是一个包含多种属性的复合对象。# 使用字典或类来定义一个提醒任务 reminder_template { ‘id‘: 1, # 唯一标识 ‘title‘: ‘团队例会‘, # 提醒标题 ‘time‘: datetime.datetime(2023, 10, 27, 14, 30, 0), # 触发时间 ‘repeat‘: ‘weekly‘, # 重复周期once一次, daily每天, weekly每周, monthly每月, weekday工作日 ‘sound‘: True, # 是否启用声音 ‘sound_type‘: ‘beep‘, # 声音类型beep哔声, melody旋律 ‘light‘: True, # 是否启用灯光 ‘light_pattern‘: ‘flash_red‘, # 灯光模式solid_red, breath_blue, rainbow ‘vibrate‘: False, # 是否启用震动需外接模块 ‘enabled‘: True, # 是否启用 ‘snooze‘: 5, # 贪睡时间分钟 }我们需要一个管理器来负责这些提醒任务的增删改查和持久化存储防止断电丢失。行空板通常基于Linux系统我们可以使用简单的JSON文件来存储。import json import os class ReminderManager: def __init__(self, file_path‘reminders.json‘): self.file_path file_path self.reminders self._load_from_file() def _load_from_file(self): 从JSON文件加载提醒列表 if os.path.exists(self.file_path): try: with open(self.file_path, ‘r‘, encoding‘utf-8‘) as f: data json.load(f) # 需要将字符串时间转换回datetime对象 for r in data: r[‘time‘] datetime.datetime.fromisoformat(r[‘time‘]) return data except Exception as e: print(f“加载提醒文件失败: {e}“) return [] return [] def _save_to_file(self): 保存提醒列表到JSON文件 # 转换datetime对象为字符串以便JSON序列化 save_data [] for r in self.reminders: r_copy r.copy() r_copy[‘time‘] r[‘time‘].isoformat() save_data.append(r_copy) try: with open(self.file_path, ‘w‘, encoding‘utf-8‘) as f: json.dump(save_data, f, indent2, ensure_asciiFalse) except Exception as e: print(f“保存提醒文件失败: {e}“) def add_reminder(self, reminder_dict): 新增一个提醒 reminder_dict[‘id‘] len(self.reminders) 1 self.reminders.append(reminder_dict) self._save_to_file() def get_next_reminder(self): 获取下一个即将触发的提醒用于主界面显示 enabled_reminders [r for r in self.reminders if r[‘enabled‘]] if not enabled_reminders: return None # 按时间排序返回最早的一个 return min(enabled_reminders, keylambda x: x[‘time‘])4.2 多感官提醒的协同执行当提醒触发时我们需要协调屏幕、蜂鸣器、LED等多个外设同时工作。这里的关键是“非阻塞”执行。我们不能让提醒动作比如播放一段长音乐卡住整个主循环否则用户将无法进行任何操作比如按键确认。解决方案是使用线程Threading或异步任务。对于行空板上的Python使用threading模块是一个直接的选择。import threading import time class AlertExecutor: def __init__(self, screen, buzzer, led): self.screen screen self.buzzer buzzer self.led led self.alert_active False self.alert_thread None self.current_reminder None def trigger(self, reminder): 触发一个提醒 if self.alert_active: # 如果已有提醒在运行可以选择排队或忽略新提醒 print(“已有提醒正在执行忽略新提醒“) return self.current_reminder reminder self.alert_active True # 在新线程中执行提醒动作避免阻塞主循环 self.alert_thread threading.Thread(targetself._alert_worker, daemonTrue) self.alert_thread.start() def _alert_worker(self): 提醒工作线程 reminder self.current_reminder # 1. 更新屏幕显示提醒信息在主线程中通过事件通知可能更好这里简化处理 self.screen.show_alert(reminder[‘title‘]) # 2. 根据设置启动声音和灯光线程 threads [] if reminder.get(‘sound‘): sound_thread threading.Thread(targetself._play_sound, args(reminder[‘sound_type‘],)) sound_thread.start() threads.append(sound_thread) if reminder.get(‘light‘): light_thread threading.Thread(targetself._run_light_pattern, args(reminder[‘light_pattern‘],)) light_thread.start() threads.append(light_thread) # 3. 等待提醒被用户确认或超时 # 这里需要一个停止标志由主线程在用户确认后设置 start_time time.time() timeout 60 # 提醒最多持续60秒 while self.alert_active and (time.time() - start_time) timeout: time.sleep(0.1) # 4. 停止所有提醒效果 self._stop_all_effects() for t in threads: t.join(timeout1.0) # 等待子线程结束 self.alert_active False self.current_reminder None def _play_sound(self, sound_type): if sound_type ‘beep‘: for _ in range(3): self.buzzer.beep(1000, 0.2) # 频率1000Hz响0.2秒 time.sleep(0.1) elif sound_type ‘melody‘: # 播放一段简单的旋律例如《小星星》片段 melody [(262, 0.3), (294, 0.3), (330, 0.3), (262, 0.3)] # 频率和时长 for freq, duration in melody: self.buzzer.beep(freq, duration) time.sleep(duration * 0.1) def _run_light_pattern(self, pattern): while self.alert_active: if pattern ‘flash_red‘: self.led.set_color(255, 0, 0) # 红色 time.sleep(0.5) self.led.set_color(0, 0, 0) # 关闭 time.sleep(0.5) elif pattern ‘breath_blue‘: # 实现呼吸灯效果 for i in range(0, 255, 5): if not self.alert_active: break self.led.set_color(0, 0, i) time.sleep(0.02) for i in range(255, 0, -5): if not self.alert_active: break self.led.set_color(0, 0, i) time.sleep(0.02) def _stop_all_effects(self): self.buzzer.off() self.led.off() def acknowledge(self): 用户确认提醒停止所有效果 self.alert_active False这样当提醒触发时主程序会立刻创建一个AlertExecutor线程来负责所有的提醒效果而主循环依然可以流畅地响应用户的按键操作比如按下B键来确认提醒这会调用acknowledge()方法。5. 用户界面与交互设计实战硬件项目的用户体验很大程度上取决于其界面与交互设计。在资源受限的行空板屏幕小、输入设备少上设计需要格外讲究效率和清晰度。5.1 屏幕UI布局规划对于一个小尺寸屏幕比如2.8英寸信息必须高度浓缩。我们可以将屏幕分为几个固定的区域状态栏顶部显示当前时间、Wi-Fi信号如果联网、电池电量如果可测。主内容区中部根据当前状态动态显示。在主界面显示下一个提醒的概要在菜单显示选项列表在设置界面显示设置项和当前值。操作提示栏底部始终显示当前状态下各个按键的功能例如“A:选择 B:返回”。这是非常重要的设计能极大降低用户的学习成本。5.2 菜单导航与设置逻辑使用A、B两个按键进行导航是经典设计。一个常见的逻辑是A键通常作为“确认”、“进入”、“下一步”功能。B键通常作为“返回”、“取消”、“上一步”功能。在菜单列表中我们需要一个视觉上的“光标”来指示当前选中的项。可以通过反色、箭头或高亮边框来实现。# 一个简单的菜单绘制与处理示例 class MenuManager: def __init__(self, screen, items): self.screen screen self.menu_items items # 例如 [‘新增提醒‘, ‘提醒列表‘, ‘系统设置‘] self.selected_index 0 # 当前选中项的索引 self.top_index 0 # 当前屏幕显示的第一项的索引用于长列表滚动 def draw(self): self.screen.clear() # 绘制标题 self.screen.draw_text(‘主菜单‘, x10, y10) # 计算当前屏幕能显示多少项 items_per_page 5 # 绘制当前页的菜单项 for i in range(items_per_page): item_idx self.top_index i if item_idx len(self.menu_items): break y_pos 40 i * 25 # 如果是选中的项反色显示 if item_idx self.selected_index: self.screen.fill_rect(5, y_pos-2, 230, 20, color‘white‘) self.screen.draw_text(self.menu_items[item_idx], x10, yy_pos, color‘black‘) else: self.screen.draw_text(self.menu_items[item_idx], x10, yy_pos, color‘white‘) # 绘制底部操作提示 self.screen.draw_text(‘A:确认 B:返回‘, x10, y220) def handle_button_a(self): 处理A键按下事件 selected_item self.menu_items[self.selected_index] # 返回被选中的菜单项由主状态机决定下一步动作 return selected_item def handle_button_b(self): 处理B键按下事件返回上一级 return ‘back‘ def move_cursor_down(self): 向下移动光标 self.selected_index (self.selected_index 1) % len(self.menu_items) # 如果光标移出了当前屏幕则滚动列表 if self.selected_index self.top_index 5: self.top_index 1 def move_cursor_up(self): 向上移动光标 self.selected_index (self.selected_index - 1) % len(self.menu_items) if self.selected_index self.top_index: self.top_index max(0, self.top_index - 1)5.3 时间设置的人性化设计设置提醒时间是最高频的操作之一。如果让用户用按键一位一位地输入数字体验会非常糟糕。一个更好的方案是提供“快速调整”和“微调”两种模式。例如在时间设置界面光标停留在“小时”位时短按A键小时数加1。长按A键小时数快速连续增加。短按B键切换到“分钟”位。旋转编码器如果有这是最理想的方案顺时针增加逆时针减少。同时屏幕上应该提供清晰的视觉反馈比如高亮当前正在调整的位置并实时显示调整后的时间。6. 项目优化与扩展思路一个能跑通的基础版提醒器已经完成了。但要让它变得更好用、更可靠我们还需要考虑以下优化和扩展点。6.1 低功耗优化如果希望设备能电池供电长时间运行功耗是关键。屏幕背光控制在无操作一段时间后例如30秒自动调暗或关闭屏幕背光。当检测到按键操作或提醒触发时再点亮。CPU频率调节在空闲状态主界面无操作可以适当降低CPU主频。外设电源管理不使用的传感器如未连接震动马达对应的GPIO口应设置为输入模式或关闭其电源域如果支持。高效的事件检测主循环中的time.sleep(0.05)在低功耗场景下可能仍显浪费。可以考虑使用硬件中断来唤醒CPU或者使用更长的休眠间隔并在休眠期间依靠RTC的闹钟功能来唤醒系统进行检查。6.2 数据持久化与可靠性我们之前用JSON文件存储提醒列表但直接频繁写入文件会损耗存储介质通常是TF卡。可以优化为增量保存只在提醒列表发生变化增、删、改时才触发保存操作而不是每次循环都保存。写缓存将多次连续的修改合并为一次保存。备份机制保存时先写入一个临时文件写入成功后再重命名为正式文件防止程序意外崩溃导致数据文件损坏。6.3 网络功能扩展进阶为行空板连接Wi-Fi后可以解锁更多强大功能网络对时NTP开机后自动从网络获取准确时间无需手动校准。这是确保提醒准时最关键的一步。语音合成提醒将提醒文本通过在线API如百度语音合成转换为语音通过音频输出接口播放体验更自然。远程管理与同步开发一个简单的手机App或网页端通过局域网甚至互联网来添加、管理行空板上的提醒事项。这涉及到简单的HTTP服务器或MQTT客户端编程。天气/日历集成从网络获取天气信息创建“下雨提醒带伞”的智能提醒或者同步在线日历的事件作为提醒源。6.4 硬件扩展玩法增加传感器结合温湿度传感器创建“室内干燥提醒加湿器”的环境提醒。结合人体红外传感器实现“人离开房间超过10分钟提醒关灯”的节能提醒。输出多样化除了板载资源可以连接一个OLED小屏幕显示更多信息连接一个功放和喇叭播放更复杂的MP3提醒音频或者连接一个舵机举起一个“flag”做物理提醒。从点亮第一个LED到完成这个“多功能提醒器”你走过的路正是一个典型的嵌入式应用开发流程需求分析、硬件选型、架构设计、模块编码、调试优化。这个项目像一块积木你已经掌握了它的基本形状。接下来是把它搭成一座小房子还是组合进一个更大的机器人完全取决于你的想象力和需求。编程和硬件的乐趣就在于这种从无到有、不断打磨和扩展的创造过程。
基于行空板的多功能提醒器：状态机与事件驱动架构实践
1. 项目缘起从“定时器”到“提醒器”的思维跃迁很多朋友在拿到行空板这类开源硬件时第一个想到的往往是点亮一个LED或者让蜂鸣器响一下。这当然没错是经典的“Hello World”。但当我们掌握了这些基础操作后下一步该做什么是继续重复这些简单的GPIO控制还是尝试将多个功能组合起来解决一个更贴近实际生活的小问题我认为后者才是从“玩具”走向“工具”的关键一步。“多功能提醒器”这个项目就是一个绝佳的跳板。它听起来比“定时器”或“闹钟”更丰富也更有想象空间。核心需求其实很明确我们需要一个设备它能在预设的时间点通过多种感官方式比如声音、灯光、甚至屏幕显示来提醒我们。这听起来简单但当你真正动手去实现时会发现里面藏着许多值得琢磨的细节如何让时间设置更人性化如何管理多种提醒模式如何确保提醒的可靠性以及如何让代码结构清晰便于后续增加新功能这正是本课的价值所在。我们将不仅仅是用Python写几行控制硬件的代码而是要构建一个具备完整逻辑的小型应用。通过这个项目你会接触到事件驱动编程、状态管理、用户交互设计等更接近真实软件开发的概念。无论你是刚接触Python和硬件的新手还是想了解如何将软硬件结合解决实际问题这个“多功能提醒器”都能提供一个结构清晰、可扩展性强的实践范本。2. 硬件清单与核心元件功能剖析在开始写代码之前我们必须先搞清楚手头的“兵器”。对于行空板其集成的丰富外设是我们实现多功能提醒的物理基础。下面我们来逐一拆解并理解它们在本项目中的角色。行空板核心外设清单屏幕Display这是最重要的人机交互界面。我们将用它来显示当前时间、设置菜单、倒计时信息以及提醒内容。它的存在使得我们的提醒器脱离了简单的“蜂鸣器LED”组合具备了信息展示和复杂交互的能力。蜂鸣器Buzzer最直接的听觉提醒装置。我们可以通过编程控制它发出不同频率、不同节奏的声音从而实现普通提示音、急促警报音等不同级别的听觉反馈。RGB LED位于板载的通常是一个可编程的全彩LED。它是视觉提醒的重要组成部分。我们可以用红色表示紧急或错误用绿色表示就绪或成功用蓝色闪烁表示等待或运行中用彩虹色表示庆祝或完成极大地丰富了提醒的视觉语义。按键Buttons行空板通常配有多个物理按键如A、B键。它们是我们进行设置、确认、取消等操作的主要输入设备。如何设计按键逻辑使其在菜单导航、时间调整、功能切换时直观易用是交互设计的核心。实时时钟RTC 如果板载支持这是实现精准定时提醒的关键。虽然主控芯片本身可以计时但RTC模块通常有独立的电源如纽扣电池在主板断电时也能持续走时确保时间基准不丢失。如果板子没有硬件RTC我们就需要依赖网络对时如果联网或接受每次上电后手动校准时间。除了行空板自身你还可以考虑扩展振动马达通过GPIO口连接一个小型振动马达可以实现静音或增强提醒如放在口袋里的震动提醒。环境光传感器用于自动调节屏幕亮度或在检测到环境光很暗比如夜晚时自动将提醒方式切换为震动避免打扰他人。理解了硬件能力我们就能有的放矢地进行软件设计。例如一个“会议提醒”可以这样设计倒计时结束时屏幕高亮显示“会议时间到”蜂鸣器发出三声短促的“滴滴”声RGB LED快速闪烁红色。而一个“喝水提醒”则可以设计得温和一些屏幕显示“该喝水啦~”蜂鸣器播放一小段舒缓的音乐RGB LED缓慢呼吸变换蓝色。3. 软件架构设计状态机与事件驱动面对一个功能看似简单的提醒器如果将所有逻辑都塞进一个巨大的while True循环里代码很快就会变得难以阅读和维护。比如你既要检测按键、更新屏幕、检查定时、控制蜂鸣器和LED还要处理各种设置逻辑。这种“面条式”代码的典型特征是满屏的if...else和标志位改一处而动全身。一个更优雅的方案是采用“状态机State Machine”结合“事件驱动Event-Driven”的架构。听起来有点高级但其实思想很简单。3.1 核心状态定义我们的提醒器在任何时刻都处于一个明确的状态。我们可以定义以下几个主要状态主界面状态STATE_HOME显示当前时间、下一个提醒的概要信息。这是设备的常态。菜单状态STATE_MENU列出可操作的功能如“新增提醒”、“查看提醒”、“系统设置”。新增提醒状态STATE_ADD引导用户设置提醒时间、内容、重复周期和提醒方式声、光、震。提醒触发状态STATE_ALERT当到达预设时间时进入此状态执行预设的提醒动作响铃、闪灯、震动并等待用户确认。3.2 事件与状态迁移状态不会凭空改变而是由“事件”触发的。事件主要来源于硬件事件按键按下EVENT_BUTTON_A_PRESS,EVENT_BUTTON_B_PRESS、定时器到期EVENT_TIMER_ALARM。内部逻辑事件用户完成设置EVENT_SETTING_DONE、用户确认提醒EVENT_ALERT_ACK。每个状态都定义了一组“事件-响应”规则。例如在STATE_HOME状态下如果收到EVENT_BUTTON_A_PRESS事件则迁移到STATE_MENU状态。在STATE_ALERT状态下如果收到EVENT_ALERT_ACK事件则停止提醒动作并迁移回STATE_HOME状态。3.3 代码结构示例基于以上思想我们的主程序骨架会非常清晰# 状态定义 STATE_HOME 0 STATE_MENU 1 STATE_ADD 2 STATE_ALERT 3 # ... 其他状态 # 事件定义可以使用字符串或枚举 EVENT_BUTTON_A ‘btn_a‘ EVENT_BUTTON_B ‘btn_b‘ EVENT_TIMER ‘timer‘ # ... 其他事件 class MultiReminder: def __init__(self): self.current_state STATE_HOME self.reminder_list [] # 存储所有提醒任务 # 初始化屏幕、按键、蜂鸣器、LED等硬件对象 self.screen ... self.buzzer ... self.led ... self.setup_hardware() self.setup_ui() # 初始化界面 def run(self): 主事件循环 while True: # 1. 收集所有发生的事件非阻塞方式 events self.check_events() # 检测按键、定时器等 # 2. 根据当前状态处理这些事件 self.handle_state(self.current_state, events) # 3. 更新当前状态下的显示 self.update_display(self.current_state) # 4. 短暂延时避免CPU跑满 time.sleep(0.05) def handle_state(self, state, events): 状态处理机 if state STATE_HOME: self._handle_home_state(events) elif state STATE_MENU: self._handle_menu_state(events) # ... 处理其他状态 def _handle_home_state(self, events): 处理主界面状态的事件 for event in events: if event EVENT_BUTTON_A: # 按下A键进入菜单 self.current_state STATE_MENU self._draw_menu() # 绘制菜单界面 elif event EVENT_TIMER: # 定时器事件检查是否有提醒到期 self._check_reminders() def _check_reminders(self): 检查提醒列表如果有到期的触发提醒 now self.get_current_time() for reminder in self.reminder_list: if reminder[enabled] and reminder[time] now: self._trigger_alert(reminder) # 处理重复提醒逻辑 if reminder[repeat] ‘daily‘: # 将时间增加一天 reminder[time] datetime.timedelta(days1) elif reminder[repeat] ‘once‘: reminder[enabled] False这种架构的好处是显而易见的逻辑分离清晰。handle_state函数就像一个总调度中心而每个_handle_xxx_state函数只关心自己这一亩三分地的事。增加一个新状态比如“设置亮度”状态或新事件只需要新增对应的处理函数而不会影响其他状态的逻辑。这为我们的“多功能”扩展打下了坚实的基础。4. 核心功能模块实现详解有了清晰的架构我们就可以像搭积木一样逐个实现功能模块。这里我们深入两个最核心的模块提醒任务管理和提醒触发执行。4.1 提醒数据结构的定义与管理如何存储一个“提醒”它不是一个简单的时间点而是一个包含多种属性的复合对象。# 使用字典或类来定义一个提醒任务 reminder_template { ‘id‘: 1, # 唯一标识 ‘title‘: ‘团队例会‘, # 提醒标题 ‘time‘: datetime.datetime(2023, 10, 27, 14, 30, 0), # 触发时间 ‘repeat‘: ‘weekly‘, # 重复周期once一次, daily每天, weekly每周, monthly每月, weekday工作日 ‘sound‘: True, # 是否启用声音 ‘sound_type‘: ‘beep‘, # 声音类型beep哔声, melody旋律 ‘light‘: True, # 是否启用灯光 ‘light_pattern‘: ‘flash_red‘, # 灯光模式solid_red, breath_blue, rainbow ‘vibrate‘: False, # 是否启用震动需外接模块 ‘enabled‘: True, # 是否启用 ‘snooze‘: 5, # 贪睡时间分钟 }我们需要一个管理器来负责这些提醒任务的增删改查和持久化存储防止断电丢失。行空板通常基于Linux系统我们可以使用简单的JSON文件来存储。import json import os class ReminderManager: def __init__(self, file_path‘reminders.json‘): self.file_path file_path self.reminders self._load_from_file() def _load_from_file(self): 从JSON文件加载提醒列表 if os.path.exists(self.file_path): try: with open(self.file_path, ‘r‘, encoding‘utf-8‘) as f: data json.load(f) # 需要将字符串时间转换回datetime对象 for r in data: r[‘time‘] datetime.datetime.fromisoformat(r[‘time‘]) return data except Exception as e: print(f“加载提醒文件失败: {e}“) return [] return [] def _save_to_file(self): 保存提醒列表到JSON文件 # 转换datetime对象为字符串以便JSON序列化 save_data [] for r in self.reminders: r_copy r.copy() r_copy[‘time‘] r[‘time‘].isoformat() save_data.append(r_copy) try: with open(self.file_path, ‘w‘, encoding‘utf-8‘) as f: json.dump(save_data, f, indent2, ensure_asciiFalse) except Exception as e: print(f“保存提醒文件失败: {e}“) def add_reminder(self, reminder_dict): 新增一个提醒 reminder_dict[‘id‘] len(self.reminders) 1 self.reminders.append(reminder_dict) self._save_to_file() def get_next_reminder(self): 获取下一个即将触发的提醒用于主界面显示 enabled_reminders [r for r in self.reminders if r[‘enabled‘]] if not enabled_reminders: return None # 按时间排序返回最早的一个 return min(enabled_reminders, keylambda x: x[‘time‘])4.2 多感官提醒的协同执行当提醒触发时我们需要协调屏幕、蜂鸣器、LED等多个外设同时工作。这里的关键是“非阻塞”执行。我们不能让提醒动作比如播放一段长音乐卡住整个主循环否则用户将无法进行任何操作比如按键确认。解决方案是使用线程Threading或异步任务。对于行空板上的Python使用threading模块是一个直接的选择。import threading import time class AlertExecutor: def __init__(self, screen, buzzer, led): self.screen screen self.buzzer buzzer self.led led self.alert_active False self.alert_thread None self.current_reminder None def trigger(self, reminder): 触发一个提醒 if self.alert_active: # 如果已有提醒在运行可以选择排队或忽略新提醒 print(“已有提醒正在执行忽略新提醒“) return self.current_reminder reminder self.alert_active True # 在新线程中执行提醒动作避免阻塞主循环 self.alert_thread threading.Thread(targetself._alert_worker, daemonTrue) self.alert_thread.start() def _alert_worker(self): 提醒工作线程 reminder self.current_reminder # 1. 更新屏幕显示提醒信息在主线程中通过事件通知可能更好这里简化处理 self.screen.show_alert(reminder[‘title‘]) # 2. 根据设置启动声音和灯光线程 threads [] if reminder.get(‘sound‘): sound_thread threading.Thread(targetself._play_sound, args(reminder[‘sound_type‘],)) sound_thread.start() threads.append(sound_thread) if reminder.get(‘light‘): light_thread threading.Thread(targetself._run_light_pattern, args(reminder[‘light_pattern‘],)) light_thread.start() threads.append(light_thread) # 3. 等待提醒被用户确认或超时 # 这里需要一个停止标志由主线程在用户确认后设置 start_time time.time() timeout 60 # 提醒最多持续60秒 while self.alert_active and (time.time() - start_time) timeout: time.sleep(0.1) # 4. 停止所有提醒效果 self._stop_all_effects() for t in threads: t.join(timeout1.0) # 等待子线程结束 self.alert_active False self.current_reminder None def _play_sound(self, sound_type): if sound_type ‘beep‘: for _ in range(3): self.buzzer.beep(1000, 0.2) # 频率1000Hz响0.2秒 time.sleep(0.1) elif sound_type ‘melody‘: # 播放一段简单的旋律例如《小星星》片段 melody [(262, 0.3), (294, 0.3), (330, 0.3), (262, 0.3)] # 频率和时长 for freq, duration in melody: self.buzzer.beep(freq, duration) time.sleep(duration * 0.1) def _run_light_pattern(self, pattern): while self.alert_active: if pattern ‘flash_red‘: self.led.set_color(255, 0, 0) # 红色 time.sleep(0.5) self.led.set_color(0, 0, 0) # 关闭 time.sleep(0.5) elif pattern ‘breath_blue‘: # 实现呼吸灯效果 for i in range(0, 255, 5): if not self.alert_active: break self.led.set_color(0, 0, i) time.sleep(0.02) for i in range(255, 0, -5): if not self.alert_active: break self.led.set_color(0, 0, i) time.sleep(0.02) def _stop_all_effects(self): self.buzzer.off() self.led.off() def acknowledge(self): 用户确认提醒停止所有效果 self.alert_active False这样当提醒触发时主程序会立刻创建一个AlertExecutor线程来负责所有的提醒效果而主循环依然可以流畅地响应用户的按键操作比如按下B键来确认提醒这会调用acknowledge()方法。5. 用户界面与交互设计实战硬件项目的用户体验很大程度上取决于其界面与交互设计。在资源受限的行空板屏幕小、输入设备少上设计需要格外讲究效率和清晰度。5.1 屏幕UI布局规划对于一个小尺寸屏幕比如2.8英寸信息必须高度浓缩。我们可以将屏幕分为几个固定的区域状态栏顶部显示当前时间、Wi-Fi信号如果联网、电池电量如果可测。主内容区中部根据当前状态动态显示。在主界面显示下一个提醒的概要在菜单显示选项列表在设置界面显示设置项和当前值。操作提示栏底部始终显示当前状态下各个按键的功能例如“A:选择 B:返回”。这是非常重要的设计能极大降低用户的学习成本。5.2 菜单导航与设置逻辑使用A、B两个按键进行导航是经典设计。一个常见的逻辑是A键通常作为“确认”、“进入”、“下一步”功能。B键通常作为“返回”、“取消”、“上一步”功能。在菜单列表中我们需要一个视觉上的“光标”来指示当前选中的项。可以通过反色、箭头或高亮边框来实现。# 一个简单的菜单绘制与处理示例 class MenuManager: def __init__(self, screen, items): self.screen screen self.menu_items items # 例如 [‘新增提醒‘, ‘提醒列表‘, ‘系统设置‘] self.selected_index 0 # 当前选中项的索引 self.top_index 0 # 当前屏幕显示的第一项的索引用于长列表滚动 def draw(self): self.screen.clear() # 绘制标题 self.screen.draw_text(‘主菜单‘, x10, y10) # 计算当前屏幕能显示多少项 items_per_page 5 # 绘制当前页的菜单项 for i in range(items_per_page): item_idx self.top_index i if item_idx len(self.menu_items): break y_pos 40 i * 25 # 如果是选中的项反色显示 if item_idx self.selected_index: self.screen.fill_rect(5, y_pos-2, 230, 20, color‘white‘) self.screen.draw_text(self.menu_items[item_idx], x10, yy_pos, color‘black‘) else: self.screen.draw_text(self.menu_items[item_idx], x10, yy_pos, color‘white‘) # 绘制底部操作提示 self.screen.draw_text(‘A:确认 B:返回‘, x10, y220) def handle_button_a(self): 处理A键按下事件 selected_item self.menu_items[self.selected_index] # 返回被选中的菜单项由主状态机决定下一步动作 return selected_item def handle_button_b(self): 处理B键按下事件返回上一级 return ‘back‘ def move_cursor_down(self): 向下移动光标 self.selected_index (self.selected_index 1) % len(self.menu_items) # 如果光标移出了当前屏幕则滚动列表 if self.selected_index self.top_index 5: self.top_index 1 def move_cursor_up(self): 向上移动光标 self.selected_index (self.selected_index - 1) % len(self.menu_items) if self.selected_index self.top_index: self.top_index max(0, self.top_index - 1)5.3 时间设置的人性化设计设置提醒时间是最高频的操作之一。如果让用户用按键一位一位地输入数字体验会非常糟糕。一个更好的方案是提供“快速调整”和“微调”两种模式。例如在时间设置界面光标停留在“小时”位时短按A键小时数加1。长按A键小时数快速连续增加。短按B键切换到“分钟”位。旋转编码器如果有这是最理想的方案顺时针增加逆时针减少。同时屏幕上应该提供清晰的视觉反馈比如高亮当前正在调整的位置并实时显示调整后的时间。6. 项目优化与扩展思路一个能跑通的基础版提醒器已经完成了。但要让它变得更好用、更可靠我们还需要考虑以下优化和扩展点。6.1 低功耗优化如果希望设备能电池供电长时间运行功耗是关键。屏幕背光控制在无操作一段时间后例如30秒自动调暗或关闭屏幕背光。当检测到按键操作或提醒触发时再点亮。CPU频率调节在空闲状态主界面无操作可以适当降低CPU主频。外设电源管理不使用的传感器如未连接震动马达对应的GPIO口应设置为输入模式或关闭其电源域如果支持。高效的事件检测主循环中的time.sleep(0.05)在低功耗场景下可能仍显浪费。可以考虑使用硬件中断来唤醒CPU或者使用更长的休眠间隔并在休眠期间依靠RTC的闹钟功能来唤醒系统进行检查。6.2 数据持久化与可靠性我们之前用JSON文件存储提醒列表但直接频繁写入文件会损耗存储介质通常是TF卡。可以优化为增量保存只在提醒列表发生变化增、删、改时才触发保存操作而不是每次循环都保存。写缓存将多次连续的修改合并为一次保存。备份机制保存时先写入一个临时文件写入成功后再重命名为正式文件防止程序意外崩溃导致数据文件损坏。6.3 网络功能扩展进阶为行空板连接Wi-Fi后可以解锁更多强大功能网络对时NTP开机后自动从网络获取准确时间无需手动校准。这是确保提醒准时最关键的一步。语音合成提醒将提醒文本通过在线API如百度语音合成转换为语音通过音频输出接口播放体验更自然。远程管理与同步开发一个简单的手机App或网页端通过局域网甚至互联网来添加、管理行空板上的提醒事项。这涉及到简单的HTTP服务器或MQTT客户端编程。天气/日历集成从网络获取天气信息创建“下雨提醒带伞”的智能提醒或者同步在线日历的事件作为提醒源。6.4 硬件扩展玩法增加传感器结合温湿度传感器创建“室内干燥提醒加湿器”的环境提醒。结合人体红外传感器实现“人离开房间超过10分钟提醒关灯”的节能提醒。输出多样化除了板载资源可以连接一个OLED小屏幕显示更多信息连接一个功放和喇叭播放更复杂的MP3提醒音频或者连接一个舵机举起一个“flag”做物理提醒。从点亮第一个LED到完成这个“多功能提醒器”你走过的路正是一个典型的嵌入式应用开发流程需求分析、硬件选型、架构设计、模块编码、调试优化。这个项目像一块积木你已经掌握了它的基本形状。接下来是把它搭成一座小房子还是组合进一个更大的机器人完全取决于你的想象力和需求。编程和硬件的乐趣就在于这种从无到有、不断打磨和扩展的创造过程。
