docs: add USB port warning to prevent plugging into wrong port
Many ESP32-S3 boards have two USB-C ports (USB and COM). Added a callout with a reference photo reminding users to use the USB (Serial/JTAG) port instead of the COM (UART bridge) port. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -85,6 +85,15 @@ ls /dev/ttyACM* # Linux
|
|||||||
idf.py -p PORT flash monitor
|
idf.py -p PORT flash monitor
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> **Important: Plug into the correct USB port!** Most ESP32-S3 boards have two USB-C ports. You must use the one labeled **USB** (native USB Serial/JTAG), **not** the one labeled **COM** (external UART bridge). Plugging into the wrong port will cause flash/monitor failures.
|
||||||
|
>
|
||||||
|
> <details>
|
||||||
|
> <summary>Show reference photo</summary>
|
||||||
|
>
|
||||||
|
> <img src="assets/esp32s3-usb-port.jpg" alt="Plug into the USB port, not COM" width="480" />
|
||||||
|
>
|
||||||
|
> </details>
|
||||||
|
|
||||||
### CLI Commands
|
### CLI Commands
|
||||||
|
|
||||||
Connect via serial to configure or debug. **Config commands** let you change settings without recompiling — just plug in a USB cable anywhere.
|
Connect via serial to configure or debug. **Config commands** let you change settings without recompiling — just plug in a USB cable anywhere.
|
||||||
|
|||||||
@@ -85,6 +85,15 @@ ls /dev/ttyACM* # Linux
|
|||||||
idf.py -p PORT flash monitor
|
idf.py -p PORT flash monitor
|
||||||
```
|
```
|
||||||
|
|
||||||
|
> **注意:请插对 USB 口!** 大多数 ESP32-S3 开发板有两个 Type-C 接口,必须插标有 **USB** 的那个口(原生 USB Serial/JTAG),**不要**插标有 **COM** 的口(外部 UART 桥接)。插错口会导致烧录/监控失败。
|
||||||
|
>
|
||||||
|
> <details>
|
||||||
|
> <summary>查看参考图片</summary>
|
||||||
|
>
|
||||||
|
> <img src="assets/esp32s3-usb-port.jpg" alt="请插 USB 口,不要插 COM 口" width="480" />
|
||||||
|
>
|
||||||
|
> </details>
|
||||||
|
|
||||||
### 代理配置(国内用户)
|
### 代理配置(国内用户)
|
||||||
|
|
||||||
在国内需要代理才能访问 Telegram 和 Anthropic API。MimiClaw 内置 HTTP CONNECT 隧道支持。
|
在国内需要代理才能访问 Telegram 和 Anthropic API。MimiClaw 内置 HTTP CONNECT 隧道支持。
|
||||||
|
|||||||
BIN
assets/esp32s3-usb-port.jpg
Normal file
BIN
assets/esp32s3-usb-port.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 72 KiB |
Reference in New Issue
Block a user