diff options
Diffstat (limited to 'Documentation/userspace-api/media/v4l/pixfmt-meta-intel-ipu3.rst')
| -rw-r--r-- | Documentation/userspace-api/media/v4l/pixfmt-meta-intel-ipu3.rst | 81 |
1 files changed, 0 insertions, 81 deletions
diff --git a/Documentation/userspace-api/media/v4l/pixfmt-meta-intel-ipu3.rst b/Documentation/userspace-api/media/v4l/pixfmt-meta-intel-ipu3.rst deleted file mode 100644 index 84d81dd7a7b5..000000000000 --- a/Documentation/userspace-api/media/v4l/pixfmt-meta-intel-ipu3.rst +++ /dev/null @@ -1,81 +0,0 @@ -.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later - -.. _v4l2-meta-fmt-params: -.. _v4l2-meta-fmt-stat-3a: - -****************************************************************** -V4L2_META_FMT_IPU3_PARAMS ('ip3p'), V4L2_META_FMT_IPU3_3A ('ip3s') -****************************************************************** - -.. ipu3_uapi_stats_3a - -3A statistics -============= - -The IPU3 ImgU 3A statistics accelerators collect different statistics over -an input Bayer frame. Those statistics are obtained from the "ipu3-imgu [01] 3a -stat" metadata capture video nodes, using the :c:type:`v4l2_meta_format` -interface. They are formatted as described by the :c:type:`ipu3_uapi_stats_3a` -structure. - -The statistics collected are AWB (Auto-white balance) RGBS (Red, Green, Blue and -Saturation measure) cells, AWB filter response, AF (Auto-focus) filter response, -and AE (Auto-exposure) histogram. - -The struct :c:type:`ipu3_uapi_4a_config` saves all configurable parameters. - -.. code-block:: c - - struct ipu3_uapi_stats_3a { - struct ipu3_uapi_awb_raw_buffer awb_raw_buffer; - struct ipu3_uapi_ae_raw_buffer_aligned ae_raw_buffer[IPU3_UAPI_MAX_STRIPES]; - struct ipu3_uapi_af_raw_buffer af_raw_buffer; - struct ipu3_uapi_awb_fr_raw_buffer awb_fr_raw_buffer; - struct ipu3_uapi_4a_config stats_4a_config; - __u32 ae_join_buffers; - __u8 padding[28]; - struct ipu3_uapi_stats_3a_bubble_info_per_stripe stats_3a_bubble_per_stripe; - struct ipu3_uapi_ff_status stats_3a_status; - }; - -.. ipu3_uapi_params - -Pipeline parameters -=================== - -The pipeline parameters are passed to the "ipu3-imgu [01] parameters" metadata -output video nodes, using the :c:type:`v4l2_meta_format` interface. They are -formatted as described by the :c:type:`ipu3_uapi_params` structure. - -Both 3A statistics and pipeline parameters described here are closely tied to -the underlying camera sub-system (CSS) APIs. They are usually consumed and -produced by dedicated user space libraries that comprise the important tuning -tools, thus freeing the developers from being bothered with the low level -hardware and algorithm details. - -.. code-block:: c - - struct ipu3_uapi_params { - /* Flags which of the settings below are to be applied */ - struct ipu3_uapi_flags use; - - /* Accelerator cluster parameters */ - struct ipu3_uapi_acc_param acc_param; - - /* ISP vector address space parameters */ - struct ipu3_uapi_isp_lin_vmem_params lin_vmem_params; - struct ipu3_uapi_isp_tnr3_vmem_params tnr3_vmem_params; - struct ipu3_uapi_isp_xnr3_vmem_params xnr3_vmem_params; - - /* ISP data memory (DMEM) parameters */ - struct ipu3_uapi_isp_tnr3_params tnr3_dmem_params; - struct ipu3_uapi_isp_xnr3_params xnr3_dmem_params; - - /* Optical black level compensation */ - struct ipu3_uapi_obgrid_param obgrid_param; - }; - -Intel IPU3 ImgU uAPI data types -=============================== - -.. kernel-doc:: drivers/staging/media/ipu3/include/uapi/intel-ipu3.h |