首次连接、烧录与 LED 排障
适用范围： ESP32-S3-DevKitC-1 官方板卡，两个 USB 口。
问题
“板子开箱了。用哪个 USB 口？第一次 blink 之前可能败在哪？为什么烧录完什么灯都不亮？”
两个 USB 口——都能用，但要按需选
板上有两个 USB 连接器，它们背后接的东西不可互换：
| 端口 | 连接器 | 它是什么 | 用途 |
|---|---|---|---|
| USB 转 UART 口 | Micro-USB | 板载 USB 转 UART 桥芯片，最高 3 Mbps | 供电、经串口烧录、串口通信。默认选择——官方指南后续步骤都用它 |
| USB 口 | — | ESP32-S3 原生全速 USB OTG（USB 1.1） | 供电、烧录、USB 通信，以及 JTAG 调试 |
实用规则：从 USB 转 UART 口开始；需要原生 USB 功能（绕过桥芯片的 USB CDC 串口，或 JTAG 调试）时再换原生 USB 口。
线缆陷阱。 官方指南警告：有些 USB 线是纯充电线、没有数据线芯——能给板供电，随后烧录悄无声息地失败。请用确知能传数据的线（指南对 UART 口给出的规格是 USB 2.0 Standard-A 转 Micro-B）。
按序上手
- 检查板卡——无可见损伤（指南明确写了这一步）。
- 经 USB 转 UART 口连接。
- 看 3.3 V 电源 LED——USB 供电接入时它应当点亮。若不亮，把它当供电链线索：先换线、换口再做其他。注意：纯充电线通常仍能点亮它（它给板供电）——那个陷阱出现在下一步"没有串口"，而不是 LED 不亮。
- 装工具链——官方路径是 ESP-IDF Get Started 指南（Installation 章节）；Arduino IDE 装 esp32 板包同样支持 ESP32-S3。
- 烧第一个示例（IDF 示例里的 blink / hello_world）。正常情况下工具会自动复位芯片进入下载模式。
- 若自动同步失败，手动进入下载模式：按住 Boot，按下并松开 Reset，再松开 Boot——板卡即进入固件下载模式，可串口烧录。
LED 排障
第一次烧录成功后，经典故障是"烧录 OK、灯不亮"。按这个顺序排查：
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 3.3 V 电源 LED 从不亮 | 坏端口、坏线或供电不足——纯充电线通常能供电点亮 LED，所以 LED 不亮指向供电链，不指向充电线陷阱 | 换线换口；核实供电 |
| 电脑上不出现串口 | 还是纯充电线，或桥芯片缺驱动 | 数据线；驱动按 ESP-IDF Get Started |
| 烧录报 “Failed to connect” | 芯片不在下载模式，自动同步失败 | 手动下载模式：按住 Boot、点按 Reset、松开 Boot |
| 烧录 OK 但板载 RGB LED 不亮 | 你的修订用错了 GPIO——v1.0 在 GPIO48，v1.1 在 GPIO38 | 见板载 LED 为什么在 GPIO38 或 GPIO48 |
对 LED 引脚 digitalWrite“成功"但没有颜色 | 该 LED 是可寻址的（单线协议），不是普通 LED | 用 neopixelWrite() / led_strip 驱动——同上篇指南 |
| 板上随机崩溃，J3-11/12/13 接了东西 | Octal 存储板的 GPIO35–37 是内部存储线 | 见GPIO35、GPIO36、GPIO37 能用吗？ |
USB 之外的供电
为完整起见——本板支持三条互斥供电路径：任一 USB 口（推荐默认）、排针 5V 与 G，或排针 3V3 与 G。不要同时使用。
本页不能告诉你的
- 操作系统相关的驱动安装（桥芯片驱动、端口权限）维护在 ESP-IDF Get Started 指南里，不在板卡文档中——按第 4 步的链接走，别信可能滞后的转载。
- 你手里是哪个 PCB 修订——定 LED 引脚时需要；官方识别路径见我手上的是哪个 ESP32-S3-DevKitC-1？。
来源
- ESP32-S3-DevKitC-1 v1.1 用户指南——Start Application Development（所需硬件、线缆注记、硬件设置）、Description of Components（两个 USB 口、Boot/Reset 按键、电源 LED、RGB LED）、Power Supply Options（commit
5c06bf18） - ESP-IDF Get Started——板卡指南指向的官方工具链路径
- MCUID 数据记录：ESP32-S3-DevKitC-1——排针、元件与按修订区分字段及固定来源