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

@@ -191,6 +191,35 @@ mimi> cron_start # cronスケジューラを今すぐ開始
mimi> restart # 再起動
```
### USBJTAGvs UARTどのポートで何をするか
ほとんどの 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` |
> **REPL CLIを使用するには、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はすべてのデータをプレーンテキストファイルとして保存します。直接読み取り・編集可能です