macOS／Linux のコマンドライン¶

macOS と Linux では、FreeRTOS アプリケーションを make -C でビルドするか、ビルド、書き込み、モニターを 1 行でつなげて実行できる build_freertos.sh でビルドします。このページは両方のリファレンスです。ビルドディレクトリと出力、別構成、クリーン、build_freertos.sh のアクション、オプション、環境変数、制限事項を、IPRO7AI Reef EVK の例とともに説明します。ツールのインストールは 開発環境の準備 にあります。

前提条件¶

• 開発環境の準備 が完了していること：ツールチェーン、CMake、make、Python、IntelProCube。
• 以下のコマンドはすべて SDK ルートで実行します。
• 書き込みを行う場合は、スイッチの設定とボードの接続 のとおりにボードを接続しておきます。

ディレクトリ構成¶

コンポーネントについては システムアーキテクチャ で説明しています。

make でビルドする¶

make -C apps/<category>/<app>                            # .config を build/ にビルド
make -C apps/<category>/<app> DEFCONFIG=defconfig_<name>  # 別構成を build_<name>/ にビルド

• ビルドディレクトリ： DEFCONFIG= を指定すると、build_ の後ろにファイル名から defconfig_ プレフィックスを除いたものを付けた名前になります。例：defconfig_reef → build_reef/、defconfig_wifi_ipro6s → build_wifi_ipro6s/。代替ファイルは build_<name>/.config にコピーされ、アプリケーション自身の .config は変更されません。編集するのはコピーではなく、アプリケーションディレクトリにある元のファイルです。
• 出力： <build dir>/build_out/<app>_IPRO7.bin（書き込み用）、.elf（デバッグシンボル付き）、.map（メモリマップ）。<build dir>/include/generated/autoconf.h には、設定から生成されたマクロが入ります。また、ビルドのたびに、エディターのインデックス作成用として compile_commands.json が SDK ルートにコピーされます。
• ツールチェーン： make -C … CROSS_COMPILE=<dir>/bin/riscv64-unknown-elf- または同名の環境変数で、.config の CONFIG_CROSS_COMPILE を上書きします。
• 並列ビルド： 内側の CMake ビルドは常に -j4 で実行されます。
• BOARD=： ipro_agora_sentino（デフォルトは reef）と ipro_pdm_mic_demo だけが使います。その他のアプリケーションは DEFCONFIG= でボードを選びます。

ipro7ai_reef_demo をビルドすると次のように表示されます（抜粋）：

[INFO] Build Path: <SDK>/apps/platform/ipro7ai_reef_demo/build
CPU: intelpro_ipro7
...
-- [toolchain] Vendor toolchain detected - enabling xxldsp and mtune=intelpro-ipro7
-- Generated autoconf header: <SDK>/apps/platform/ipro7ai_reef_demo/build/include/generated/autoconf.h
...
-- [board] IPRO7AI Reef: CONFIG_IPRO7_XTAL_CAPCODE=95 (board default)
-- IPRO7 flash: 1M (default, on-chip)
-- AI disabled: OCRAM=256KB
...
Memory region         Used Size  Region Size  %age Used
           flash:      249944 B         1 MB     23.84%
           psram:       45376 B         8 MB      0.54%
           ocram:       32144 B       256 KB     12.26%
          hbnram:        2460 B         4 KB     60.06%
Generate <SDK>/apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.bin
[100%] Built target ipro7ai_reef_demo_IPRO7.elf

[board] IPRO7AI Reef の行は、ビルドが Reef 向けであることを示します。この行がない場合、その設定は別のボード向けです。

Reef 用のビルド設定¶

以下の設定は Reef 向けです。表に DEFCONFIG= があるアプリケーションでは、単に make を実行すると、別のボード向けであるアプリケーションの .config がビルドされます。

各アプリケーションの書き込みに使うパーティションテーブルと、boot2 や mfg データが必要なアプリケーション：書き込みとシリアルコンソール：パーティションテーブル。

クリーン¶

make -C apps/platform/ipro7ai_reef_demo clean                                   # build/ を削除
make -C apps/platform/ipro7ai_reef_demo DEFCONFIG=defconfig_wifi_ipro6s clean   # build_wifi_ipro6s/ を削除

clean は対応するビルドディレクトリだけを削除します。.config や別構成を変更したら、クリーンしてからビルドしてください。

build_freertos.sh¶

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

アクションはつなげて指定でき、順に実行されます。最初に失敗した時点で残りは実行されず、複数のアクションを指定した場合は最後に各結果のサマリーが表示されます。アクションを指定しない場合は build が実行されます。プロジェクトは名前（ipro7ai_reef_demo）または apps/ 以下のパス（platform/ipro7ai_reef_demo）で指定します。

アクション¶

オプション¶

環境変数¶

プロジェクトの一覧¶

./build_freertos.sh -l

apps/ 以下のプロジェクトをカテゴリ別に一覧表示し、各 .config の 1 行目を説明として表示します（抜粋）：

