1. 项目缘起从“想健身”到“能坚持”的痛点每次看到别人晒出完美的健身数据你是不是也心血来潮下载了一堆健身App办了健身卡结果没几天就因为各种“忘了”、“累了”、“没动力”而放弃我太懂这种感觉了。健身最难的不是开始而是坚持。而坚持不下去的一个核心原因就是缺乏即时、正向的反馈和可视化的成就感。传统的健身记录方式要么是纸笔容易丢要么是手机App需要频繁解锁、点击过程繁琐容易分心。有没有一种方式能把健身打卡这件事变得像玩游戏一样简单、直观甚至有点“酷”这就是我们今天要用行空板和图形化Python来做的“健身打卡追踪器”。这个项目本质上是一个物理化的、可交互的健身数据看板。它不依赖手机通过实体按键或传感器来记录每一次的健身动作比如俯卧撑、深蹲并在屏幕上实时显示累计次数、历史数据甚至用灯光、声音来给你加油打气。想象一下做完一组动作伸手按一下按钮屏幕上数字“1”同时板载的RGB灯带亮起庆祝的灯光这种满足感是手机App难以比拟的。行空板作为一款集成了屏幕、按键、传感器和Wi-Fi的开源硬件是制作这类交互式项目的绝佳平台。而图形化Python如Mind中的行空板库则大大降低了编程门槛让我们可以专注于逻辑和交互设计而不是复杂的代码语法。通过这个项目你不仅能收获一个实用的健身工具更能深入理解事件驱动编程、数据持久化存储和硬件交互的核心思想。2. 核心硬件与交互设计让设备“懂”你的训练在开始动手之前我们需要先规划好这个追踪器需要具备哪些功能以及如何与用户也就是你自己进行交互。一个好用的小工具交互设计往往比功能堆砌更重要。2.1 功能清单与硬件映射我们的健身打卡追踪器需要实现以下核心功能并对应到行空板的硬件资源上记录动作次数这是核心功能。我们需要记录不同健身项目的完成次数例如俯卧撑、深蹲、引体向上等。硬件实现使用行空板上的三个物理按键A、B、C来分别代表三种不同的健身动作。按一下对应项目的计数就加一。实时数据显示用户需要立刻看到自己的成果。硬件实现使用行空板自带的LCD屏幕来显示。我们可以设计一个简洁明了的界面同时显示三个项目的今日次数、总次数甚至是一个简单的进度条。数据持久化关机重启后数据不能丢失。我们需要把数据保存起来。硬件实现利用行空板的文件系统。我们可以创建一个文本文件如fitness_data.txt或JSON文件来存储数据。每次计数更新时同时更新这个文件。提供正向反馈增加打卡的仪式感和乐趣。硬件实现视觉反馈使用板载的RGB灯带。例如每完成10次动作灯带闪烁一次绿色完成一组目标比如50次灯带播放一段彩虹流光效果。听觉反馈使用行空板的蜂鸣器或通过音频接口连接小喇叭。完成目标时播放一段简短的胜利音效。重置与清零功能开始新一天的训练或纠正错误计数。硬件实现可以设计为长按某个按键如Home键2秒以上弹出确认界面来清零当日数据。2.2 界面布局设计草图在编程前最好先在纸上画一下屏幕的布局。一个清晰的界面能极大提升使用体验。我建议的布局如下----------------------------------- | 健身打卡追踪器 v1.0 | ----------------------------------- | 项目 今日 总计 进度 | ----------------------------------- | 俯卧撑 15 150 [...] | | 深蹲 20 300 [.] | | 引体向上 5 80 [.....] | ----------------------------------- | | | 按键A:俯卧撑 B:深蹲 C:引体向上 | | | | 长按Home键重置今日数据 | -----------------------------------这个布局包含了标题、表头项目、今日、总计、进度以及三行数据。进度条可以用字符如和.模拟直观显示今日完成度与目标比如50次的对比。底部是操作提示。这样的设计信息密度适中一目了然。3. 图形化编程实战从零搭建逻辑骨架接下来我们进入最核心的环节——使用Mind的行空板图形化编程模块来实现上述设计。我会分模块讲解并解释每个积木背后的逻辑。注意请确保你的Mind已安装“行空板”扩展库并且行空板通过USB连接电脑串口连接成功。3.1 初始化程序启动的准备工作任何程序都需要一个起点。对于我们的追踪器启动时需要做以下几件事初始化屏幕清空屏幕设置背景色和文字颜色。初始化数据文件检查存储数据的文件是否存在。如果不存在就创建一个并写入初始数据三个项目计数均为0。如果存在就读取里面的数据加载到程序的变量中。绘制静态界面画出那些不会频繁变化的元素比如标题、表头、项目名称、进度条标签等。初始化按键监听告诉程序当A、B、C、Home键被按下时应该去执行哪一段逻辑。在图形化编程中我们通常用一个“当开机时”或“当绿色旗帜被点击”的积木作为总入口。下面是用积木逻辑描述的过程当开机时 清空屏幕 设置屏幕方向为横向根据你的布局选择 设置背景色为黑色文字色为白色 如果 文件“/fitness_data.json”不存在 创建初始数据字典{“push_up”: {“today”:0, “total”:0}, “squat”: {...}, “pull_up”: {...}} 将这个字典以JSON格式写入文件“/fitness_data.json” 否则 从文件“/fitness_data.json”中读取内容并解析为字典存入变量“fitness_data” 调用函数“draw_static_ui” # 绘制静态界面 调用函数“update_display” # 用读取的数据更新动态显示 当按键A被按下 调用函数“add_count” 参数为 “push_up” 当按键B被按下 调用函数“add_count” 参数为 “squat” 同理设置按键C和Home键这里我引入了“函数”的概念。在复杂项目中把功能封装成函数在Mind中是“自制积木”是保持代码清晰的关键。draw_static_ui负责画固定部分update_display负责用最新数据刷新数字和进度条。3.2 核心逻辑按键响应与数据处理当用户按下按键A代表俯卧撑时程序需要增加对应项目的“今日”计数和“总计”计数。更新屏幕上的显示。保存更新后的数据到文件。检查是否达到某个里程碑触发反馈灯光/声音。我们来实现add_count这个函数函数 add_count (项目名): # 1. 更新内存中的数据 将变量 fitness_data[项目名][“today”] 增加 1 将变量 fitness_data[项目名][“total”] 增加 1 # 2. 更新屏幕显示 调用函数 update_display # 3. 持久化保存 将变量 fitness_data 以JSON格式写入文件 “/fitness_data.json” # 4. 提供即时反馈 设置RGB灯带颜色为绿色 等待0.1秒 关闭RGB灯带 # 5. 检查里程碑例如每10次一个里程碑 如果 fitness_data[项目名][“today”] 除以10的余数等于0 播放音调例如1000Hz, 0.2秒 让RGB灯带显示彩虹流光效果持续1秒这里有几个关键点数据存储格式我推荐使用JSON。它结构清晰易于读写和扩展。fitness_data变量是一个字典里面嵌套了字典分别存储每个项目的今日和总计数据。反馈的层次感每次按键都有简单的灯光反馈绿色闪烁每完成10次则有更强的视听反馈音调彩虹灯。这种渐进式的反馈能有效维持用户的参与感。文件操作的时机每次计数更新都立即保存。虽然对微型SD卡寿命有一定理论影响但对于这种低频次一天几十上百次的操作完全无需担心最重要的是保证数据安全避免突然断电丢失。3.3 数据显示更新让进度一目了然update_display函数是连接数据和界面的桥梁。它的任务是在屏幕的指定位置用最新的数字覆盖旧数字。根据“今日次数”和“目标次数”比如50次计算并绘制进度条。进度条可以用纯文本模拟这是一种经典且兼容性极强的方法。例如目标50次那么每完成5次进度条就增长10%。我们可以用10个字符位来表示进度条长度 (今日次数 / 目标次数) * 10 # 例如今日25次25/50*105那么进度条就是5个‘’和5个‘.’ 进度条字符串 “”重复(进度条长度) “.”重复(10 - 进度条长度) # 结果“.....”在屏幕上绘制时你需要精确计算每个数字和进度条的位置坐标x, y。行空板屏幕分辨率是240*320你需要通过多次调试来确定最合适的坐标。一个技巧是先在draw_static_ui函数里用浅灰色画出位置框调试好坐标后再在update_display中用背景色黑色覆盖旧数据然后写上新的数据实现“局部刷新”避免全屏重绘导致的闪烁。3.4 重置功能实现长按操作的逻辑清零功能需要谨慎避免误触。设计为长按Home键2秒是一个好方法。这需要用到“计时”逻辑。当按键Home被按下 记录当前时间戳为 start_time 等待直到按键Home被松开 或 当前时间 - start_time 2秒 如果 当前时间 - start_time 2秒 # 长按触发 在屏幕中央绘制一个确认对话框“确认清零今日数据[Y/N]” 等待用户按下按键Y或N 如果按下Y 遍历 fitness_data 中所有项目将其“today”值设为0 调用 update_display 将更新后的 fitness_data 写入文件 在屏幕上提示“今日数据已清零” 等待1秒 清空提示 否则如果按下N 关闭确认对话框 否则 # 短按什么也不做或可以设计为其他功能如切换显示模式这个逻辑模拟了常见的长按交互。在图形化编程中“等待直到”和计时可能需要组合使用“计时器”积木和变量来判断。4. 项目优化与扩展思考让你的追踪器更聪明基础功能实现后我们可以让这个项目变得更加强大和个性化。这里分享几个我实践过的优化方向和踩过的坑。4.1 数据可视化与历史回顾单纯的数字是枯燥的。我们可以利用行空板的网络功能将数据同步到云端生成更丰富的图表。但即使离线我们也能在板子上做简单的历史可视化。周视图/月视图修改数据存储结构不再只存“总计”而是记录每天的数据。文件结构可以变为{ “push_up”: { “2023-10-27”: 30, “2023-10-28”: 25, “total”: 150 } }然后可以设计一个界面通过按键切换用柱状图同样可以用字符|绘制显示最近7天的训练量。这需要更复杂的屏幕绘制逻辑但能让你一眼看清自己的训练周期律。趋势提示在界面上增加一行小字比如“昨日: 25次 ↑”用箭头和颜色绿色↑、红色↓直观对比昨日数据激励自己。4.2 自适应目标与成就系统固定的目标如50次可能不适合所有人或所有阶段。我们可以引入动态目标。智能目标建议根据过去一周的平均完成量自动建议今天的目标比如平均值的120%。成就徽章定义一些成就如“持之以恒”连续打卡7天、“突飞猛进”单日次数破纪录、“全能战士”三个项目均达标。当条件达成时在屏幕上显示一个特殊的徽章图案并永久记录。这能极大提升游戏的趣味性。实现成就系统需要在数据文件中增加一个“achievements”字段并在每次数据更新时检查各种成就条件。4.3 硬件扩展与交互升级行空板的引脚可以连接更多传感器创造全新的交互方式。脱离双手的打卡如果你在做波比跳或开合跳手可能不方便按按键。可以连接一个振动传感器或声音传感器放在地板上。完成一次跳跃落地产生的震动或击掌声音可以被传感器识别为一次有效计数。这需要调试传感器的阈值避免误触发。踩坑记录声音传感器在嘈杂环境下误触发率很高。后来我换成了压电薄膜传感器贴在瑜伽垫下专门检测跳跃落地的冲击效果就好很多。关键在于要设置一个短暂的“触发冷却时间”比如0.5秒内不重复计数防止一次落地产生多个信号震荡。环境反馈连接一个WS2812B RGB灯环放在显眼位置。不同的项目用不同颜色代表进度用灯环点亮的角度来显示比屏幕上的进度条更酷炫。4.4 稳定性与数据安全加固项目久了最怕数据损坏或丢失。我遇到过因为突然拔电导致JSON文件写入一半变成无效格式程序下次启动就崩溃的情况。数据写入原子化不要直接覆盖原文件。采用“写新换旧”策略。每次保存时先写入一个临时文件如fitness_data.json.tmp写入完成且验证无误后再删除旧文件并将临时文件重命名为正式文件。这样即使写入过程中断电也只会损失一个临时文件原有的数据文件完好无损。数据备份与恢复增加一个通过Wi-Fi将数据文件备份到电脑的功能。可以写一个简单的HTTP服务器在行空板上电脑浏览器访问一个特定地址就能下载当前的数据文件。同理也可以上传一个备份文件进行恢复。异常处理在读取数据文件的代码块周围一定要加上“异常处理”积木。如果文件损坏读不出来就重置为初始数据并在屏幕上显示“数据文件已重置请重新开始”。这总比程序完全卡死要好。5. 从项目到习惯工具之外的思考做完这个硬件项目它最终会成为一个安静的伙伴放在你的书桌或健身角。它的价值不仅仅在于技术实现更在于它如何融入并改变你的行为模式。我自己的设备就放在书房显眼处。工作间隙看到它就会下意识地做几个俯卧撑然后去按一下按键。那个“1”的反馈和跳动的数字形成了一种微妙的奖励机制。久而久之从“需要坚持”变成了“顺手的事”。这就是行为设计学中“提示-行动-奖励”循环的物理化体现。这个项目的代码和逻辑并不复杂但它完整地展示了一个物联网原型产品的开发流程需求分析、交互设计、硬件选型与映射、逻辑实现、数据持久化、反馈优化。你可以把它看作一个模板将“健身打卡”替换成“喝水提醒”、“番茄钟”、“单词记忆”其核心架构——输入按键/传感器、处理计数/逻辑、输出屏幕/灯光、存储文件——是完全相通的。最后别忘了给你的追踪器设计一个漂亮的外壳。3D打印一个支架或者用乐高积木搭一个让它成为你生活空间中有个性的一部分。技术最终要服务于生活而让工具变得可爱、可触、可互动正是我们动手创造的乐趣所在。