Windows のセットアップと VS Code¶

インストーラーをダウンロードします： IPRO SDK Online Setup の最新リリース（3.6.0）から IPRO-SDK-Online-Setup-3.6.0.exe をダウンロードします。GitHub へのサインインは不要です。

PowerShell で検証します：

Get-FileHash .\IPRO-SDK-Online-Setup-3.6.0.exe -Algorithm SHA256

Hash 列の値が、同じリリースの SHA256SUMS.txt に記載された同じファイルの値と一致する必要があります（大文字と小文字は区別しません）。インストーラーにはコード署名がないため、Windows が SmartScreen の警告を表示することがあります。社内のセキュリティ規定に従ってください。

Full environment を選びます： Choose packages で選択します。

バージョンを確認します： Select package versions では、すべてのコンポーネントを latest のままにします。一覧には latest が実際にどのバージョンになるかが表示されます（例：latest (2.2.0)）。

ディレクトリを選びます： Select Destination Location では、デフォルトの新しいフォルダー C:\IPRO\versions\3.6.0-<date-time> のままにするか、まだ存在しないフォルダーを入力します（これがインストールルートで、このページでは <install dir> と表記します）。

追加のタスクを選びます： VS Code がインストールされていない場合は Install VS Code from Microsoft if absent にチェックを入れます。Install the selected Extension into VS Code はチェックしたままにします。VS Code がこの環境を使うようにするには Switch only selected component settings に、どのターミナルからでもツールを実行できるようにするには Add installed tools to user PATH にチェックを入れます。

インストールします： Ready to Install でディレクトリ、モード、バージョンを確認し、Install をクリックします。

完了ページを確認します： SDK フォルダー（<install dir>\sdk\IPRO-SDK-V2.2.0）、最初に実行するコマンドラインのコマンド、ツールチェーンのフォルダーが表示されます。新しい設定と PATH を反映させるため、VS Code とターミナルを開き直してください。

Extension がインストールされていることを確認します： Extensions パネルで @installed IPRO を検索すると、IPRO SDK Extension（識別子 ipro.ipro-sdk-extension）が表示されます。

SDK を開きます： File → Open Folder… で <install dir>\sdk\IPRO-SDK-V2.2.0 を開き、ソースを確認したうえで Workspace Trust を許可します。

SDK ルートを設定します： インストール時に設定のタスクにチェックを入れなかった場合は、F1 を押し、同じフォルダーに対して IPRO Setup: Set SDK Root を実行します。

環境を確認します： IPRO Setup: Run Diagnostics を実行し、SDK ルート、コンパイラー、CMake、Python、書き込みツールがすべて <install dir> の下を指していることを確認します。

出荷時ファームウェアをビルドします： IPRO: Go to Project… を実行して platform カテゴリの ipro7ai_reef_demo を選び、IPRO: Build を実行します。

SDK フォルダーに移動します

cd <install dir>\sdk\IPRO-SDK-V2.2.0

ビルドします

powershell -ExecutionPolicy Bypass -File .\build_freertos.ps1 build ipro7ai_reef_demo

Project: ipro7ai_reef_demo  (platform/ipro7ai_reef_demo)

-> Building ipro7ai_reef_demo...
[OK] Build succeeded (21s)
  Binary: ...\apps\platform\ipro7ai_reef_demo\build\build_out\ipro7ai_reef_demo_IPRO7.bin (219 KB)
  Toolchain: <install dir>/toolchain/riscv_ipro7_win32/bin/riscv64-unknown-elf-gcc
  Log: ...\apps\platform\ipro7ai_reef_demo\build\build.log

失敗した場合は、ビルドログの最後の 30 行と、ログ全体の場所が表示されます。

IPRO ツールチェーンが認識されたことを確認します

Select-String -Path apps\platform\ipro7ai_reef_demo\build\build.log -Pattern "\[toolchain\]"

-- [toolchain] Vendor toolchain detected - enabling xxldsp and mtune=intelpro-ipro7

接続します： SW7 を CAM、SW8 を PWR にし、IPRO Debug Probe を U6 に接続してから、Reef の USB-C を接続します。スイッチの設定とボードの接続 を参照してください。Windows ではプローブは 2 つの COM ポートとして表示されます。ポートの見分け方 を参照してください。

書き込んで起動バナーを確認します： SDK フォルダーで次を実行します：

powershell -ExecutionPolicy Bypass -File .\build_freertos.ps1 flash monitor ipro7ai_reef_demo -w "IPRO7AI Reef carrier demo"

スクリプトがプローブのコンソールポートを選び、IntelProCube がボードをダウンロードモードにして書き込み、リセットします。バナーが表示されるとモニターは停止します：

[All Success]
[OK] Flash succeeded (6s)
...
[serial_monitor] MATCHED: IPRO7AI Reef carrier demo

Summary:
  [OK] flash
  [OK] monitor

IPRO7AI ボードのアプリケーションには、--chip-variant IPRO7AI とパーティションテーブル partition_cfg_2M.toml が自動的に適用されます。複数のシリアルポートが接続されている場合は、-p COM5 でコンソールポートを指定します。

接続します： SW7 を CAM、SW8 を PWR にし、コンソールケーブルを U6 に接続してから、USB-C を接続します。スイッチの設定とボードの接続 を参照してください。

COM ポートを確認します： デバイス マネージャー → ポート (COM と LPT) を開きます。アダプターを接続したときに現れるポートがコンソールです（例：COM5）。

ダウンロードモードに入ります： SW1 (BOOT) を押したまま SW2 (RESET) を 1 回押し、SW1 を離します。

書き込みます： PowerShell で <install dir>\IntelProCube に移動し、次を実行します：

cd <install dir>\IntelProCube
.\ipro_iot_tool.exe --chipname ipro7 --chip-variant IPRO7AI `
    --port COM5 --baudrate 921600 `
    --pt chips/ipro7/partition/partition_cfg_2M.toml `
    --firmware <install dir>\sdk\IPRO-SDK-V2.2.0\apps\platform\ipro7ai_reef_demo\build\build_out\ipro7ai_reef_demo_IPRO7.bin

最後の行が [All Success] の場合のみ成功です。ツールは失敗しても終了コード 0 で終了します。パラメーターについては 書き込みとシリアルコンソール で説明しています。完了したら SW2 を押してリセットします。

コンソールを開きます： SDK フォルダーで powershell -ExecutionPolicy Bypass -File .\build_freertos.ps1 monitor ipro7ai_reef_demo -t 30 を実行するか、PuTTY で Serial を選び、Serial line をコンソールの COM ポート、Speed を 115200 に設定して Open をクリックします。Tera Term や VS Code Extension の IPRO: Serial Monitor も使えます。

リセットします： build_freertos.ps1 monitor は reboot を送信します。他のターミナルプログラムでは SW2 (RESET) を押します。ウィンドウに起動バナー IPRO7AI Reef carrier demo が表示されます。Enter を押すと ipro /> が表示されます。

セルフテストを実行します： reef selftest と入力します。期待される出力は 最初の FreeRTOS アプリケーション にあります。