docs: add USB(JTAG) vs UART port guide for REPL usage

Add a detailed section to all three READMEs (EN, CN, JA) explaining
the difference between the USB (JTAG) and UART (COM) ports on
ESP32-S3 boards. Clarifies that the REPL CLI requires the UART port
and documents behavior when both ports are connected simultaneously.

Signed-off-by: Asklv <boironic@gmail.com>
This commit is contained in:
Asklv
2026-02-27 16:00:00 +08:00
parent 70cd1a0eb7
commit c46f78d88e
3 changed files with 87 additions and 0 deletions

View File

@@ -206,6 +206,35 @@ mimi> cron_start # 立即启动 cron 调度器
mimi> restart # 重启
```
### USB (JTAG) 与 UART哪个口做什么
大多数 ESP32-S3 开发板有 **两个 USB-C 口**,务必区分清楚:
| 端口 | 标注 | 协议 | 用途 |
|------|------|------|------|
| **USB** | USB / JTAG | 原生 USB Serial/JTAG | `idf.py flash``idf.py monitor`、JTAG 调试 |
| **COM** | UART / COM | 外置 UART 桥接芯片CP2102/CH340 | **REPL 命令行**、串口控制台、`idf.py monitor` |
> **使用 REPL 命令行必须连接 UARTCOM口**,而不是 USBJTAG口。ESP-IDF 控制台默认配置为 UART 输出(`CONFIG_ESP_CONSOLE_UART_DEFAULT=y`。USBJTAG口提供辅助串口输出但不能可靠地支持交互式 REPL 输入。
**同时连接两个口时:**
- USBJTAG口负责烧录/下载,并提供辅助串口输出
- UARTCOM口提供主要的交互式控制台用于 REPL
- macOS 下两个口都会显示为 `/dev/cu.usbmodem*``/dev/cu.usbserial-*`,用 `ls /dev/cu.usb*` 区分
- Linux 下 USBJTAG通常是 `/dev/ttyACM0`UART 通常是 `/dev/ttyUSB0`
**推荐工作流:**
```bash
# 通过 USBJTAG口烧录
idf.py -p /dev/cu.usbmodem11401 flash
# 通过 UARTCOM口打开 REPL
idf.py -p /dev/cu.usbserial-110 monitor
# 或使用任意串口工具screen、minicom、PuTTY波特率 115200
```
## 记忆
MimiClaw 把所有数据存为纯文本文件,可以直接读取和编辑: