确认 ESP32 板卡与目标
Zephyr 编译命令需要的是 board target，不是商品页面上泛称的“ESP32 开发板”。
本教程的范围
示例面向经典 ESP32-DevKitC，主核目标为：
esp32_devkitc/esp32/procpu
esp32_devkitc 是板卡，esp32 是 SoC，procpu 是 CPU 目标。先查看模块金属屏蔽罩上的型号及开发板原理图。WROOM、WROVER 和不同克隆板的 Flash、PSRAM、LED 可能不同。
查询本地支持列表
激活虚拟环境后，在 Zephyr 源码目录执行：
west boards | grep esp32
该命令帮助找到板卡名称；完整限定目标还要查相应板卡文档和源码目录中的 board.yml。搜索结果不代表任意后缀都可用。
ESP32-S3、C3、C6 应使用各自的板卡页和工具链，不要仅修改教程中的某个字符串就继续烧录。
建立硬件档案
| 信息 | 自己填写 |
|---|---|
| 开发板名称 / PCB 修订 | 待填写 |
| 模组 / SoC | 待填写 |
| Flash / PSRAM | 待填写 |
| Zephyr 完整目标 | 待填写 |
| USB 转串口芯片 / 串口路径 | 待填写 |
| 用户 LED GPIO / 极性 | 待查原理图 |
接口与 LED
USB 线必须支持数据。经典 DevKitC 的电源指示灯不等于可编程 LED；因此本路线先跑 Hello World，再做 GPIO。烧录会替换板上已有固件，执行前确认连接的是目标实验板。
官方来源
基于 Zephyr v4.2.0 官方资料整理的中文学习笔记，非逐字翻译；命令及说明作了学习场景适配。