GX mipi camera manual - Revision history

Xumm: /* Functional Limitations by Working Mode for GX-MIPI-IMX662 */

2026-04-15T08:23:42Z

Functional Limitations by Working Mode for GX-MIPI-IMX662

Xumm: /* Work Modes */

2026-04-15T07:25:16Z

Work Modes

Xumm: /* Image Color Parameters */

2026-04-04T07:34:12Z

Image Color Parameters

Xumm: /* 3D Noise Reduction */

2026-04-04T07:23:36Z

3D Noise Reduction

Xumm: /* Sharpen */

2026-04-04T07:08:13Z

Sharpen

Xumm: /* White Balance Modes */

2026-04-04T07:05:23Z

White Balance Modes

Xumm: /* Anti-Flicker */

2026-04-04T07:01:55Z

Anti-Flicker

Xumm: /* Max Gain in AE */

2026-04-04T06:06:17Z

Max Gain in AE

Xumm: /* Manual Exposure Time */

2026-04-04T04:00:52Z

Manual Exposure Time

Show changes

Xumm: /* ISP functions */

2026-04-04T03:33:00Z

ISP functions

@@ Line 356: / Line 356: @@
 The working mode is a fundamental camera parameter. Please note that certain features may be restricted depending on the selected mode, as shown in the table below:
