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 欄應與同一個 Release 的 SHA256SUMS.txt 中同名檔案的值相同（大小寫不影響）。安裝程式沒有程式碼簽章，Windows 可能顯示 SmartScreen 警告，請依公司的資訊安全規定處理。

選擇 Full environment：執行安裝程式，在 Choose packages 選 Full environment。

確認版本：Select package versions 各元件保持 latest，選單會直接顯示對應的版本，例如 latest (2.2.0)。

選擇目錄：在 Select Destination Location 保留預設的新資料夾 C:\IPRO\versions\3.6.0-<日期時間>，或填入一個尚不存在的資料夾（安裝根目錄，本頁寫作 <安裝目錄>）。

選擇附加工作：尚未安裝 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 的位置（<安裝目錄>\sdk\IPRO-SDK-V2.2.0）、命令列建置的第一個指令與工具鏈的位置。重新開啟 VS Code 與終端機，讓新的設定與 PATH 生效。

確認 Extension 已安裝：在 Extensions 面板搜尋 @installed IPRO，應看到 IPRO SDK Extension（識別碼 ipro.ipro-sdk-extension）。

開啟 SDK：以 File → Open Folder… 開啟 <安裝目錄>\sdk\IPRO-SDK-V2.2.0，確認來源後允許 Workspace Trust。

指定 SDK 根目錄：安裝時沒有勾選設定切換工作時，按 F1 執行 IPRO Setup: Set SDK Root，選擇同一個目錄。

檢查環境：執行 IPRO Setup: Run Diagnostics，確認 SDK 根目錄、編譯器、CMake、Python 與燒錄工具都指向 <安裝目錄> 底下。

建置開箱韌體：執行 IPRO: Go to Project…，在 platform 分類選擇 ipro7ai_reef_demo，再執行 IPRO: Build。

切換到 SDK 目錄

cd <安裝目錄>\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: <安裝目錄>/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，見設定開關與接線。Probe 在 Windows 上會出現兩個 COM 埠，見辨識序列埠。

燒錄並看開機訊息：在 SDK 目錄執行：

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

腳本會選用 probe 的主控台埠，由 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），再放開 SW1。

燒錄：在 PowerShell 切換到 <安裝目錄>\IntelProCube 執行：

cd <安裝目錄>\IntelProCube
.\ipro_iot_tool.exe --chipname ipro7 --chip-variant IPRO7AI `
    --port COM5 --baudrate 921600 `
    --pt chips/ipro7/partition/partition_cfg_2M.toml `
    --firmware <安裝目錄>\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 應用。