IPRO7AI Reef EVK V4.0¶

V4.0

IPRO7AI Reef EVK 以 IPRO7AI（QFN56）为核心，Flash 与 PSRAM 都在芯片封装内。板上有 OV5640 摄像头排线座、PDM 数字麦克风、耳麦插孔与扬声器功放、microSD 卡座、RGB LED、按键，以及位置与引脚排列都与树莓派相同的 40-pin 扩展排针；仅由 USB-C 供电，没有 LCD 和电池。本页对应 V4.0 开发板（丝印“IPRO7AI REEF EVK V4.0”）；本站所有步骤都以这块板为准。

板载功能¶

规格依据 V4.0 设计文件（原理图与物料清单）。

开关与跳线¶

测量 IPRO7AI 的电流：拔掉 USB-C，把电流表接在 JP2 的 1、2 脚之间（或把外部 3.3 V 电源接在 2、3 脚），SW8 拨到 MEAS，再接上 USB-C。测量完毕先拔掉 USB-C，把 SW8 拨回 PWR，再拆下电流表。测得的是 IPRO7AI 的 3.3 V 引脚及其去耦电容、启动引脚上拉电阻的电流，不含外设。

快速上手¶

完成后，开发板运行出厂固件 ipro7ai_reef_demo，并在控制台响应 reef selftest。主机需要 RISC-V 工具链（向 INTELPRO 获取）、IntelProCube 0.7.0.1（从 GitHub 下载）、CMake 3.15 及以上、GNU make 与 Python 3.8 及以上，见开始使用。

熟悉流程后，可以用 build_freertos.sh 一次完成构建、烧录与打开控制台。它根据应用的配置自动选用 --chip-variant IPRO7AI，以应用自己的波特率打开控制台；板上已有 SDK 固件时会先发送 reboot_dl，首次烧录则要先用按键进入下载模式：

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

这个脚本无法写入 boot2 与 mfg 数据，ipro_ble_remote 的首次烧录与 ipro_reef_teach 请直接使用 IntelProCube。选项见工具命令行。

下载模式¶

烧录前，IPRO7AI 必须在复位时检测到 BOOT（GPIO41）为高电平，进入 ROM 的下载模式。进入后控制台没有任何输出；烧录完成后按一下 SW2 回到正常启动。

用 Debug Probe 进入下载模式（每行发送一个关键字）：

python3 tools/serial_monitor.py /dev/cu.usbmodemXXXX02 --send IPRODL_1 --timeout 1
python3 tools/serial_monitor.py /dev/cu.usbmodemXXXX02 --send IPRORST_RESET --timeout 1

烧录完成后用同样的方式发送 IPRODL_0 与 IPRORST_RESET，开发板正常启动。

使用 boot2 的镜像（例如 ipro_ble_remote 的 Reef 版）另有 reboot_usb [code]：重启后进入 boot2 的 USB 下载模式（默认一直等待）。OTA 包校验失败时，boot2 也会停在这个 USB 救援模式。

出厂固件 ipro7ai_reef_demo¶

板上每个功能模块各有一组 shell 命令，help 列出全部命令。Reef 没有 LCD，摄像头用 shell 命令检查。

应用 README 中的 AUX-IN 输入（mic rec aux）是上一版底板的功能，V4.0 没有 AUX-IN 插座。

摄像头上手的顺序（SW7 在 CAM）：

cam probe        经 SCCB 读取传感器 ID
cam start        开始采集
cam status       间隔一秒执行两次：帧数增加、错误数不变
cam bar on       切换到彩条
cam snap         ASCII 缩略图应为竖直色带
cam bar off
cam snap         拍到实际画面

Wi-Fi 与 RTSP 摄像头视频流¶

把 IPRO6S FIN 卡插入 microSD 卡座，Reef 即可经 SDIO 连上 Wi-Fi，并通过 RTSP 提供摄像头的 MJPEG 视频流（rtsp://<ip>:8554/av0_0）。

• FIN 卡固件：IPRO6S 的 ipro6_if_wifi，用 defconfig_ipro6_sdio 构建：

  make -C apps/platform/ipro6_if_wifi DEFCONFIG=defconfig_ipro6_sdio   # build_ipro6_sdio/build_out/ipro6_if_wifi_IPRO6.bin
  

  更新方式见 IPRO6S；卡片已连上 Wi-Fi 时，可在 Reef 控制台用 ipro6s_ota <http url> 更新。

• Reef 固件：ipro7ai_reef_demo 的 defconfig_wifi_ipro6s：

  make -C apps/platform/ipro7ai_reef_demo DEFCONFIG=defconfig_wifi_ipro6s   # build_wifi_ipro6s/build_out/
  

• 开关：JP3 放在 GPIO，fin cycle 才能给卡片重新上电。

连接后在控制台输入 ipronet_up <ssid> <psk>，再输入 rtsp_cam on，用 RTSP 播放器打开 rtsp://<ip>:8554/av0_0。完整步骤见 Wi-Fi 与 RTSP 摄像头视频流。

支持的示例¶

下列 9 个应用（11 个配置）可在 Reef 上构建与运行，每个都有示例页面给出烧录与运行步骤。除 ipro7ai_reef_demo、ipro_reef_teach 与 ipro_agora_sentino 外，其他应用直接执行 make 会构建为其他开发板，Reef 要加上 DEFCONFIG=。