ai
  ipro7ai_evk_person_detect           IPRO7AI EVK person detection: SC101IOT camera -> ISP -> NPU (YOLOv8) with
  ipro7ai_evk_rps                     IPRO7AI EVK rock-paper-scissors: SC101IOT camera -> ISP -> NPU classifier,
  ipro_reef_teach
  ipro_speaker_recog

bluetooth/ble
  ipro_ble_hid_keyboard
  ipro_ble_remote
  ipro_ble_transparent
  ipro_throughput_test
...
platform
  ...
  ipro7ai_reef_demo                   IPRO7AI Reef carrier board demo.

一覧にはすべてのボードのアプリケーションが含まれます。Reef 用の設定は 上の表 にあるものです。

Reef の例¶

最初に一度だけ環境を設定します（macOS の例）：

export IPRO_FLASH_TOOL=<IntelProCube>/ipro_iot_tool_macos
export IPRO_SERIAL_PORT=/dev/cu.usbserial-XXXX
PT2M=<IntelProCube>/chips/ipro7/partition/partition_cfg_2M.toml

# 出荷時ファームウェア：ビルド、書き込み、起動メッセージを 30 秒間表示
./build_freertos.sh -P $PT2M build flash monitor ipro7ai_reef_demo

# Wi-Fi 版をクリーンしてから再ビルド
./build_freertos.sh -d defconfig_wifi_ipro6s clean build ipro7ai_reef_demo

# USB ウェブカメラ：ビルドして書き込み
./build_freertos.sh -d defconfig_reef_ov5640 -P $PT2M build flash ipro7_uvc_cam

# 921600 baud のアプリケーション：monitor は設定のボーレートを使用
./build_freertos.sh -d defconfig_reef build flash monitor ipro7_jpeg_decode

# ビルドのみ（初回の書き込みには boot2 が必要なので、ツールを直接実行する）
./build_freertos.sh -d defconfig_reef build size ipro_ble_remote

build が成功すると次のように表示されます：

Project: ipro_ble_remote  (bluetooth/ble/ipro_ble_remote)
Defconfig: defconfig_reef

→ Building ipro_ble_remote...
✓ Build succeeded (19s)
  Binary: <SDK>/apps/bluetooth/ble/ipro_ble_remote/build_reef/build_out/ipro_ble_remote_IPRO7.bin (561 KB)
  Log: <SDK>/apps/bluetooth/ble/ipro_ble_remote/build_reef/build.log

制限事項¶

• IPRO7 のみ： flash は常に --chipname ipro7 を渡すため、IPRO6S のイメージは書き込めません。
• --boot2、--mfg、--skip-ota は使えません： ipro_ble_remote の初回書き込みと ipro_reef_teach の mfg データは、IntelProCube を直接実行して書き込みます。書き込みとシリアルコンソール を参照してください。
• ツールはカレントディレクトリで実行されます： -P には .toml のフルパスを指定してください。
• reboot_dl にはシェルが必要です： シェルのないファームウェアやハングしたファームウェアの場合は、先にボタンでダウンロードモードに入ります。
• monitor は対話型のターミナルではありません： コマンドを入力するにはターミナルプログラムを使います。対話型ターミナル を参照してください。タイムアウト（終了コード 2）や PASSED を含まない一致（終了コード 1）は失敗とみなされ、後続のアクションが実行されなくなるため、monitor は最後に指定してください。
• size はデフォルトのツールチェーンパスを使います： 常に /opt/toolchain/riscv_ipro7/bin/riscv64-unknown-elf-size を呼び出します。
• BOARD= オプションはありません： 別構成は -d で選びます。
• macOS と Linux のみ： スクリプトには bash が必要で、ポートの自動検出は /dev/* の名前にしか対応していません。

動作確認¶

./build_freertos.sh -l                      # プロジェクトを一覧表示
./build_freertos.sh ipro7ai_reef_demo       # ✓ Build succeeded と Binary: のパスを表示
ls apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.bin

macOS での注意点¶

• シリアルポートは /dev/tty.* ではなく /dev/cu.*（例：/dev/cu.usbserial-XXXX）を使ってください。/dev/tty.* はキャリア検出を待つため、ハングします。
• tools/cmake/ に同梱の CMake は Linux 用のバイナリです。ビルドは PATH 上の cmake を優先するため、macOS では Homebrew の CMake だけで十分です。
• tools/serial_monitor.py は Python 標準ライブラリ（termios）のみを使い、pyserial は不要です。921600 などの高いボーレートも macOS 上で自ら設定するため、そのまま使えます。

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

次のステップ¶

• 最初の FreeRTOS アプリケーション：Reef で ipro7ai_reef_demo をビルド、書き込み、実行します。
• ビルドと書き込みの流れ：日常的な編集、ビルド、書き込み、モニターのサイクル。
• ビルドシステムと設定：.config のキー、リンカースクリプト、メモリレイアウト。