实验手记与验证清单
这里用来区分“看过文档”和“自己跑通”。首批内容均为资料整理,尚未验证板卡行为。
当前实验台账
| 实验 | 资料版本 | 实板状态 | 证据 |
|---|---|---|---|
| Fedora / west / SDK | v4.2.0 | 待执行 | 待补安装日志 |
| Hello World | v4.2.0 | 待验证 | 待补串口输出 |
| GPIO / Blinky | v4.2.0 | 待验证 | 待补接线图与观察 |
| 自建应用 | v4.2.0 | 待验证 | 待补编译和运行日志 |
新建自己的记录
仓库提供 templates/experiment.md。从项目目录复制:
cp templates/experiment.md docs/lab/001-hello-world.md
修改标题、板卡、日期和内容,然后在 sidebars.js 的“实验手记”中加入 lab/001-hello-world。执行 npm run build 检查链接与 Markdown。
一篇记录至少保留什么
- 想验证的一个问题,以及预期结果。
- 主机、板卡、引脚、Zephyr / SDK / west 版本。
- 完整命令与执行目录。
- 实际输出、失败信息和每次调整。
- 结论、适用范围及仍未确认的部分。
图片放 static/img/experiments/,使用描述性文件名。大型串口日志留在本地固件工作区,文档只摘录有用片段;不要把 Wi-Fi 密码、令牌或个人设备凭据提交进仓库。