GX Camera on Firfly Boards/zh
怎样在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排线的接触面向外。
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
第一个版本。