跳至内容
本页目录

首次连接、烧录与 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)。

按序上手

  1. 检查板卡——无可见损伤(指南明确写了这一步)。
  2. 经 USB 转 UART 口连接。
  3. 看 3.3 V 电源 LED——USB 供电接入时它应当点亮。若不亮,把它当供电链线索:先换线、换口再做其他。注意:纯充电线通常仍能点亮它(它给板供电)——那个陷阱出现在下一步"没有串口",而不是 LED 不亮。
  4. 装工具链——官方路径是 ESP-IDF Get Started 指南(Installation 章节);Arduino IDE 装 esp32 板包同样支持 ESP32-S3。
  5. 烧第一个示例(IDF 示例里的 blink / hello_world)。正常情况下工具会自动复位芯片进入下载模式。
  6. 若自动同步失败,手动进入下载模式:按住 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——排针、元件与按修订区分字段及固定来源