| 1 |
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later |
| 2 |
.. c:namespace:: V4L |
| 3 |
|
| 4 |
.. _v4l2-meta-fmt-params: |
| 5 |
.. _v4l2-meta-fmt-stat-3a: |
| 6 |
|
| 7 |
****************************************************************** |
| 8 |
V4L2_META_FMT_IPU3_PARAMS ('ip3p'), V4L2_META_FMT_IPU3_3A ('ip3s') |
| 9 |
****************************************************************** |
| 10 |
|
| 11 |
.. ipu3_uapi_stats_3a |
| 12 |
|
| 13 |
3A statistics |
| 14 |
============= |
| 15 |
|
| 16 |
The IPU3 ImgU 3A statistics accelerators collect different statistics over |
| 17 |
an input Bayer frame. Those statistics are obtained from the "ipu3-imgu [01] 3a |
| 18 |
stat" metadata capture video nodes, using the :c:type:`v4l2_meta_format` |
| 19 |
interface. They are formatted as described by the :c:type:`ipu3_uapi_stats_3a` |
| 20 |
structure. |
| 21 |
|
| 22 |
The statistics collected are AWB (Auto-white balance) RGBS (Red, Green, Blue and |
| 23 |
Saturation measure) cells, AWB filter response, AF (Auto-focus) filter response, |
| 24 |
and AE (Auto-exposure) histogram. |
| 25 |
|
| 26 |
The struct :c:type:`ipu3_uapi_4a_config` saves all configurable parameters. |
| 27 |
|
| 28 |
.. code-block:: c |
| 29 |
|
| 30 |
struct ipu3_uapi_stats_3a { |
| 31 |
struct ipu3_uapi_awb_raw_buffer awb_raw_buffer; |
| 32 |
struct ipu3_uapi_ae_raw_buffer_aligned ae_raw_buffer[IPU3_UAPI_MAX_STRIPES]; |
| 33 |
struct ipu3_uapi_af_raw_buffer af_raw_buffer; |
| 34 |
struct ipu3_uapi_awb_fr_raw_buffer awb_fr_raw_buffer; |
| 35 |
struct ipu3_uapi_4a_config stats_4a_config; |
| 36 |
__u32 ae_join_buffers; |
| 37 |
__u8 padding[28]; |
| 38 |
struct ipu3_uapi_stats_3a_bubble_info_per_stripe stats_3a_bubble_per_stripe; |
| 39 |
struct ipu3_uapi_ff_status stats_3a_status; |
| 40 |
}; |
| 41 |
|
| 42 |
.. ipu3_uapi_params |
| 43 |
|
| 44 |
Pipeline parameters |
| 45 |
=================== |
| 46 |
|
| 47 |
The pipeline parameters are passed to the "ipu3-imgu [01] parameters" metadata |
| 48 |
output video nodes, using the :c:type:`v4l2_meta_format` interface. They are |
| 49 |
formatted as described by the :c:type:`ipu3_uapi_params` structure. |
| 50 |
|
| 51 |
Both 3A statistics and pipeline parameters described here are closely tied to |
| 52 |
the underlying camera sub-system (CSS) APIs. They are usually consumed and |
| 53 |
produced by dedicated user space libraries that comprise the important tuning |
| 54 |
tools, thus freeing the developers from being bothered with the low level |
| 55 |
hardware and algorithm details. |
| 56 |
|
| 57 |
.. code-block:: c |
| 58 |
|
| 59 |
struct ipu3_uapi_params { |
| 60 |
/* Flags which of the settings below are to be applied */ |
| 61 |
struct ipu3_uapi_flags use; |
| 62 |
|
| 63 |
/* Accelerator cluster parameters */ |
| 64 |
struct ipu3_uapi_acc_param acc_param; |
| 65 |
|
| 66 |
/* ISP vector address space parameters */ |
| 67 |
struct ipu3_uapi_isp_lin_vmem_params lin_vmem_params; |
| 68 |
struct ipu3_uapi_isp_tnr3_vmem_params tnr3_vmem_params; |
| 69 |
struct ipu3_uapi_isp_xnr3_vmem_params xnr3_vmem_params; |
| 70 |
|
| 71 |
/* ISP data memory (DMEM) parameters */ |
| 72 |
struct ipu3_uapi_isp_tnr3_params tnr3_dmem_params; |
| 73 |
struct ipu3_uapi_isp_xnr3_params xnr3_dmem_params; |
| 74 |
|
| 75 |
/* Optical black level compensation */ |
| 76 |
struct ipu3_uapi_obgrid_param obgrid_param; |
| 77 |
}; |
| 78 |
|
| 79 |
Intel IPU3 ImgU uAPI data types |
| 80 |
=============================== |
| 81 |
|
| 82 |
.. kernel-doc:: drivers/staging/media/ipu3/include/uapi/intel-ipu3.h |