docs: simplify UART/JTAG port section with collapsible details

Keep the essential port-to-use-case table and REPL warning visible,
move protocol details and workflow commands into <details> collapse.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
crispyberry
2026-02-28 02:20:41 +08:00
parent bc773d11f4
commit 3d806541f7
3 changed files with 58 additions and 22 deletions

View File

@@ -208,14 +208,24 @@ mimi> restart # 重启
### USB (JTAG) 与 UART哪个口做什么
大多数 ESP32-S3 开发板有 **两个 USB-C 口**,务必区分清楚
大多数 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` |
| 端口 | 用途 |
|------|------|
| **USB**JTAG | `idf.py flash`、JTAG 调试 |
| **COM**UART | **REPL 命令行**、串口控制台 |
> **使用 REPL 命令行必须连接 UARTCOM口**,而不是 USBJTAG。ESP-IDF 控制台默认配置为 UART 输出(`CONFIG_ESP_CONSOLE_UART_DEFAULT=y`。USBJTAG口提供辅助串口输出但不能可靠地支持交互式 REPL 输入。
> **REPL 必须连接 UARTCOM** USBJTAG支持交互式 REPL 输入。
<details>
<summary>端口详情与推荐工作流</summary>
| 端口 | 标注 | 协议 |
|------|------|------|
| **USB** | USB / JTAG | 原生 USB Serial/JTAG |
| **COM** | UART / COM | 外置 UART 桥接芯片CP2102/CH340 |
ESP-IDF 控制台默认配置为 UART 输出(`CONFIG_ESP_CONSOLE_UART_DEFAULT=y`)。
**同时连接两个口时:**
@@ -235,6 +245,8 @@ idf.py -p /dev/cu.usbserial-110 monitor
# 或使用任意串口工具screen、minicom、PuTTY波特率 115200
```
</details>
## 记忆
MimiClaw 把所有数据存为纯文本文件,可以直接读取和编辑: