Difference between revisions of "GX mipi camera manual"

From wiki_veye
Jump to navigation Jump to search
Line 148: Line 148:
  
 
'''Script Function:''' <code>i2caddr</code>
 
'''Script Function:''' <code>i2caddr</code>
 +
 +
=== Image Acquisition ===
 +
 +
==== Rolling Shutter and Global Shutter ====
 +
Image sensors can be classified into two types based on their exposure method: rolling shutter and global shutter.
 +
 +
Different exposure methods behave differently when capturing moving objects or operating in triggered modes.
 +
 +
===== Rolling Shutter =====
 +
The operation of a rolling shutter sensor is illustrated in the following figure.
 +
 +
In this mode, the rows of the image start exposure sequentially:
 +
 +
* The first row begins exposure first.
 +
* After one row period, the second row starts exposure.
 +
* This process continues, with the Nth row starting exposure immediately after the (N−1)th row.
 +
 +
Once the first row finishes exposure, data readout begins. Reading each row of data takes one row period, including the row blanking time.
 +
 +
When the first row has been read out, the second row begins reading. Subsequent rows are read sequentially until the entire image is output.
 +
 +
Rolling shutter sensors have the following characteristics:
 +
 +
* Relatively simple structure
 +
* Lower cost
 +
* Capable of achieving high resolution
 +
 +
