Activity & Compass · 活动与指南针

利用 ESP-Mosaico 的 480 × 480 触摸屏、内置 BMI270 运动传感器和 BMM150 磁力计，查看本次运行的估算步数、设备姿态，以及校准后水平放置时的方向。无需网络或扩展子板。

操作

点击 Less / More（降低 / 提高） 调整计步阈值。连续点击两次 Reset steps（重置步数） 清除本次计数。应用重启后计数归零，不提供每日历史或后台记录。

点击 Calibrate（校准），让设备保持水平并完整转动一圈，再点击 Finish（完成）。转动不足时会拒绝校准；查看方向时请保持水平。附近金属和外壳磁铁可能影响读数。指南针没有倾斜补偿，步数也只是估算，不适合作为导航或医疗工具。

安装与验证

提供的 1.0.1 Iris 包面向配备 16 MiB Flash、保留 Vibe Mode/Recovery 的 ESP32-S31。请使用平台的 Iris 安装流程。包内包含应用、分区表和所需界面数据。

1.0.1 已在 ESP32-S31 实机上安装。通过真实屏幕和 USB 注入触控验证阈值增减、两次确认重置、校准开始及失败提示；同一启动期间无应用崩溃。BMI270 和 BMM150 均提供持续更新的真实读数，静置时重力大小检查通过，屏幕显示 Face up。原生模拟器和共享 C 逻辑检查也已通过。

人工完成手指点击、水平绕圈校准和约 20 步行走后，真机屏幕显示 21 步及有效的 90° 方向。该检查证明校准和计步链路能处理实际运动；尚未进行方向角参考对照或系统计步精度测试。详情见附件中的 projects/ideas_common/DEVICE_VALIDATION.md。

源码与资源许可

附件源码包不含凭据或带有个人配置的固件。将其中的 projects/ 解压到 ESP-Mosaico Vibe 开发工作区，保持本应用与 ideas_common 目录同级；构建依赖工作区已有的框架和工具，以及固定的 ESP-IDF 提交 7b9cc1ac79f865983f59bb8ff3ff43eb74ff1dbe。

界面使用 DejaVu 字体，详见字体许可。框架依赖保留各自许可证，本页面不新增整个仓库的授权条款。