GX Camera on Radxa Boards/zh

English

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

1 概述

GX系列相机是为工业领域的AI应用推出的相机。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。它具备丰富的数据格式和触发特性，极低的延时，极高的带宽和可靠的稳定性。

本文以Radxa的ZERO 3W/3E主板为例，介绍怎样将GX系列摄像机接入RK3566/3K3568系统。

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

1.1 支持的模组

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

2 硬件准备及安装

2.1 GX-MIPI-IMX662与Radxa ZERO 3W/3E的连接

二者使用22P的FFC异面线连接，注意接触面向外。

Radxa Zero 3W/3E connect to GX series camera

3 github库介绍

https://github.com/veyeimaging/rk35xx_radxa

包括以下主要内容：

• driver和dts源码
• i2c通信工具集
• 应用层demo

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

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

https://gitee.com/veyeimaging/rk35xx_radxa

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

4 更新主板的Radxa Debain系统

4.1 概述

本章节描述怎样更新RK356x系统以支持我们的摄像头模组。我们提供了deb安装包，可以直接安装。

4.2 烧写Radxa官方标准系统

参考Radxa文档，烧写标准系统。

我们现在发布的安装包，基于这个烧写镜像版本制作。

4.3 使用编译好的debain安装包

在RK35xx板子上，执行:

下载https://github.com/veyeimaging/rk35xx_radxa/releases中最新的rk356x_radxa_zero3w.tar.gz或rk356x_radxa_zero3e.tar.gz。

tar -xavf rk356x_radxa_zero3w.tar.gz

cd rk356x_radxa_zero3w_gxmcam

sudo dpkg -i linux-headers-5.10.160-39-rk356x_5.10.160-39_arm64-gxcam.deb sudo dpkg -i linux-image-5.10.160-39-rk356x_5.10.160-39_arm64-gxcam.deb sudo reboot

如果版本不匹配，需要从源代码进行编译。

5 系统状态检测

5.1 是否正确识别到了相机

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

dmesg | grep gxcam

应当有类似下面的提示：

gxcam 2-003b: camera is：GX-MIPI-IMX662

gxcam 2-003b: firmware version: 0x1290133

可以看到识别到当前的摄像机模组的型号，版本号。

正确识别摄像头之后，MIPI-CSI2接口的摄像头识别为/dev/video0。对于Radxa zero 3W/3E，相机挂载在i2c-2。

• 执行如下命令检查video0设备节点

ls /dev/video0

可以看到

video0

正确识别摄像头之后，相机被识别为/dev/video0。

6 相机应用开发指南

应用开发指南

7 从源码编译驱动和dtb

• RK356x

https://github.com/veyeimaging/rk35xx_radxa/tree/main/linux/drivers/rk356x

8 参考资料

• Radxa Zero 3W/3E Manual

https://docs.radxa.com/zero/zero3

• BSP toolkit

https://radxa-repo.github.io/bsp/

9 本文修改记录

• 2025-12-29

发布第一个版本。