Therefore, rolling shutter is suitable for imaging applications involving static scenes or slowly moving targets.[[File:Rolling shutter mode new.png|alt=Rolling shutter mode|center|thumb|800x800px|Rolling shutter mode|link=http://wiki.veye.cc/index.php/File:Rolling_shutter_mode_new.png]]
 +
 +
===== Global Shutter =====
 +
The operation of a global shutter sensor is illustrated in the following figure.
 +
 +
In global shutter mode:
 +
 +
* All pixels on the sensor begin exposure simultaneously.
 +
* All pixels end exposure simultaneously.
 +
 +
After the exposure ends, the sensor transfers the charges from the photosensitive area to the storage area, and then reads out pixel data row by row.
 +
 +
This method ensures that:
 +
 +
* All pixels are sampled at the same time.
 +
* The image is free from motion distortion.
 +
 +
Therefore, global shutter is particularly suitable for capturing fast-moving targets, such as:
 +
 +
* Industrial inspection
 +
* Robotic vision
 +
* Motion tracking
 +
 +
[[File:Global shutter mode new.png|alt=|center|thumb|800x800px|Global shutter mode|link=http://wiki.veye.cc/index.php/File:Global_shutter_mode_new.png]]
 +
 +
==== Start/Stop Acquisition ====
 +
Users can send a '''start acquisition''' or '''stop acquisition''' command to the camera at any time.
 +
 +
When the camera receives a start acquisition command:
 +
 +
* If it is currently operating in '''video streaming mode''', the camera will immediately begin exposure and continuously output images.
 +
* If it is currently operating in '''trigger mode''', the camera will enter a '''waiting for trigger signal''' state.
 +
 +
At this point, the camera status changes to '''Running'''.
 +
 +
When the camera receives a stop acquisition command:
 +
 +
# The camera will first complete the transmission of the current image frame to ensure frame data integrity.
 +
# Then it will stop outputting images.
 +
# The camera status changes to '''Standby'''.
 +
 +
'''Note:'''
 +
 +
If the current configuration is '''multi-frame trigger mode''' and the trigger sequence is not yet complete, the stop acquisition command will interrupt the ongoing trigger process. Therefore, stopping acquisition only guarantees the integrity of the current frame, but does not guarantee the integrity of the entire trigger sequence.
 +
 +
In general, the driver automatically sends start/stop acquisition commands, so users do not need to manually control the registers.
 +
 +
'''Script function:''' <code>imgacq</code>
 +
 +
'''Video Mode'''
 +
 +
The GX series cameras support multiple video modes, with each mode corresponding to a specific resolution, maximum frame rate, and image readout method.
 +
 +
Readout methods include '''Normal Mode''', '''Binning Mode''', and '''Subsampling Mode'''. In video streaming mode, the camera continuously exposes images and outputs image data in real time according to the resolution, frame rate, and readout method of the selected video mode.
 +
 +
The supported image modes may vary depending on the camera model. Details are provided in the table below:
 +
{| class="wikitable"
 +
!Model
 +
!videomode
 +
!Resolution
 +
!Minimum Frame Rate
 +
!Maximum Frame Rate
 +
!Readout Method
 +
|-
 +
|GX-MIPI-IMX662
 +
|1
 +
|1920×1080
 +
|0.065fps
 +
|60fps
 +
|Normal
 +
|-
 +
| rowspan="2" |GX-MIPI-IMX664
 +
|1
 +
|2688×1520
 +
|TBD
 +
|30fps
 +
|Normal
 +
|-
 +
|2
 +
|1344x760
 +
|TBD
 +
|100fps
 +
|Binning
 +
|-
 +
| rowspan="3" |GX-MIPI-AR0234
 +
|1
 +
|1920×1200
 +
|TBD
 +
|54 fps
 +
|Normal
 +
|-
 +
|2
 +
|1920×1080
 +
|TBD
 +
|60fps
 +
|Normal
 +
|-
 +
|3
 +
|1600×1200
 +
|TBD
 +
|60fps
 +
|Normal
 +
|}
 +
'''Script function''':videomodecap,videomodenum, vidoemodewh1-vidoemodewh8,videomodeparam1-videomodeparam8,videomode,fps,maxfps, curwh.
 +
 +
==== '''Pixel Readout Modes''' ====
 +
The GX series cameras support multiple pixel readout modes: '''Normal Mode''', '''Binning Mode''', and '''Subsampling Mode'''. Each mode has different characteristics in terms of resolution, signal-to-noise ratio (SNR), and data bandwidth, and can be selected according to application requirements.
 +
 +
===== Normal Mode =====
 +
The sensor reads out the full pixel array row by row, with every pixel participating in acquisition and output. This mode provides the highest resolution and best image detail, but requires higher data bandwidth.
 +
 +
===== Binning Mode =====
 +
Adjacent pixels are combined internally on the sensor before output, improving SNR and low-light performance while reducing resolution and data bandwidth. This mode is suitable for low-light or high-sensitivity applications.
 +
 +
===== Subsampling Mode =====
 +
Pixels are read out at fixed intervals, reducing resolution and data volume while keeping SNR largely unchanged. This mode is suitable for scenarios that require higher frame rates or lower bandwidth.
 +
 +
===== Mode Comparison =====
 +
{| class="wikitable"
 +
!Mode
 +
! '''Readout Method'''
 +
!'''Resolution'''
 +
!'''SNR'''
 +
!'''Data Bandwidth'''
 +
|-
 +
|Normal
 +
|Full Pixel Readout
 +
|High
 +
|Baseline
 +
|High
 +
|-
 +
|Binning
 +
|Pixel Binning
 +
|Medium
 +
|Improved
 +
|Low
 +
|-
 +
|Subsampling
 +
|Interval
 +
|Medium
 +
|Largely Unchanged
 +
|Low
 +
|}<br />

Revision as of 10:05, 10 March 2026

查看中文

GX Series MIPI Camera Module Manual

1 Overview

The GX series camera modules feature a high-performance ISP (Image Signal Processor), supporting multiple operating modes and providing extensive configuration options. The products have been thoroughly validated in terms of system stability, manufacturing quality control, and supply capability, making them suitable for embedded vision systems and AI vision applications.

GX series MIPI camera modules use a standard 22-pin FPC user interface, which simplifies system integration. They can be directly connected to a variety of mainstream embedded platforms, such as platforms based on Raspberry Pi Ltd, NVIDIA Jetson series, and the Rockchip RK3588 platform.

This document mainly introduces the functional features and working principles of the GX series products.

For the following topics, please refer to the corresponding dedicated documentation:

  • Hardware Interface Manual
  • Register Description Document
  • Configuration Script Guide
  • Driver and User Guides for each embedded platform

In this document, each functional section includes a [Script Function] column. This column lists the relevant commands of the gx_mipi_i2c.sh script to help users configure and debug specific features conveniently.

1.1 Camera Model List

Series Model Max Resolution Shutter Mode
GX series GX-MIPI-IMX662 1920×1080@60 fps Rolling Shutter
GX series GX-MIPI-IMX664 2688×1520@30 fps Rolling Shutter
GX series GX-MIPI-AR0234 1920×1200@54 fps Golbal Shutter

2 Basic Functions

This chapter introduces the basic management functions of the camera, including device information access, parameter management, and system control.

Through these registers, users can obtain device identification information, manage camera configuration parameters, and perform system-level operations.

2.1 Device Information

The camera provides several read-only registers for querying basic device information. These parameters can be used for device identification, system management, and software debugging.

The information includes:

  • Manufacturer name
  • Product model
  • Sensor model
  • Device serial number
  • Firmware version
2.1.1 Manufacturer Name

The name of the camera manufacturer.

Script Function: manufacturer

2.1.2 Product Model

The model identifier of the camera.

Script Function: model

2.1.3 Sensor Model

The image sensor model used by the camera.

Script Function: sensorname

2.1.4 Serial Number

Each camera is assigned a unique serial number during manufacturing.

The serial number contains information about the production date, batch, and unit number.

Script Function: serialno

2.1.5 Firmware Version

Returns the firmware version information of the camera.

This register is a 32-bit value in the format:

Where:

  • AA.BB represents the control firmware version (C version)
  • CC.DD represents the logic firmware version (L version)

2.2 Parameter Management

The camera supports saving the current configuration parameters to internal Flash memory.

Saved parameters are automatically loaded when the camera powers on.

2.2.1 Save Parameters

Saves the current camera configuration parameters to Flash.

Notes:

  • This operation erases and rewrites the system Flash memory
  • The power supply must remain stable during the operation
  • Frequent execution of this operation is not recommended

Script Function: paramsave

2.2.2 Restore Factory Parameters

Restores all camera parameters to the factory default configuration.

Notes:

  • This operation erases and rewrites the system Flash memory
  • The power supply must remain stable during the operation
  • Frequent factory resets are not recommended

Script Function: factoryparam

2.3 System Control

The camera provides several basic system control functions, such as device reboot and system uptime query.

2.3.1 System Reboot

Executing this operation will restart the camera.

Script Function: reboot

2.3.2 System Timestamp

The elapsed running time since the camera was powered on.

This parameter can be used for:

  • System debugging
  • Device uptime statistics
  • Simple synchronization reference

Script Function: timestamp

2.3.3 I²C Address Configuration

The camera allows the I²C communication address to be configured through a register.

Users can modify the camera's I²C address according to system requirements to avoid address conflicts in multi-device systems.

Configuration details:

  • Configurable address range: 0x08 – 0x77
  • After modification, the Save Parameters operation must be executed
  • The new address takes effect after the device is rebooted

Script Function: i2caddr

3 Image Acquisition

3.1 Rolling Shutter and Global Shutter

Image sensors can be classified into two types based on their exposure method: rolling shutter and global shutter.

Different exposure methods behave differently when capturing moving objects or operating in triggered modes.

3.1.1 Rolling Shutter

The operation of a rolling shutter sensor is illustrated in the following figure.

In this mode, the rows of the image start exposure sequentially:

  • The first row begins exposure first.
  • After one row period, the second row starts exposure.
  • This process continues, with the Nth row starting exposure immediately after the (N−1)th row.

Once the first row finishes exposure, data readout begins. Reading each row of data takes one row period, including the row blanking time.

When the first row has been read out, the second row begins reading. Subsequent rows are read sequentially until the entire image is output.

Rolling shutter sensors have the following characteristics:

  • Relatively simple structure
  • Lower cost
  • Capable of achieving high resolution

Therefore, rolling shutter is suitable for imaging applications involving static scenes or slowly moving targets.

Rolling shutter mode
Rolling shutter mode
3.1.2 Global Shutter

The operation of a global shutter sensor is illustrated in the following figure.

In global shutter mode:

  • All pixels on the sensor begin exposure simultaneously.
  • All pixels end exposure simultaneously.

After the exposure ends, the sensor transfers the charges from the photosensitive area to the storage area, and then reads out pixel data row by row.

This method ensures that:

  • All pixels are sampled at the same time.
  • The image is free from motion distortion.

Therefore, global shutter is particularly suitable for capturing fast-moving targets, such as:

  • Industrial inspection
  • Robotic vision
  • Motion tracking
Global shutter mode

3.2 Start/Stop Acquisition

Users can send a start acquisition or stop acquisition command to the camera at any time.

When the camera receives a start acquisition command:

  • If it is currently operating in video streaming mode, the camera will immediately begin exposure and continuously output images.
  • If it is currently operating in trigger mode, the camera will enter a waiting for trigger signal state.

At this point, the camera status changes to Running.

When the camera receives a stop acquisition command:

  1. The camera will first complete the transmission of the current image frame to ensure frame data integrity.
  2. Then it will stop outputting images.
  3. The camera status changes to Standby.

Note:

If the current configuration is multi-frame trigger mode and the trigger sequence is not yet complete, the stop acquisition command will interrupt the ongoing trigger process. Therefore, stopping acquisition only guarantees the integrity of the current frame, but does not guarantee the integrity of the entire trigger sequence.

In general, the driver automatically sends start/stop acquisition commands, so users do not need to manually control the registers.

Script function: imgacq

Video Mode

The GX series cameras support multiple video modes, with each mode corresponding to a specific resolution, maximum frame rate, and image readout method.

Readout methods include Normal Mode, Binning Mode, and Subsampling Mode. In video streaming mode, the camera continuously exposes images and outputs image data in real time according to the resolution, frame rate, and readout method of the selected video mode.

The supported image modes may vary depending on the camera model. Details are provided in the table below:

Model videomode Resolution Minimum Frame Rate Maximum Frame Rate Readout Method
GX-MIPI-IMX662 1 1920×1080 0.065fps 60fps Normal
GX-MIPI-IMX664 1 2688×1520 TBD 30fps Normal
2 1344x760 TBD 100fps Binning
GX-MIPI-AR0234 1 1920×1200 TBD 54 fps Normal
2 1920×1080 TBD 60fps Normal
3 1600×1200 TBD 60fps Normal

Script function:videomodecap,videomodenum, vidoemodewh1-vidoemodewh8,videomodeparam1-videomodeparam8,videomode,fps,maxfps, curwh.

3.3 Pixel Readout Modes

The GX series cameras support multiple pixel readout modes: Normal Mode, Binning Mode, and Subsampling Mode. Each mode has different characteristics in terms of resolution, signal-to-noise ratio (SNR), and data bandwidth, and can be selected according to application requirements.

3.3.1 Normal Mode

The sensor reads out the full pixel array row by row, with every pixel participating in acquisition and output. This mode provides the highest resolution and best image detail, but requires higher data bandwidth.

3.3.2 Binning Mode

Adjacent pixels are combined internally on the sensor before output, improving SNR and low-light performance while reducing resolution and data bandwidth. This mode is suitable for low-light or high-sensitivity applications.

3.3.3 Subsampling Mode

Pixels are read out at fixed intervals, reducing resolution and data volume while keeping SNR largely unchanged. This mode is suitable for scenarios that require higher frame rates or lower bandwidth.

3.3.4 Mode Comparison
Mode Readout Method Resolution SNR Data Bandwidth
Normal Full Pixel Readout High Baseline High
Binning Pixel Binning Medium Improved Low
Subsampling Interval Medium Largely Unchanged Low