From: Sakari Ailus <sakari.ailus@linux.intel.com>
To: linux-media@vger.kernel.org
Cc: hverkuil@xs4all.nl, laurent.pinchart@ideasonboard.com,
Prabhakar <prabhakar.csengg@gmail.com>,
Kate Hsuan <hpa@redhat.com>,
Alexander Shiyan <eagle.alexander923@gmail.com>,
Mikhail Rudenko <mike.rudenko@gmail.com>,
Dave Stevenson <dave.stevenson@raspberrypi.com>,
Tommaso Merciai <tomm.merciai@gmail.com>,
Umang Jain <umang.jain@ideasonboard.com>,
Benjamin Mugnier <benjamin.mugnier@foss.st.com>,
Sylvain Petinot <sylvain.petinot@foss.st.com>,
Christophe JAILLET <christophe.jaillet@wanadoo.fr>,
Julien Massot <julien.massot@collabora.com>,
Naushir Patuck <naush@raspberrypi.com>
Subject: [RFC 1/4] media: Documentation: Rework embedded data documentation
Date: Fri, 11 Oct 2024 10:55:32 +0300 [thread overview]
Message-ID: <20241011075535.588140-2-sakari.ailus@linux.intel.com> (raw)
In-Reply-To: <20241011075535.588140-1-sakari.ailus@linux.intel.com>
Rework embedded data documentation by removing the reference to the pixel
data stream. The specific documentation of the embedded data interface
will be elsewhere.
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
---
.../userspace-api/media/drivers/camera-sensor.rst | 13 ++++++-------
1 file changed, 6 insertions(+), 7 deletions(-)
diff --git a/Documentation/userspace-api/media/drivers/camera-sensor.rst b/Documentation/userspace-api/media/drivers/camera-sensor.rst
index dc415b8f6c8e..d82cd803e337 100644
--- a/Documentation/userspace-api/media/drivers/camera-sensor.rst
+++ b/Documentation/userspace-api/media/drivers/camera-sensor.rst
@@ -111,13 +111,12 @@ the sensor configuration for the captured frame back to the host. While CSI-2 is
the most common data interface used by such sensors, embedded data can be
available on other interfaces as well.
-Such sensors expose two internal sink pads (pads that have both the
-``MEDIA_PAD_FL_SINK <MEDIA-PAD-FL-SINK>`` and ``MEDIA_PAD_FL_INTERNAL
-<MEDIA-PAD-FL-INTERNAL>`` flags set) to model the source of the image and
-embedded data streams. Both of these pads produces a single stream, and the
-sub-device routes those streams to the external (source) pad. If the sub-device
-driver supports disabling embedded data, this can be done by disabling the
-embedded data route via the ``VIDIOC_SUBDEV_S_ROUTING`` IOCTL.
+Embedded data support is indicated by an internal sink pad (pad that has both
+the ``MEDIA_PAD_FL_SINK <MEDIA-PAD-FL-SINK>`` and ``MEDIA_PAD_FL_INTERNAL
+<MEDIA-PAD-FL-INTERNAL>`` flags set) with a metadata format to model the
+embedded data stream. If the sub-device driver supports disabling embedded data,
+this can be done by disabling the embedded data route via the
+``VIDIOC_SUBDEV_S_ROUTING`` IOCTL.
In general, changing the embedded data format from the driver-configured values
is not supported. The height of the metadata is device-specific and the width
--
2.39.5
next prev parent reply other threads:[~2024-10-11 7:55 UTC|newest]
Thread overview: 28+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-10-11 7:55 [RFC 0/4] Sub-device configuration models Sakari Ailus
2024-10-11 7:55 ` Sakari Ailus [this message]
2024-10-22 15:08 ` [RFC 1/4] media: Documentation: Rework embedded data documentation Jacopo Mondi
2024-11-08 12:23 ` Sakari Ailus
2024-10-22 19:27 ` Laurent Pinchart
2024-10-11 7:55 ` [RFC 2/4] media: Documentation: Reword split of sensor driver to two classes Sakari Ailus
2024-10-22 15:12 ` Jacopo Mondi
2024-10-22 19:39 ` Laurent Pinchart
2024-11-08 12:39 ` Sakari Ailus
2024-11-08 12:57 ` Laurent Pinchart
2024-10-11 7:55 ` [RFC 3/4] media: Documentation: Add subdev configuration models, raw sensor model Sakari Ailus
2024-10-22 16:02 ` Jacopo Mondi
2024-10-22 22:10 ` Laurent Pinchart
2024-11-13 7:35 ` Sakari Ailus
2024-11-13 8:20 ` Jacopo Mondi
2024-11-13 10:18 ` Sakari Ailus
2024-10-11 7:55 ` [RFC 4/4] media: v4l: ctrl: Add V4L2_CID_CONFIG_MODEL control Sakari Ailus
2024-10-22 19:42 ` Laurent Pinchart
2024-11-13 7:37 ` Sakari Ailus
2024-11-13 8:03 ` Hans Verkuil
2024-11-13 8:35 ` Sakari Ailus
2024-11-13 12:26 ` Hans Verkuil
2024-11-18 2:40 ` Laurent Pinchart
2025-02-11 8:31 ` Sakari Ailus
2025-02-13 22:47 ` Laurent Pinchart
2024-10-21 14:29 ` [RFC 0/4] Sub-device configuration models Mikhail Rudenko
2024-10-22 16:05 ` Jacopo Mondi
2024-10-22 17:40 ` Mikhail Rudenko
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=20241011075535.588140-2-sakari.ailus@linux.intel.com \
--to=sakari.ailus@linux.intel.com \
--cc=benjamin.mugnier@foss.st.com \
--cc=christophe.jaillet@wanadoo.fr \
--cc=dave.stevenson@raspberrypi.com \
--cc=eagle.alexander923@gmail.com \
--cc=hpa@redhat.com \
--cc=hverkuil@xs4all.nl \
--cc=julien.massot@collabora.com \
--cc=laurent.pinchart@ideasonboard.com \
--cc=linux-media@vger.kernel.org \
--cc=mike.rudenko@gmail.com \
--cc=naush@raspberrypi.com \
--cc=prabhakar.csengg@gmail.com \
--cc=sylvain.petinot@foss.st.com \
--cc=tomm.merciai@gmail.com \
--cc=umang.jain@ideasonboard.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