書き込みとシリアルコンソール¶

FreeRTOS アプリケーションは IntelProCube のコマンドラインツールで UART0 経由で書き込み、コンソールも同じ UART で動作します。IPRO7AI Reef EVK では、どちらもデバッグコネクター U6 を経由します。このページでは、Reef に書き込むすべての方法、各アプリケーションに必要なパーティションテーブルと追加のイメージ、コンソールの開き方、シリアルポートの見分け方を説明します。初めて実行する場合は、最初の FreeRTOS アプリケーション に従ってください。

前提条件¶

• IntelProCube 0.7.0.1：ipro_iot_tool_macos、ipro_iot_tool_linux、または ipro_iot_tool.exe。開発環境の準備 を参照してください。
• ビルド済みのイメージ：apps/<category>/<app>/build/build_out/<app>_IPRO7.bin。DEFCONFIG=defconfig_<name> でビルドした場合は build_<name>/build_out/ にあります。
• U6 に接続したコンソールケーブル。スイッチの設定とボードの接続 を参照してください。ポートは /dev/cu.usbserial-XXXX（macOS）、/dev/ttyUSB0（Linux）、COM5（Windows）と表記します。

書き込みツール¶

コマンドラインツールは IntelProCube のディレクトリで実行してください。チップ設定を chips/ から読み込み、--pt chips/... などの相対パスもそこを基準に解決されます。Reef で使うオプションは次のとおりです：

--help ですべてのオプションが表示されます。

ダウンロードモードに入る¶

書き込みの前に、IPRO7AI をブート ROM のダウンロードモードにする必要があります。その後、次にリセットするまでコンソールには何も表示されません。

Debug Probe でダウンロードモードに入る手順（macOS の例、SDK ルートで実行）：

書き込み手順¶

パーティションテーブル¶

パーティションテーブルは、ファームウェア、mfg データ（AI モデル）、その他のデータを Flash 上に配置します。IntelProCube には、<IntelProCube>/chips/ipro7/partition/ に partition_cfg_2M.toml などの汎用テーブルが付属しています。特別なレイアウトが必要なアプリケーションは、アプリケーションディレクトリに独自の .toml を持っています。

ipro7ai_reef_demo はデフォルトで 1 MB の Flash レイアウトでリンクされ、どちらのパッケージ内 Flash 部品にも収まります。起動ログに JEDEC 0xEF4015（2 MB）と表示された場合は、.config に CONFIG_IPRO7_FLASH_2M=y を追加すると、リンカーが Flash 全体を使えるようになります。

ipro_ble_remote の初回書き込み（boot2 と A/B テーブル）¶

ipro_ble_remote の Reef 用設定は BLE OTA に対応しており、boot2 と A、B の 2 つのファームウェアスロットが必要です。最初に有線で書き込むときは、boot2 とアプリケーション独自のテーブルを一緒に書き込みます：

ipro_reef_teach（mfg データ）¶

Edge AI ファームウェア ipro_reef_teach は独自のパーティションテーブルを使い、その mfg パーティションにモード設定と声紋モデルが格納されます。初回の書き込みでは mfg データも書き込みます：

make -C apps/ai/ipro_reef_teach
python3 apps/ai/ipro_reef_teach/mfg_payload.py \
    --voice apps/ai/ipro_reef_teach/model/model_b.spkb --mode image -o reef_teach_mfg.bin
cd <IntelProCube>
./ipro_iot_tool_macos --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/cu.usbserial-XXXX --baudrate 921600 --skip-ota \
    --pt <SDK>/apps/ai/ipro_reef_teach/partition_reef_teach.toml \
    --firmware <SDK>/apps/ai/ipro_reef_teach/build/build_out/ipro_reef_teach_IPRO7.bin \
    --mfg <SDK>/reef_teach_mfg.bin

リセット後、コンソール（115200）に RTCH: mode: image … と表示され、USB-C に USB カメラとシリアルポート（3896:0705）が現れます。ファームウェアだけを更新する場合は --mfg を省きます。モードとモデルはそのまま残ります。モードの切り替えと IPRO AI Studio の使い方：IPRO AI Teach。

build_freertos.sh での書き込み¶

macOS と Linux では、build_freertos.sh の flash アクションは次の順序で動作します：

