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 应用。