media: v4l2-ctrls: Add V4L2_CID_NOTIFY_GAINS control
authorDavid Plowman <david.plowman@raspberrypi.com>
Mon, 16 Aug 2021 11:39:08 +0000 (13:39 +0200)
committerPhil Elwell <8911409+pelwell@users.noreply.github.com>
Mon, 20 Dec 2021 20:32:54 +0000 (20:32 +0000)
commitc2507252456bbebd397f6e1c9a35fb915e490f39
treeee87a6876507f0dbd0775c925200e1cd6e6e4b9e
parent48f234641072c3619fa8c357b93e4f5131899cb6
media: v4l2-ctrls: Add V4L2_CID_NOTIFY_GAINS control

Commit a9c80593ff80ddb7c6496624e5384e1ea3460a72 upstream.

We add a new control V4L2_CID_NOTIFY_GAINS which allows the sensor to
be notified what gains will be applied to the different colour
channels by subsequent processing (such as by an ISP), even though the
sensor will not apply any of these gains itself.

For Bayer sensors this will be an array control taking 4 values which
are the 4 gains arranged in the fixed order B, Gb, Gr and R,
irrespective of the exact Bayer order of the sensor itself. The use of
an array makes it straightforward to extend this control to non-Bayer
sensors (for example, sensors with an RGBW pattern) in future.

The units are in all cases linear with the default value indicating a
gain of exactly 1.0. For example, if the default value were reported as
128 then the value 192 would represent a gain of exactly 1.5.

Signed-off-by: David Plowman <david.plowman@raspberrypi.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
drivers/media/v4l2-core/v4l2-ctrls.c
include/uapi/linux/v4l2-controls.h