1. 项目概述从“Hello World”到真实世界应用如果你已经跟着行空板的前两课点亮了LED也玩转了按钮可能会觉得这些基础操作挺有意思但好像离做一个“有用”的东西还有点距离。没错学编程最怕的就是停留在“玩具”阶段那种成就感来得快去得也快。今天这第三课我们要来点真格的——做一个“多功能提醒器”。这不再是一个简单的演示程序而是一个能解决实际生活小痛点的工具。想象一下这些场景你在书桌前专注工作或学习很容易忘记时间一坐就是两三个小时厨房里炖着汤你回到客厅刷手机结果完全忘了炉子上的事或者你给自己设定了一些简单的待办事项比如每半小时起来活动一下、每天下午三点吃药但总因为忙别的事而错过。这个“多功能提醒器”就是为了解决这些问题而生的。它本质上是一个集成了定时提醒、倒计时和简单任务清单功能的小设备我们可以通过行空板的屏幕进行交互让它用声音、灯光甚至文字来提醒我们。为什么选择这个项目作为入门后的第一个综合应用因为它几乎用到了我们目前学到的所有核心概念GPIO控制控制LED和蜂鸣器、屏幕显示TFT库、用户交互按钮和触摸屏、逻辑判断if/else和循环while并且将它们有机地组合在一起。你会看到单个知识点是零散的积木而这个项目就是教你如何按照图纸把这些积木搭成一个有趣的小房子。通过它你会第一次感受到用代码“创造”出一个完整功能的乐趣这才是编程入门路上最关键的“顿悟”时刻。2. 核心功能设计与硬件连接思路在动手写代码之前我们必须先想清楚这个提醒器要做什么以及行空板上的资源如何为我们所用。盲目接线和写代码只会导致混乱和不断的返工。2.1 功能模块分解我们的多功能提醒器主要包含三个核心功能每个功能都对应一个独立的操作模式定时提醒模式设定一个未来的时间点例如17:30到达该时间后触发提醒。这需要用到行空板的实时时钟RTC功能来获取当前时间。倒计时模式设定一个时长例如25分钟开始倒计时归零时触发提醒。这需要程序内部进行计时逻辑。简单任务清单模式可以添加几条文本任务完成一项勾选一项。这主要涉及屏幕列表的显示和触摸交互。此外所有模式共享以下公共模块提醒方式需要至少两种感官提醒。视觉上我们可以用板载的RGB LED例如闪烁红灯听觉上可以使用蜂鸣器发出“滴滴”声。高级一点还可以在屏幕上弹出醒目的大字提示。用户界面需要一个清晰的菜单让用户在主界面选择进入哪种模式。在每个子模式里要有直观的设置和启动/停止控制。状态反馈任何时候用户都应该能一眼看到当前模式、设置状态或剩余时间。2.2 硬件资源映射与连接规划行空板自带丰富的资源我们不需要额外连接任何传感器这就大大简化了硬件准备。我们来规划一下各个功能如何映射到硬件上显示核心2.8英寸的IPS电容触摸屏。这是我们整个项目的交互和显示中心。所有菜单、时间设置、任务列表、倒计时显示都靠它。输入设备电容触摸屏用于主菜单选择、数字键盘输入时间、勾选任务清单。这是最自然、最主要的交互方式。物理按键A/B键作为辅助或备用按键。例如在倒计时模式下A键可以用于“开始/暂停”B键用于“重置”。在设置时间时可以作为“确认”和“取消”键。物理按键的加入能让操作更有“实体感”在某些场景下比触摸更快捷。输出设备提醒装置板载RGB LED位于屏幕下方。我们可以编程让它在不同状态下显示不同颜色如待机蓝色、运行绿色、提醒红色闪烁这是非常直观的状态指示灯。板载蜂鸣器发出提醒音。可以设计不同的蜂鸣模式如短促单音、急促连响来区分不同类型的提醒如定时到达 vs. 任务完成。计时核心行空板内置的RTC实时时钟。我们需要在程序初始化时同步网络时间或手动设置以确保定时提醒的准确性。注意行空板的引脚功能是复用的。在编程时我们不需要像使用普通单片机那样先初始化GPIO模式而是直接调用针对板载资源封装好的高级库函数如pinpong库或行空板专用库这极大降低了入门门槛。例如控制蜂鸣器可能只需要一行board.buzzer.on()而不是去设置某个引脚的高低电平。2.3 软件架构草图在代码层面我们可以采用一个“状态机”的简单思想来组织程序主循环始终运行根据当前的“模式状态”如MAIN_MENU,SET_TIMER,COUNTDOWN_RUNNING等来决定显示什么界面、检测什么输入。模式处理函数每个主要功能主菜单、定时设置、倒计时运行、任务列表写成独立的函数。主循环根据状态调用对应的函数。全局变量用于存储当前模式状态、设置的时间值、倒计时剩余秒数、任务列表数据等。这种结构清晰易于调试和扩展。比如未来你想增加一个“秒表模式”只需要新增一个模式状态和对应的处理函数即可不会影响原有代码。3. 代码实现与核心环节解析理论清晰后我们开始动手实现。这里我将分模块讲解关键代码并解释其背后的逻辑。请确保你的行空板已连接到同一局域网并通过WebIDE或SSH进行编程。3.1 环境准备与库的导入行空板基于Linux并预装了Python和许多常用库。我们主要会用到以下几个# 多功能提醒器 - 主程序框架 import time from pinpong.board import Board, Pin from pinpong.extension.unihiker import * import pygame # 用于更复杂的声音播放如果需要 from unihiker import GUI # 行空板官方GUI库简化屏幕绘图pinpong.board和pinpong.extension.unihiker这是行空板推荐的硬件控制库。Board().begin()初始化板子unihiker扩展模块则提供了直接控制行空板LED、蜂鸣器、按键的简便方法。pygamePython中强大的多媒体库。虽然行空板的pinpong库可以驱动蜂鸣器发出简单音调但如果你想播放更复杂的提示音如一段MP3pygame.mixer会非常有用。对于本课我们先使用简单的蜂鸣器。unihiker.GUI这是行空板官方提供的图形用户界面库它比直接使用PIL画图更高级、更方便提供了文本、按钮、图片等控件能极大地简化触摸交互界面的开发。初始化工作# 初始化 Board().begin() # 初始化pinpong库连接板子 gui GUI() # 初始化GUI对象 screen_width gui.width screen_height gui.height # 初始化硬件对象 led_rgb RGB_LED() # RGB LED对象 buzzer Buzzer(Pin(Pin.P22, Pin.OUT)) # 蜂鸣器对象连接在P22引脚 btn_a Button(Pin(Pin.P21, Pin.IN), pull_upTrue) # A键 btn_b Button(Pin(Pin.P20, Pin.IN), pull_upTrue) # B键 # 定义一些全局状态变量 current_mode MAIN_MENU # 当前模式 timer_target {hour: 18, minute: 0} # 定时提醒的目标时间 countdown_seconds 0 # 倒计时总秒数 countdown_remaining 0 # 倒计时剩余秒数 is_countdown_running False task_list [喝一杯水, 活动肩颈, 阅读30分钟] # 示例任务清单 task_done [False, False, False] # 对应任务完成状态3.2 主菜单与界面绘制实现主界面是用户的第一印象也是所有功能的调度中心。我们使用unihiker.GUI来创建按钮。def draw_main_menu(): 绘制主菜单界面 gui.clear() # 清空屏幕 gui.draw_text(text多功能提醒器, xscreen_width//2, y30, font_size20, colorblue) # 创建三个模式选择按钮 btn_timer gui.draw_button(x60, y80, text定时提醒, width200, height50) btn_countdown gui.draw_button(x60, y150, text倒计时, width200, height50) btn_tasks gui.draw_button(x60, y220, text任务清单, width200, height50) btn_exit gui.draw_button(x60, y290, text退出, width200, height50, colorgray) # 为按钮绑定触摸事件处理函数 btn_timer.config(commandlambda: switch_mode(SET_TIMER)) btn_countdown.config(commandlambda: switch_mode(SET_COUNTDOWN)) btn_tasks.config(commandlambda: switch_mode(TASK_LIST)) btn_exit.config(commandcleanup_and_exit) def switch_mode(new_mode): 切换当前模式 global current_mode current_mode new_mode # 模式切换后需要绘制新的界面 if new_mode SET_TIMER: draw_timer_setting() elif new_mode SET_COUNTDOWN: draw_countdown_setting() elif new_mode TASK_LIST: draw_task_list() elif new_mode MAIN_MENU: draw_main_menu()这里的关键是gui.draw_button和config(command...)。它创建了一个可触摸的按钮并将一个函数这里用了lambda匿名函数绑定到其点击事件上。当用户触摸按钮时对应的函数会被自动调用从而改变current_mode并刷新界面。这种事件驱动的编程模式是图形界面开发的核心。3.3 定时提醒模式详解定时提醒需要用户设置小时和分钟。我们可以设计一个简单的数字键盘或使用“”/“-”按钮来调整。def draw_timer_setting(): 绘制定时设置界面 gui.clear() gui.draw_text(text设置提醒时间, xscreen_width//2, y30, font_size18) global timer_target # 显示当前设置的时间 time_display f{timer_target[hour]:02d}:{timer_target[minute]:02d} time_label gui.draw_text(texttime_display, xscreen_width//2, y80, font_size40, colorgreen) # 创建调整按钮 btn_hour_up gui.draw_button(x50, y150, text时, width80, height40) btn_hour_down gui.draw_button(x150, y150, text时-, width80, height40) btn_min_up gui.draw_button(x250, y150, text分, width80, height40) btn_min_down gui.draw_button(x350, y150, text分-, width80, height40) btn_start gui.draw_button(x100, y220, text开始定时, width200, height50, colorgreen) btn_back gui.draw_button(x100, y290, text返回, width200, height50, colororange) # 绑定事件 def update_time_display(): time_label.config(textf{timer_target[hour]:02d}:{timer_target[minute]:02d}) btn_hour_up.config(commandlambda: (timer_target.update({hour: (timer_target[hour] 1) % 24}), update_time_display())) btn_hour_down.config(commandlambda: (timer_target.update({hour: (timer_target[hour] - 1) % 24}), update_time_display())) # ... 类似绑定分分- ... btn_start.config(commandstart_timer_monitor) btn_back.config(commandlambda: switch_mode(MAIN_MENU))设置好时间后start_timer_monitor函数会被调用。这个函数不会阻塞主界面它通常通过一个后台检查线程或是在主循环中定期检查来实现。def start_timer_monitor(): 启动定时监控并跳转到监控界面 global current_mode current_mode TIMER_MONITOR draw_timer_monitor() def draw_timer_monitor(): 显示定时监控界面 gui.clear() gui.draw_text(text定时监控中..., xscreen_width//2, y60, font_size16) gui.draw_text(textf目标: {timer_target[hour]:02d}:{timer_target[minute]:02d}, xscreen_width//2, y100) # 这里可以显示当前时间 # 一个“停止”按钮 btn_stop gui.draw_button(xscreen_width//2-100, y200, text停止, width200, height50, colorred) btn_stop.config(commandlambda: switch_mode(MAIN_MENU))那么如何检查时间是否到了呢这需要在我们的主循环中实现。3.4 主循环与后台检查逻辑主循环是程序的心脏它不断检查各种状态并更新界面。def main_loop(): last_check_time 0 while True: now time.time() # 获取当前时间戳 # 1. 处理定时提醒检查每秒检查一次即可避免过于频繁 if current_mode TIMER_MONITOR and now - last_check_time 1: last_check_time now current time.localtime() if current.tm_hour timer_target[hour] and current.tm_min timer_target[minute]: trigger_alarm(定时时间到) switch_mode(MAIN_MENU) # 提醒后返回主菜单 # 2. 处理倒计时 if current_mode COUNTDOWN_RUNNING and is_countdown_running: # 这里需要一个更精确的计时方式例如记录开始时间点。 # 简化处理在主循环中每秒减1不精确仅演示逻辑 pass # 3. 检查物理按键作为触摸屏的补充 if btn_a.is_pressed(): # 例如在倒计时界面A键可以暂停/继续 handle_button_a() if btn_b.is_pressed(): # B键可以重置或返回 handle_button_b() time.sleep(0.2) # 简单防抖 # 4. 更新界面上的动态信息如倒计时显示 update_display() time.sleep(0.05) # 主循环延迟降低CPU占用 def trigger_alarm(message): 触发提醒 # 视觉提醒LED闪烁红色 for _ in range(10): led_rgb.set_color(255, 0, 0) # 红色 time.sleep(0.3) led_rgb.set_color(0, 0, 0) # 关闭 time.sleep(0.3) # 听觉提醒蜂鸣器响 buzzer.on() time.sleep(1) buzzer.off() # 屏幕提示可以设计一个弹窗 gui.msgbox(message, 提醒)3.5 倒计时模式的关键实现倒计时模式比定时更复杂因为它需要持续运行并更新显示。关键在于如何管理时间流逝。一个常见但不够精确的方法是在主循环中每秒减少剩余秒数。但主循环的time.sleep(0.05)会导致严重误差。推荐的方法是记录倒计时开始的精确时间点。import threading countdown_start_time 0 # 倒计时开始的时间戳 def start_countdown(): global is_countdown_running, countdown_start_time, countdown_remaining if countdown_remaining 0: gui.msgbox(请先设置时间, 提示) return is_countdown_running True countdown_start_time time.time() # 记录开始时刻 switch_mode(COUNTDOWN_RUNNING) def update_countdown_display(): 在倒计时运行界面更新显示 if not is_countdown_running: return elapsed time.time() - countdown_start_time remaining max(0, countdown_seconds - int(elapsed)) # 更新屏幕上的剩余时间文本 # ... 代码更新gui上的文本控件 ... if remaining 0: is_countdown_running False trigger_alarm(倒计时结束) switch_mode(MAIN_MENU)然后在main_loop中定期调用update_countdown_display()即可。为了更流畅可以单独开一个线程来管理倒计时但作为入门教程在主循环中更新是更简单可控的方式。3.6 任务清单模式的交互实现任务清单的核心是列表显示和状态切换。def draw_task_list(): gui.clear() gui.draw_text(text任务清单, xscreen_width//2, y20, font_size20) y_offset 60 task_widgets [] # 保存任务文本和复选框控件便于后续更新 for i, (task, done) in enumerate(zip(task_list, task_done)): # 绘制复选框用文本模拟 status [✓] if done else [ ] status_text gui.draw_text(textstatus, x30, yy_offset, font_size16, colorgreen if done else black) # 绘制任务文本 task_text gui.draw_text(texttask, x80, yy_offset, font_size16, colorgray if done else black) # 将整行区域设置为可触摸 # unihiker GUI库暂时没有原生复选框控件我们可以用一个按钮覆盖这片区域来模拟 btn_area gui.draw_button(x25, yy_offset-15, text, widthscreen_width-50, height30, color, borderFalse) # 使用闭包保存当前索引i def make_toggle_callback(index): return lambda: toggle_task(index) btn_area.config(commandmake_toggle_callback(i)) task_widgets.append((status_text, task_text)) y_offset 40 # 返回按钮 gui.draw_button(xscreen_width//2-100, yy_offset20, text返回, width200, height50, commandlambda: switch_mode(MAIN_MENU)) def toggle_task(index): 切换任务完成状态 task_done[index] not task_done[index] # 这里需要重绘任务列表界面或者更高效地只更新对应行的文本颜色和状态标记 draw_task_list() # 简单处理重绘整个界面这里用按钮模拟了列表项的触摸区域点击后切换任务状态并刷新界面。虽然重绘整个列表在任务不多时没问题但更好的做法是只更新发生变化的那一行控件这需要更精细的控件管理。4. 系统集成、调试与优化心得当各个模块的代码都编写完成后我们需要将它们整合到一个完整的程序中并解决实际运行中会遇到的问题。4.1 程序入口与整体框架一个结构清晰的main.py文件如下# main.py import sys import time from pinpong.board import Board from pinpong.extension.unihiker import * from unihiker import GUI # 导入我们写好的各个模块的函数和全局变量 from modes import * # 假设我们把所有界面绘制和逻辑函数放在modes.py中 # 初始化 Board().begin() gui GUI() # ... 硬件初始化 ... # ... 全局变量初始化 ... def main(): try: draw_main_menu() # 绘制初始界面 main_loop() # 进入主循环 except KeyboardInterrupt: cleanup_and_exit() except Exception as e: print(f程序出错: {e}) cleanup_and_exit() def cleanup_and_exit(): 退出前的清理工作 led_rgb.set_color(0, 0, 0) buzzer.off() gui.clear() sys.exit(0) if __name__ __main__: main()4.2 常见问题与排查实录在实际把玩这个项目的过程中你几乎一定会遇到下面几个问题。这里是我的排查记录和解决方案问题1触摸按钮没反应或反应不灵敏。现象点击屏幕上的按钮程序毫无反应。排查检查事件绑定确认btn.config(commandyour_function)中的your_function是否正确定义且没有语法错误。最常见的是在lambda函数中使用了错误的变量。检查控件重叠unihiker.GUI中后绘制的控件会覆盖在先绘制的控件之上。如果你的按钮被后来绘制的其他透明或空白控件比如一个没有边框的文本盖住了就会点不到。确保按钮的绘制顺序和区域没有冲突。打印调试在按钮的命令函数里第一行加上print(按钮被点击)运行程序时观察WebIDE的控制台是否有输出。这是最直接的调试方法。问题2倒计时时间不准走得忽快忽慢。现象设置1分钟倒计时实际可能花了65秒或55秒。根源在主循环中使用time.sleep(0.05)和累加/减的方式来计时误差会累积。sleep函数并不精确且主循环中其他代码的执行也会耗时。解决方案使用时间戳差值法如前文所述记录开始时刻start_time time.time()在需要显示时计算elapsed time.time() - start_time。这样无论主循环快慢经过的真实时间总是准确的。使用线程或定时器Python的threading.Timer或sched模块可以安排函数在指定延迟后运行更适合精确的单一提醒。但对于需要持续更新的倒计时显示结合时间戳差值法和主循环更新显示是最佳实践。问题3蜂鸣器声音太刺耳或太小。行空板蜂鸣器通常是无源蜂鸣器需要通过PWM信号驱动才能发出不同频率的声音。pinpong库的Buzzer类可能已经封装了tone()方法。调整方法# 尝试播放一个特定频率和时长的声音而不是简单的on/off # 注意pinpong库的Buzzer类用法请查阅其文档以下为示例 buzzer.tone(1000, 500) # 播放1000Hz频率的声音持续500毫秒频率Hz决定音高持续时间ms决定长短。可以组合成简单的旋律。如果声音太小可能是驱动电流不足。行空板上的蜂鸣器通常是固定音量无法通过软件大幅调节。问题4程序运行一段时间后卡死或无响应。可能原因内存泄漏在死循环中不断创建新的GUI控件如draw_text,draw_button而没有清除旧控件会导致内存耗尽。确保在绘制新界面时先调用gui.clear()或者复用/更新现有控件。阻塞操作在按钮的事件处理函数或主循环中执行了非常耗时的操作如网络请求、大量文件读写导致界面“冻住”。对于耗时操作应考虑使用线程。异常未捕获某个函数抛出异常导致整个线程终止。用try...except包裹主循环和关键函数。4.3 功能优化与扩展建议当你成功实现了基础版本后可以尝试以下优化让这个提醒器变得更实用、更酷持久化存储目前任务清单和定时设置会在程序重启后丢失。可以使用json模块将task_list、task_done、timer_target等数据保存到行空板的一个文件如/home/pi/config.json中程序启动时再加载。多组定时与倒计时允许用户保存多组定时/倒计时设置并可以命名如“午休”、“番茄钟”。网络时间同步行空板可以连接Wi-Fi。使用ntplib库或简单的requests从网络时间服务器同步确保定时提醒绝对精准。更丰富的提醒方式除了LED和蜂鸣器可以尝试让屏幕全屏闪烁某种颜色。调用pygame.mixer播放一段更柔和的MP3提示音需先将音频文件上传到行空板。美化界面使用unihiker.GUI的图片显示功能为按钮添加图标背景。使用更美观的字体和布局。这个“多功能提醒器”项目就像一把钥匙帮你打开了用行空板结合Python解决实际问题的大门。它涉及的事件驱动编程、状态管理、时间处理、用户交互等概念是几乎所有嵌入式图形应用和小工具的基础。代码从几十行扩展到几百行管理复杂度随之上升你会开始思考如何组织代码更清晰比如将不同模式分到不同文件这正是一个开发者成长的必经之路。