-===== Functional Limitations by Working Mode for GX-MIPI-IMX662 =====
+=====Functional Limitations by Working Mode for GX-MIPI-IMX662=====
 {| class="wikitable"
 !Work Mode
 !Auto / Manual Exposure
 !Slow Shutter (Auto Frame Rate Reduction)
@@ Line 366: / Line 365: @@
 |-
 |LINEAR Stream Mode
 |Both Supported
 |Supported
@@ Line 373: / Line 371: @@
 |-
 |DOL WDR Stream Mode
 |AE Only
 |Not Supported
@@ Line 380: / Line 377: @@
 |-
 |Normal Trigger
 |ME Only
 |Not Supported
@@ Line 387: / Line 383: @@
 |-
 |Sync Mode - Master
 |Both Supported
 |Not Supported
@@ Line 394: / Line 389: @@
 |-
 |Sync Mode - Slave
 |Both Supported
 |Not Supported

@@ Line 353: / Line 353: @@
 The types of operating modes supported may vary depending on the camera model and can be queried using the <code>workmodecap</code> command.
 '''Script functions:''' <code>workmodecap</code>, <code>workmode</code>
@@ Line 825: / Line 873: @@
 '''Script functions:''' <code>saturation</code>, <code>contrast</code>, <code>hue</code><br />
-==== Istortion Correction ====
+====Istortion Correction====
 Distortion correction is a technology in image processing used to '''eliminate or reduce optical lens distortion''', aiming to ensure that straight lines in the scene remain “straight” after imaging, and that geometric shapes are closer to their real-world counterparts. This is crucial for applications that require high geometric accuracy, such as '''machine vision, autonomous driving, precision measurement, and AR/VR'''.
 '''Script Function:''' <code>ldc</code>
-==== Dehaze ====
+====Dehaze====
 Dehazing is used to '''eliminate or reduce image degradation caused by atmospheric scattering''', such as fog, haze, smoke, or underwater turbidity, thereby restoring image clarity and contrast.
 '''Script Function:''' <code>dehaze</code>
-==== Gamma ====
+====Gamma====
 Gamma is a '''non-linear luminance mapping technique that simulates human visual perception'''. By compressing bright areas while preserving dark details during encoding and restoring natural appearance during display, gamma correction is a key technology for ensuring images look visually correct in digital imaging.
@@ Line 842: / Line 890: @@
 '''Script Function:''' <code>gamma_index</code>
-==== Wide Dynamic Range ====
+====Wide Dynamic Range====
 '''DOL-type WDR:'''
 TBD
-==== Dynamic Range Compression (DRC) ====
+====Dynamic Range Compression (DRC)====
 Dynamic Range Compression (DRC) aims to '''provide consistent visual perception for both real-world observers and display device viewers'''. The DRC algorithm compresses high-dynamic-range images into the displayable dynamic range while preserving as much original detail and contrast as possible.
 '''Script Function:''' <code>drc</code>
-=== IO Control ===
+===IO Control===
-==== Trigger Delay ====
+====Trigger Delay====
 Trigger delay controls the '''time interval between receiving an external trigger signal and the actual start of exposure'''. The unit is usually microseconds (μs). This applies to both software and hardware triggers.
 '''Script Function:''' <code>trgdelay</code>
-==== Trigger Edge Selection ====
+====Trigger Edge Selection====
-* '''0: Rising edge trigger''' — exposure starts when the signal transitions from low to high
+*'''0: Rising edge trigger''' — exposure starts when the signal transitions from low to high
-* '''1: Falling edge trigger''' — exposure starts when the signal transitions from high to low
+*'''1: Falling edge trigger''' — exposure starts when the signal transitions from high to low
 The selection depends on the logic polarity of your external sensor or controller output, ensuring the camera captures at the precise moment of the physical event.
@@ Line 868: / Line 916: @@
 '''Script Function:''' <code>trgedge</code>
-==== Exposure Delay ====
+====Exposure Delay====
 Exposure delay is the '''time between the sensor receiving the exposure start command and the actual beginning of exposure''', used to set the advance timing of the trigger signal relative to the actual exposure moment.
 '''Script Function:''' <code>trgexp_delay</code>
-=== Revision History ===
+===Revision History===
-* '''2026/04/04:'''
+*'''2026/04/04:'''
 Initial draft largely completed
-* '''2026/03/07:'''
+*'''2026/03/07:'''
 Completed sections on basic functions, image capture, and image attributes

@@ Line 818: / Line 818: @@
 '''Script function:''' <code>denoise3d</code>
-==== Image Color Parameters ====
+====Image Color Parameters====
 At the later stage of the ISP pipeline, the camera provides controls for adjusting key image color parameters, including '''saturation''', '''contrast''', and '''hue'''.
 These parameters allow users to fine-tune the overall color appearance and visual style of the image.
-'''Script functions:''' <code>saturation</code>, <code>contrast</code>, <code>hue</code>
+'''Script functions:''' <code>saturation</code>, <code>contrast</code>, <code>hue</code><br />
-<br />

@@ Line 800: / Line 800: @@
 '''Script function:''' <code>sharppen</code>
-==== Noise Reduction ====
+====Noise Reduction====
 Noise reduction is divided into '''2D Noise Reduction (2D NR)''' and '''3D Noise Reduction (3D NR)'''.
 The camera integrates an internal noise reduction control mechanism that automatically adjusts parameters based on scene conditions, system gain, and other factors. A user-configurable '''noise reduction strength''' parameter is provided for flexible tuning of the visual effect.
-===== 2D Noise Reduction =====
+=====2D Noise Reduction=====
 D noise reduction operates on a '''single frame'''. It reduces noise by analyzing the relationship between each pixel and its neighboring pixels within the same image.
 '''Script function:''' <code>denoise2d</code>
-----
+=====3D Noise Reduction=====
 D noise reduction, also known as '''temporal-spatial noise reduction''', extends 2D NR by incorporating the time dimension. It utilizes correlations between consecutive frames to reduce noise more effectively.
@@ Line 819: / Line 817: @@
 '''Script function:''' <code>denoise3d</code>

@@ Line 793: / Line 793: @@
 *<code>mwbbgain</code> — manually set blue channel gain
-==== Sharpen ====
+====Sharpen====
 The '''Sharpen''' module is used to enhance image clarity by adjusting edge sharpness and improving the visibility of details and textures. In addition, it provides control over sharpening artifacts such as '''overshoot''' (bright halos/white edges) and '''undershoot''' (dark halos/black edges), while also suppressing noise amplification caused by sharpening.
 The camera incorporates an internal sharpening mechanism that adapts parameters automatically based on scene conditions, system gain, and other factors. A user-adjustable '''sharpening strength''' parameter is exposed to allow fine-tuning of the visual effect.
-'''Script function:''' <code>sharppen</code><br />
+'''Script function:''' <code>sharppen</code>

@@ Line 670: / Line 670: @@
 '''Script function:''' <code>antiflicker</code>
-====== Slow Shutter ======
+======Slow Shutter======
 Slow Shutter is an extended strategy of Auto Exposure (AE), designed to prioritize image brightness and signal-to-noise ratio (SNR) under low-light conditions.
 In this mode, AE operates according to the following logic:
-* Exposure time is increased with priority to improve image brightness while minimizing gain, thereby reducing noise;
+*Exposure time is increased with priority to improve image brightness while minimizing gain, thereby reducing noise;
-* When the exposure time reaches the limit allowed by the current frame rate, and the '''gain has already reached the user-defined maximum (<code>aemaxgain</code>)''':
+*When the exposure time reaches the limit allowed by the current frame rate, and the '''gain has already reached the user-defined maximum (<code>aemaxgain</code>)''':
-* The system will gradually reduce the frame rate to allow further extension of the exposure time;
+*The system will gradually reduce the frame rate to allow further extension of the exposure time;
-* This process continues until the exposure time reaches the '''maximum allowed value defined by AE (<code>aemaxtime</code>)'''.
+*This process continues until the exposure time reaches the '''maximum allowed value defined by AE (<code>aemaxtime</code>)'''.
 The Slow Shutter mode effectively reduces image noise and improves brightness and overall image quality in low-light environments.<blockquote>'''Note:'''
@@ Line 793: / Line 793: @@
 *<code>mwbbgain</code> — manually set blue channel gain
-<br />
+==== Sharpen ====

@@ Line 661: / Line 661: @@
 '''Script Function:''' <code>aemaxgain</code>
-====== Anti-Flicker ======
+======Anti-Flicker======
 A key camera feature designed to eliminate interference caused by flickering from artificial light sources. By synchronizing the exposure time with the AC power line frequency, it prevents artifacts such as brightness banding, flickering, or rolling dark bands when shooting under fluorescent or similar lighting.
@@ Line 669: / Line 669: @@
 '''Script function:''' <code>antiflicker</code>
 =====Manual Exposure=====

@@ Line 660: / Line 660: @@
 '''Script Function:''' <code>aemaxgain</code>
 =====Manual Exposure=====
@@ Line 689: / Line 698: @@
 '''Script Function:''' <code>mgain</code>
-==== White Balance ====
+====White Balance====
 In real-world scenes, the perceived color of objects varies under different lighting conditions, and the image sensor faithfully records these color variations caused by differences in light sources.
@@ Line 696: / Line 705: @@
 The function of the '''Auto White Balance (AWB)''' algorithm is to minimize the influence of external light sources on the perceived color, converting the captured color information into a neutral representation, as if observed under ideal daylight illumination.
-===== White Balance Modes =====
+=====White Balance Modes=====
 The GX series cameras support '''White Balance (WB)''' adjustment to correct color deviations under varying lighting conditions, ensuring accurate color reproduction in images.
 The system provides two white balance control modes:
-* Auto White Balance (AWB)
+*Auto White Balance (AWB)
 The camera automatically adjusts the gain of each color channel (R/G/B) based on the scene illumination. This mode is suitable for general-purpose scenarios with varying lighting conditions.
-* Manual White Balance (MWB)
+*Manual White Balance (MWB)
 Users explicitly set the gain of each color channel. This mode is suitable for environments with stable lighting or applications requiring fixed color reproduction.
@@ Line 711: / Line 720: @@
 '''Script function:''' <code>wbmode</code>
-===== Current Status =====
+=====Current Status=====
-====== Current Color Temperature ======
+======Current Color Temperature======
 Indicates the color temperature of the light source currently used or estimated by the camera, expressed in '''Kelvin (K)'''. It reflects the system’s assessment or setting of the scene’s “warmth or coolness.”
-* Higher color temperature (e.g., 8000 K): light is bluer, resulting in a cooler image tone.
+*Higher color temperature (e.g., 8000 K): light is bluer, resulting in a cooler image tone.
-* Lower color temperature (e.g., 2500 K): light is redder, resulting in a warmer image tone.
+*Lower color temperature (e.g., 2500 K): light is redder, resulting in a warmer image tone.
 '''Script function:''' <code>colortemp</code>
-====== Current Red Gain ======
+======Current Red Gain======
 Represents the gain applied to the '''red (R) channel''' in the current imaging state to achieve white balance. Gain amplifies the sensor’s output signal and adjusts the intensity of individual color components.
-* In AWB mode: dynamically calculated by the AWB algorithm
+*In AWB mode: dynamically calculated by the AWB algorithm
-* In MWB mode: equal to the user-set red gain
+*In MWB mode: equal to the user-set red gain
 Red gain is one of the core parameters in white balance control and, together with blue gain, determines image tone and overall color temperature.
@@ Line 731: / Line 740: @@
 '''Script function:''' <code>currgain</code>
-====== Current Blue Gain ======
+======Current Blue Gain======
 Represents the gain applied to the '''blue (B) channel''' in the current imaging state to achieve white balance. Used in conjunction with red gain, it determines color balance and the perceived color temperature of the image.
-* In AWB mode: dynamically calculated by the AWB algorithm
+*In AWB mode: dynamically calculated by the AWB algorithm
-* In MWB mode: equal to the user-set blue gain
+*In MWB mode: equal to the user-set blue gain
 The ratio of blue gain to red gain controls the cool/warm appearance and overall white balance of the image.
@@ Line 741: / Line 750: @@
 '''Script function:''' <code>curbgain</code>
-===== Auto White Balance (AWB) =====
+=====Auto White Balance (AWB)=====
 In AWB mode, the camera dynamically adjusts the '''R, G, and B channel gains''' according to different lighting conditions and color temperatures, ensuring accurate reproduction of white or neutral gray objects.
-* '''Goal:''' White or gray objects appear neutral white, and overall image colors are natural and true-to-life.
+*'''Goal:''' White or gray objects appear neutral white, and overall image colors are natural and true-to-life.
-* '''Algorithm:''' AWB uses the estimated '''Color Temperature''' and scene illumination to adjust channel gains dynamically, prioritizing low noise and natural color reproduction.
+*'''Algorithm:''' AWB uses the estimated '''Color Temperature''' and scene illumination to adjust channel gains dynamically, prioritizing low noise and natural color reproduction.
-* '''Adjustable parameters:''' Users can set allowed color temperature ranges to limit algorithm adjustments under extreme lighting, preventing excessive color shifts.
+*'''Adjustable parameters:''' Users can set allowed color temperature ranges to limit algorithm adjustments under extreme lighting, preventing excessive color shifts.
 '''Script functions:'''
-* <code>awbcolortempmin</code> — minimum allowed color temperature for AWB
+*<code>awbcolortempmin</code> — minimum allowed color temperature for AWB
-* <code>awbcolortempmax</code> — maximum allowed color temperature for AWB
+*<code>awbcolortempmax</code> — maximum allowed color temperature for AWB
 <blockquote>Note: Color temperature is expressed in Kelvin (K), typically ranging from 2500 K (warm light) to 8000 K (cool light).</blockquote>
-===== Manual White Balance (MWB) =====
+=====Manual White Balance (MWB)=====
 Manual white balance allows users to actively set the gain of each color channel under specific lighting conditions to precisely control image colors.
-* '''Goal:''' White or neutral gray objects appear truly neutral, without yellow, blue, or green color cast.
+*'''Goal:''' White or neutral gray objects appear truly neutral, without yellow, blue, or green color cast.
-* '''Usage scenarios:''' Suitable for controlled lighting or specialized environments, such as laboratory lighting, industrial inspection, and color calibration.
+*'''Usage scenarios:''' Suitable for controlled lighting or specialized environments, such as laboratory lighting, industrial inspection, and color calibration.
-* '''Parameter details:''' Users can directly set '''Red Gain (R Gain)''' and '''Blue Gain (B Gain)'''. The green channel is typically used as a reference and is not directly adjusted.
+*'''Parameter details:''' Users can directly set '''Red Gain (R Gain)''' and '''Blue Gain (B Gain)'''. The green channel is typically used as a reference and is not directly adjusted.
-* '''Advantages:''' Eliminates potential color shifts, flicker, or misjudgment caused by AWB, maintaining highly consistent and stable colors.
+*'''Advantages:''' Eliminates potential color shifts, flicker, or misjudgment caused by AWB, maintaining highly consistent and stable colors.
 '''Script functions:'''
-* <code>mwbrgain</code> — manually set red channel gain
+*<code>mwbrgain</code> — manually set red channel gain
-* <code>mwbbgain</code> — manually set blue channel gain
+*<code>mwbbgain</code> — manually set blue channel gain
 <br />

← Older revision		Revision as of 03:33, 4 April 2026
Line 572:		Line 572:
	[[File:Vertical color stripes.png\|center\|thumb\|800x800px\|Gx Vertical color stripes\|link=http://wiki.veye.cc/index.php/File:Vertical_color_stripes.png]]'''Script function:''' <code>testimg</code>		[[File:Vertical color stripes.png\|center\|thumb\|800x800px\|Gx Vertical color stripes\|link=http://wiki.veye.cc/index.php/File:Vertical_color_stripes.png]]'''Script function:''' <code>testimg</code>

−	=== ISP functions ===	+	===ISP functions===
		+
		+	==== Exposure & Gain Control ====
		+	GX series cameras support independent control of '''Exposure Time (Shutter)''' and '''Gain'''. Aperture (Iris) control is not supported in the current version.
		+
		+	The system provides two exposure control modes:
		+
		+	* Auto Exposure (AE)
		+	* Manual Exposure
		+
		+	===== Exposure Mode =====
		+	Used to configure the exposure control method of the camera.
		+
		+	* '''Auto Mode:'''The camera automatically adjusts exposure parameters based on ambient lighting conditions. Suitable for general-purpose applications.
		+	* '''Manual Mode:'''The user explicitly sets exposure time and gain. Suitable for stable lighting environments or scenarios such as external trigger operation.
		+
		+	'''Script Function:''' <code>expmode</code>
		+
		+	===== Current Exposure Time =====
		+	Indicates the actual exposure time applied to the current frame. This is a real-time feedback parameter.
		+
		+	* In Auto Exposure mode: dynamically calculated by the AE algorithm
		+	* In Manual mode: equal to the user-defined value
		+
		+	This parameter reflects the actual sensor integration time of the current image.
		+
		+	'''Script Function:''' <code>exptime</code>
		+
		+	===== Current Gain =====
		+	Indicates the actual gain applied to the current frame. This is a real-time representation of signal amplification.
		+
		+	* In Auto mode: dynamically adjusted by the AE algorithm
		+	* In Manual mode: equal to the user-defined value
		+
		+	Unit: dB (decibels)
		+
		+	'''Script Function:''' <code>curgain</code>
		+
		+	===== Auto Exposure (AE) =====
		+	In Auto Exposure mode, the camera dynamically adjusts exposure time and/or gain according to ambient brightness to achieve a target image brightness.
		+
		+	Within the configured exposure time and gain limits, the AE algorithm prioritizes increasing exposure time over gain to improve image brightness, thereby minimizing noise.
		+
		+	This mode is suitable for environments with varying illumination (e.g., indoor/outdoor transitions, natural lighting conditions).
		+
		+	====== AE Target ======
		+	Defines the target brightness level for Auto Exposure. It serves as the convergence reference for the AE algorithm.
		+
		+	* Higher value: brighter image
		+	* Lower value: darker image
		+
		+	This parameter directly affects image appearance and brightness stability.
		+
		+	'''Script Function:''' <code>aetarget</code>
		+
		+	====== AE Strategy ======
		+	Defines how the AE algorithm balances exposure parameters under different conditions.
		+
		+	* '''Highlight Priority:'''More sensitive to bright regions; minimizes overexposure whenever possible.
		+	* '''Low-light Priority:'''More sensitive to dark regions; enhances visibility in low-light areas, even at the risk of overexposure.
		+
		+	The default strategy is '''Highlight Priority'''. Users can adjust it according to application requirements.
		+
		+	'''Script Function:''' <code>aestrategy</code>
		+
		+	====== Max Exposure Time in AE ======
		+	Defines the upper limit of exposure time allowed in Auto Exposure mode.
		+
		+	'''Purpose:'''
		+
		+	* Prevent motion blur caused by excessive exposure time
		+	* Avoid frame rate reduction or instability due to long exposure
		+
		+	<blockquote>'''Note:''' Typically, the following condition should be satisfied:
		+
		+	'''Exposure Time ≤ 1 / Frame Rate'''</blockquote>'''Script Function:''' <code>aemaxtime</code>
		+
		+	====== Max Gain in AE ======
		+	Defines the upper limit of gain allowed in Auto Exposure mode.
		+
		+	'''Purpose:'''
		+
		+	* Prevent excessive image noise caused by high gain
		+	* Avoid detail loss and color distortion
		+
		+	Unit: dB
		+
		+	'''Script Function:''' <code>aemaxgain</code>
		+
		+	===== Manual Exposure =====
		+	In Manual Exposure mode, exposure time and gain are fixed by the user, and no automatic adjustment is performed.
		+
		+	'''Advantages:'''
		+
		+	* High frame-to-frame brightness consistency (no flicker)
		+	* Precise control over motion blur
		+	* Suitable for industrial inspection, synchronized triggering, AI vision, and similar applications
		+
		+	'''Disadvantages:'''
		+
		+	* Not adaptive to lighting changes, which may result in overexposure or underexposure
		+	* Requires stable lighting conditions or manual parameter tuning
		+
		+	====== Manual Exposure Time ======
		+	Defines the exposure time explicitly set by the user.
		+
		+	Due to hardware limitations, the effective exposure time of most image sensors is not truly continuous at microsecond precision. Instead, it is typically quantized in units of line time (row readout time). Therefore, slight differences between <code>metime</code> and <code>exptime</code> are expected and considered normal.
		+
		+	'''Script Function:''' <code>metime</code>
		+
		+	====== Manual Gain ======
		+	Defines the gain value explicitly set by the user.
		+
		+	Different sensors may support different gain ranges and step resolutions. As a result, slight differences between <code>mgain</code> and <code>curgain</code> are expected and considered normal.
		+
		+	'''Script Function:''' <code>mgain</code>