sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget8/translations/zh_CN/userspace-api/media/v4l/ext-ctrls-dvmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/zh_TW/userspace-api/media/v4l/ext-ctrls-dvmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/it_IT/userspace-api/media/v4l/ext-ctrls-dvmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ja_JP/userspace-api/media/v4l/ext-ctrls-dvmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ko_KR/userspace-api/media/v4l/ext-ctrls-dvmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/sp_SP/userspace-api/media/v4l/ext-ctrls-dvmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhR/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/ext-ctrls-dv.rsthKubhtarget)}(h.. _dv-controls:h]h}(h]h ]h"]h$]h&]refid dv-controlsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hDigital Video Control Referenceh]hDigital Video Control Reference}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXThe Digital Video control class is intended to control receivers and transmitters for `VGA `__, `DVI `__ (Digital Visual Interface), HDMI (:ref:`hdmi`) and DisplayPort (:ref:`dp`). These controls are generally expected to be private to the receiver or transmitter subdevice that implements them, so they are only exposed on the ``/dev/v4l-subdev*`` device node.h](hVThe Digital Video control class is intended to control receivers and transmitters for }(hhhhhNhNubh reference)}(h*`VGA `__h]hVGA}(hhhhhNhNubah}(h]h ]h"]h$]h&]nameVGArefuri http://en.wikipedia.org/wiki/Vgauh1hhhubh, }(hhhhhNhNubh)}(h?`DVI `__h]hDVI}(hhhhhNhNubah}(h]h ]h"]h$]h&]nameDVIh5http://en.wikipedia.org/wiki/Digital_Visual_Interfaceuh1hhhubh# (Digital Visual Interface), HDMI (}(hhhhhNhNubh)}(h :ref:`hdmi`h]hinline)}(hjh]hhdmi}(hjhhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdoc$userspace-api/media/v4l/ext-ctrls-dv refdomainjreftyperef refexplicitrefwarn reftargethdmiuh1hhhhK hhubh) and DisplayPort (}(hhhhhNhNubh)}(h :ref:`dp`h]j)}(hj9h]hdp}(hj;hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]refdocj+ refdomainjEreftyperef refexplicitrefwarnj1dpuh1hhhhK hhubh). These controls are generally expected to be private to the receiver or transmitter subdevice that implements them, so they are only exposed on the }(hhhhhNhNubhliteral)}(h``/dev/v4l-subdev*``h]h/dev/v4l-subdev*}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hhubh device node.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hhhhubhnote)}(hXNote that these devices can have multiple input or output pads which are hooked up to e.g. HDMI connectors. Even though the subdevice will receive or transmit video from/to only one of those pads, the other pads can still be active when it comes to EDID (Extended Display Identification Data, :ref:`vesaedid`) and HDCP (High-bandwidth Digital Content Protection System, :ref:`hdcp`) processing, allowing the device to do the fairly slow EDID/HDCP handling in advance. This allows for quick switching between connectors.h]h)}(hXNote that these devices can have multiple input or output pads which are hooked up to e.g. HDMI connectors. Even though the subdevice will receive or transmit video from/to only one of those pads, the other pads can still be active when it comes to EDID (Extended Display Identification Data, :ref:`vesaedid`) and HDCP (High-bandwidth Digital Content Protection System, :ref:`hdcp`) processing, allowing the device to do the fairly slow EDID/HDCP handling in advance. This allows for quick switching between connectors.h](hX%Note that these devices can have multiple input or output pads which are hooked up to e.g. HDMI connectors. Even though the subdevice will receive or transmit video from/to only one of those pads, the other pads can still be active when it comes to EDID (Extended Display Identification Data, }(hj{hhhNhNubh)}(h:ref:`vesaedid`h]j)}(hjh]hvesaedid}(hjhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj+ refdomainjreftyperef refexplicitrefwarnj1vesaediduh1hhhhKhj{ubh>) and HDCP (High-bandwidth Digital Content Protection System, }(hj{hhhNhNubh)}(h :ref:`hdcp`h]j)}(hjh]hhdcp}(hjhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj+ refdomainjreftyperef refexplicitrefwarnj1hdcpuh1hhhhKhj{ubh) processing, allowing the device to do the fairly slow EDID/HDCP handling in advance. This allows for quick switching between connectors.}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjwubah}(h]h ]h"]h$]h&]uh1juhhhhhhhNubh)}(hThese pads appear in several of the controls in this section as bitmasks, one bit for each pad. Bit 0 corresponds to pad 0, bit 1 to pad 1, etc. The maximum value of the control is the set of valid pads.h]hThese pads appear in several of the controls in this section as bitmasks, one bit for each pad. Bit 0 corresponds to pad 0, bit 1 to pad 1, etc. The maximum value of the control is the set of valid pads.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h.. _dv-control-id:h]h}(h]h ]h"]h$]h&]h dv-control-iduh1hhK!hhhhhhubh)}(hhh](h)}(hDigital Video Control IDsh]hDigital Video Control IDs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK$ubhdefinition_list)}(hhh](hdefinition_list_item)}(hB``V4L2_CID_DV_CLASS (class)`` The Digital Video class descriptor. h](hterm)}(h``V4L2_CID_DV_CLASS (class)``h]j\)}(hjh]hV4L2_CID_DV_CLASS (class)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjubah}(h]h ]h"]h$]h&]uh1j hhhK'hjubh definition)}(hhh]h)}(h#The Digital Video class descriptor.h]h#The Digital Video class descriptor.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hj'ubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1jhhhK'hjubj)}(hX``V4L2_CID_DV_TX_HOTPLUG (bitmask)`` Many connectors have a hotplug pin which is high if EDID information is available from the source. This control shows the state of the hotplug pin as seen by the transmitter. Each bit corresponds to an output pad on the transmitter. If an output pad does not have an associated hotplug pin, then the bit for that pad will be 0. This read-only control is applicable to DVI-D, HDMI and DisplayPort connectors. h](j )}(h$``V4L2_CID_DV_TX_HOTPLUG (bitmask)``h]j\)}(hjJh]h V4L2_CID_DV_TX_HOTPLUG (bitmask)}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjHubah}(h]h ]h"]h$]h&]uh1j hhhK0hjDubj&)}(hhh]h)}(hXMany connectors have a hotplug pin which is high if EDID information is available from the source. This control shows the state of the hotplug pin as seen by the transmitter. Each bit corresponds to an output pad on the transmitter. If an output pad does not have an associated hotplug pin, then the bit for that pad will be 0. This read-only control is applicable to DVI-D, HDMI and DisplayPort connectors.h]hXMany connectors have a hotplug pin which is high if EDID information is available from the source. This control shows the state of the hotplug pin as seen by the transmitter. Each bit corresponds to an output pad on the transmitter. If an output pad does not have an associated hotplug pin, then the bit for that pad will be 0. This read-only control is applicable to DVI-D, HDMI and DisplayPort connectors.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK*hj_ubah}(h]h ]h"]h$]h&]uh1j%hjDubeh}(h]h ]h"]h$]h&]uh1jhhhK0hjhhubj)}(hX``V4L2_CID_DV_TX_RXSENSE (bitmask)`` Rx Sense is the detection of pull-ups on the TMDS clock lines. This normally means that the sink has left/entered standby (i.e. the transmitter can sense that the receiver is ready to receive video). Each bit corresponds to an output pad on the transmitter. If an output pad does not have an associated Rx Sense, then the bit for that pad will be 0. This read-only control is applicable to DVI-D and HDMI devices. h](j )}(h$``V4L2_CID_DV_TX_RXSENSE (bitmask)``h]j\)}(hjh]h V4L2_CID_DV_TX_RXSENSE (bitmask)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjubah}(h]h ]h"]h$]h&]uh1j hhhK9hj|ubj&)}(hhh]h)}(hXRx Sense is the detection of pull-ups on the TMDS clock lines. This normally means that the sink has left/entered standby (i.e. the transmitter can sense that the receiver is ready to receive video). Each bit corresponds to an output pad on the transmitter. If an output pad does not have an associated Rx Sense, then the bit for that pad will be 0. This read-only control is applicable to DVI-D and HDMI devices.h]hXRx Sense is the detection of pull-ups on the TMDS clock lines. This normally means that the sink has left/entered standby (i.e. the transmitter can sense that the receiver is ready to receive video). Each bit corresponds to an output pad on the transmitter. If an output pad does not have an associated Rx Sense, then the bit for that pad will be 0. This read-only control is applicable to DVI-D and HDMI devices.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1j%hj|ubeh}(h]h ]h"]h$]h&]uh1jhhhK9hjhhubj)}(hX``V4L2_CID_DV_TX_EDID_PRESENT (bitmask)`` When the transmitter sees the hotplug signal from the receiver it will attempt to read the EDID. If set, then the transmitter has read at least the first block (= 128 bytes). Each bit corresponds to an output pad on the transmitter. If an output pad does not support EDIDs, then the bit for that pad will be 0. This read-only control is applicable to VGA, DVI-A/D, HDMI and DisplayPort connectors. h](j )}(h)``V4L2_CID_DV_TX_EDID_PRESENT (bitmask)``h]j\)}(hjh]h%V4L2_CID_DV_TX_EDID_PRESENT (bitmask)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjubah}(h]h ]h"]h$]h&]uh1j hhhKAhjubj&)}(hhh]h)}(hXWhen the transmitter sees the hotplug signal from the receiver it will attempt to read the EDID. If set, then the transmitter has read at least the first block (= 128 bytes). Each bit corresponds to an output pad on the transmitter. If an output pad does not support EDIDs, then the bit for that pad will be 0. This read-only control is applicable to VGA, DVI-A/D, HDMI and DisplayPort connectors.h]hXWhen the transmitter sees the hotplug signal from the receiver it will attempt to read the EDID. If set, then the transmitter has read at least the first block (= 128 bytes). Each bit corresponds to an output pad on the transmitter. If an output pad does not support EDIDs, then the bit for that pad will be 0. This read-only control is applicable to VGA, DVI-A/D, HDMI and DisplayPort connectors.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK