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

Revision as of 10:51, 6 December 2025

怎样在Firefly板子上使用GX系列相机

1 概述

GX系列相机是为嵌入式的AI应用推出的相机，具备卓越的ISP性能，多种工作模式，丰富的功能选项，可靠的稳定性设计。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。

本文以Firefly的ROC-RK3588S-PC、ROC-RK3576-PC和ROC-RK3566-PC主板为例，介绍怎样将GX系列摄像机接入RK3566/3K3568、RK3576和RK3588S/RK3588系统。

我们提供了Linux(以Ubuntu为例)操作系统下的驱动。

1.1 支持的模组

系列	型号	状态
GX系列	GX-MIPI-IMX662	完成

1.2 支持的主板

厂家	型号	状态
Firefly	ROC-RK3588S-PC	完成
Firefly	ROC-RK3576-PC	TBD
Firefly	ROC-RK3566-PC	TBD

2 硬件准备及安装

Firefly的主板采用了30pin的连接器，而GX系列相机是22pin接口并且需要独立5V供电，因此我们设计了专用了转接排线（FFC cable）和供电线。

2.1 连接示意图

连接时，注意要断电操作，FFC排线的接触面向外。

TODO

3 github库介绍

3.1 Rockchip平台通用部分

https://github.com/veyeimaging/rk35xx_veye_bsp

包括以下主要内容：

driver
i2c通信工具集
应用层demo

国内用户可以访问gitee仓库：

https://gitee.com/veyeimaging/rk35xx_veye_bsp

3.2 Firefly主板相关部分

https://github.com/veyeimaging/rk35xx_firefly

包括以下主要内容：

dts源码和dtb文件
驱动编译指导文档

国内用户可以访问gitee仓库：

https://gitee.com/veyeimaging/rk35xx_firefly

3.3 主板烧写镜像

在github releases中，提供了编译好的linux系统镜像。

国内用户可通过百度云下载：https://pan.baidu.com/s/1LdK0n_uCx1yGej4PB8-bxg?pwd=yft9。

4 更新ubuntu系统

对于ROC-RK3566-PC、ROC-RK3576-PC 和ROC-RK3588S-PC，我们提供了发布系统的烧写镜像。

在前面所述下载路径中，找到对应主板的，支持GX系列相机产品的对应镜像。

参考Firefly文档(ROC-RK3588S-PC ROC-RK3566-PC ROC-RK3576-PC），烧写系统。

5 系统状态检测

5.1 是否正确识别到了相机

完成系统安装并在硬件上连接好相机之后，系统上电。在Firefly板端执行以下命令来检测是否正确连接相机。

$ dmesg | grep gxcam

应当有类似下面的提示：

[ 6.667547] gxcam 7-003b: veye gx series camera driver version: 01.00.02

[ 6.781681] gxcam 7-003b: camera is: GX-MIPI-IMX662

[ 6.820210] gxcam 7-003b: Success to get gxcam endpoint data lanes, dts uses 2 lanes,will set to camera

[ 6.834597] gxcam 7-003b: gxcam_enum_controls success

[ 6.891209] rockchip-csi2-dphy csi2-dphy0: dphy0 matches m00_b_gxcam 7-003b:bus type 5

分析上述提示信息，可以看到当前相机型号是GX-MIPI-IMX662。

从7-003b信息可以看到，当前相机挂载的i2c总线序号是7，i2c地址是0x3b。

在ROC-RK3588S-PC上，摄像机挂载在i2c-7；在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-06

调整了文档格式并进行适当润色。

2025-11-28

第一个版本。

@@ Line 4: / Line 4: @@
 === 概述 ===
-GX系列相机是为工业领域的AI应用推出的相机。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。它具备丰富的数据格式和触发特性，极高的带宽和可靠的稳定性。
+GX系列相机是为嵌入式的AI应用推出的相机，具备卓越的ISP性能，多种工作模式，丰富的功能选项，可靠的稳定性设计。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。
 本文以Firefly的ROC-RK3588S-PC、ROC-RK3576-PC和ROC-RK3566-PC主板为例，介绍怎样将GX系列摄像机接入RK3566/3K3568、RK3576和RK3588S/RK3588系统。
@@ Line 20: / Line 20: @@
 |完成
 |}
