Difference between revisions of "GX Camera on Firfly Boards"
| Line 1: | Line 1: | ||
[https://wiki.veye.cc/index.php/GX_Camera_on_Firfly_Boards/zh 查看中文] | [https://wiki.veye.cc/index.php/GX_Camera_on_Firfly_Boards/zh 查看中文] | ||
| − | How to use the GX series cameras on the Firefly board | + | '''<big>How to use the GX series cameras on the Firefly board</big>''' |
| − | === Overview === | + | ===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. | 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. | ||
| Line 10: | Line 10: | ||
We provide drivers for the Linux operating system (taking Ubuntu as an example). | We provide drivers for the Linux operating system (taking Ubuntu as an example). | ||
| − | ==== Camera Module List ==== | + | ====Camera Module List==== |
{| class="wikitable" | {| class="wikitable" | ||
!Series | !Series | ||
| Line 21: | Line 21: | ||
|} | |} | ||
| − | ==== Supported motherboards ==== | + | ====Supported motherboards==== |
{| class="wikitable" | {| class="wikitable" | ||
!manufacturers | !manufacturers | ||
| Line 40: | Line 40: | ||
|} | |} | ||
| − | === Hardware Setup === | + | ===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. | 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. | ||
| Line 53: | Line 53: | ||
|} | |} | ||
| − | ===== Connection of RAW-MIPI-SC132M and ADP-MV2 ===== | + | =====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. | 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. | ||
{| class="wikitable" | {| class="wikitable" | ||
| − | ! TOP | + | !TOP |
!BOTTOM | !BOTTOM | ||
|- | |- | ||
| Line 62: | Line 62: | ||
|[[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|link=http://wiki.veye.cc/index.php/File:ADP-MV2_to_RAW-MIPI-SC132M_No.2.jpg]] | |[[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|link=http://wiki.veye.cc/index.php/File:ADP-MV2_to_RAW-MIPI-SC132M_No.2.jpg]] | ||
|} | |} | ||
| − | ===== Connection of other RAW series camera and ADP-MV2 ===== | + | =====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. | 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. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 75: | Line 75: | ||
<br />[[File:RK-ADP-MV2-V2-RAW-MIPI 02.jpg|alt=|center|thumb|800x800px|RK to ADP-MV2 and MV cam|link=http://wiki.veye.cc/index.php/File:RK-ADP-MV2-V2-RAW-MIPI_02.jpg]] | <br />[[File:RK-ADP-MV2-V2-RAW-MIPI 02.jpg|alt=|center|thumb|800x800px|RK to ADP-MV2 and MV cam|link=http://wiki.veye.cc/index.php/File:RK-ADP-MV2-V2-RAW-MIPI_02.jpg]] | ||
| − | ==== V-by-One-HS-KIT Camera Connection Diagram ==== | + | ====V-by-One-HS-KIT Camera Connection Diagram==== |
[[File:VBYONE connection with rk3588.jpg|center|thumb|800x800px|VBYONE connection with rk3588]] | [[File:VBYONE connection with rk3588.jpg|center|thumb|800x800px|VBYONE connection with rk3588]] | ||
| − | === Introduction to the GitHub Library === | + | ===Introduction to the GitHub Library=== |
====General part of the Rockchip platform==== | ====General part of the Rockchip platform==== | ||
| Line 93: | Line 93: | ||
https://gitee.com/veyeimaging/rk35xx_veye_bsp | https://gitee.com/veyeimaging/rk35xx_veye_bsp | ||
| − | ==== Firefly motherboard-related sections ==== | + | ====Firefly motherboard-related sections==== |
<nowiki>https://github.com/veyeimaging/rk35xx_firefly</nowiki> | <nowiki>https://github.com/veyeimaging/rk35xx_firefly</nowiki> | ||
Including the following main contents: | Including the following main contents: | ||
| − | * DTS source code and DTB files | + | *DTS source code and DTB files |
| − | * Driver compilation guidance document | + | *Driver compilation guidance document |
Domestic users can access the Gitee repository: | Domestic users can access the Gitee repository: | ||
| Line 105: | Line 105: | ||
<nowiki>https://gitee.com/veyeimaging/rk35xx_firefly</nowiki> | <nowiki>https://gitee.com/veyeimaging/rk35xx_firefly</nowiki> | ||
| − | ==== Board firmware image writing ==== | + | ====Board firmware image writing==== |
In the GitHub releases, a pre-compiled Linux system image is provided. | 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。 | Domestic users can download it through Baidu Cloud:https://pan.baidu.com/s/1LdK0n_uCx1yGej4PB8-bxg?pwd=yft9。 | ||
| − | === Upgrade Firefly Ubuntu system === | + | ===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. | For ROC-RK3566-PC, ROC-RK3576-PC and ROC-RK3588S-PC, we have provided the flashing images for the release system. | ||
| Line 119: | Line 119: | ||
===Check system status=== | ===Check system status=== | ||
| − | ==== Whether the camera is correctly recognized ==== | + | ====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. | 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. | ||
| Line 142: | Line 142: | ||
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. | 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: | + | *Check the video0 device node: |
<code>ls /dev/video0</code> | <code>ls /dev/video0</code> | ||
| Line 154: | Line 154: | ||
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. | 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. | ||
| − | === Camera Application Development Guide === | + | ===Camera Application Development Guide=== |
Application Development Guide | Application Development Guide | ||
| Line 176: | Line 176: | ||
===Document History=== | ===Document History=== | ||
| − | * 2025-12-06 | + | *2025-12-06 |
The document format was adjusted and it was appropriately revised. | The document format was adjusted and it was appropriately revised. | ||
| − | * 2025-11-28 | + | *2025-11-28 |
The first version. | The first version. | ||
<br /> | <br /> | ||
Revision as of 11:02, 20 December 2025
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|
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.
2.5 V-by-One-HS-KIT Camera Connection Diagram
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
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.