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

@@ -193,14 +193,24 @@ mimi> restart # 再起動
### USBJTAGvs UARTどのポートで何をするか
ほとんどの ESP32-S3 開発ボードには **2つの USB-C ポート**があります。用途を正しく理解することが重要です
ほとんどの ESP32-S3 開発ボードには **2つの USB-C ポート**があります:
| ポート | ラベル | プロトコル | 用途 |
|--------|--------|------------|------|
| **USB** | USB / JTAG | ネイティブ USB Serial/JTAG | `idf.py flash``idf.py monitor`JTAGデバッグ |
| **COM** | UART / COM | 外部 UART ブリッジCP2102/CH340 | **REPL CLI**、シリアルコンソール`idf.py monitor` |
| ポート | 用途 |
|--------|------|
| **USB**JTAG | `idf.py flash`、JTAGデバッグ |
| **COM**UART | **REPL CLI**、シリアルコンソール |
> **REPL CLIを使用するには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`)。
**両方のポートを同時に接続している場合:**
@@ -220,6 +230,8 @@ idf.py -p /dev/cu.usbserial-110 monitor
# または任意のシリアルターミナルscreen、minicom、PuTTYボーレート 115200
```
</details>
## メモリ
MimiClawはすべてのデータをプレーンテキストファイルとして保存します。直接読み取り・編集可能です