-=== 硬件准备及安装 ===
-GX系列相机需要使用[[ADP-MV2 Adapter Board Data Sheet/zh|ADP-MV2]]转接板才能连接到ROC-RK35xx-PC主板。
-==== 新版本ADP-MV2的连接 ====
-===== GX相机与ADP-MV2的连接 =====
+==== 支持的主板 ====
-二者使用0.5mm间距*30P的FFC异面线连接，注意接触面向外。
 {| class="wikitable"
-!TOP
+!厂家
-!BOTTOM
+!型号
+!状态
+|-
+|Firefly
+|ROC-RK3588S-PC
+|完成
+|-
+|Firefly
+|ROC-RK3576-PC
+|TBD
 |-
-|[[File:ADP-MV2-V2 to MV-MIPI-X.jpg|alt=|center|thumb|600x600px|ADP-MV2 to MV-MIPI-X]]
+|Firefly
-|[[File:ADP-MV2-V2 to MV-MIPI-X No.2.jpg|alt=|center|thumb|600x600px|ADP-MV2 to MV-MIPI-X]]
+|ROC-RK3566-PC
-|}<br />
+|TBD
+|}
+=== 硬件准备及安装 ===
+Firefly的主板采用了30pin的连接器，而GX系列相机是22pin接口并且需要独立5V供电，因此我们设计了专用了转接排线（FFC cable）和供电线。
+==== 连接示意图 ====
+连接时，注意要断电操作，FFC排线的接触面向外。
 <br />
-===== ADP-MV2与主板的连接 =====
+[[File:RK-ADP-MV2-V2-RAW-MIPI 02.jpg|alt=|center|thumb|800x800px|TODO]]
-二者使用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 />
+=== github库介绍 ===
-==== V-by-One-HS-KIT摄像机连接示意图 ====
+==== Rockchip平台通用部分 ====
-[[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源码
+*driver
 *i2c通信工具集
 *应用层demo
-此外，在[https://github.com/veyeimaging/rk356x_firefly/releases releases]中，提供了编译好的linux系统镜像。
 国内用户可以访问gitee仓库：
 https://gitee.com/veyeimaging/rk35xx_veye_bsp
+==== Firefly主板相关部分 ====
+https://github.com/veyeimaging/rk35xx_firefly
+包括以下主要内容：
+*dts源码和dtb文件
+*驱动编译指导文档
+国内用户可以访问gitee仓库：
 https://gitee.com/veyeimaging/rk35xx_firefly
+==== 主板烧写镜像 ====
+在[https://github.com/veyeimaging/rk356x_firefly/releases github releases]中，提供了编译好的linux系统镜像。
 国内用户可通过百度云下载：https://pan.baidu.com/s/1LdK0n_uCx1yGej4PB8-bxg?pwd=yft9<nowiki/>。
@@ Line 68: / Line 82: @@
 对于ROC-RK3566-PC、ROC-RK3576-PC 和ROC-RK3588S-PC，我们提供了发布系统的烧写镜像。
-下载[https://github.com/veyeimaging/rk356x_firefly/releases/ https://github.com/veyeimaging/rk35xx_firefly/releases/]中最新的支持GX系列的镜像。
+在前面所述下载路径中，找到对应主板的，支持GX系列相机产品的对应镜像。
 参考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]），烧写系统。
@@ Line 74: / Line 88: @@
 ==== 是否正确识别到了相机 ====
-完成系统安装后，系统上电。在Firefly板端执行以下命令来检测是否正确连接相机。
+完成系统安装并在硬件上连接好相机之后，系统上电。在Firefly板端执行以下命令来检测是否正确连接相机。
 <code>$ dmesg | grep gxcam</code>
@@ Line 80: / Line 94: @@
 应当有类似下面的提示：
-<code>[    6.667547] gxcam 7-003b: veye gx series camera driver version: 01.00.01</code>
+<code>[    6.667547] gxcam 7-003b: veye gx series camera driver version: 01.00.02</code>
 <code>[    6.781681] gxcam 7-003b: camera is: GX-MIPI-IMX662</code>
@@ Line 90: / Line 104: @@
 <code>[    6.891209] rockchip-csi2-dphy csi2-dphy0: dphy0 matches m00_b_gxcam 7-003b:bus type 5</code>
-可以看到识别到当前的摄像机模组的型号，版本号。
+分析上述提示信息，可以看到当前相机型号是<code>GX-MIPI-IMX662</code>。
-在ROC-RK3588S-PC上，摄像机挂载在i2c-7, i2c地址是0x3b。
+从<code>7-003b</code>信息可以看到，当前相机挂载的i2c总线序号是7，i2c地址是0x3b。
-在ROC-RK3566-PC和ROC-RK3576-PC上，摄像机挂载在i2c-4。
+在ROC-RK3588S-PC上，摄像机挂载在i2c-7；在ROC-RK3566-PC和ROC-RK3576-PC上，摄像机挂载在i2c-4。
 *执行如下命令检查video0设备节点
@@ Line 105: / Line 119: @@
 正确识别摄像头之后，相机被识别为/dev/video0。
+至此，相机的硬件安装和驱动安装已经完成，后续应用开发请参考下面的文章。
 === 相机应用开发指南 ===
 [https://wiki.veye.cc/index.php/GX_Camera_Application_Development_Guide/zh 应用开发指南]
+<br />
 === 参考资料 ===
@@ Line 119: / Line 138: @@
 https://wiki.t-firefly.com/zh_CN/ROC-RK3576-PC/
 === 本文修改记录 ===
+* 2025-12-06
+调整了文档格式并进行适当润色。
 *2025-11-28
 第一个版本。