跳到主要内容

实验手记与验证清单

这里用来区分“看过文档”和“自己跑通”。首批内容均为资料整理,尚未验证板卡行为。

当前实验台账

实验资料版本实板状态证据
Fedora / west / SDKv4.2.0待执行待补安装日志
Hello Worldv4.2.0待验证待补串口输出
GPIO / Blinkyv4.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。

一篇记录至少保留什么

  1. 想验证的一个问题,以及预期结果。
  2. 主机、板卡、引脚、Zephyr / SDK / west 版本。
  3. 完整命令与执行目录。
  4. 实际输出、失败信息和每次调整。
  5. 结论、适用范围及仍未确认的部分。

图片放 static/img/experiments/,使用描述性文件名。大型串口日志留在本地固件工作区,文档只摘录有用片段;不要把 Wi-Fi 密码、令牌或个人设备凭据提交进仓库。