diff mbox series

[3/6] media: docs: Add V4L2_CAP_EDID

Message ID 5b880a060574363d5ea351e20e0766abb476f6db.1723190258.git.hverkuil-cisco@xs4all.nl
State New
Headers show
Series media: cec: add support for the Extron DA HD 4K Plus HDMI Splitter | expand

Commit Message

Hans Verkuil Aug. 9, 2024, 7:57 a.m. UTC
From: Erling Ljunggren <hljunggr@cisco.com>

Add documentation for the new edid capability.

Signed-off-by: Erling Ljunggren <hljunggr@cisco.com>
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
---
 Documentation/userspace-api/media/v4l/biblio.rst      | 11 +++++++++++
 .../userspace-api/media/v4l/vidioc-querycap.rst       | 11 +++++++++++
 .../userspace-api/media/videodev2.h.rst.exceptions    |  1 +
 3 files changed, 23 insertions(+)

Comments

Sebastian Fricke Aug. 28, 2024, 12:38 p.m. UTC | #1
Hello,

On 09.08.2024 09:57, Hans Verkuil wrote:
>From: Erling Ljunggren <hljunggr@cisco.com>
>
>Add documentation for the new edid capability.
>
>Signed-off-by: Erling Ljunggren <hljunggr@cisco.com>
>Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>

Reviewed-by: Sebastian Fricke <sebastian.fricke@collabora.com>

Regards,
Sebastian