用 DEFCONFIG= 构建的输出放在 build_<名称>/build_out/，名称为文件名去掉 defconfig_ 的部分，例如 defconfig_reef → build_reef/。

USB 标识符¶

Reef 的 USB-C 由 IPRO7AI 的 USB 2.0 Full-Speed 设备提供，标识符取决于运行的固件。所有应用的 VID 都是 0x3896（INTELPRO INC.）。

ipro_ble_remote、ipro_throughput_test、ipro_le_audio_headset、ipro7_jpeg_decode、ipro_agora_sentino 与 ipro7ai_reef_demo 的 defconfig_wifi_ipro6s 不使用 USB 设备，USB-C 仅用于供电。

引脚对照¶

microSD 的 CMD 与 DAT 线没有外部上拉电阻，要开启 IPRO7AI 的内部上拉（SDK 的板级配置已开启）。用 GPIO14 关闭卡座电源前，先把 GPIO28–33 设为低电平或输入。microSD 这组引脚只接卡座，没有引出到 J_IO。

40-pin 扩展排针 J_IO¶

J_IO 是 2 × 20、2.54 mm 间距的直针排针，位置与引脚排列同树莓派的 40-pin 排针：电源、地、I2C 与 UART 都在相同位置。奇数引脚在靠板内的一排，偶数引脚在板边的一排。所有信号都是 3.3 V，每个信号引脚都有 ESD 保护。

• 标 * 的引脚经过摄像头切换芯片：只有 SW7＝GPIO 时才接到 IPRO7AI，SW7＝CAM 时不连接任何信号。
• 2、4 脚的 5 V 由 USB 5 V 经二极管输出，只在接着 USB-C 时有电，不能从这里给开发板供电。
• 16、18 脚（BOOT、RESET）默认未连接；需要时在 R92、R93 焊上 0 Ω 电阻。
• 27、28 脚是第二组 I2C，SW7＝GPIO 时可读取扩展板上的 ID EEPROM。

调试插座 U6¶

U6 是 1.0 mm 间距、6 pin 的卧式插座（SH1.0），提供控制台 UART 与 BOOT、RESET 控制线，用于烧录固件与查看启动日志。控制台是 UART0，也是烧录用的 UART：115200 baud、8N1、无流控（烧录时 921600 baud）。

IPRO Debug Probe 的 CN_UART 用两端线序反向的排线接到 U6：探针第 n 脚接 U6 第 7 − n 脚（探针 RST→RESET、DL→BOOT、TXD→RX、RXD→TX、GND→GND，探针的 3V3 落在 U6 的空脚上）。

SDK 板级支持¶

• 板级配置：.config 中写入 CONFIG_IPRO7AI_REEF=y 与 CONFIG_BOARD="IPRO7AI_REEF"，引脚定义在 bsp/board/ipro7/ipro7ai_reef_board_config.h。同一个配置中不要再写入 CONFIG_EVB=y：两者都存在时会按 IPRO7 EVB 构建。
• PSRAM：构建不应用 Kconfig 的 select，Reef 配置都显式写入 CONFIG_USE_PSRAM=y（ipro_throughput_test 的 defconfig_reef 例外，它没有开启 PSRAM）。从零开始的新应用请复制 apps/platform/ipro7ai_reef_demo/.config。
• 引脚定义：配置文件中控制台、USB、摄像头、扬声器、麦克风、LED、按键与 SD 卡的 BOARD_* 引脚与本页一致。文件内注释描述的扩展排针与跳线属于上一版（V3.0）底板，V4.0 以本页为准。
• 晶振微调：.config 没有设置 CONFIG_IPRO7_XTAL_CAPCODE 时，构建会为 Reef 应用 95；在 .config 中写入其他值即可覆盖（0 = 保留启动时的值）。启动日志中的 [XTAL] capcode 一行显示实际的值。
• Flash 布局：ipro7ai_reef_demo、ipro7_uvc_cam、ipro7_jpeg_decode 与 ipro_throughput_test 的 Reef 配置使用 1 MB 布局，两种封装内 Flash 都放得下；ipro_reef_teach、ipro_agora_sentino 的 .config 与 ipro_ble_remote、ipro_le_audio_headset、ipro_ai_link 的 defconfig_reef 设置了 CONFIG_IPRO7_FLASH_2M=y。要让 1 MB 布局的应用使用整颗 2 MB Flash，在其配置中加入 CONFIG_IPRO7_FLASH_2M=y。
• Zephyr RTOS：本版本没有 Reef 的 Zephyr 板型。SoC 的 Kconfig 说明 Reef 可运行 ipro7_evb 镜像并需设置 CONFIG_SOC_IPRO7_XTAL_CAPCODE=95，这种用法未经验证。

相关文档¶

• IPRO AI Teach：在这块板上用 IPRO AI Studio 教开发板识别图像、声纹与传感器信号。
• 示例：可在 Reef 上运行的应用，各有构建、烧录与运行步骤。
• 引脚与外设对照、电源与功耗测量、IPRO7AI、IPRO6S。
• apps/platform/ipro7ai_reef_demo/README.md：出厂固件的完整命令与摄像头调试说明。
• IPRO7AI Reef 开发套件使用手册（V4.0 开发板硬件、接口与供电）与 IPRO Debug Probe 使用手册：向 INTELPRO 索取，见文档下载。