ツールのコマンドライン¶

SDK に同梱されているホストツールのコマンド構文、オプション、使用例です。例は IPRO7AI Reef EVK V4.0 を対象にしています。書き込みとコンソールの手順は 書き込みとシリアルコンソール を参照してください。

ツール一覧¶

本リリースには、JTAG / GDB によるオンターゲットデバッグの設定や手順はありません。デバッグはシリアルコンソール、ログ、オフラインの addr2line で行います。デバッグとトラブルシューティング を参照してください。

環境変数¶

build_freertos.sh¶

./build_freertos.sh [actions...] [options] <project>

アクションは連結でき、指定した順に実行されます。失敗した時点で停止します。アクションを指定しない場合は build を実行します。macOS と Linux 用の bash スクリプトです。

コンソールのボーレートは、使用する設定ファイルの CONFIG_PLATFORM_UART_BAUDRATE です。未設定の場合は 115200 です。

<project> にはアプリケーション名（ipro7ai_reef_demo）または apps/ 以下のパス（platform/ipro7ai_reef_demo）を指定します。名前があいまいな場合や不明な場合は候補を表示します。-l の説明列は .config の最初のコメント行から取られ、アプリケーションによっては空欄です。

Reef でビルド、書き込み、コンソール表示を一度に行います（最初の書き込み前はボードに SDK ファームウェアがなく reboot_dl に応答しないため、手動で ダウンロードモードに入って ください）。

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

次の順に表示されます。

→ Entering download mode...
→ Flashing ipro7ai_reef_demo_IPRO7.bin (--chip-variant IPRO7AI, --pt <IntelProCube>/chips/ipro7/partition/partition_cfg_2M.toml)...
...
✓ Flash succeeded (…)
→ Opening serial monitor on /dev/cu.usbserial-XXXX at 115200...

-d で Reef 用の別の設定を選べます。例：

./build_freertos.sh -d defconfig_reef build ipro_ble_remote          # build_reef/build_out/ に出力
./build_freertos.sh -d defconfig_reef_ov5640 build flash ipro7_uvc_cam
./build_freertos.sh -l                                              # 40 個のプロジェクトを一覧表示
./build_freertos.sh size ipro7ai_reef_demo

出力先は <app>/build/build_out/（-d 指定時は build_<name>/build_out/）で、<app>_<chip>.bin、.elf、.map が生成されます。チップ名は CONFIG_CHIP から決まります（IPRO7 アプリケーションは _IPRO7、IPRO6S アプリケーションは _IPRO6）。

make ターゲット¶

各アプリケーションの Makefile は SDK ルートの project.build を呼び出します（Unix Makefiles ジェネレーターで CMake を実行し、続けて make -j4）。

• CMake：まず PATH 上の cmake、次に tools/cmake/（Linux x86-64）を使います。どちらもない場合、ビルドは No cmake found で停止します。
• ビルドのたびに、エディター用に compile_commands.json が SDK ルートにコピーされます。
• make menuconfig には tools/kconfig/menuconfig.py が必要ですが、同梱されていません。一部の Makefile の defconfig と list-defconfigs ターゲットが参照する configs/ ディレクトリも同梱されていません。.config を直接編集するか、コピーを defconfig_<name> として保存し、DEFCONFIG= でビルドしてください。

IntelProCube 書き込みツール¶

書き込みには IntelProCube のコマンドラインツールを使います。このツールは V2.2.1 には含まれていません。GitHub から 0.7.0.1 をダウンロードし、開発環境の準備に従ってインストールしてください。ツールはチップファイルを自身の chips/ ディレクトリから読み込むため、IntelProCube のディレクトリで実行してください。この表は SDK 内の README とスクリプトからまとめたものです。全オプションについてはツール自体が正となります。

Reef の出荷時ファームウェアを書き込みます（先に ダウンロードモードに入って ください）。

cd <IntelProCube>
./ipro_iot_tool_macos --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/cu.usbserial-XXXX --baudrate 921600 \
    --pt chips/ipro7/partition/partition_cfg_2M.toml \
    --firmware <SDK>/apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.bin

成功すると最後に [All Success] が表示されます。ツールは失敗しても終了コード 0 を返すため、この行で判断してください。Linux では ./ipro_iot_tool_linux、Windows では ipro_iot_tool.exe と COM5 などのポートを使います。Reef の各アプリケーションに必要なパーティションテーブル、--boot2、--mfg は IPRO7AI Reef EVK に記載しています。

serial_monitor.py¶

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