>---
> Documentation/userspace-api/media/v4l/biblio.rst      | 11 +++++++++++
> .../userspace-api/media/v4l/vidioc-querycap.rst       | 11 +++++++++++
> .../userspace-api/media/videodev2.h.rst.exceptions    |  1 +
> 3 files changed, 23 insertions(+)
>
>diff --git a/Documentation/userspace-api/media/v4l/biblio.rst b/Documentation/userspace-api/media/v4l/biblio.rst
>index 72aef1759b60..35674eeae20d 100644
>--- a/Documentation/userspace-api/media/v4l/biblio.rst
>+++ b/Documentation/userspace-api/media/v4l/biblio.rst
>@@ -334,6 +334,17 @@ VESA DMT
>
> :author:    Video Electronics Standards Association (http://www.vesa.org)
>
>+.. _vesaeddc:
>+
>+E-DDC
>+=====
>+
>+
>+:title:     VESA Enhanced Display Data Channel (E-DDC) Standard
>+:subtitle:  Version 1.3
>+
>+:author:    Video Electronics Standards Association (http://www.vesa.org)
>+
> .. _vesaedid:
>
> EDID
>diff --git a/Documentation/userspace-api/media/v4l/vidioc-querycap.rst b/Documentation/userspace-api/media/v4l/vidioc-querycap.rst
>index 6c57b8428356..3d11d86d9cbf 100644
>--- a/Documentation/userspace-api/media/v4l/vidioc-querycap.rst
>+++ b/Documentation/userspace-api/media/v4l/vidioc-querycap.rst
>@@ -244,6 +244,17 @@ specification the ioctl returns an ``EINVAL`` error code.
>       - 0x01000000
>       - The device supports the :c:func:`read()` and/or
> 	:c:func:`write()` I/O methods.
>+    * - ``V4L2_CAP_EDID``
>+      - 0x02000000
>+      - The device stores the EDID for a video input, or retrieves the EDID for a video
>+        output. It is a standalone EDID device, so no video streaming etc. will take place.
>+
>+        For a video input this is typically an eeprom that supports the
>+        :ref:`VESA Enhanced Display Data Channel Standard <vesaeddc>`. It can be something
>+        else as well, for example a micro controller.
>+
>+        For a video output this is typically read from an external device such as an
>+        HDMI splitter accessed by a serial port.
>     * - ``V4L2_CAP_STREAMING``
>       - 0x04000000
>       - The device supports the :ref:`streaming <mmap>` I/O method.
>diff --git a/Documentation/userspace-api/media/videodev2.h.rst.exceptions b/Documentation/userspace-api/media/videodev2.h.rst.exceptions
>index bdc628e8c1d6..d67fd4038d22 100644
>--- a/Documentation/userspace-api/media/videodev2.h.rst.exceptions
>+++ b/Documentation/userspace-api/media/videodev2.h.rst.exceptions
>@@ -197,6 +197,7 @@ replace define V4L2_CAP_META_OUTPUT device-capabilities
> replace define V4L2_CAP_DEVICE_CAPS device-capabilities
> replace define V4L2_CAP_TOUCH device-capabilities
> replace define V4L2_CAP_IO_MC device-capabilities
>+replace define V4L2_CAP_EDID device-capabilities
>
> # V4L2 pix flags
> replace define V4L2_PIX_FMT_PRIV_MAGIC :c:type:`v4l2_pix_format`
>-- 
>2.43.0
>
>
diff mbox series

Patch

diff --git a/Documentation/userspace-api/media/v4l/biblio.rst b/Documentation/userspace-api/media/v4l/biblio.rst
index 72aef1759b60..35674eeae20d 100644
--- a/Documentation/userspace-api/media/v4l/biblio.rst
+++ b/Documentation/userspace-api/media/v4l/biblio.rst
@@ -334,6 +334,17 @@  VESA DMT
 
 :author:    Video Electronics Standards Association (http://www.vesa.org)
 
+.. _vesaeddc:
+
+E-DDC
+=====
+
+
+:title:     VESA Enhanced Display Data Channel (E-DDC) Standard
+:subtitle:  Version 1.3
+
+:author:    Video Electronics Standards Association (http://www.vesa.org)
+
 .. _vesaedid:
 
 EDID
diff --git a/Documentation/userspace-api/media/v4l/vidioc-querycap.rst b/Documentation/userspace-api/media/v4l/vidioc-querycap.rst
index 6c57b8428356..3d11d86d9cbf 100644
--- a/Documentation/userspace-api/media/v4l/vidioc-querycap.rst
+++ b/Documentation/userspace-api/media/v4l/vidioc-querycap.rst
@@ -244,6 +244,17 @@  specification the ioctl returns an ``EINVAL`` error code.
       - 0x01000000
       - The device supports the :c:func:`read()` and/or
 	:c:func:`write()` I/O methods.
+    * - ``V4L2_CAP_EDID``
+      - 0x02000000
+      - The device stores the EDID for a video input, or retrieves the EDID for a video
+        output. It is a standalone EDID device, so no video streaming etc. will take place.
+
+        For a video input this is typically an eeprom that supports the
+        :ref:`VESA Enhanced Display Data Channel Standard <vesaeddc>`. It can be something
+        else as well, for example a micro controller.
+
+        For a video output this is typically read from an external device such as an
+        HDMI splitter accessed by a serial port.
     * - ``V4L2_CAP_STREAMING``
       - 0x04000000
       - The device supports the :ref:`streaming <mmap>` I/O method.
diff --git a/Documentation/userspace-api/media/videodev2.h.rst.exceptions b/Documentation/userspace-api/media/videodev2.h.rst.exceptions
index bdc628e8c1d6..d67fd4038d22 100644
--- a/Documentation/userspace-api/media/videodev2.h.rst.exceptions
+++ b/Documentation/userspace-api/media/videodev2.h.rst.exceptions
@@ -197,6 +197,7 @@  replace define V4L2_CAP_META_OUTPUT device-capabilities
 replace define V4L2_CAP_DEVICE_CAPS device-capabilities
 replace define V4L2_CAP_TOUCH device-capabilities
 replace define V4L2_CAP_IO_MC device-capabilities
+replace define V4L2_CAP_EDID device-capabilities
 
 # V4L2 pix flags
 replace define V4L2_PIX_FMT_PRIV_MAGIC :c:type:`v4l2_pix_format`