
本文把轻AI越影视觉开发板能用的资料一次性梳理清楚芯片什么水平、板子有什么接口、代码在哪个仓、18 个 sample 各解决什么问题、文档该按什么顺序读。适合刚拿到板子、准备上手的人直接当地图用。一、先搞清楚这块板是什么轻AI越影视觉开发板的核心是一颗定位轻智能视觉终端的 IPC SoC。标称 6M30 / 4K20也就是 600 万像素 30fps、4K 20fps 的编码能力。它最容易被误解的地方在这里这不是一块跑通用 Linux 应用的小电脑。DDR 只有 128MBCortex-A7 双核跑 950MHz。真正的开发范式是——Cortex-A7 只做控制逻辑和轻量 UI重活全部交给 MPP 硬件通路VI / VPSS / VENC和 NPU / IVE写代码的第一原则是「不要 memcpy 大帧、不要用软件转格式」。理解了这条后面所有 sample 的写法就看懂了它们几乎都是同一个骨架的裁剪版。二、芯片规格模块规格要点处理器内核ARM Cortex-A7 MP2双核950MHz32KB I-Cache / 32KB D-Cache / 128KB L2支持 Neon 与 FPUNPU1 TOPS支持 Transformer 特性加速内置人脸 / 人形 / 车形 / 包裹 / 宠物检测算法配套模型生产与进化工具链IVE 2.5升级算子支持运动侦测、周界防范、跟踪、透视变换、视频诊断AI ISP静态/动态坏点矫正、3A、镜头阴影校正两帧 WDR 融合32 倍曝光比、Advanced LTM、强光抑制时域空域降噪、去 FPN、去色噪 2.0、去紫边 2.0、去雾PQ Tool 1.2 调优视频处理1/15.5 ~ 16× 缩放、镜头畸变校正、Mirror / Flip / 90°·270° 旋转视频编码H.265 MP L5、H.264 BP/MP/HP L5.1、SVAC3.0最大 3840×2160典型双流 3200×180030 1280×72030 或 3840×216020 1280×720208 区 OSD、8 区 ROIJPEGBaseline 编码最大 16384×16384抓拍 3200×180030fpsYUV420视频输入MIPI / LVDS / Sub-LVDS / HiSPi2×2-Lane 或 4-Lane 组合最高 2 路 Sensor8/10/12bit Bayer音频内置 Audio Codec16bit 双路差分输入 单路单端输出1 路 I2S3AAEC/ANR/ALC2.0、降风噪、哭声检测 2.0安全安全启动、TrustZone REE/TEE 隔离、AES/RSA/ECC/SHA、SM2/SM3/SM4 国密外围集成 FEPHY TSO 网络加速2× SDIO 2.01× USB2.0 Host/Device独立供电 RTC多路 UART / I²C / SPI / PWM / GPIO存储接口内置1Gb DDR3/3L最高 2133MbpsSPI Nor ≤32MBSPI Nand ≤512MBeMMC 4.5支持三种启动介质物理规格QFN9×9mm脚距 0.35mm工作温度 -20℃ ~ 70℃型号上按功能分00B / 10B / 20B / 00S / 20S / 00G / 20G等档位差异在存储接口、编码档次与外设组合。开发板板端加载脚本叫load3516cv610_20s_debug说明套件默认按 20S 档位配置。三、开发板硬件积木式六件套板子采用分层合体形态由主板 五类扩展板组合#部件数量关键参数1主板 CV610 DevBoard1Hi3516CV610128MB DDR3LSPI NAND 256MBDS35Q2GB-IB2屏接口板 LCD ExtBoard1仅支持 SPI 屏已适配 1.28″ 双圆 / 2.1″ 单圆 / 2.8″ 单方3WiFi 板 WSx3 ExtBoard1WS53低功耗或WS73常电集成 WiFi / BLE / SLE含 2 路模拟硅麦与音频回采44G Cat1 板 Hi21311国内全网通 FDD B1/3/5/8、TDD B34/38/39/40/41上行 5Mbps / 下行 10Mbps5Sensor 板 OS04D101 或 24MP2-Lane MIPI双板可实现双目6MCU 板 Hi30611用于马达 / 舵机控制场景7LCD 屏1M013-0600-1B11.28″双圆/ M021-0605-1B02.1″单圆/ M028-0603-1B02.8″单方8喇叭18Ω / 2W9–10线材各 1USB to Type-C100cmDebug 用、Type-C to Type-C主板板载值得一提的几项Debug 口Type-C 转 UART串口转换芯片是CH343P注意是 CDC-ACM 类不是 CH340 那种 USB-serial双 Sensor 接口Sensor0 / Sensor1 均为 30P、0.5mm 脚距 FPC 下接触座100M 网口TFTP 网络调试、SCP 传文件的主通道40PIN 排针IO 电平 3.3V与拨码开关配合复用TF 卡槽与 SDIO0 / 40PIN 复用需拨码切到 ON 才能读写RTC 电池座1.0mm 间距 2P。RTC 电池与 Sensor 接口均不可热插拔。四、最容易踩的坑SW1301 拨码开关板子为尽量引出芯片全部接口用两位拨码做时分复用。屏不亮、TF 卡读不到、双目只出一路九成是拨码没拨对。开关状态切换结果SW1301-1OFFSDIO0GPIO3_4/5/6/7 GPIO4_0/1/2/3切到 40PIN →支持单屏显示SW1301-1ONSDIO0 切到 TF 卡槽 →支持 TF 卡读写SW1301-2OFFGPIO6_0/1/2/3 GPIO7_1 切到 40PIN → 两位都 OFF 时支持双屏显示SW1301-2ON同组 GPIO 切到 Sensor1 接口 →支持双 SensorSensor0 可改 4-Lane官方推荐的三种组合场景场景拨码1/2能力组合场景一OFF / OFF双屏显示屏 1 带触控 外置 ADC 音频回采 WiFi 单摄像头 UART场景二OFF / ON单屏显示带触控 外置 ADC 音频回采 WiFi 双摄像头 UART场景三ON / ONWiFi 双摄像头 UART TF 卡无屏出厂镜像烧的就是场景二小系统开箱即用。要跑双目的sensor/dual保持场景二要读写 TF 卡或做无屏项目切场景三。五、I²C 地址与 4-Lane 改造写驱动或改 DTS 时直接对表填地址组GPIO挂载设备7 位地址I2C0GPIO6_6 / GPIO6_7Sensor OS04D10 →0x3CI²C 扩展器 GXA543U →0x70I2C1GPIO1_5 / GPIO1_4屏触摸 IC CST3530 →0x1A外置 ADC ES7210 →0x40I2C2—未接设备Sensor 接口默认 2-Lane。要把单 Sensor 提到 4-Lane需要改电阻选焊并同时把 SW1301-2 拨到 ONMIPI 模式R7545 / R7546 / R7551 / R7552R7547 / R7548 / R7549 / R75502-Lane默认0Ω 上件NC4-LaneNC0Ω 上件六、软件栈分层┌─────────────────────────────────────────────────────────────┐ │ 应用层 samples / references │ │ sensor · ai_component · gui · panel · local_voice_process │ │ push_stream · factory_demo · ai_table_lamp … │ ├─────────────────────────────────────────────────────────────┤ │ 框架层 libhi_mapi / framework_media / ai_autorate │ │ pipeline 对外接口 hi_mapi_*DIRECT 单进程 / SERVERCLIENT │ ├─────────────────────────────────────────────────────────────┤ │ MPP 媒体处理平台 VI → VPSS → VENC / VDEC AI → AENC / AO │ │ ss_mpi_* 接口 · VB 视频缓存池 · IVE 2.5 算子 · NPU 推理 │ ├─────────────────────────────────────────────────────────────┤ │ BSP / 驱动 bsp/dts bsp/patch 内核 defconfig │ │ sensor 驱动 · DRM(mipi_dbi) SPI 屏 · 触摸 · WS73 WiFi · 音频 │ ├─────────────────────────────────────────────────────────────┤ │ 底层 Linux 5.10 / OpenHarmony · U-Boot · MPP 内核模块 │ └─────────────────────────────────────────────────────────────┘双系统说明SDK 主线是Linux 5.10出厂镜像也是 Linux。OpenHarmony 6.1 只对ws73_lcd整机方案做过适配走scripts/build_ohos.sh小型系统内核其实仍是 Linux。除非明确要做 OHOS 应用否则建议主线走 Linux。七、仓库地图repo 多仓到底拉了些什么整个工程由repo管理一个 manifest 仓拉下 SDK、BSP、适配层、应用案例多个子仓。官方入口repo init-uhttps://gitcode.com/HiSpark/hi_aiot_solution_manifest.git-bmain reposyncrepo start master--all拉下来之后各仓分别落在哪、版本锁在哪这张表说清楚仓库落地路径版本体积浅克隆实测HiSpark/hi_aiot_solutionhi_aiot_solutionmaster1.3GHiSpark/hi_aiot_solution_cv610_ev_boardhi_aiot_solution/apps/cv610_ev_boardmaster298MHiSpark/Hi3516CV610hi_aiot_solution/sdk/Hi3516CV610tagtag_V2.0.0_Beta1.1Ghi_aiot_solution_adaptercomponents/adaptermaster五组件合计 69Mhi_aiot_solution_hiaicomponents/hiaimaster↑hi_aiot_solution_hichannelcomponents/hichannelmaster↑hi_aiot_solution_mediacomponents/mediamaster↑hi_aiot_solution_networkcomponents/networkmaster↑HiSpark/linuxsdk/Hi3516CV610/third_party/linux/linux-5.10.ycommitb84393335.10.2211.3GHiSpark/u-boot.../third_party/u-boot/u-boot-2022.07commita70c451b201MHiSpark/busybox.../third_party/busybox/busybox-1.34.1commitb13de36223M组装完约5.2G。几个关键点SDK 仓不是 master锁在tag_V2.0.0_Beta这是最容易踩的版本坑内核 / U-Boot / BusyBox 是独立 project不是 submodule 自动带components/*五个组件即使案例不用也必须拉——顶层Kconfig里有硬source缺了直接抛KconfigError只用-g linux分组可以排除 OHOS 代码树。八、18 个 samples按功能域分类板级仓结构很清爽业务代码在samples/与references/硬件资料在hardware/板级 DTS 与补丁在bsp/。hi_aiot_solution_cv610_ev_board/ ├── bsp/ │ ├── dts/ hi3516cv610-demb.dts / -flash.dts / -emmc.dts │ │ board_io_config.dtsi · hi3516cv610-open.dtsi │ └── patch/ 板级补丁 ├── hardware/ │ ├── dev-kit/ schematic/ · pcb-Assembly/ · pcb-dxf/ │ ├── hardware-design-guide/ 开发板使用指南接口/拨码/I2C 全表 │ ├── hardware-design-checklist/ │ └── other-hardware-docs/ Datasheet/ · 40PIN_GPIO功能复用表.xlsx · PINOUT.xlsx ├── samples/ 18 个功能样例 ├── references/ 5 套整机方案 └── README.md 案例总索引媒体通路视觉必看案例路径解决什么问题sensor/singlesamples/sensor/single单目出图全链路VI → VPSS双通道→ VENC(H.265)VI offline VPSS onlineRTSP 推流 LCD 实时预览CHN1 缩到 240×320 经 IVE 硬件 CSC 送 LVGL/DRM 推屏支持场景自适应动态帧率sensor/dualsamples/sensor/dual双目双路编码用hi_mapi_*pipeline 搭两路全离线 VI→VPSS→VENC双路同时落盘LCD 运行时切换显示源自带可烧写镜像capture_picturesamples/capture_pictureJPEG 抓拍VI → VPSS → VENC(JPEG)VPSS 双通道原始 768×448 小流-n连续抓拍存/mnt/capture_YYYYMMDD_HHMMSS.jpgpush_streamsamples/push_streamRTMP 推流基于 components/media 与 ZLMediaKit 6.0把 H.265 AAC 推到 SRS内置开机自启脚本framework_mediasamples/framework_media应用框架范本DIRECT 直调 SERVER/CLIENT 跨进程 IPC 两种部署fw_cli命令行控制启停与抓拍h264_decodersamples/h264_decoder纯软解芯片无硬解码器tinyh264仅 Baselineopenh264 v2.6.0B/M/H Profile内置 7 段测试码流AI 与语音案例路径解决什么问题ai_componentsamples/ai_componentNPU 检测与识别aidetect做人形 车辆 人脸/宠物/包裹检测aivsr做人脸特征建底库 余弦比对。输入 NV21 YUV 图 指定模型local_voice_processsamples/local_voice_process本地语音全双工mic → AI AENC(Opus) → ASR → zeroclaw → TTS → AO → speaker单进程共用一次 MPP 音频初始化4 种 ASR 后端、3 种 TTS 后端唤醒词 VADagent_audio_samplesamples/agent_audio_sample端云 Agent 语音内置 ADC / 外置 ES7210 双变体纯端侧KWS 命令词/ 纯上云 / 端侧唤醒 上云多轮三种模式显示与 UI案例路径解决什么问题panelsamples/panelSPI 屏适配集合Linux DRM(mipi_dbi) LVGL 9.x9 个子案例覆盖 ST7789V / ST7796 / GC9B72 / JD9853 / GC9A01A 双圆屏 / ST77912 双圆屏含 GT911、FT5x06、CST3530 触摸guisamples/gui视频叠加 UI方屏JD9853 240×320、圆屏GC9B72 360×360、双屏ST7789V ×2。方屏实测内存 ≈4MB、CPU 10%dialog_fullscreen_uisamples/dialog_fullscreen_ui全屏聊天界面LVGL 渲染一问一答气泡 8 种全屏大表情命名管道接收外部文字最多 200 条历史panel 案例的命名规则是驱动_宽_高_尺寸×10_SPI 频率看懂规则能直接定位新屏该抄哪份。网络与无线案例路径解决什么问题ble_wifisamples/ble_wifiBLE 配网手机经 GATTService0xFFE0写 SSID/密码完成 2.4G 配网状态 Notify 回 JSON成功forkexeclp拉起 udhcpcsle_connectsamples/sle_connect星闪 SLE 收发基于 IOTC SDK 在 WS73 上跑 SLE常驻服务经/tmp/sle_connect.sock收 JSON 指令转发对端at_toolsamples/at_toolUSB 4G AT 工具交互式 AT 终端 一键配网CFUN→SIM→CGDCONT→NDISDUP→配 IP/路由/DNS 常驻拨号守护autoratesamples/autorate空口码率自适应Vi→VPSS→VENC 真实通路 后台 500ms 评估网络质量动态调码率/帧率/QP/GOP系统案例路径解决什么问题basesamples/base最小可烧录镜像DHCP dropbear SSH22 端口/root/hello。适合作为环境是否搭对的判定标准fastbootsamples/fastboot冷启动优化三件套SPI-NANDsquashfslzo/ SPI-NOR / eMMC 三种介质跨 GSL、U-Boot、Kernel、BSP 多层打补丁PWM 快启 30ms→5ms九、5 个 references整机级方案如果目标是做出一个像样的东西而不是跑通一个 demo直接从这五个方案改能省掉大量拼装工作。方案路径形态factory_demo / ws73_lcdreferences/factory_demo/ws73_lcd六合一整机RTSP 点播最多 2 客户端 JD9853 LCD 屏显 LVGL 9 页竖屏触摸 UI BLE 配网 ZeroClaw Agent接入 QQ/飞书/钉钉 本地 WebUI含 NPU 实时检测与 JPEG 抓拍。单进程事件驱动EventHub 事件总线 主线程环形队列 route_event()单点路由ai_table_lampreferences/ai_table_lampAI 智能台灯指尖查词 / 坐姿检测两个变体-DAPP_VARIANTFINGERTIP|POSTUREOS04D10 采集 云端 AI 火山引擎 RTC 回传 TTS 内置 codec 播报cloud_agentreferences/cloud_agent端云协同对话本地音视频经 MPP 编码上云云端返回音频流本地解码播放。provider 二选一火山 RTC / 阿里百炼 Qwen MMI-DCLOUD_AGENT_PROVIDER必须显式传offline_voice_ac_controlreferences/offline_voice_ac_control离线声控远场拾音 3AAEC/NS/AGC KWS 离线命令词全链路不联网。四层架构清晰应用 / 算法 / MPP / 驱动zeroclaw_basereferences/zeroclaw_base智能体底座为 zeroclaw 准备 BSP 环境、rootfs 镜像与 SDK patch集成拍照、SLE 星闪、全屏对话 UI、本地语音。想跑 ZeroClaw 相关能力基本都从这个镜像起步十、sensor 支持矩阵官方单目案例实测支持的 sensorSensor分辨率fpsMIPI LaneRAW场景自适应LCDSC4336P2560×144030{0,2}12bit是有OS04D10套件标配2560×144030{0,2}10bit是有CS51863840×216015{0,1,2,3}10bit否无SC450AI2688×152030{0,1}10bit是有SC500AI2880×162030{0,1}10bit是有CS5186 是 4K sensor因开发板内存限制不启用 LCD只保留录像 推流。表中 fps 是初始化帧率开启SCENE_AUTO后实际帧率会随增益与曝光时间跨exp_ltoh_thresh选档动态变化。十一、文档导航官方文档在哪官方文档经常被漏掉因为它不在板级仓而在主方案仓docs/zh-CN/下。新手入门链路按这个顺序读顺序文档路径①快速入门总览docs/zh-CN/get-started/README.md②开发板选型get-started/board-selection/board-selection.md③开发板组装get-started/board-assembly/sunniwell-cv610-dev-board-assembly.md④构建首个项目get-started/first-project/README.md⑤预编译镜像免编译Release 里的FactoryDemo_base.rar⑥FAQdocs/zh-CN/FAQ/README.md第 ④ 篇里有两个很有用的细节一是提供预编译镜像直烧与源码编译两条路只想验证板子可以不碰工具链二是给了明确的验收表——串口应打印Welcome to Linux.执行/root/hello应输出Welcome to the world of Hi3516CV610, start your exploration now!。把这两句当成环境搭对了的判定标准。关键文档全表文档路径快速入门总览docs/zh-CN/get-started/README.md构建首个项目HelloWorlddocs/zh-CN/get-started/first-project/README.md开发板组装docs/zh-CN/get-started/board-assembly/sunniwell-cv610-dev-board-assembly.md开发板使用指南硬件全表hardware/hardware-design-guide/sunniwell-cv610-dev-board.md40PIN GPIO 功能复用表hardware/other-hardware-docs/40PIN_GPIO功能复用表.xlsx芯片 PIN OUTQFNhardware/other-hardware-docs/Hi3516CV610_PINOUT_CN_(QFN).xlsxPCB 原理图 / 装配图 / DXFhardware/dev-kit/schematic|pcb-Assembly|pcb-dxf/开发环境搭建四场景hi_aiot_solution/docs/zh-CN/software-guide/environment-setup/编译构建与烧录hi_aiot_solution/docs/zh-CN/software-guide/build-and-burn.mdrepo 安装与源码下载hi_aiot_solution/docs/zh-CN/software-guide/repo-installation-and-source-download.md增量编译进文件系统hi_aiot_solution/docs/zh-CN/FAQ/develop/solution/incremental-build-filesystem.md板级 DTSbsp/dts/hi3516cv610-demb-flash.dts等LCD 适配 AI Skill.agents/skills/hi-aiot-cv610-lcd-adapter/SKILL.md十二、资料链接合集官方入口活动主页https://builderx.csdn.net/activity-site/haisi/xinghuo610开发板官方介绍页https://developers.hisilicon.com/cn/caselibrary/34/610_dev_boardHi3516CV610 芯片规格https://www.hisilicon.com/cn/products/smart-vision/public-security/ipc/hi3516cv610轻 AI 越影方案https://developers.hisilicon.com/cn/solutions/light_ai_yueyingHiSpark 论坛 · 轻 AI 越影区https://developers.hisilicon.com/forum/01101205484609485006开发板购买链接https://item.taobao.com/item.htm?fttid1072742743399skuId6299924726707代码仓库板级案例仓主https://gitcode.com/HiSpark/hi_aiot_solution_cv610_ev_board板级案例仓镜像https://atomgit.com/HiSpark/hi_aiot_solution_cv610_ev_board主方案仓SDK / 文档https://gitcode.com/HiSpark/hi_aiot_solutionmanifest 多仓入口https://gitcode.com/HiSpark/hi_aiot_solution_manifest驱动适配层https://gitcode.com/HiSpark/hi_aiot_solution_adapter端侧智能体仓https://gitcode.com/HiSpark/hi_aiot_solution_hiai官方 sample 直达单摄像头通路samples/sensor/single/README.md双摄像头通路samples/sensor/dual/README.mdAI SDK 示例NPU/SVPsamples/ai_component/README.md屏幕驱动适配集合samples/panel/README.md本地语音处理samples/local_voice_process/README.md端侧 GUI 集合samples/gui/README.md十三、上手路线建议不同目标对应不同路径别一上来就repo sync等半小时。路线 A只想确认板子是好的30 分钟烧预编译镜像 → 串口看Welcome to Linux.→ 执行/root/hello→ 网口插上跑 RTSP。全程不碰工具链。路线 B要能自己改代码出图半天搭环境见本文第二篇→ 编samples/base验证链路 → 编sensor/single看 RTSP 画面 → 改app.defconfig换 sensor 型号。路线 C要做一个完整作品从references/五个方案里挑最接近的当骨架而不是从samples/拼。factory_demo/ws73_lcd覆盖视觉 屏幕 语音 网络最全。十四、小结用三句话概括这块板算力不追求绝对值胜在集成度——AI ISP 1TOPS NPU H.265 编码 国密全塞进 QFN 9×9mm编程模型是硬件通路 控制流不是通用计算128MB DDR 决定了必须这么用官方资源给得很足——18 个 sample 覆盖视觉/语音/显示/网络5 套整机方案能当骨架文档藏在主方案仓的docs/zh-CN/下。下一篇会完整记录从零搭建编译环境的全过程包括实测耗时、产物清单和六个真实踩过的坑。本文硬件规格与案例说明整理自 CSDN 活动页、海思官网芯片/方案页、HiSpark 官方代码仓 README 及开发板使用指南文档版本 022026-08-06。文档间偶有版本差异例如芯片页标注 OpenHarmony 4.1、开发板指南标注 6.1 Release实际以到手板卡的出厂镜像与 SDK 分支为准。