> For the complete documentation index, see [llms.txt](https://auvidea.gitbook.io/csi-camera/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://auvidea.gitbook.io/csi-camera/guide/camera-configuration.md). # Camera configuration {% hint style="info" %} More detailed information about this can be found on the NVIDIA [Camera adaption guide ](https://docs.nvidia.com/jetson/archives/r35.1/DeveloperGuide/text/SD/CameraDevelopment/CameraSoftwareDevelopmentSolution.html)& [manual pages](https://manpages.debian.org/stretch/v4l-utils/v4l2-ctl.1) for the used commands bellow {% endhint %} ## Introduction The Video4Linux-API (V4L in short) is the Linux interface that is used to manage the CSI video input from the CSI-Camera. Most of those cameras are using I2C for futher configurations for the camera, which can be changed over the V4L-API in the following ways. {% hint style="warning" %} `v4l-utils` is required in order to execute the following examples properly by using {% code title="Install" lineNumbers="true" %} ```bash test@test-desktop:~$ sudo apt update & sudo apt install v4l-utils ``` {% endcode %} {% endhint %} ## Video4Linux Controls V4L allows the user to make further configurations on the Camera sensor to alter/improve the video stream settings. The video device can be found in the `/dev/` directory. If the camera correctly plugged in then there should be a device called `/dev/videoX`, where `X` is the camera id. ### List available controls Returns a list of available camera controls to change Syntax: `sudo v4l2-ctl --device /dev/videoX -l` {% code title="" lineNumbers="true" %} ```bash test@test-desktop:~$ sudo v4l2-ctl --device /dev/video0 -l Camera Controls group_hold 0x009a2003 (bool) : default=0 value=0 flags=execute-on-write sensor_mode 0x009a2008 (int64) : min=0 max=3 step=1 default=0 value=1 flags=slider gain 0x009a2009 (int64) : min=16 max=356 step=1 default=16 value=16 flags=slider exposure 0x009a200a (int64) : min=13 max=683709 step=1 default=2495 value=26011 flags=slider frame_rate 0x009a200b (int64) : min=2000000 max=60000000 step=1 default=60000000 value=21000000 flags=slider bypass_mode 0x009a2064 (intmenu): min=0 max=1 default=0 value=1 override_enable 0x009a2065 (intmenu): min=0 max=1 default=0 value=1 height_align 0x009a2066 (int) : min=1 max=16 step=1 default=1 value=1 size_align 0x009a2067 (intmenu): min=0 max=2 default=0 value=0 write_isp_format 0x009a2068 (int) : min=1 max=1 step=1 default=1 value=1 sensor_signal_properties 0x009a2069 (u32) : min=0 max=4294967295 step=1 default=0 [30][18] flags=read-only, has-payload sensor_image_properties 0x009a206a (u32) : min=0 max=4294967295 step=1 default=0 [30][16] flags=read-only, has-payload sensor_control_properties 0x009a206b (u32) : min=0 max=4294967295 step=1 default=0 [30][36] flags=read-only, has-payload sensor_dv_timings 0x009a206c (u32) : min=0 max=4294967295 step=1 default=0 [30][16] flags=read-only, has-payload low_latency_mode 0x009a206d (bool) : default=0 value=0 preferred_stride 0x009a206e (int) : min=0 max=65535 step=1 default=0 value=0 sensor_modes 0x009a2082 (int) : min=0 max=30 step=1 default=30 value=3 flags=read-only test@test-desktop:~$ ``` {% endcode %} ### Set control value For this example we use the `exposure` controls from the list above {% code title="available control output" lineNumbers="true" %} ``` exposure 0x009a200a (int64) : min=13 max=683709 step=1 default=2495 value=26011 flags=slider ``` {% endcode %} This control can be changed by using the following command\ Syntax: `sudo v4l2-ctl --device /dev/videoX --set-ctrl==` {% code title="set exposure control " lineNumbers="true" %} ```bash test@test-desktop:~$ sudo v4l2-ctl --device /dev/video0 --set-ctrl=exposure=600000 ``` {% endcode %} ### Get control value For this example we use the `exposure` controls from the list above. This control can be read by using the following command\ Syntax: `sudo v4l2-ctl --device /dev/videoX --get-ctrl=` {% code title="get exposure control " lineNumbers="true" %} ```bash test@test-desktop:~$ sudo v4l2-ctl --device /dev/video0 --get-ctrl=exposure exposure: 19999 ``` {% endcode %} {% hint style="warning" %} Pleas note that other streaming tools can also intervene and change those settings and might be overwritten or not applied correctly. {% endhint %} ## Example Stream The following screenshots are showing the difference between different exposure settings on a [Raspberry PI IMX477](https://www.raspberrypi.com/products/raspberry-pi-high-quality-camera/) camera sensor that is connected via CSI on our JNX30M Carrierboard | default setting | custom setting | | -------------------------------- | ------------------------------------------------------------------- | | ![](/files/Uawu7AarTo1itWxoywHA) | |