titor/mimiclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add USB port warning to prevent plugging into wrong port

Browse Source 
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:
crispyberry
2026-02-12 21:59:26 +08:00
parent e4d482cfcc
commit c9a4eae8f2
3 changed files with 18 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
README.md
View File

@@ -85,6 +85,15 @@ ls /dev/ttyACM* # Linux
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
Connect via serial to configure or debug. **Config commands** let you change settings without recompiling — just plug in a USB cable anywhere.