| Message ID | 20240918-c3isp-v3-8-f774a39e6774@amlogic.com |
|---|---|
| State | New |
| Headers | show |
| Series | Amlogic C3 ISP support | expand |
Hi Keke On Wed, Sep 18, 2024 at 02:07:19PM +0800, Keke Li via B4 Relay wrote: > From: Keke Li <keke.li@amlogic.com> > > Add the file 'metafmt-c3-isp.rst' that documents > the meta format of c3-isp. Do not break lines too early! > > Signed-off-by: Keke Li <keke.li@amlogic.com> > --- > .../userspace-api/media/v4l/meta-formats.rst | 1 + > .../userspace-api/media/v4l/metafmt-c3-isp.rst | 39 ++++++++++++++++++++++ > 2 files changed, 40 insertions(+) > > diff --git a/Documentation/userspace-api/media/v4l/meta-formats.rst b/Documentation/userspace-api/media/v4l/meta-formats.rst > index c6e56b5888bc..3a420747f6e7 100644 > --- a/Documentation/userspace-api/media/v4l/meta-formats.rst > +++ b/Documentation/userspace-api/media/v4l/meta-formats.rst > @@ -12,6 +12,7 @@ These formats are used for the :ref:`metadata` interface only. > .. toctree:: > :maxdepth: 1 > > + metafmt-c3-isp > metafmt-d4xx > metafmt-generic > metafmt-intel-ipu3 > diff --git a/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst b/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst > new file mode 100644 > index 000000000000..bbaf3542c1ca > --- /dev/null > +++ b/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst > @@ -0,0 +1,39 @@ > +.. SPDX-License-Identifier: (GPL-2.0-only OR MIT) > + > +.. _v4l2-meta-fmt-c3isp-stats: > +.. _v4l2-meta-fmt-c3isp-params: > + > +*********************************************************************** > +V4L2_META_FMT_C3ISP_STATS ('CSTS'), V4L2_META_FMT_C3ISP_PARAMS ('CPRM') > +*********************************************************************** > + > +.. c3_isp_stats_info This does not seem to be used > + > +3A statistics > +============= > + > +The C3 ISP can collect different statistics over an input Bayer frame. > +Those statistics are obtained from the "isp-stats" metadata capture video nodes, > +using the :c:type:`v4l2_meta_format` interface. > +They are formatted as described by the :c:type:`c3_isp_stats_info` structure. > + > +The statistics collected are Auto-white balance, > +Auto-exposure and Auto-focus information. Do not break lines too early > + > +.. c3_isp_params_buffer Unsued as well ? > + > +Pipeline parameters > +=================== > + > +The pipeline parameters are passed to the "isp-params" metadata > +output video nodes, using the :c:type:`v4l2_meta_format` interface. They are > +formatted as described by the :c:type:`c3_isp_params_buffer` structure. > + > +The structure c3_isp_params_buffer includes the necessary parameters > +required by the ISP. > +These parameters are written to the ISP hardware. > + > +Amlogic C3 ISP uAPI data types > +=============================== Additional = at the end > + > +.. kernel-doc:: drivers/media/platform/amlogic/c3-isp/include/uapi/c3-isp-config.h > > -- > 2.46.1 > > >
diff --git a/Documentation/userspace-api/media/v4l/meta-formats.rst b/Documentation/userspace-api/media/v4l/meta-formats.rst index c6e56b5888bc..3a420747f6e7 100644 --- a/Documentation/userspace-api/media/v4l/meta-formats.rst +++ b/Documentation/userspace-api/media/v4l/meta-formats.rst @@ -12,6 +12,7 @@ These formats are used for the :ref:`metadata` interface only. .. toctree:: :maxdepth: 1 + metafmt-c3-isp metafmt-d4xx metafmt-generic metafmt-intel-ipu3 diff --git a/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst b/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst new file mode 100644 index 000000000000..bbaf3542c1ca --- /dev/null +++ b/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst @@ -0,0 +1,39 @@ +.. SPDX-License-Identifier: (GPL-2.0-only OR MIT) + +.. _v4l2-meta-fmt-c3isp-stats: +.. _v4l2-meta-fmt-c3isp-params: + +*********************************************************************** +V4L2_META_FMT_C3ISP_STATS ('CSTS'), V4L2_META_FMT_C3ISP_PARAMS ('CPRM') +*********************************************************************** + +.. c3_isp_stats_info + +3A statistics +============= + +The C3 ISP can collect different statistics over an input Bayer frame. +Those statistics are obtained from the "isp-stats" metadata capture video nodes, +using the :c:type:`v4l2_meta_format` interface. +They are formatted as described by the :c:type:`c3_isp_stats_info` structure. + +The statistics collected are Auto-white balance, +Auto-exposure and Auto-focus information. + +.. c3_isp_params_buffer + +Pipeline parameters +=================== + +The pipeline parameters are passed to the "isp-params" metadata +output video nodes, using the :c:type:`v4l2_meta_format` interface. They are +formatted as described by the :c:type:`c3_isp_params_buffer` structure. + +The structure c3_isp_params_buffer includes the necessary parameters +required by the ISP. +These parameters are written to the ISP hardware. + +Amlogic C3 ISP uAPI data types +=============================== + +.. kernel-doc:: drivers/media/platform/amlogic/c3-isp/include/uapi/c3-isp-config.h