使用Platform.IO调试Seeed XIAO ESP32C3失败求助

问题描述 #

我尝试用Platform.IO调试Seeed XIAO ESP32C3开发板，但始终无法成功。按理论来说，使用支持数据传输的USB线和自带USB JTAG接口的该开发板应该能正常调试，目前却遇到了设备无法识别的问题。

我的platformio.ini配置如下：

[env:seeed_xiao_esp32c3]
platform = espressif32
board = seeed_xiao_esp32c3
framework = arduino
debug_tool = esp-builtin
debug_init_break = tbreak setup

VS Code调试配置：

{
    "type": "platformio-debug",
    "request": "launch",
    "name": "PIO Debug",
    "executable": "xxx/.pio/build/seeed_xiao_esp32c3/firmware.elf",
    "projectEnvName": "seeed_xiao_esp32c3",
    "toolchainBinDir": "xxx/.platformio/packages/toolchain-riscv32-esp/bin",
    "internalConsoleOptions": "openOnSessionStart",
    "preLaunchTask": {
        "type": "PlatformIO",
        "task": "Pre-Debug"
    }
}

启动调试时出现错误：

Warn : Transport "jtag" was already selected
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Error: libusb_open() failed with LIBUSB_ERROR_NOT_SUPPORTED
Error: libusb_open() failed with LIBUSB_ERROR_NOT_FOUND
Error: esp_usb_jtag: could not find or open device!

解决方案 #

1. 确认USB线与连接 #

• 必须使用带数据传输功能的USB线，仅充电线无法传输调试信号。可通过插拔后查看系统是否识别到新USB设备验证。
• 重新插拔USB线，确保接口连接牢固，避免接触不良。

2. 系统驱动与权限配置 #

• Windows：安装Espressif官方的USB JTAG驱动，打开设备管理器检查是否有带黄色感叹号的设备，若有则更新驱动至适配版本。
• Linux：添加USB权限规则，避免权限不足导致无法访问设备：
  1. 创建文件/etc/udev/rules.d/99-esp32.rules，写入内容：

     SUBSYSTEM=="usb", ATTR{idVendor}=="303a", ATTR{idProduct}=="1001", MODE="0666"
     

  2. 执行命令重载规则：

     sudo udevadm control --reload-rules && sudo udevadm trigger
     

• macOS：若系统提示无法识别设备，需在「系统设置-隐私与安全性」中允许对应的USB驱动访问权限。

3. 更新Platform.IO平台与配置 #

• 打开Platform.IO主页，找到espressif32平台并更新至最新版本，旧版本可能存在驱动兼容问题。
• 在platformio.ini中手动指定调试设备端口，根据系统不同填写实际路径：

  [env:seeed_xiao_esp32c3]
  platform = espressif32
  board = seeed_xiao_esp32c3
  framework = arduino
  debug_tool = esp-builtin
  debug_init_break = tbreak setup
  debug_port = /dev/ttyACM0  # Linux示例，Windows用COMx，macOS用/dev/cu.usbmodemXXXX
  

4. 硬件与软件重置 #

• 重启VS Code和开发板，清除可能的缓存或连接残留。
• 检查开发板硬件状态：确认JTAG相关引脚未被自定义代码占用，开发板无物理损坏。

内容的提问来源于stack exchange，提问作者Thom Kiesewetter