Commit dc794d3d authored by Sakari Ailus's avatar Sakari Ailus Committed by Mauro Carvalho Chehab

media: staging: ipu3-imgu: Move the UAPI header from include under include/uapi

The header defines the user space interface but may be mistaken as
kernel-only header due to its location. Add "uapi" directory under
driver's include directory and move the header there.
Suggested-by: default avatarGreg KH <gregkh@linuxfoundation.org>
Signed-off-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: default avatarBingbu Cao <bingbu.cao@intel.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent ff3cc65c
...@@ -234,22 +234,23 @@ The IPU3 ImgU pipelines can be configured using the Media Controller, defined at ...@@ -234,22 +234,23 @@ The IPU3 ImgU pipelines can be configured using the Media Controller, defined at
Running mode and firmware binary selection Running mode and firmware binary selection
------------------------------------------ ------------------------------------------
ImgU works based on firmware, currently the ImgU firmware support run 2 pipes in ImgU works based on firmware, currently the ImgU firmware support run 2 pipes
time-sharing with single input frame data. Each pipe can run at certain mode - in time-sharing with single input frame data. Each pipe can run at certain mode
"VIDEO" or "STILL", "VIDEO" mode is commonly used for video frames capture, and - "VIDEO" or "STILL", "VIDEO" mode is commonly used for video frames capture,
"STILL" is used for still frame capture. However, you can also select "VIDEO" to and "STILL" is used for still frame capture. However, you can also select
capture still frames if you want to capture images with less system load and "VIDEO" to capture still frames if you want to capture images with less system
power. For "STILL" mode, ImgU will try to use smaller BDS factor and output load and power. For "STILL" mode, ImgU will try to use smaller BDS factor and
larger bayer frame for further YUV processing than "VIDEO" mode to get high output larger bayer frame for further YUV processing than "VIDEO" mode to get
quality images. Besides, "STILL" mode need XNR3 to do noise reduction, hence high quality images. Besides, "STILL" mode need XNR3 to do noise reduction,
"STILL" mode will need more power and memory bandwidth than "VIDEO" mode. TNR hence "STILL" mode will need more power and memory bandwidth than "VIDEO" mode.
will be enabled in "VIDEO" mode and bypassed by "STILL" mode. ImgU is running at TNR will be enabled in "VIDEO" mode and bypassed by "STILL" mode. ImgU is
“VIDEO” mode by default, the user can use v4l2 control V4L2_CID_INTEL_IPU3_MODE running at “VIDEO” mode by default, the user can use v4l2 control
(currently defined in drivers/staging/media/ipu3/include/intel-ipu3.h) to query V4L2_CID_INTEL_IPU3_MODE (currently defined in
and set the running mode. For user, there is no difference for buffer queueing drivers/staging/media/ipu3/include/uapi/intel-ipu3.h) to query and set the
between the "VIDEO" and "STILL" mode, mandatory input and main output node running mode. For user, there is no difference for buffer queueing between the
should be enabled and buffers need be queued, the statistics and the view-finder "VIDEO" and "STILL" mode, mandatory input and main output node should be
queues are optional. enabled and buffers need be queued, the statistics and the view-finder queues
are optional.
The firmware binary will be selected according to current running mode, such log The firmware binary will be selected according to current running mode, such log
"using binary if_to_osys_striped " or "using binary if_to_osys_primary_striped" "using binary if_to_osys_striped " or "using binary if_to_osys_primary_striped"
...@@ -586,7 +587,7 @@ preserved. ...@@ -586,7 +587,7 @@ preserved.
References References
========== ==========
.. [#f5] drivers/staging/media/ipu3/include/intel-ipu3.h .. [#f5] drivers/staging/media/ipu3/include/uapi/intel-ipu3.h
.. [#f1] https://github.com/intel/nvt .. [#f1] https://github.com/intel/nvt
......
...@@ -78,4 +78,4 @@ hardware and algorithm details. ...@@ -78,4 +78,4 @@ hardware and algorithm details.
Intel IPU3 ImgU uAPI data types Intel IPU3 ImgU uAPI data types
=============================== ===============================
.. kernel-doc:: drivers/staging/media/ipu3/include/intel-ipu3.h .. kernel-doc:: drivers/staging/media/ipu3/include/uapi/intel-ipu3.h
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
#ifndef __IPU3_ABI_H #ifndef __IPU3_ABI_H
#define __IPU3_ABI_H #define __IPU3_ABI_H
#include "include/intel-ipu3.h" #include "include/uapi/intel-ipu3.h"
/******************* IMGU Hardware information *******************/ /******************* IMGU Hardware information *******************/
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment