工具命令列¶

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 上一次完成建置、燒錄與開啟主控台（第一次燒錄前，板子上還沒有 SDK 韌體可回應 reboot_dl，請先依進入下載模式手動進入）：

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 上修改、建置、燒錄並檢查主控台的一輪循環，見建置與燒錄流程；建立自己的應用見建立第一個自己的應用。除錯與常見錯誤見除錯與疑難排解。