GX Camera on Firfly Boards

How to use the GX series cameras on the Firefly board

1 Overview

The GX series cameras are designed for embedded AI applications. They feature outstanding ISP performance, multiple working modes, a wide range of functional options, and reliable stability design. They use the MIPI CSI-2 interface and are particularly suitable for use in embedded computing platforms.

This article takes the Firefly's ROC-RK3588S-PC, ROC-RK3576-PC and ROC-RK3566-PC motherboards as examples to introduce how to connect the GX series cameras to the RK3566/3K3568, RK3576 and RK3588S/RK3588 systems.

We provide drivers for the Linux operating system (taking Ubuntu as an example).

1.1 Camera Module List

Series	Model	Status
GX series	GX-MIPI-IMX662	Done

1.2 Supported motherboards

manufacturers	model	status
Firefly	ROC-RK3588S-PC	accomplish
Firefly	ROC-RK3576-PC	TBD
Firefly	ROC-RK3566-PC	TBD

2 Hardware Setup

The motherboard of Firefly uses a 30-pin connector, while the GX series cameras have a 22-pin interface and require independent 5V power supply. Therefore, we have designed dedicated adapter cables (FFC cables) and power supply lines.

2.1 Connection of GX series camera and ADP-MV2

The two are connected using 0.5 mm pitch*30P FFC cable with opposite-side contacts. The cable must be inserted with the silver contacts facing outside.

TOP	BOTTOM
ADP-MV2 to MV-MIPI-X	ADP-MV2 to MV-MIPI-X

2.2 Connection of RAW-MIPI-SC132M and ADP-MV2

The two are connected using 1.0 mm pitch*15P FFC cable with opposite-side contacts. The cable must be inserted with the silver contacts facing outside.

TOP	BOTTOM
ADP-MV2 to RAW-MIPI-SC132M	ADP-MV2 to RAW-MIPI-SC132M

2.3 Connection of other RAW series camera and ADP-MV2

The two are connected using 0.5 mm pitch*pin FFC cable with opposite-side contacts. The cable must be inserted with the silver contacts facing outside.

TOP	BOTTOM
ADP-MV2 to RAW series camera	ADP-MV2 to RAW series camera

2.4 Connection with Main board using ADP-MV2

The two are connected using 0.5mm pitch * 30P FFC coaxial wires, paying attention to the direction of the contact surfaces, silver contacts facing outside on the ADP-MV2 and facing inside on the RK board.

RK to ADP-MV2 and MV cam

2.5 V-by-One-HS-KIT Camera Connection Diagram

VBYONE connection with rk3588

3 Introduction to the GitHub Library

3.1 General part of the Rockchip platform

https://github.com/veyeimaging/rk35xx_veye_bsp

includes：

driver source code
i2c toolkits
application demo

Domestic users can access the Gitee repository:

https://gitee.com/veyeimaging/rk35xx_veye_bsp

3.2 Firefly motherboard-related sections

https://github.com/veyeimaging/rk35xx_firefly

Including the following main contents:

DTS source code and DTB files
Driver compilation guidance document

Domestic users can access the Gitee repository:

https://gitee.com/veyeimaging/rk35xx_firefly

3.3 Board firmware image writing

In the GitHub releases, a pre-compiled Linux system image is provided.

Domestic users can download it through Baidu Cloud:https://pan.baidu.com/s/1LdK0n_uCx1yGej4PB8-bxg?pwd=yft9。

4 Upgrade Firefly Ubuntu system

For ROC-RK3566-PC, ROC-RK3576-PC and ROC-RK3588S-PC, we have provided the flashing images for the release system.

In the download path mentioned earlier, locate the corresponding image for the motherboard that supports the GX series camera products.

Refer to the Firefly documentation (ROC-RK3588S-PC ROC-RK3566-PC ROC-RK3576-PC） , and write the system.

5 Check system status

5.1 Whether the camera is correctly recognized

After completing the system installation and connecting the camera to the hardware, the system is powered on. Execute the following command on the Firefly board to check if the camera is connected correctly.

$ dmesg | grep gxcam

There should be similar prompts like the following:

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

[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

By analyzing the above prompt information, it can be seen that the current camera model is GX-MIPI-IMX662.

From the 7-003b information, it can be seen that the current i2c bus number of the camera is 7 and the i2c address is 0x3b.

On ROC-RK3588S-PC, the camera is mounted on i2c-7; on ROC-RK3566-PC and ROC-RK3576-PC, the camera is mounted on i2c-4.

Check the video0 device node:

ls /dev/video0

You should see:

video0

After correctly identifying the camera, the camera is recognized as /dev/video0.

At this point, the hardware installation of the camera and the driver installation have been completed. For subsequent application development, please refer to the following article.

6 Camera Application Development Guide

Application Development Guide

7 References

ROC-RK3566-PC Manual

https://wiki.t-firefly.com/en/ROC-RK3566-PC/

ROC-RK3588S-PC Manual

https://wiki.t-firefly.com/en/ROC-RK3588S-PC/

ROC-RK3576-PC Manual

https://wiki.t-firefly.com/en/ROC-RK3576-PC/

Firefly Linux User Guide

https://wiki.t-firefly.com/en/Firefly-Linux-Guide/index.html

8 Document History

2025-12-06

The document format was adjusted and it was appropriately revised.

2025-11-28

The first version.