新物先写一个能核对的问题，避免只收藏文档首页
“看懂ESP32”没有一个明确结束点。先把任务改成“v1.1板载RGB接哪一个GPIO”“core3.3.12的ledcWrite首参是什么”“IDF5.5.5的S3最小工程从哪里开始”。三问需要的证据不同，后面逐一走通。
在记录顶部写芯片、模组后缀、开发板厂商/修订、框架版本和所问功能。能拍清楚板子不等于已经知道修订；看不到丝印时先标未知，再向供应商要匹配资料，不把相似商品图直接当作你的实板。
- 做到这里，你应该看到
- 问题包含具体对象和版本，答案可以由一张表、一条声明或完整工程验证。
参考：[1] ESP-IDF v5.5.5 / ESP32-S3 入门入口[3] DevKitC-1 v1.1固定资料：硬件修订与排针表[4] Arduino-ESP32 3.3.12 LEDC接口声明[6] ESP32-S3数据手册v2.2：芯片能力与电气信息
任务一：芯片能用哪个GPIO，不等于板上灯接哪个GPIO
ESP32-S3数据手册回答芯片的电气与外设能力；DevKitC-1手册回答这块开发板把器件接到了哪里。打开固定v1.1章节，读硬件说明和连接器表，再读与初版差异：v1.1板载可寻址RGB是GPIO38，初版是GPIO48。只有“ESP32-S3”几个字不能确定是哪一个。
记录的结论应是“该上游v1.1板级资料将RGB标为GPIO38”，随后对照自己的板厂商和修订。匿名兼容板不能因用了同一模组就直接套38；也不能拿一张GPIO功能表来证明普通LED与可寻址RGB的驱动相同。
| 资料层 | 这次能回答 | 还不能回答 |
|---|---|---|
| S3芯片手册 | 引脚/外设/额定能力 | 某开发板RGB实际走线 |
| DevKitC-1 v1.1板级文档 | 指定修订RGB38、USB/排针 | 匿名兼容板布线 |
| 模块与器件资料 | 电源/逻辑/协议/地址 | 整个装置已接对或已运行 |
参考：[3] DevKitC-1 v1.1固定资料：硬件修订与排针表[6] ESP32-S3数据手册v2.2：芯片能力与电气信息
任务二：先固定文档版本与芯片目标，再看API
打开IDF文档后，检查标题和选择器同时指向v5.5.5与ESP32-S3；相应URL路径含/en/v5.5.5/esp32s3/。切换版本或目标后重新看标题与URL，旧标签页不会因为你在另一页选过S3就自动变成S3。latest可作浏览入口，交付记录应保存明确版本。
再问调用层：Arduino-ESP32的ledcWrite是core的包装，IDF的ledc_set_duty/ledc_update_duty是另一套API。去3.3.12的esp32-hal-ledc.h看前者首参为pin，去相同IDF版本的LEDC章节看后者的speed_mode/channel与更新步骤。不能把来自不同调用层的签名拼成一个程序。
- 做到这里，你应该看到
- 保存的链接与页面标题共同指向同一SDK版本、目标芯片和调用层。
参考：[1] ESP-IDF v5.5.5 / ESP32-S3 入门入口[2] ESP-IDF v5.5.5 / ESP32-S3 LEDC具体API章节[4] Arduino-ESP32 3.3.12 LEDC接口声明
从参数继续读到返回值、限制与失败处理
搜索函数名后，不要停在最像自己代码的第一行。记录包含文件、组件依赖、参数单位、返回值和适用目标；遇到返回bool或esp_err_t，示例里就应有失败分支。无法解释一项约束时回到具体章节，而不是把类型强制转换到能编译。
例如LEDC涉及频率、分辨率、通道与定时器资源，S3章节明确其模式条件；Arduino包装的自动通道分配也不等于无限资源。这里不列一个通用“所有ESP32都支持”的数字表：以你选中的芯片/版本章节和实现为准，记录仍未知的范围。
| 阅读栏 | 记录方式 |
|---|---|
| 环境 | SDK/core精确版本 + 目标 + 板修订 |
| 接口 | 固定tag文件路径 + 函数声明 + 参数单位 |
| 失败 | 返回值含义 + 本项目将如何停止/恢复 |
| 边界 | 目标限制、资源共享和未验证组合 |
| 证据 | 具体章节/commit、读取日期、构建或实板状态分开 |
参考：[2] ESP-IDF v5.5.5 / ESP32-S3 LEDC具体API章节[4] Arduino-ESP32 3.3.12 LEDC接口声明
任务三：找完整工程，再判断它是否匹配自己的目标
在v5.5.5的hello_world目录读取根CMake、main组件及README，确认它是工程而非孤立app_main片段。通过E01进入同一SDK环境，再选择esp32s3、构建、烧录、监视；哪一步通过，就只记录哪一步。下载了源码不代表编译完成，编译完成不代表看到新固件。
上游例程是接口起点，仍需核对默认引脚、Kconfig、组件manifest和依赖锁。含外设的例程尤其不能只改名字就接匿名模块。若你只是想读文档，本篇到完整工程映射即完成；要运行，则按E01或对应实战教程的具体器材与步骤执行，不把未做的烧录勾选通过。
参考：[1] ESP-IDF v5.5.5 / ESP32-S3 入门入口[5] ESP-IDF v5.5.5完整hello_world工程
用三条完成记录自检，找不到时回到上一层
现在应有三条不同记录：板级v1.1的RGB38及修订边界；Arduino3.3.12的LEDC pin式声明；IDF5.5.5/S3的完整hello_world工程与进入方式。每条写“据何资料得出什么、还没证明什么”，不要把官网首页链接当作全部依据。
遇到404先从该项目同版本目录或固定tag重新进入，保留原链接和失效时间；不要默默换latest后继续声称原版本。不同资料冲突时先检查目标、发布日期与修订，仍无法解决就把冲突具体列出并暂缓对应动作。串口/板载灯问题回板级与上传步骤，缺函数回框架声明，电平与地址回器件手册。
| 本次任务 | 实际定位 | 结论边界 |
|---|---|---|
| 板载RGB | 固定DevKitC-1 v1.1硬件/排针/修订段 | 38只对匹配板修订成立 |
| PWM首参 | Arduino3.3.12 esp32-hal-ledc.h | pin式包装，不混IDF channel式接口 |
| 第一个IDF工程 | v5.5.5 hello_world完整目录 + S3入门 | 找到工程，运行结果仍须另验收 |
参考：[1] ESP-IDF v5.5.5 / ESP32-S3 入门入口[3] DevKitC-1 v1.1固定资料：硬件修订与排针表[4] Arduino-ESP32 3.3.12 LEDC接口声明[5] ESP-IDF v5.5.5完整hello_world工程
资料来源与版本说明
本文是实际入口辨识与决策记录，不是固件运行实验；目录页只作入口，结论再落实到具体章节、声明和板级表。资料核对日期：。资料核对、程序构建与实板测试分别记录，不互相替代。
