工具命令行¶

SDK 随附主机端工具的命令格式、选项与示例，示例以 IPRO7AI Reef EVK V4.0 为准。逐步的烧录与控制台操作见烧录与串口。

工具一览¶

本版本没有通过 JTAG／GDB 进行片上调试的配置与步骤；调试以串口控制台、日志与离线的 addr2line 为主，见调试与故障排除。

环境变量¶

build_freertos.sh¶

./build_freertos.sh [动作...] [选项] <项目>

动作可以串联，依次执行；任一动作失败即停止。未指定动作时执行 build。这是 bash 脚本，在 macOS 与 Linux 上运行。

控制台波特率取自所用配置文件中的 CONFIG_PLATFORM_UART_BAUDRATE，未设置时为 115200。

<项目> 可以写应用名称（ipro7ai_reef_demo），或 apps/ 下的路径（platform/ipro7ai_reef_demo）。名称不唯一或找不到时，会列出候选名称。-l 的说明栏取自 .config 第一行注释，部分应用会显示为空。

在 Reef 上一次完成构建、烧录并打开控制台（首次烧录前，板上还没有能响应 reboot_dl 的 SDK 固件，请先按进入下载模式手动进入）：

export IPRO_FLASH_TOOL=<IntelProCube>/ipro_iot_tool_macos
./build_freertos.sh -p /dev/cu.usbserial-XXXX \
    -P <IntelProCube>/chips/ipro7/partition/partition_cfg_2M.toml \
    build flash monitor ipro7ai_reef_demo

依次输出：

→ Entering download mode...
→ Flashing ipro7ai_reef_demo_IPRO7.bin (--chip-variant IPRO7AI, --pt <IntelProCube>/chips/ipro7/partition/partition_cfg_2M.toml)...
...
✓ Flash succeeded (…)
→ Opening serial monitor on /dev/cu.usbserial-XXXX at 115200...

其他 Reef 配置用 -d 选择，例如：

./build_freertos.sh -d defconfig_reef build ipro_ble_remote          # 输出在 build_reef/build_out/
./build_freertos.sh -d defconfig_reef_ov5640 build flash ipro7_uvc_cam
./build_freertos.sh -l                                              # 列出 40 个项目
./build_freertos.sh size ipro7ai_reef_demo

产物位于 <应用>/build/build_out/（使用 -d 时为 build_<名称>/build_out/）：<应用>_<芯片>.bin、.elf、.map，芯片取自 CONFIG_CHIP（IPRO7 应用为 _IPRO7，IPRO6S 应用为 _IPRO6）。

make 目标¶

每个应用的 Makefile 都转而调用 SDK 根目录的 project.build（CMake 以 Unix Makefiles 生成器配置，再以 make -j4 构建）。

• CMake：优先使用 PATH 上的 cmake，找不到时才用 tools/cmake/（Linux x86-64）；两者都没有时停在 No cmake found。
• 每次构建后，compile_commands.json 会复制到 SDK 根目录，供编辑器使用。
• make menuconfig 需要未随附的 tools/kconfig/menuconfig.py；部分 Makefile 的 defconfig、list-defconfigs 目标会到未随附的 configs/ 目录中查找。请直接编辑 .config，或另存为 defconfig_<名称> 再以 DEFCONFIG= 构建。

IntelProCube 烧录工具¶

烧录使用 IntelProCube 的命令行工具。它未包含在 V2.2.1 中，从 GitHub 下载 0.7.0.1，安装方法见准备开发环境。工具从自己的 chips/ 目录读取芯片文件，请在 IntelProCube 目录下运行。下表根据 SDK 内的 README 与脚本整理，完整选项以工具本身为准。

Reef 出厂固件的烧录（先让开发板进入下载模式）：

cd <IntelProCube>
./ipro_iot_tool_macos --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/cu.usbserial-XXXX --baudrate 921600 \
    --pt chips/ipro7/partition/partition_cfg_2M.toml \
    --firmware <SDK>/apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.bin

成功时输出末尾有 [All Success]。工具即使失败也以 0 退出，请以这一行判断结果。Linux 用 ./ipro_iot_tool_linux，Windows 用 ipro_iot_tool.exe 与 COM5 这类端口名。各 Reef 应用需要的分区表与 --boot2、--mfg 见 IPRO7AI Reef EVK。

serial_monitor.py¶

python3 tools/serial_monitor.py <串口> [--baud 115200] [--timeout 30]
                                [--send CMD] [--wait-for PATTERN] [--log FILE]

