Difference between revisions of "MV Camera on Firfly Boards/zh"

From wiki_veye
Jump to navigation Jump to search
(Created page with "English")
 
 
(59 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[MV Camera on Firfly Boards|English]]
 
[[MV Camera on Firfly Boards|English]]
 +
 +
'''<big>怎样在Firefly板子上使用MV系列和RAW系列相机</big>'''
 +
 +
===概述===
 +
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为例)操作系统下的驱动。
 +
 +
====支持的模组====
 +
{| class="wikitable"
 +
!系列
 +
!型号
 +
!状态
 +
|-
 +
|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连接模式的驱动。
 +
 +
===硬件准备及安装===
 +
MV系列和RAW系列相机需要使用[[ADP-MV2 Adapter Board Data Sheet/zh|ADP-MV2]]转接板才能连接到ROC-RK35xx-PC主板。
 +
 +
====新版本ADP-MV2的连接====
 +
 +
=====MV相机与ADP-MV2的连接=====
 +
二者使用0.5mm间距*30P的FFC异面线连接,注意接触面向外。
 +
{| class="wikitable"
 +
!TOP
 +
!BOTTOM
 +
|-
 +
|[[File:ADP-MV2-V2 to MV-MIPI-X.jpg|alt=|center|thumb|600x600px|ADP-MV2 to MV-MIPI-X]]
 +
|[[File:ADP-MV2-V2 to MV-MIPI-X No.2.jpg|alt=|center|thumb|600x600px|ADP-MV2 to MV-MIPI-X]]
 +
|}<br />
 +
 +
=====RAW-MIPI-SC132M与ADP-MV2的连接=====
 +
二者使用1.0mm间距*15P的FFC异面线连接,注意接触面向外。
 +
{| class="wikitable"
 +
!TOP
 +
!BOTTOM
 +
|-
 +
|[[File:ADP-MV2 to RAW-MIPI-SC132M.jpg|alt=|center|thumb|600x600px|ADP-MV2 to RAW-MIPI-SC132M ]]
 +
|[[File:ADP-MV2 to RAW-MIPI-SC132M No.2.jpg|alt=ADP-MV2 to RAW-MIPI-SC132M|center|thumb|600x600px|ADP-MV2 to RAW-MIPI-SC132M]]
 +
|}
 +
=====其他RAW系列摄像头与ADP-MV2的连接=====
 +
二者使用0.5mm间距*22P的FFC异面线连接,注意接触面向外。
 +
{| class="wikitable"
 +
!TOP
 +
!BOTTOM
 +
|-
 +
|[[File:ADP-MV2 to RAW series camera.jpg|alt=|center|thumb|600x600px|ADP-MV2 to RAW series camera]]
 +
|[[File:ADP-MV2 to RAW series camera No.2.jpg|alt=ADP-MV2 to RAW series camera No.2|center|thumb|600x600px|ADP-MV2 to RAW series camera]]
 +
|}
 +
<br />
 +
=====ADP-MV2与主板的连接=====
 +
二者使用0.5mm间距*30P的FFC同面线连接,注意接触面方向,ADP-MV2上向外,RK board上向内。
 +
[[File:RK-ADP-MV2-V2-RAW-MIPI 02.jpg|alt=|center|thumb|800x800px|RK to ADP-MV2 and MV cam]]
 +
<br />
 +
 +
====V-by-One-HS-KIT摄像机连接示意图====
 +
[[File:VBYONE connection with rk3588.jpg|center|thumb|800x800px|VBYONE connection with rk3588]]
 +
<br />
 +
===github库介绍===
 +
https://github.com/veyeimaging/rk35xx_veye_bsp
 +
 +
https://github.com/veyeimaging/rk35xx_firefly
 +
 +
包括以下主要内容:
 +
 +
*driver和dts源码
 +
*i2c通信工具集
 +
*应用层demo
 +
 +
此外,在[https://github.com/veyeimaging/rk356x_firefly/releases 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<nowiki/>。
 +
 +
===更新ubuntu系统===
 +
对于ROC-RK3566-PC、ROC-RK3576-PC 和ROC-RK3588S-PC,我们提供了发布系统的烧写镜像。
 +
 +
下载[https://github.com/veyeimaging/rk356x_firefly/releases/ https://github.com/veyeimaging/rk35xx_firefly/releases/]中最新的支持MV和RAW系列的镜像。
 +
 +
参考Firefly文档([https://wiki.t-firefly.com/en/ROC-RK3588S-PC/upgrade_bootmode.html ROC-RK3588S-PC] [https://wiki.t-firefly.com/en/ROC-RK3566-PC/03-upgrade_firmware.html ROC-RK3566-PC] [https://wiki.t-firefly.com/en/ROC-RK3576-PC/upgrade_bootmode.html ROC-RK3576-PC]),烧写系统。
 +
===系统状态检测===
 +
 +
====是否正确识别到了相机====
 +
完成系统安装后,系统上电。在Firefly板端执行以下命令来检测是否正确连接相机。
 +
 +
<code>dmesg | grep mvcam</code>
 +
 +
应当有类似下面的提示:
 +
 +
<code>mvcam 7-003b: camera is:MV-MIPI-IMX296M</code>
 +
 +
<code>mvcam 7-003b: firmware version: 0x1290133</code>
 +
 +
可以看到识别到当前的摄像机模组的型号,版本号。
 +
 +
在ROC-RK3588S-PC上,摄像机挂载在i2c-7, i2c地址是0x3b。
 +
 +
在ROC-RK3566-PC和ROC-RK3576-PC上,摄像机挂载在i2c-4。
 +
 +
*执行如下命令检查video0设备节点
 +
 +
<code>ls /dev/video0</code>
 +
 +
可以看到
 +
 +
<code>video0</code>
 +
 +
正确识别摄像头之后,相机被识别为/dev/video0。
 +
 +
===相机应用开发指南===
 +
[[MV Camera Application Development Guide on Rochchip/zh|应用开发指南]]
 +
===参考资料===
 +
 +
*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/
 +
===本文修改记录===
 +
 +
* 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
 +
 +
第一个版本。

Latest revision as of 14:39, 26 December 2025

English

怎样在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
ADP-MV2 to MV-MIPI-X
ADP-MV2 to MV-MIPI-X


2.1.2 RAW-MIPI-SC132M与ADP-MV2的连接

二者使用1.0mm间距*15P的FFC异面线连接,注意接触面向外。

TOP BOTTOM
ADP-MV2 to RAW-MIPI-SC132M
ADP-MV2 to RAW-MIPI-SC132M
ADP-MV2 to RAW-MIPI-SC132M
2.1.3 其他RAW系列摄像头与ADP-MV2的连接

二者使用0.5mm间距*22P的FFC异面线连接,注意接触面向外。

TOP BOTTOM
ADP-MV2 to RAW series camera
ADP-MV2 to RAW series camera No.2
ADP-MV2 to RAW series camera


2.1.4 ADP-MV2与主板的连接

二者使用0.5mm间距*30P的FFC同面线连接,注意接触面方向,ADP-MV2上向外,RK board上向内。

RK to ADP-MV2 and MV cam


2.2 V-by-One-HS-KIT摄像机连接示意图

VBYONE connection with rk3588


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

第一个版本。