From: Jacopo Mondi <jacopo@jmondi.org>
To: Mauro Carvalho Chehab <mchehab@kernel.org>,
Hans Verkuil <hverkuil-cisco@xs4all.nl>,
Sakari Ailus <sakari.ailus@linux.intel.com>,
Laurent Pinchart <laurent.pinchart@ideasonboard.com>,
tfiga@google.com, pavel@ucw.cz
Cc: Jacopo Mondi <jacopo@jmondi.org>,
linux-media@vger.kernel.org (open list:MEDIA INPUT
INFRASTRUCTURE (V4L/DVB))
Subject: [PATCH v4 02/11] media: v4l2-ctrl: Document V4L2_CID_CAMERA_SENSOR_LOCATION
Date: Mon, 7 Oct 2019 18:29:04 +0200 [thread overview]
Message-ID: <20191007162913.250743-3-jacopo@jmondi.org> (raw)
In-Reply-To: <20191007162913.250743-1-jacopo@jmondi.org>
Add documentation for the V4L2_CID_CAMERA_SENSOR_LOCATION camera
control. The newly added read-only control reports the camera device
mounting position.
Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>
---
.../media/uapi/v4l/ext-ctrls-camera.rst | 32 +++++++++++++++++++
1 file changed, 32 insertions(+)
diff --git a/Documentation/media/uapi/v4l/ext-ctrls-camera.rst b/Documentation/media/uapi/v4l/ext-ctrls-camera.rst
index 51c1d5c9eb00..b151c016256c 100644
--- a/Documentation/media/uapi/v4l/ext-ctrls-camera.rst
+++ b/Documentation/media/uapi/v4l/ext-ctrls-camera.rst
@@ -510,6 +510,38 @@ enum v4l2_scene_mode -
value down. A value of zero stops the motion if one is in progress
and has no effect otherwise.
+``V4L2_CID_CAMERA_SENSOR_LOCATION (integer)``
+ This read-only control describes the camera sensor location by reporting
+ its mounting position on the device where the camera is installed. The
+ control value is constant and not modifiable by software. This control is
+ particularly meaningful for devices which have a well defined orientation,
+ such as phones, laptops and portable devices since the camera location is
+ expressed as a position relative to the device's intended usage orientation.
+ For example, a camera sensor installed on the user-facing side of a phone,
+ a tablet or a laptop device is said to be installed in the
+ ``V4L2_LOCATION_FRONT`` location while camera sensors installed on the side
+ opposite the front one are said to be installed in the
+ ``V4L2_LOCATION_BACK`` location. Camera sensors not directly attached to
+ the device or attached in a way that allows them to move freely, such as
+ webcams and digital cameras, are said to have the ``V4L2_LOCATION_EXTERNAL``
+ location.
+
+
+
+.. flat-table::
+ :header-rows: 0
+ :stub-columns: 0
+
+ * - ``V4L2_LOCATION_FRONT``
+ - The camera sensor is located on the front side of the device.
+ * - ``V4L2_LOCATION_BACK``
+ - The camera sensor is located on the back side of the device.
+ * - ``V4L2_LOCATION_EXTERNAL``
+ - The camera sensor is not directly attached to the device and is
+ freely movable.
+
+
+
.. [#f1]
This control may be changed to a menu control in the future, if more
options are required.
--
2.23.0
next prev parent reply other threads:[~2019-10-07 16:27 UTC|newest]
Thread overview: 29+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-10-07 16:29 [PATCH v4 00/11] media: Report camera sensor properties Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 01/11] dt-bindings: video-interfaces: Document 'location' property Jacopo Mondi
2019-10-08 7:40 ` Pavel Machek
2019-10-08 7:58 ` Jacopo Mondi
2019-10-08 8:06 ` Pavel Machek
2019-10-08 8:20 ` Jacopo Mondi
2019-10-22 14:27 ` Hans Verkuil
2019-10-23 14:27 ` Pavel Machek
2019-10-25 6:29 ` Tomasz Figa
2019-10-26 20:48 ` Laurent Pinchart
2019-11-18 11:32 ` Tomasz Figa
2019-11-21 16:02 ` Jacopo Mondi
2019-11-22 4:53 ` Tomasz Figa
2019-10-26 11:23 ` Jacopo Mondi
2019-10-18 19:40 ` Sakari Ailus
2019-10-07 16:29 ` Jacopo Mondi [this message]
2019-10-07 16:29 ` [PATCH v4 03/11] dt-bindings: video-interface: Expand rotation description Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 04/11] media: v4l2-ctrl: Document V4L2_CID_CAMERA_SENSOR_ROTATION Jacopo Mondi
2019-10-22 14:14 ` Hans Verkuil
2019-10-07 16:29 ` [PATCH v4 05/11] media: v4l2-ctrls: Add camera location and rotation Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 06/11] media: v4l2-fwnode: Add helper to parse device properties Jacopo Mondi
2019-10-18 19:36 ` Sakari Ailus
2019-11-08 9:20 ` Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 07/11] include: v4l2-ctrl: Sort forward declarations Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 08/11] media: v4l2-ctrls: Sort includes alphabetically Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 09/11] media: v4l2-ctrls: Add helper to register properties Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 10/11] media: i2c: ov5670: Parse and " Jacopo Mondi
2019-10-07 16:29 ` [PATCH v4 11/11] media: i2c: ov13858: " Jacopo Mondi
2019-10-18 19:10 ` [PATCH v4 00/11] media: Report camera sensor properties Sakari Ailus
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20191007162913.250743-3-jacopo@jmondi.org \
--to=jacopo@jmondi.org \
--cc=hverkuil-cisco@xs4all.nl \
--cc=laurent.pinchart@ideasonboard.com \
--cc=linux-media@vger.kernel.org \
--cc=mchehab@kernel.org \
--cc=pavel@ucw.cz \
--cc=sakari.ailus@linux.intel.com \
--cc=tfiga@google.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).