openvela 智能手环应用

作者：武汉大学计算机学院李佳斌

GitLink：https://gitlink.org.cn/Lijiabin1234/openvela-smart-band-lijiabin

本项目是面向 CCF 开源创新大赛 openvela 智能手环赛题的初赛作品。作品采用原生应用路线，核心逻辑使用 C 实现，并提供 openvela LVGL 应用片段、host 端可复现模拟器、自动化测试、截图和演示素材。

功能

表盘：显示当前时间、日期、电量、步数和心率，支持两种表盘风格。
健康数据：模拟心率、步数、卡路里、活跃时长，并维护 7 天历史趋势。
页面交互：支持表盘、心率、计步、运动、消息、低功耗页面切换。
加分底座：运动记录、消息提醒、低功耗/抬腕亮屏模拟、历史查看接口。
工程化：一键构建测试、host Web 演示、openvela 移植说明、许可证和第三方声明。
交付校验：全量质量门禁、host API 烟测、压缩包 SHA-256 manifest。

快速开始

建议在 WSL2 Ubuntu 中执行，避免污染 Windows 主系统。

cd /mnt/d/06_MYD/竞赛/CCF开源创新大赛2/基于\ openvela\ 的智能手环应用开发/openvela-smart-band-lijiabin
python3 scripts/run_tests.py
python3 scripts/full_quality_gate.py
python3 host/server.py --host 127.0.0.1 --port 8765

浏览器打开：

http://127.0.0.1:8765

打包提交物：

python3 scripts/package_submission.py
python3 scripts/verify_submission.py

项目结构

core/            共享 C 状态模型和传感器模拟
openvela_app/    openvela/NuttX/LVGL 原生应用集成片段
host/            host Web 模拟器和静态 UI
tests/           C 单元测试
tools/           JSON 状态导出工具
scripts/         构建、截图、打包和 openvela 安装脚本
docs/            架构、复现、移植和演示说明
deliverables/    提交清单、方案文档、截图、视频和压缩包

openvela 集成

将应用安装到 openvela apps 仓库：

python3 scripts/install_into_openvela.py /path/to/openvela/apps

安装后目标目录为：

apps/packages/demos/lijiabin_band

启用 CONFIG_LVX_USE_DEMO_LIJIABIN_BAND，构建手环模拟器目标后，在 openvela shell 中启动：

lijiabin_band &

详细步骤见 docs/openvela_integration.md 和 docs/reproducibility.md。

验证命令

python3 scripts/run_tests.py

该命令会完成：

CMake 配置与编译。
CTest 单元测试。
所有页面 JSON 快照检查。
host API 真实启动烟测。
openvela Kconfig/CMake/Make 命名一致性检查。
README、许可证、文档和提交材料完整性检查。

交付材料

源代码仓库：本项目完整目录。
方案文档：deliverables/solution_document.md。
验证报告：deliverables/validation_report.md。
功能覆盖矩阵：deliverables/scoring_matrix.md。
评审快速入口：deliverables/reviewer_quickstart.md。
质量报告：deliverables/quality_report.json。
复现文档：docs/reproducibility.md。
演示脚本：docs/demo_script.md。
答辩 PPT：deliverables/openvela-smart-band-lijiabin-presentation.pptx，18 页答辩版。
中文旁白演示视频：deliverables/showcase_demo_narrated.mp4 和 deliverables/showcase_demo_narrated.webm，72 秒。
内嵌中文字幕演示视频：deliverables/showcase_demo_narrated_subtitled.mp4，用于静音或在线预览评审。
视频封面与故事板：deliverables/showcase_poster.png、deliverables/showcase_storyboard.png 和 deliverables/showcase_chapters.json，用于快速预览 12 个展示场景。
PPT 与视频审查报告：deliverables/presentation_video_qa_report.md。
中文旁白字幕稿：deliverables/showcase_narration_zh.srt。
截图：deliverables/screenshots/，由 scripts/render_demo_assets.py 或 scripts/capture_demo.js 生成。
基础视频素材：deliverables/demo_recording.webm，由 scripts/render_demo_assets.py 或 scripts/capture_demo.js 生成。
精修 showcase 视频：deliverables/showcase_demo.mp4 和 deliverables/showcase_demo.webm，72 秒。
压缩包：deliverables/openvela-smart-band-lijiabin-submission.zip。
完整性清单：deliverables/submission_manifest.json。

许可证

本项目采用 Apache License 2.0。第三方信息见 THIRD_PARTY.md。