media/v4l/ext-ctrls-dv.rst

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
3 .. _dv-controls:
12 (Digital Visual Interface), HDMI (:ref:`hdmi`) and DisplayPort
15 only exposed on the ``/dev/v4l-subdev*`` device node.
20    hooked up to e.g. HDMI connectors. Even though the subdevice will
23    Identification Data, :ref:`vesaedid`) and HDCP (High-bandwidth Digital
25    device to do the fairly slow EDID/HDCP handling in advance. This allows
28 These pads appear in several of the controls in this section as
33 .. _dv-control-id:
47     read-only control is applicable to DVI-D, HDMI and DisplayPort
51     Rx Sense is the detection of pull-ups on the TMDS clock lines. This
56     that pad will be 0. This read-only control is applicable to DVI-D
57     and HDMI devices.
64     EDIDs, then the bit for that pad will be 0. This read-only control
65     is applicable to VGA, DVI-A/D, HDMI and DisplayPort connectors.
70 enum v4l2_dv_tx_mode -
71     HDMI transmitters can transmit in DVI-D mode (just video) or in HDMI
74     This control is applicable to HDMI connectors.
79 enum v4l2_dv_rgb_range -
81     follows the RGB quantization range specified in the standard for the
82     video interface (ie. :ref:`cea861` for HDMI).
85     standard correctly (unfortunately quite common for HDMI and DVI-D).
87     range sets the range to (16 << (N-8)) - (235 << (N-8)) where N is
89     DVI-A/D, HDMI and DisplayPort connectors.
94 enum v4l2_dv_it_content_type -
96     information is sent over HDMI and DisplayPort connectors as part of
104 .. flat-table::
105     :header-rows:  0
106     :stub-columns: 0
108     * - ``V4L2_DV_IT_CONTENT_TYPE_GRAPHICS``
109       - Graphics content. Pixel data should be passed unfiltered and
111     * - ``V4L2_DV_IT_CONTENT_TYPE_PHOTO``
112       - Photo content. The content is derived from digital still pictures.
115     * - ``V4L2_DV_IT_CONTENT_TYPE_CINEMA``
116       - Cinema content.
117     * - ``V4L2_DV_IT_CONTENT_TYPE_GAME``
118       - Game content. Audio and video latency should be minimized.
119     * - ``V4L2_DV_IT_CONTENT_TYPE_NO_ITC``
120       - No IT Content information is available and the ITC bit in the AVI
127     HDMI carries 5V on one of the pins). This is often used to power an
129     read the EDID even if the sink is in standby/power off. Each bit
132     will be 0. This read-only control is applicable to DVI-D, HDMI and
138 enum v4l2_dv_rgb_range -
140     follows the RGB quantization range specified in the standard for the
141     video interface (ie. :ref:`cea861` for HDMI).
144     standard correctly (unfortunately quite common for HDMI and DVI-D).
146     range sets the range to (16 << (N-8)) - (235 << (N-8)) where N is
148     DVI-A/D, HDMI and DisplayPort connectors.
153 enum v4l2_dv_it_content_type -
155     sent over HDMI and DisplayPort connectors as part of the AVI