Python 標準ライブラリの termios でポートを開くため、pyserial は不要です。macOS と Linux で動作し、Windows では動作しません。出力を読み取るだけで（最初に 1 つのコマンドを送信することは可能）、対話型ターミナルではありません。コマンドを 1 行ずつ入力するには、screen、minicom などのシリアルターミナルソフトウェアを使ってください。

# Reef コンソール（115200）：セルフテストを実行し、10 秒後に終了
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --send "reef selftest" --timeout 10

# ipro7_jpeg_decode の Reef 用設定（921600）：Ctrl-C まで監視し、ログを保存
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --baud 921600 --timeout 0 --log console.log

# 実行中のファームウェアをダウンロードモードで再起動（"reboot to download mode" と表示される）
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --send reboot_dl --timeout 2

macOS では /dev/cu.* を使ってください。/dev/tty.* はキャリア検出を待つため止まってしまいます。書き込みの前にモニターを終了し、ポートを解放してください。

create_ota.py¶

IntelProCube が生成する結合イメージを boot2 OTA パッケージにまとめます。デフォルトでは XZ 圧縮して <input name>.xz.ota として書き出し、--raw を付けると非圧縮の <input name>.ota になります。入力は IPNP で始まるブートヘッダーを持つ結合イメージ（ツールの chips/ipro7/img_create_iot/whole_img.bin）でなければならず、SDK ビルドの .bin は使えません。それ以外の形式ではスクリプトが停止します。

python3 tools/create_ota.py <whole_img.bin> [--raw] [-o OUTPUT] [--hw-ver STR] [--fw-ver STR]

Reef では、ipro_ble_remote の make_reef_ota.sh がツールの --build とこのスクリプトを自動で実行します。Reef アプリケーション用のホストツール を参照してください。OTA の全体の流れは OTA アップデート にあります。

Reef アプリケーション用のホストツール¶

ブラウザー版の画像 Teach：tools/teach_web¶

IPRO AI Studio をインストールせずに、Chrome または Edge で Reef のカメラから画像を収集し、分類器を学習して USB 経由でデプロイします。ボードは ipro_reef_teach を image モードで実行している必要があります。ホストには Python 3.8 以降が必要です。

ipro_reef_teach の mfg 内容：mfg_payload.py¶

ipro_reef_teach の初回書き込みでは、起動モードと声紋モデルを --mfg で書き込みます。

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

--mode は image、voice、sensor のいずれかです。生成された reef_teach_mfg.bin を IntelProCube に --mfg で渡します。書き込みコマンドは サンプルページ にあります。ファームウェアだけを更新する場合は --mfg を省略してください。

ipro_ble_remote の Reef OTA ツール¶

どちらの Python スクリプトにも bleak が必要です：python3 -m venv .venv && .venv/bin/pip install bleak。OTA は boot2 と partition_cfg_2M_remote_ab.toml で書き込んだボードでのみ動作します。標準の partition_cfg_2M.toml で書き込んだ Reef では、絶対に OTA を実行しないでください。

その他の Reef アプリケーションのツール¶

Zephyr スクリプト¶

tools/zephyr/（bootstrap.sh、build.sh、flash.sh、monitor.sh、ci_build.sh）は Zephyr ボード ipro7_evb と ipro7ai_evk 用です。本リリースには Reef 用の Zephyr ボードはありません。使い方は Zephyr RTOS を参照してください。

サイズとメモリの解析¶

./build_freertos.sh size ipro7ai_reef_demo
/opt/toolchain/riscv_ipro7/bin/riscv64-unknown-elf-nm --size-sort -S \
    apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.elf | tail -20

CONFIG_AI_SUPPORT と CONFIG_MM_SUPPORT の両方を有効にすると、リンカースクリプトは OCRAM 領域を 64 KB（CONFIG_EM_SIZE が 0）または 48 KB（CONFIG_EM_SIZE が 0 より大きい）に縮小し、CMake は構成時に AI+MM …: OCRAM=… を表示します。メモリマップは IPRO7 に、OCRAM の配分は ビルドシステムと設定 にあります。

自動テスト¶

./build_freertos.sh test ipro_unit_test はビルドと書き込みを行い、ALL TESTS PASSED または SOME TESTS FAILED を待ちます。ipro_unit_test には IPRO7 EVB が必要です。Reef のオンボードセルフテストは出荷時ファームウェアの reef selftest です。デバッグとトラブルシューティング を参照してください。

その他のツール¶

開発の流れ¶

Reef での編集、ビルド、書き込み、コンソールの繰り返しは ビルドと書き込みの流れ にあります。独自のアプリケーションを始めるには 最初の独自アプリケーションを作る を参照してください。デバッグとよくあるエラーは デバッグとトラブルシューティング にあります。