以 Python 标准库的 termios 打开串口，不需要 pyserial；可在 macOS 与 Linux 上运行，不适用于 Windows。它只读取输出（可在开始时发送一行命令），不是交互式终端；要逐行输入命令，请用 screen、minicom 或其他串口终端程序。

# Reef 控制台（115200），发送自检命令，10 秒后退出
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --send "reef selftest" --timeout 10

# ipro7_jpeg_decode 的 Reef 配置（921600），持续监视并保存到文件
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --baud 921600 --timeout 0 --log console.log

# 让运行中的固件重启并进入下载模式（输出 reboot to download mode）
python3 tools/serial_monitor.py /dev/cu.usbserial-XXXX --send reboot_dl --timeout 2

macOS 请使用 /dev/cu.*，/dev/tty.* 会等待载波检测而卡住。烧录前先退出监视，释放串口。

create_ota.py¶

把 IntelProCube 生成的合并镜像打包成 boot2 OTA 包：默认以 XZ 压缩并输出 <输入文件名>.xz.ota，加 --raw 则不压缩并输出 <输入文件名>.ota。输入必须是以 IPNP 开头、含启动头的合并镜像（工具的 chips/ipro7/img_create_iot/whole_img.bin），而不是 SDK 构建出的 .bin；格式不符时脚本会停止。

python3 tools/create_ota.py <whole_img.bin> [--raw] [-o OUTPUT] [--hw-ver STR] [--fw-ver STR]

在 Reef 上，ipro_ble_remote 的 make_reef_ota.sh 会代为调用工具的 --build 与本脚本，见 Reef 应用的主机端工具。OTA 的整体流程见 OTA 更新。

Reef 应用的主机端工具¶

浏览器版图像 Teach：tools/teach_web¶

无需安装 IPRO AI Studio，在 Chrome 或 Edge 中为 Reef 的摄像头采集图像、训练分类器并通过 USB 部署。开发板需烧录 ipro_reef_teach 并处于 image 模式；主机需要 Python 3.8 及以上版本。

ipro_reef_teach 的 mfg 内容：mfg_payload.py¶

首次烧录 ipro_reef_teach 时，--mfg 写入的内容包含启动模式与声纹模型：

python3 apps/ai/ipro_reef_teach/mfg_payload.py \
    --voice apps/ai/ipro_reef_teach/model/model_b.spkb --mode image -o reef_teach_mfg.bin

--mode 可为 image、voice 或 sensor。生成的 reef_teach_mfg.bin 以 --mfg 交给 IntelProCube，烧录命令见示例页面；只更新固件时不要带 --mfg。

ipro_ble_remote 的 Reef OTA 工具¶

两个 Python 脚本需要 bleak：python3 -m venv .venv && .venv/bin/pip install bleak。OTA 只适用于以 boot2 与 partition_cfg_2M_remote_ab.toml 烧录过的开发板；不要在 Reef 上以标准 partition_cfg_2M.toml 做 OTA。

其他 Reef 应用的工具¶

Zephyr 脚本¶

tools/zephyr/（bootstrap.sh、build.sh、flash.sh、monitor.sh、ci_build.sh）用于 Zephyr 的 ipro7_evb 与 ipro7ai_evk 板型；本版本没有 Reef 的 Zephyr 板型。用法见 Zephyr RTOS。

大小与内存分析¶

./build_freertos.sh size ipro7ai_reef_demo
/opt/toolchain/riscv_ipro7/bin/riscv64-unknown-elf-nm --size-sort -S \
    apps/platform/ipro7ai_reef_demo/build/build_out/ipro7ai_reef_demo_IPRO7.elf | tail -20

同时启用 CONFIG_AI_SUPPORT 与 CONFIG_MM_SUPPORT 时，链接器脚本会把 OCRAM 区段缩小为 64 KB（CONFIG_EM_SIZE 为 0）或 48 KB（CONFIG_EM_SIZE 大于 0），CMake 配置阶段会打印 AI+MM …: OCRAM=…。内存地址分布见 IPRO7，OCRAM 预算见构建系统与配置。

自动测试¶

./build_freertos.sh test ipro_unit_test 会构建、烧录并等待 ALL TESTS PASSED 或 SOME TESTS FAILED；ipro_unit_test 需要 IPRO7 EVB。Reef 的板上自检是出厂固件的 reef selftest，见调试与故障排除。

其他工具¶

开发流程¶

在 Reef 上修改、构建、烧录并检查控制台的一轮循环，见构建与烧录流程；创建自己的应用见创建第一个自己的应用。调试与常见错误见调试与故障排除。