0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 .. _v4l2-meta-fmt-rk-isp1-params:
0004
0005 .. _v4l2-meta-fmt-rk-isp1-stat-3a:
0006
0007 *****************************************************************************
0008 V4L2_META_FMT_RK_ISP1_PARAMS ('rk1p'), V4L2_META_FMT_RK_ISP1_STAT_3A ('rk1s')
0009 *****************************************************************************
0010
0011 Configuration parameters
0012 ========================
0013
0014 The configuration parameters are passed to the
0015 :ref:`rkisp1_params <rkisp1_params>` metadata output video node, using
0016 the :c:type:`v4l2_meta_format` interface. The buffer contains
0017 a single instance of the C structure :c:type:`rkisp1_params_cfg` defined in
0018 ``rkisp1-config.h``. So the structure can be obtained from the buffer by:
0019
0020 .. code-block:: c
0021
0022 struct rkisp1_params_cfg *params = (struct rkisp1_params_cfg*) buffer;
0023
0024 .. rkisp1_stat_buffer
0025
0026 3A and histogram statistics
0027 ===========================
0028
0029 The ISP1 device collects different statistics over an input Bayer frame.
0030 Those statistics are obtained from the :ref:`rkisp1_stats <rkisp1_stats>`
0031 metadata capture video node,
0032 using the :c:type:`v4l2_meta_format` interface. The buffer contains a single
0033 instance of the C structure :c:type:`rkisp1_stat_buffer` defined in
0034 ``rkisp1-config.h``. So the structure can be obtained from the buffer by:
0035
0036 .. code-block:: c
0037
0038 struct rkisp1_stat_buffer *stats = (struct rkisp1_stat_buffer*) buffer;
0039
0040 The statistics collected are Exposure, AWB (Auto-white balance), Histogram and
0041 AF (Auto-focus). See :c:type:`rkisp1_stat_buffer` for details of the statistics.
0042
0043 The 3A statistics and configuration parameters described here are usually
0044 consumed and produced by dedicated user space libraries that comprise the
0045 important tuning tools using software control loop.
0046
0047 rkisp1 uAPI data types
0048 ======================
0049
0050 .. kernel-doc:: include/uapi/linux/rkisp1-config.h
