vidioc-g-edid.xml 7.1 KB
Newer Older
1
<refentry id="vidioc-g-edid">
2
  <refmeta>
3
    <refentrytitle>ioctl VIDIOC_G_EDID, VIDIOC_S_EDID, VIDIOC_SUBDEV_G_EDID, VIDIOC_SUBDEV_S_EDID</refentrytitle>
4 5 6 7
    &manvol;
  </refmeta>

  <refnamediv>
8 9
    <refname>VIDIOC_G_EDID</refname>
    <refname>VIDIOC_S_EDID</refname>
10 11
    <refname>VIDIOC_SUBDEV_G_EDID</refname>
    <refname>VIDIOC_SUBDEV_S_EDID</refname>
12 13 14 15 16 17 18 19 20
    <refpurpose>Get or set the EDID of a video receiver/transmitter</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <funcsynopsis>
      <funcprototype>
	<funcdef>int <function>ioctl</function></funcdef>
	<paramdef>int <parameter>fd</parameter></paramdef>
	<paramdef>int <parameter>request</parameter></paramdef>
21
	<paramdef>struct v4l2_edid *<parameter>argp</parameter></paramdef>
22 23 24 25 26 27 28
      </funcprototype>
    </funcsynopsis>
    <funcsynopsis>
      <funcprototype>
	<funcdef>int <function>ioctl</function></funcdef>
	<paramdef>int <parameter>fd</parameter></paramdef>
	<paramdef>int <parameter>request</parameter></paramdef>
29
	<paramdef>struct v4l2_edid *<parameter>argp</parameter></paramdef>
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
      </funcprototype>
    </funcsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Arguments</title>

    <variablelist>
      <varlistentry>
	<term><parameter>fd</parameter></term>
	<listitem>
	  <para>&fd;</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term><parameter>request</parameter></term>
	<listitem>
47
	  <para>VIDIOC_G_EDID, VIDIOC_S_EDID, VIDIOC_SUBDEV_G_EDID, VIDIOC_SUBDEV_S_EDID</para>
48 49 50 51 52 53 54 55 56 57 58 59 60
	</listitem>
      </varlistentry>
      <varlistentry>
	<term><parameter>argp</parameter></term>
	<listitem>
	  <para></para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>Description</title>
61 62 63 64 65 66 67 68 69 70
    <para>These ioctls can be used to get or set an EDID associated with an input
    from a receiver or an output of a transmitter device. They can be
    used with subdevice nodes (/dev/v4l-subdevX) or with video nodes (/dev/videoX).</para>

    <para>When used with video nodes the <structfield>pad</structfield> field represents the
    input (for video capture devices) or output (for video output devices) index as
    is returned by &VIDIOC-ENUMINPUT; and &VIDIOC-ENUMOUTPUT; respectively. When used
    with subdevice nodes the <structfield>pad</structfield> field represents the
    input or output pad of the subdevice. If there is no EDID support for the given
    <structfield>pad</structfield> value, then the &EINVAL; will be returned.</para>
71 72 73

    <para>To get the EDID data the application has to fill in the <structfield>pad</structfield>,
    <structfield>start_block</structfield>, <structfield>blocks</structfield> and <structfield>edid</structfield>
74 75
    fields, zero the <structfield>reserved</structfield> array and call
    <constant>VIDIOC_G_EDID</constant>. The current EDID from block
76 77 78 79 80 81 82 83 84 85 86 87
    <structfield>start_block</structfield> and of size <structfield>blocks</structfield>
    will be placed in the memory <structfield>edid</structfield> points to. The <structfield>edid</structfield>
    pointer must point to memory at least <structfield>blocks</structfield>&nbsp;*&nbsp;128 bytes
    large (the size of one block is 128 bytes).</para>

    <para>If there are fewer blocks than specified, then the driver will set <structfield>blocks</structfield>
    to the actual number of blocks. If there are no EDID blocks available at all, then the error code
    ENODATA is set.</para>

    <para>If blocks have to be retrieved from the sink, then this call will block until they
    have been read.</para>

