实验手记与验证清单
这里用来区分“看过文档”和“自己跑通”。当前主板为微雪 ESP32-S3-Touch-LCD-1.28。编译与运行分开记录，不把生成固件当作实板成功。
当前实验台账
| 实验 | 主机验证 | 实板状态 | 证据 |
|---|---|---|---|
| Python / west | Python 3.12.14 完整依赖安装及 import 检查通过 | 不适用 | .diagnostics/python-dependencies/ |
| SDK / Hello World | SDK 0.17.2，v4.2.0 微雪 Touch 目标编译、烧录、启动通过（2026-09-18） | 串口输出 SPI_FAST_FLASH_BOOT、*** Booting Zephyr OS build v4.2.0 ***、Hello World! esp32s3_touch_lcd_1_28/esp32s3/procpu | zephyr/build/waveshare-hello/zephyr/zephyr.elf、.bin |
| GPIO2 背光 PWM | 本机编译通过（2026-09-18），已检查 overlay 仅使用 GPIO2 | 待亮度与串口观察 | zephyr/build/waveshare-backlight/zephyr/zephyr.elf、.bin |
| 自建应用概念示例 | 未编译 | 待验证 | 待补日志 |
编译目标统一为 esp32s3_touch_lcd_1_28/esp32s3/procpu。上表路径均相对 ~/Projects/zephyr-workspace/。背光示例源码放在文档仓库 examples/waveshare-backlight/，已复制到工作区 applications/waveshare-backlight/。
新建自己的记录
仓库提供 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 密码、令牌或个人设备凭据提交进仓库。