summaryrefslogtreecommitdiff
path: root/drivers/staging/media/ipu3/include/intel-ipu3.h
diff options
context:
space:
mode:
authorBingbu Cao <bingbu.cao@intel.com>2019-10-22 23:59:02 -0300
committerMauro Carvalho Chehab <mchehab@kernel.org>2019-11-05 08:19:16 -0300
commit318335c250962cde36338e341235b313bc35e386 (patch)
treefb6e806ec8384f383436119a2a4bad82f040112f /drivers/staging/media/ipu3/include/intel-ipu3.h
parent4147dca25d1f2aae2a44ac02647eaf29ef8d028a (diff)
media: doc-rst: ipu3: clarification on data type conversion of IEFD CU
The data type conversion of the IEFD CU inputs in ipu3 uapi is ambiguities, add some clarification to help user to understand this conversion. Signed-off-by: Bingbu Cao <bingbu.cao@intel.com> Suggested-by: Sakari Ailus <sakari.ailus@linux.intel.com> Cc: Tomasz Figa <tfiga@chromium.org> Cc: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Diffstat (limited to 'drivers/staging/media/ipu3/include/intel-ipu3.h')
-rw-r--r--drivers/staging/media/ipu3/include/intel-ipu3.h5
1 files changed, 5 insertions, 0 deletions
diff --git a/drivers/staging/media/ipu3/include/intel-ipu3.h b/drivers/staging/media/ipu3/include/intel-ipu3.h
index c7cd27efac8a..08eaa0bad0de 100644
--- a/drivers/staging/media/ipu3/include/intel-ipu3.h
+++ b/drivers/staging/media/ipu3/include/intel-ipu3.h
@@ -1217,6 +1217,11 @@ struct ipu3_uapi_shd_config {
*
* All CU inputs are unsigned, they will be converted to signed when written
* to register, i.e. a01 will be written to 9 bit register in s4.4 format.
+ * The data precision s4.4 means 4 bits for integer parts and 4 bits for the
+ * fractional part, the first bit indicates positive or negative value.
+ * For userspace software (commonly the imaging library), the computation for
+ * the CU slope values should be based on the slope resolution 1/16 (binary
+ * 0.0001 - the minimal interval value), the slope value range is [-256, +255].
* This applies to &ipu3_uapi_iefd_cux6_ed, &ipu3_uapi_iefd_cux2_1,
* &ipu3_uapi_iefd_cux2_1, &ipu3_uapi_iefd_cux4 and &ipu3_uapi_iefd_cux6_rad.
*/