開発環境の準備¶
このページを終えると、コンピューターに SDK、ビルドツール、RISC-V ツールチェーン、書き込みツール IntelProCube がそろい、Reef のコンソールポートが認識され、SDK ルートから IPRO7AI Reef EVK の出荷時ファームウェアをビルドできるようになります。各手順には OS ごとのタブがあります。Windows の手順全体は Windows のセットアップと VS Code にあります。
前提条件¶
| 項目 | 要件 |
|---|---|
| ホスト | bash が使える macOS または Linux、または Windows x64 |
| 権限 | パッケージのインストールと /opt/toolchain/ への書き込みには管理者権限が必要です |
| ネットワーク | SDK のダウンロードに必要です。Windows の Online Setup には GitHub へのアクセスが必要です |
| 別途入手するもの | RISC-V ツールチェーン:macOS/Linux 用は INTELPRO から入手し、Windows では Online Setup がインストールします |
| 書き込みツール | IntelProCube 0.7.0.1:GitHub からダウンロードします。IntelProCube のインストールを参照してください。Windows では Online Setup がインストールします |
| ハードウェア | IPRO7AI Reef EVK、USB-C ケーブル、コンソールケーブル。必要なもの を参照してください |
SDK の入手¶
-
ダウンロードします: IPRO-SDK-V2.2.1 リリース から
IPRO-SDK-V2.2.1.tar.gzをダウンロードし、そのページに掲載されている SHA-256 を控えておきます。 -
ダウンロードしたファイルを検証します:
表示される 64 文字の 16 進数が、リリースページの値と一致する必要があります(大文字と小文字は区別しません)。一致しない場合は、もう一度ダウンロードしてください。
-
展開してバージョンを確認します。 新しいディレクトリに展開し、古い SDK に上書きしないでください。
VERSION.txtの内容:IPRO SDK Release ======================================== IPRO7: IPRO-SDK-V2.2.1 IPRO6: IPRO-SDK-V2.2.1 Release Date: 2026-11-10 Base Commit: 60afd4abIPRO-SDK-V2.2.1/が SDK ルート(このサイトでは<SDK>)で、apps/、bsp/、components/、build_freertos.sh、VERSION.txtが入っています。
ビルドツールのインストール¶
-
CMake、GNU Make、Python をインストールします。
Debian/Ubuntu の例です。他のディストリビューションでは同等のパッケージをインストールしてください。Linux x86-64 では、
PATHにcmakeがない場合、SDK のtools/cmake/にある CMake 3.15 がビルドに使われます。Online Setup は、Full environment または Build tools only を選ぶと CMake、Ninja、Python をインストールします。Windows のセットアップと VS Code を参照してください。
-
バージョンを確認します(macOS/Linux):
RISC-V ツールチェーンのインストール¶
-
デフォルトのパスに配置します。
Online Setup は Windows 用ツールチェーン GCC 13.1.1 をインストールし、SDK をそれに合わせて準備するため、SDK V2.2.0 はそのままビルドできます。生成されるイメージは、macOS と Linux で GCC 14 を使ってビルドしたものとは異なります。Windows のセットアップと VS Code を参照してください。
-
動作を確認します(macOS/Linux):
1 行目は
riscv64-unknown-elf-gccで始まり、バージョン 14.x が表示されます。 -
別の場所に置く場合: コンパイラーのプレフィックス
CROSS_COMPILE(末尾のハイフンを含む)を設定します。ビルドは、まずコマンドラインまたは環境変数のCROSS_COMPILE、次にアプリケーションの.configのCONFIG_CROSS_COMPILE、最後にデフォルトのパスの順に使います。設定を残すには、この行を
~/.zshrc(macOS)または~/.bashrc(Linux)に追加します。
IntelProCube のインストール¶
IntelProCube は IPRO6 と IPRO7 の書き込み・OTA ツールで、GitHub で公開されています。このサイトは 0.7.0.1 を前提にしています。Windows では Online Setup が 0.7.0 をインストールします。IPRO7 と Reef の書き込みに使うファイルは 0.7.0.1 と同じです(Windows のセットアップと VS Code を参照)。IPRO6S に書き込むときは、IntelProCube の README に従って 0.7.0.1 も別途インストールしてください。
-
ダウンロードして確認します。
curl -LO https://github.com/INTELPRO-INC/ipro-cube/releases/download/v0.7.0.1/IntelProCube-0.7.0.1-macos-arm64.tar.gz shasum -a 256 IntelProCube-0.7.0.1-macos-arm64.tar.gzc3a8bf7eca2a48c3f9bf40c3241ddf6aec5155688f2a92f40a84cc47f7633bc4と表示されます。macOS 版には Apple シリコンが必要です。ブラウザーでダウンロードした場合は、展開する前にxattr -d com.apple.quarantine IntelProCube-0.7.0.1-macos-arm64.tar.gzを実行してください。実行しないと、macOS がパッケージ内のプログラムを終了させます。値が異なる場合はダウンロードし直してください。各バージョンの値はリリースの
SHA256SUMS.txtにも記載されています。 -
展開します。
~/ipro/IntelProCubeができます。このサイトでは<IntelProCube>と表記します。コマンドラインツールはこのディレクトリで実行してください。チップ設定、パーティションテーブル、boot2 イメージをchips/から読み込むためです。 -
動作を確認します。
出力は使い方の概要から始まります:
-
build_freertos.shから見つけられるようにします(macOS/Linux):IPRO_FLASH_TOOLを設定するか、<IntelProCube>をPATHに追加します。
コンソールケーブルの接続¶
Reef には USB-UART 変換チップが搭載されていません。USB-C は電源とボード自身の USB デバイス機能に使われ、コンソールと書き込みは U6 に接続したアダプターまたは IPRO Debug Probe を経由します。
-
アダプターまたは Debug Probe をコンピューターに接続し(ボードは接続していなくてもかまいません)、新しく現れたシリアルポートを探します:
USB-UART 変換アダプターは
/dev/cu.usbserial-XXXXとして表示されます(名前はアダプターによって異なります)。IPRO Debug Probe を接続すると/dev/cu.usbmodem…ポートが 2 つ追加され、末尾が02のものがコンソールです。アダプターは通常
/dev/ttyUSB0として表示されます。IPRO Debug Probe を接続すると/dev/ttyACM*ポートが 2 つ追加されます。デバイス マネージャー → ポート (COM と LPT) を開き、接続の前後で比較します。新しく現れたエントリがそのポートです(例:
COM5)。IPRO Debug Probe を接続すると 2 つ追加されます。 -
新しいポートが現れない場合: データ通信に対応したケーブルを試してください。システムがアダプターを認識しない場合は、アダプターのメーカーが提供するドライバーをインストールしてください。Debug Probe については INTELPRO にお問い合わせください。
-
Linux の権限: ポートを開くときに
Permission deniedで失敗する場合は、ls -l /dev/ttyUSB0でポートを所有するグループ(多くはdialout)を確認し、自分をそのグループに追加してログインし直します:
Debug Probe の 2 つのポートの見分け方と、各 Reef アプリケーションが USB-C で提供する USB デバイスについては、書き込みとシリアルコンソール:ポートの見分け方 を参照してください。
動作確認¶
SDK ルートから出荷時ファームウェアをビルドします(macOS/Linux):
ビルドに成功すると次のように表示されます:
Project: ipro7ai_reef_demo (platform/ipro7ai_reef_demo)
→ Building ipro7ai_reef_demo...
✓ Build succeeded (14s)
Binary: <SDK>/apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.bin (244 KB)
Log: <SDK>/apps/platform/ipro7ai_reef_demo/build/build.log
ビルド時間とイメージサイズは、ホストとツールチェーンによって多少異なります。Windows では、VS Code Extension の IPRO: Build または build_freertos.ps1 で確認します。Windows のセットアップと VS Code を参照してください。
2 つの環境の違い¶
| 作業 | macOS/Linux | Windows |
|---|---|---|
| ツールのインストール | システムのパッケージマネージャーに加え、INTELPRO から入手するツールチェーンと、GitHub からダウンロードする IntelProCube | Online Setup(ツールチェーン、CMake / Ninja / Python、IntelProCube、OpenOCD、VS Code Extension) |
| ビルド | make -C apps/<category>/<app> または ./build_freertos.sh |
VS Code Extension の IPRO: Build |
| 書き込み | IntelProCube のコマンドラインツール、または ./build_freertos.sh … flash |
ipro_iot_tool.exe |
| コンソール | screen や picocom などのターミナルプログラム、tools/serial_monitor.py |
PuTTY などのターミナルプログラム、または Extension の Serial Monitor |
自動化(build_freertos.sh、tools/serial_monitor.py) |
利用可能 | 利用不可:どちらも bash と POSIX termios が必要です |
Zephyr(tools/zephyr/) |
利用可能 | SDK に Windows 用の手順はありません |
このサイトのコマンドライン例は macOS/Linux 向けに書かれています。
トラブルシューティング¶
| 症状 | 原因 | 対処 |
|---|---|---|
| 計算した SHA-256 がリリースページの値と異なる | ダウンロードが不完全、またはファイルが破損している | ファイルを削除して、もう一度ダウンロードします |
No cmake found. Install cmake or provide bundled cmake at … |
PATH に cmake がなく、同梱の CMake もこのホストでは実行できない(Linux x86-64 専用) |
ビルドツールのインストール のとおり CMake 3.15 以降をインストールします |
riscv64-unknown-elf-gcc: No such file or directory |
ツールチェーンが /opt/toolchain/riscv_ipro7/ にない |
RISC-V ツールチェーンのインストール のとおり CROSS_COMPILE を設定します |
Flash tool not found: ipro_iot_tool_macos |
IPRO_FLASH_TOOL が未設定で、IntelProCube が PATH にない |
IntelProCube のインストール の手順 4 を行います |
| アダプターを接続しても新しいシリアルポートが現れない | 充電専用の USB ケーブル、またはドライバーがない | ケーブルを交換します。アダプターメーカーのドライバーをインストールします |
Linux でポートを開くと Permission denied になる |
ポートのグループに属していない | dialout(または表示されたグループ)に参加して、ログインし直します |
macOS で /dev/tty.* を開くとターミナルが固まる |
tty.* はキャリア検出を待つ |
/dev/cu.* を使います |
次のステップ¶
- Windows の場合:Windows のセットアップと VS Code
- ホストの準備ができたら:最初の FreeRTOS アプリケーション
- コマンドラインのリファレンス:macOS/Linux のコマンドライン