# 烧录故障排除

[English]

## 连接失败

如果在运行给定命令时出现如“连接失败”这样的错误，造成该错误的原因之一可能是运行 `esptool` 时出现错误。 `esptool` 是构建系统调用的程序，用于重置芯片、与 ROM 引导加载器交互以及烧录固件的工具。可以按照以下步骤进行手动复位，轻松解决该问题。如果问题仍未解决，请参考 esptool 故障排除 获取更多信息。

`esptool` 通过使 USB 至 UART 桥（如 FTDI 或 CP210x）的 DTR 和 RTS 控制线生效来自动复位 ESP32（请参考 与 ESP32 创建串口连接 获取更多详细信息）。DTR 和 RTS 控制线又连接到 ESP32 的 `GPIO0` 和 `CHIP_PU` (EN) 管脚上，因此 DTR 和 RTS 的电压电平变化会使 ESP32 进入固件下载模式。相关示例可查看 ESP32 DevKitC 开发板的 原理图。

一般来说，使用官方的 ESP-IDF 开发板不会出现问题。但是， `esptool` 在以下情况下不能自动重置硬件：

- 硬件未连接到 `GPIO0` 和 `CIHP_PU` 的 DTR 和 RTS 控制线。

- DTR 和 RTS 控制线的配置方式不同。

- 不存在这样的串行控制线路。

根据硬件的种类，也可以将 ESP32 开发板手动设置为固件下载模式（复位）。

- 对于乐鑫开发板，可以参考对应开发板的入门指南或用户指南。例如，可以通过按住 `Boot` 按钮 (`GPIO0`) 再按住 `EN` 按钮 (`CHIP_PU`) 来手动复位 ESP-IDF 开发板。

- 对于其他类型的硬件，可以尝试将 `GPIO0` 拉低。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。