MV Camera on Firfly Boards/zh
怎样在Firefly板子上使用MV系列和RAW系列相机
1 概述
MV系列和RAW系列相机是为工业领域的AI应用推出的相机。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。它具备丰富的数据格式和触发特性，极低的延时，极高的带宽和可靠的稳定性。
本文以Firefly的ROC-RK3588S-PC、ROC-RK3576-PC和ROC-RK3566-PC主板为例，介绍怎样将MV和RAW系列摄像机接入RK3566/3K3568、RK3576和RK3588S/RK3588系统。
我们提供了Linux(以Ubuntu为例)操作系统下的驱动。
1.1 支持的模组
| 系列 | 型号 | 状态 |
|---|---|---|
| MV系列 | MV-MIPI-IMX178M | 完成 |
| MV系列 | MV-MIPI-SC130M | 完成 |
| MV系列 | MV-MIPI-IMX287M | 完成 |
| MV系列 | MV-MIPI-IMX296M | 完成 |
| MV系列 | MV-MIPI-IMX265M | 完成 |
| MV系列 | MV-MIPI-IMX264M | 完成 |
| MV系列 | MV-MIPI-GMAX4002M | 完成 |
| RAW系列 | RAW-MIPI-SC132M | 完成 |
| RAW系列 | RAW-MIPI-IMX462M | 完成 |
| RAW系列 | RAW-MIPI-AR0234M | 完成 |
| RAW系列 | RAW-MIPI-SC535M | 完成 |
此外，在ubuntu系统下，已经调通V-by-One HS连接模式的驱动。
2 硬件准备及安装
MV系列和RAW系列相机需要使用ADP-MV2转接板才能连接到ROC-RK35xx-PC主板。
2.1 新版本ADP-MV2的连接
2.1.1 MV相机与ADP-MV2的连接
二者使用0.5mm间距*30P的FFC异面线连接，注意接触面向外。
| TOP | BOTTOM |
|---|---|
2.1.2 RAW-MIPI-SC132M与ADP-MV2的连接
二者使用1.0mm间距*15P的FFC异面线连接，注意接触面向外。
| TOP | BOTTOM |
|---|---|
2.1.3 其他RAW系列摄像头与ADP-MV2的连接
二者使用0.5mm间距*22P的FFC异面线连接，注意接触面向外。
| TOP | BOTTOM |
|---|---|
2.1.4 ADP-MV2与主板的连接
二者使用0.5mm间距*30P的FFC同面线连接，注意接触面方向，ADP-MV2上向外，RK board上向内。
2.2 V-by-One-HS-KIT摄像机连接示意图
3 github库介绍
https://github.com/veyeimaging/rk35xx_veye_bsp
https://github.com/veyeimaging/rk35xx_firefly
包括以下主要内容：
- driver和dts源码
- i2c通信工具集
- 应用层demo
此外，在releases中，提供了编译好的linux系统镜像。
国内用户可以访问gitee仓库：
https://gitee.com/veyeimaging/rk35xx_veye_bsp
https://gitee.com/veyeimaging/rk35xx_firefly
国内用户可通过百度云下载：https://pan.baidu.com/s/1LdK0n_uCx1yGej4PB8-bxg?pwd=yft9。
4 更新ubuntu系统
对于ROC-RK3566-PC、ROC-RK3576-PC 和ROC-RK3588S-PC，我们提供了发布系统的烧写镜像。
下载https://github.com/veyeimaging/rk35xx_firefly/releases/中最新的支持MV和RAW系列的镜像。
参考Firefly文档(ROC-RK3588S-PC ROC-RK3566-PC ROC-RK3576-PC），烧写系统。
5 系统状态检测
5.1 是否正确识别到了相机
完成系统安装后，系统上电。在Firefly板端执行以下命令来检测是否正确连接相机。
dmesg | grep mvcam
应当有类似下面的提示：
mvcam 7-003b: camera is：MV-MIPI-IMX296M
mvcam 7-003b: firmware version: 0x1290133
可以看到识别到当前的摄像机模组的型号，版本号。
在ROC-RK3588S-PC上，摄像机挂载在i2c-7, i2c地址是0x3b。
在ROC-RK3566-PC和ROC-RK3576-PC上，摄像机挂载在i2c-4。
- 执行如下命令检查video0设备节点
ls /dev/video0
可以看到
video0
正确识别摄像头之后，相机被识别为/dev/video0。
6 相机应用开发指南
7 参考资料
- ROC-RK3588S-PC 手册
https://wiki.t-firefly.com/zh_CN/ROC-RK3588S-PC/
- ROC-RK3576-PC 手册
https://wiki.t-firefly.com/zh_CN/ROC-RK3576-PC/
8 本文修改记录
- 2025-12-26
增加应用开发指南篇章
- 2025-04-14
增加支持RK3576。
- 2025-03-23
增加mv_probe.sh的说明。
- 2024-07-09
支持RAW-MIPI-SC535M。
- 2024-04-17
支持 RK3566。
- 2024-03-10
增加新版本ADP-MV2的硬件连接的图片和说明。
- 2023-08-30
增加对RAW-MIPI-IMX462M和RAW-MIPI-AR0234M的支持。
- 2023-07-31
在ubuntu系统下，已经调通V-by-One连接的驱动。
- 2023-04-12
第一个版本。