学习路线与使用约定
欢迎来到 风栖 · Zephyr Notes。这里是面向 ESP32 的中文学习工作台：先跑通，再理解，最后留下自己的实验记录。
本轮学习基线
| 项目 | 约定 |
|---|---|
| Zephyr | 固定 v4.2.0，作为可追溯学习基线，不声称是最新版 |
| 主机 | Fedora Linux；其他发行版按对应官方安装说明调整 |
| 示例板卡 | 经典 ESP32-DevKitC，目标 esp32_devkitc/esp32/procpu |
| 文档站 | Docusaurus 3，简体中文，静态构建 |
| 实践状态 | 已核对官方资料，未进行实板烧录验证 |
先确认手里的板卡
ESP32 是一个产品家族。ESP32-C3、S3、C6 等不能直接套用经典 ESP32 的目标、引脚和串口说明。先读板卡确认，再执行编译命令。
按这个顺序学习
- 准备 Fedora 环境：检查依赖和目录布局。
- 创建 west 工作区：固定源码版本，安装 SDK 与 HAL 依赖。
- 运行 Hello World：只关注编译、烧录、串口三个环节。
- 完成 GPIO / Blinky：明确 LED 接线与设备树别名。
- 理解应用结构，再学习设备树和 Kconfig。
- 填写实验手记：把自己的硬件、日志和修改留在仓库。
三种内容，三种用途
- 中文整理：提炼官方说明，补上工作目录、检查点和常见问题。
- 英文原文：保留固定版本的 RST 文件，可在站内阅读或下载，并附校验值。
- 实验记录：你亲手执行后补充。未验证的内容不标成成功经验。
后续扩展
跑通首个程序后，再增加线程与同步、UART、I²C 传感器、Wi-Fi、BLE、功耗和 OTA 专题。每个专题按“目标 → 原理 → 操作 → 观察 → 问题 → 结论”组织，不急着堆积没有验证的代码。