Gx series camera appnotes 4 rpi

From wiki_veye
Revision as of 11:06, 22 December 2025 by Bluewhale (talk | contribs)
Jump to navigation Jump to search

查看中文

How to use the GX series cameras on the Raspberry board

1 overview

The GX series cameras are designed for embedded AI applications. They offer high-performance ISP capabilities, support multiple operating modes, provide a wide range of configurable features, and are built with a robust and reliable design. The cameras use the MIPI CSI-2 interface and are well suited for embedded computing platforms.

1.1 Supported modules

series model state
GX系列 GX-MIPI-IMX662 complete

1.2 Hardware Preparation and Installation

The GX-series cameras utilize a Raspberry Pi-compatible 22-pin interface but require an independent 5 V DC power supply.

1.3 The connection method of GX series cameras with 22-pin interface Raspberry Pi


1.4 The connection method between the GX series cameras and the 15-pin interface Raspberry Pi


2 Drive Installation and Verification

2.1 Download the driver package

wget https://github.com/veyeimaging/raspberrypi_v4l2/releases/latest/download/raspberrypi_v4l2.tgz

Domestic users can download it from Gitee:

https://gitee.com/veyeimaging/raspberrypi_v4l2/releases/

2.2 install the driver

tar -xzvf raspberrypi_v4l2.tgz

cd raspberrypi_v4l2/release/

chmod +x *

  • For Raspberry Pi 5

sudo ./install_driver.sh veye_gxcam

Then restart the Raspberry Pi.

Note: If it is indicated that the corresponding version of the driver cannot be found, it means that we do not provide the compiled driver program corresponding to your PiOS version. Please try to compile from the source code.

2.3 Uninstall the driver

If you want to switch to a different model of the camera module driver, you must first uninstall the current driver.
sudo ./uninstall_driver.sh veye_gxcam

2.4 System status verification

Take GX-MIPI-IMX662 as an example:
dmesg | grep gxcam

It can be seen that the camera model probed during the Linux startup stage is:

camera is: GX-MIPI-IMX662

And the /dev/video0 node exists, which proves that the camera is functioning properly.

Note: Trigger script link.

3 Detect the status and configure the environment variables

Here, we provide a script named gx_probe.sh, which is used to automatically detect the recognized camera and configure the default model, width, height, frame rate and other information of the camera into the environment variables.

The usage method is:
$ source ./gx_probe.sh i2c_bus

A typical output is as follows:

$ source ./gx_probe.sh 10

The gxcam driver is loaded on i2c-10, but the camera is not detected!

Found veye_gxcam camera on i2c-10.

Setenv CAMERAMODEL = GX-MIPI-IMX662

Setenv FPS = 60

Setenv WIDTH = 1920

Setenv HEIGHT = 1080

You can verify the output result of the environment variable by using the command echo $CAMERAMODEL. Note that this environment variable is only valid for the current session.

4 Configuration of Raspberry Pi 5