88 89 90 91 92 93 94
    <para>If <structfield>start_block</structfield> and <structfield>blocks</structfield> are
    both set to 0 when <constant>VIDIOC_G_EDID</constant> is called, then the driver will
    set <structfield>blocks</structfield> to the total number of available EDID blocks
    and it will return 0 without copying any data. This is an easy way to discover how many
    EDID blocks there are. Note that if there are no EDID blocks available at all, then
    the driver will set <structfield>blocks</structfield> to 0 and it returns 0.</para>

95
    <para>To set the EDID blocks of a receiver the application has to fill in the <structfield>pad</structfield>,
96 97 98
    <structfield>blocks</structfield> and <structfield>edid</structfield> fields, set
    <structfield>start_block</structfield> to 0 and zero the <structfield>reserved</structfield> array.
    It is not possible to set part of an EDID,
99 100 101 102 103 104 105 106 107 108 109 110 111 112
    it is always all or nothing. Setting the EDID data is only valid for receivers as it makes
    no sense for a transmitter.</para>

    <para>The driver assumes that the full EDID is passed in. If there are more EDID blocks than
    the hardware can handle then the EDID is not written, but instead the error code E2BIG is set
    and <structfield>blocks</structfield> is set to the maximum that the hardware supports.
    If <structfield>start_block</structfield> is any
    value other than 0 then the error code EINVAL is set.</para>

    <para>To disable an EDID you set <structfield>blocks</structfield> to 0. Depending on the
    hardware this will drive the hotplug pin low and/or block the source from reading the EDID
    data in some way. In any case, the end result is the same: the EDID is no longer available.
    </para>

113 114
    <table pgwide="1" frame="none" id="v4l2-edid">
      <title>struct <structname>v4l2_edid</structname></title>
115 116 117 118 119 120
      <tgroup cols="3">
        &cs-str;
	<tbody valign="top">
	  <row>
	    <entry>__u32</entry>
	    <entry><structfield>pad</structfield></entry>
121 122 123
	    <entry>Pad for which to get/set the EDID blocks. When used with a video device
	    node the pad represents the input or output index as returned by
	    &VIDIOC-ENUMINPUT; and &VIDIOC-ENUMOUTPUT; respectively.</entry>
124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143
	  </row>
	  <row>
	    <entry>__u32</entry>
	    <entry><structfield>start_block</structfield></entry>
	    <entry>Read the EDID from starting with this block. Must be 0 when setting
	    the EDID.</entry>
	  </row>
	  <row>
	    <entry>__u32</entry>
	    <entry><structfield>blocks</structfield></entry>
	    <entry>The number of blocks to get or set. Must be less or equal to 256 (the
	    maximum number of blocks as defined by the standard). When you set the EDID and
	    <structfield>blocks</structfield> is 0, then the EDID is disabled or erased.</entry>
	  </row>
	  <row>
	    <entry>__u32</entry>
	    <entry><structfield>reserved</structfield>[5]</entry>
	    <entry>Reserved for future extensions. Applications and drivers must
	    set the array to zero.</entry>
	  </row>
144 145 146 147 148 149
	  <row>
	    <entry>__u8&nbsp;*</entry>
	    <entry><structfield>edid</structfield></entry>
	    <entry>Pointer to memory that contains the EDID. The minimum size is
	    <structfield>blocks</structfield>&nbsp;*&nbsp;128.</entry>
	  </row>
150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173
	</tbody>
      </tgroup>
    </table>
  </refsect1>

  <refsect1>
    &return-value;

    <variablelist>
      <varlistentry>
	<term><errorcode>ENODATA</errorcode></term>
	<listitem>
	  <para>The EDID data is not available.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term><errorcode>E2BIG</errorcode></term>
	<listitem>
	  <para>The EDID data you provided is more than the hardware can handle.</para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
</refentry>