1. build/ から、-d defconfig_<name> を指定した場合は build_<name>/ からイメージを探します。見つからない場合は Run 'build' first. と表示して停止します。
2. ツールを探します：IPRO_FLASH_TOOL、未設定の場合は PATH 上の ipro_iot_tool_macos / ipro_iot_tool_linux。
3. ポートを探します：-p、指定がなければ IPRO_SERIAL_PORT、それもなければ接続されている唯一の /dev/cu.usbmodem*、/dev/cu.usbserial*、/dev/ttyACM*、/dev/ttyUSB*。
4. アプリケーションのコンソールのボーレート（CONFIG_PLATFORM_UART_BAUDRATE、未設定の場合は 115200）で reboot_dl を送信し、2 秒待ちます。
5. <tool> --chipname ipro7 --chip-variant <variant> --port <port> --firmware <bin> --baudrate 921600 [--pt <table>] を実行します。バリアント：-c、指定がなければ IPRO_CHIP_VARIANT、それもなければ設定から決定（Reef の設定では IPRO7AI）。テーブル：-P、指定がなければ IPRO_FLASH_PT、それもなければ --pt なし。
6. 出力に [All Success] が含まれていれば ✓ Flash succeeded、含まれていなければ ✗ Flash failed を表示します。

export IPRO_FLASH_TOOL=<IntelProCube>/ipro_iot_tool_macos
./build_freertos.sh -p /dev/cu.usbserial-XXXX \
    -P <IntelProCube>/chips/ipro7/partition/partition_cfg_2M.toml \
    build flash monitor ipro7ai_reef_demo

-P には .toml のフルパスを指定してください。スクリプトはツールを IntelProCube のディレクトリではなく、カレントディレクトリで実行します。

シリアルコンソール¶

コンソールは UART0（GPIO20 TX / GPIO21 RX、U6 のピン 3 / 4）、8N1、フロー制御なしです。ボーレートはアプリケーションの設定の CONFIG_PLATFORM_UART_BAUDRATE で決まり、未設定の場合は 115200 です：

設定ファイルを確認するには、次を実行します（何も表示されなければ未設定、つまり 115200 です）：

grep CONFIG_PLATFORM_UART_BAUDRATE apps/multimedia/ipro7_jpeg_decode/defconfig_reef

対話型ターミナル¶

シェルコマンドを入力するには、対話型のターミナルプログラムを使います：

screen /dev/cu.usbserial-XXXX 115200

picocom -b 115200 /dev/ttyUSB0

書き込みの前にターミナルプログラムを閉じてください。開いたままだと、ツールがポートを開けません。

tools/serial_monitor.py¶

スクリプトや自動化に使う、SDK の非対話型コンソールツールです（macOS／Linux。Python 標準ライブラリの termios のみを使い、pyserial は不要）。ポートを開き、必要に応じて 1 行を送信してから、タイムアウトするかパターンに一致するまで読み取ります。

python3 tools/serial_monitor.py <port> [--baud 115200] [--timeout 30] [--send CMD] [--wait-for REGEX] [--log FILE]

# コマンドを送信して 10 秒間読み取る
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --send "reef selftest" --timeout 10

# 再起動してシェルの準備完了を待ち、ログを保存する
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --send reboot --wait-for "shell ready" --timeout 15 --log boot.log

macOS のシリアルポート¶

macOS では、シリアルポートごとに /dev/cu.* と /dev/tty.* の 2 つの名前があります。常に /dev/cu.* を使ってください。/dev/tty.* はキャリア検出を待つため、何も出力されないままハングします。

ポートの見分け方¶

IPRO Debug Probe は、USB 上では IPRO7 CMSIS_DAP として認識されます。Linux と Windows で 2 つのポートを見分けるには、それぞれを 115200 で開いて SW2 を押します。起動メッセージが表示される方がコンソールです。

Reef の USB-C はコンソールではありません。一部のアプリケーションでは、ボードが USB-C 上で INTELPRO の VID 0x3896 を持つ USB デバイスとして認識されます：

ホストで USB デバイスを一覧表示するには、macOS では system_profiler SPUSBDataType、Linux では lsusb（例：ID 3896:0705）を使います。Windows では、デバイス マネージャーでデバイスのプロパティ → 詳細 → ハードウェア ID を開きます（例：USB\VID_3896&PID_0705）。

動作確認¶

• 書き込み出力の最後の行が [All Success] になっています。
• SW2 を押すと、アプリケーションのボーレートでコンソールに起動メッセージが表示されます。シェルのあるアプリケーションでは、Enter を押すと ipro /> が表示され、help でコマンドの一覧が表示されます。
• USB を使うアプリケーションは、上の表の VID:PID でホストに認識されます。

トラブルシューティング¶

次のステップ¶

• ビルドと書き込みの流れ：日常的な編集、ビルド、書き込み、モニターのサイクル。
• macOS／Linux のコマンドライン：build_freertos.sh のすべてのアクションとオプション。
• デバッグとトラブルシューティング