DCMIPP ISP example utility

Applicable for

STM32MP21x lines, STM32MP23x lines, STM32MP25x lines

1. Overview[edit | edit source]

The DCMIPP ISP example utility named "dcmipp-isp-ctrl" is a software utility developed by STMicroelectronics to demonstrate the DCMIPP ISP capabilities regarding image correction based on STMicroelectronics basic correction algorithms. Refer to How to use the DCMIPP ISP article to have some details on how to implement this utility and put in place your own custom correction algorithms.

Information

dcmipp-isp-ctrl is required only if the Bayer color format is used AND libcamera is not used.
Please have a look to X-LINUX-ISP expansion package category for advanced ISP tuning tools.

2. Usage[edit | edit source]

/usr/local/demo/bin/dcmipp-isp-ctrl

/usr/local/demo/bin/dcmipp-isp-ctrl [options]
DCMIPP ISP Control application
-g, --gain                  Update the Sensor Gain and Exposure (AutoExposure)
-c, --contrast TYPE         Set the contrast
                            TYPE  0 : None
                                  1 :  50%
                                  2 : 200%
                                  3 : Dynamic
-i, --illuminant TYPE       Apply settings (black level, color conv, exposure) for a specific illuminant
                            TYPE  0 : D50 (daylight)
                                  1 : TL84 (fluo lamp)
-s, --stat                  Read the stat
-S, --STAT                  Read the stat continuously
--histo_top                 Top raw of the histogram area
--histo_left                Left column of the histogram area
--histo_width               Width of a region of histogram
--histo_height              Height of a region of histogram
--histo_h_region            Number of horizontal region of histogram
--histo_v_region            Number of vertical region of histogram
--histo_comp                Component(s) of histogram (0 to 4)
--histo_src                 Point of histogram capture within the pipeline
--histo_bins                Number of bins to capture per histogram
--histo_dyn                 Dynamic of pixels to capture in histogram
--histo_h_decimation        Horizontal decimation in histogram
--histo_v_decimation        Vertical decimation in histogram
--help                      Display usage
-v                          Verbose output

Warning

Some dcmipp-isp-ctrl utility options may not be available depending of the STM32MP2 series and related DCMIPP versions.
Be sure the camera pipeline is running before starting dcmipp-isp-ctrl utility.

3. Examples[edit | edit source]

Refer to V4L2 camera image correction article for examples of usage.

4. References[edit | edit source]

The code is available here: dcmipp-isp-ctrl