aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook/media
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/DocBook/media')
-rw-r--r--Documentation/DocBook/media/v4l/biblio.xml11
-rw-r--r--Documentation/DocBook/media/v4l/compat.xml2
-rw-r--r--Documentation/DocBook/media/v4l/dev-sliced-vbi.xml2
-rw-r--r--Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml92
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt-packed-rgb.xml79
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt-sgrbg8.xml16
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml2
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt-yuv420m.xml4
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt.xml110
-rw-r--r--Documentation/DocBook/media/v4l/subdev-formats.xml681
-rw-r--r--Documentation/DocBook/media/v4l/v4l2.xml9
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-cropcap.xml9
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-dqevent.xml121
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-g-crop.xml5
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-g-dv-timings.xml18
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml4
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-g-selection.xml4
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-g-sliced-vbi-cap.xml2
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-querycap.xml8
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-queryctrl.xml12
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-interval.xml13
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-size.xml13
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-subdev-enum-mbus-code.xml11
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-subscribe-event.xml111
24 files changed, 723 insertions, 616 deletions
diff --git a/Documentation/DocBook/media/v4l/biblio.xml b/Documentation/DocBook/media/v4l/biblio.xml
index 7ff01a23c2fe..fdee6b3f3eca 100644
--- a/Documentation/DocBook/media/v4l/biblio.xml
+++ b/Documentation/DocBook/media/v4l/biblio.xml
@@ -1,14 +1,13 @@
1 <bibliography> 1 <bibliography>
2 <title>References</title> 2 <title>References</title>
3 3
4 <biblioentry id="eia608"> 4 <biblioentry id="cea608">
5 <abbrev>EIA&nbsp;608-B</abbrev> 5 <abbrev>CEA&nbsp;608-E</abbrev>
6 <authorgroup> 6 <authorgroup>
7 <corpauthor>Electronic Industries Alliance (<ulink 7 <corpauthor>Consumer Electronics Association (<ulink
8url="http://www.eia.org">http://www.eia.org</ulink>)</corpauthor> 8url="http://www.ce.org">http://www.ce.org</ulink>)</corpauthor>
9 </authorgroup> 9 </authorgroup>
10 <title>EIA 608-B "Recommended Practice for Line 21 Data 10 <title>CEA-608-E R-2014 "Line 21 Data Services"</title>
11Service"</title>
12 </biblioentry> 11 </biblioentry>
13 12
14 <biblioentry id="en300294"> 13 <biblioentry id="en300294">
diff --git a/Documentation/DocBook/media/v4l/compat.xml b/Documentation/DocBook/media/v4l/compat.xml
index 350dfb3d71ea..a0aef85d33c1 100644
--- a/Documentation/DocBook/media/v4l/compat.xml
+++ b/Documentation/DocBook/media/v4l/compat.xml
@@ -2491,7 +2491,7 @@ that used it. It was originally scheduled for removal in 2.6.35.
2491 </listitem> 2491 </listitem>
2492 <listitem> 2492 <listitem>
2493 <para>Added <constant>V4L2_EVENT_CTRL_CH_RANGE</constant> control event 2493 <para>Added <constant>V4L2_EVENT_CTRL_CH_RANGE</constant> control event
2494 changes flag. See <xref linkend="changes-flags"/>.</para> 2494 changes flag. See <xref linkend="ctrl-changes-flags"/>.</para>
2495 </listitem> 2495 </listitem>
2496 </orderedlist> 2496 </orderedlist>
2497 </section> 2497 </section>
diff --git a/Documentation/DocBook/media/v4l/dev-sliced-vbi.xml b/Documentation/DocBook/media/v4l/dev-sliced-vbi.xml
index 7a8bf3011ee9..0aec62ed2bf8 100644
--- a/Documentation/DocBook/media/v4l/dev-sliced-vbi.xml
+++ b/Documentation/DocBook/media/v4l/dev-sliced-vbi.xml
@@ -254,7 +254,7 @@ ETS&nbsp;300&nbsp;231, lsb first transmitted.</entry>
254 <row> 254 <row>
255 <entry><constant>V4L2_SLICED_CAPTION_525</constant></entry> 255 <entry><constant>V4L2_SLICED_CAPTION_525</constant></entry>
256 <entry>0x1000</entry> 256 <entry>0x1000</entry>
257 <entry><xref linkend="eia608" /></entry> 257 <entry><xref linkend="cea608" /></entry>
258 <entry>NTSC line 21, 284 (second field 21)</entry> 258 <entry>NTSC line 21, 284 (second field 21)</entry>
259 <entry>Two bytes in transmission order, including parity 259 <entry>Two bytes in transmission order, including parity
260bit, lsb first transmitted.</entry> 260bit, lsb first transmitted.</entry>
diff --git a/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml b/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
index 116c301656e0..5872f8bbf774 100644
--- a/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
+++ b/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
@@ -143,86 +143,28 @@
143 <row> 143 <row>
144 <entry></entry> 144 <entry></entry>
145 <entry>struct</entry> 145 <entry>struct</entry>
146 <entry><structfield>v4l</structfield></entry> 146 <entry><structfield>dev</structfield></entry>
147 <entry></entry> 147 <entry></entry>
148 <entry>Valid for V4L sub-devices and nodes only.</entry> 148 <entry>Valid for (sub-)devices that create a single device node.</entry>
149 </row> 149 </row>
150 <row> 150 <row>
151 <entry></entry> 151 <entry></entry>
152 <entry></entry> 152 <entry></entry>
153 <entry>__u32</entry> 153 <entry>__u32</entry>
154 <entry><structfield>major</structfield></entry> 154 <entry><structfield>major</structfield></entry>
155 <entry>V4L device node major number. For V4L sub-devices with no 155 <entry>Device node major number.</entry>
156 device node, set by the driver to 0.</entry>
157 </row> 156 </row>
158 <row> 157 <row>
159 <entry></entry> 158 <entry></entry>
160 <entry></entry> 159 <entry></entry>
161 <entry>__u32</entry> 160 <entry>__u32</entry>
162 <entry><structfield>minor</structfield></entry> 161 <entry><structfield>minor</structfield></entry>
163 <entry>V4L device node minor number. For V4L sub-devices with no 162 <entry>Device node minor number.</entry>
164 device node, set by the driver to 0.</entry>
165 </row>
166 <row>
167 <entry></entry>
168 <entry>struct</entry>
169 <entry><structfield>fb</structfield></entry>
170 <entry></entry>
171 <entry>Valid for frame buffer nodes only.</entry>
172 </row>
173 <row>
174 <entry></entry>
175 <entry></entry>
176 <entry>__u32</entry>
177 <entry><structfield>major</structfield></entry>
178 <entry>Frame buffer device node major number.</entry>
179 </row>
180 <row>
181 <entry></entry>
182 <entry></entry>
183 <entry>__u32</entry>
184 <entry><structfield>minor</structfield></entry>
185 <entry>Frame buffer device node minor number.</entry>
186 </row>
187 <row>
188 <entry></entry>
189 <entry>struct</entry>
190 <entry><structfield>alsa</structfield></entry>
191 <entry></entry>
192 <entry>Valid for ALSA devices only.</entry>
193 </row>
194 <row>
195 <entry></entry>
196 <entry></entry>
197 <entry>__u32</entry>
198 <entry><structfield>card</structfield></entry>
199 <entry>ALSA card number</entry>
200 </row>
201 <row>
202 <entry></entry>
203 <entry></entry>
204 <entry>__u32</entry>
205 <entry><structfield>device</structfield></entry>
206 <entry>ALSA device number</entry>
207 </row>
208 <row>
209 <entry></entry>
210 <entry></entry>
211 <entry>__u32</entry>
212 <entry><structfield>subdevice</structfield></entry>
213 <entry>ALSA sub-device number</entry>
214 </row>
215 <row>
216 <entry></entry>
217 <entry>int</entry>
218 <entry><structfield>dvb</structfield></entry>
219 <entry></entry>
220 <entry>DVB card number</entry>
221 </row> 163 </row>
222 <row> 164 <row>
223 <entry></entry> 165 <entry></entry>
224 <entry>__u8</entry> 166 <entry>__u8</entry>
225 <entry><structfield>raw</structfield>[180]</entry> 167 <entry><structfield>raw</structfield>[184]</entry>
226 <entry></entry> 168 <entry></entry>
227 <entry></entry> 169 <entry></entry>
228 </row> 170 </row>
@@ -253,8 +195,24 @@
253 <entry>ALSA card</entry> 195 <entry>ALSA card</entry>
254 </row> 196 </row>
255 <row> 197 <row>
256 <entry><constant>MEDIA_ENT_T_DEVNODE_DVB</constant></entry> 198 <entry><constant>MEDIA_ENT_T_DEVNODE_DVB_FE</constant></entry>
257 <entry>DVB card</entry> 199 <entry>DVB frontend devnode</entry>
200 </row>
201 <row>
202 <entry><constant>MEDIA_ENT_T_DEVNODE_DVB_DEMUX</constant></entry>
203 <entry>DVB demux devnode</entry>
204 </row>
205 <row>
206 <entry><constant>MEDIA_ENT_T_DEVNODE_DVB_DVR</constant></entry>
207 <entry>DVB DVR devnode</entry>
208 </row>
209 <row>
210 <entry><constant>MEDIA_ENT_T_DEVNODE_DVB_CA</constant></entry>
211 <entry>DVB CAM devnode</entry>
212 </row>
213 <row>
214 <entry><constant>MEDIA_ENT_T_DEVNODE_DVB_NET</constant></entry>
215 <entry>DVB network devnode</entry>
258 </row> 216 </row>
259 <row> 217 <row>
260 <entry><constant>MEDIA_ENT_T_V4L2_SUBDEV</constant></entry> 218 <entry><constant>MEDIA_ENT_T_V4L2_SUBDEV</constant></entry>
@@ -282,6 +240,10 @@
282 it in some digital video standard, with appropriate embedded timing 240 it in some digital video standard, with appropriate embedded timing
283 signals.</entry> 241 signals.</entry>
284 </row> 242 </row>
243 <row>
244 <entry><constant>MEDIA_ENT_T_V4L2_SUBDEV_TUNER</constant></entry>
245 <entry>TV and/or radio tuner</entry>
246 </row>
285 </tbody> 247 </tbody>
286 </tgroup> 248 </tgroup>
287 </table> 249 </table>
diff --git a/Documentation/DocBook/media/v4l/pixfmt-packed-rgb.xml b/Documentation/DocBook/media/v4l/pixfmt-packed-rgb.xml
index 6ab4f0f3db64..b60fb935b91b 100644
--- a/Documentation/DocBook/media/v4l/pixfmt-packed-rgb.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt-packed-rgb.xml
@@ -303,45 +303,6 @@ for a pixel lie next to each other in memory.</para>
303 <entry>b<subscript>1</subscript></entry> 303 <entry>b<subscript>1</subscript></entry>
304 <entry>b<subscript>0</subscript></entry> 304 <entry>b<subscript>0</subscript></entry>
305 </row> 305 </row>
306 <row id="V4L2-PIX-FMT-BGR666">
307 <entry><constant>V4L2_PIX_FMT_BGR666</constant></entry>
308 <entry>'BGRH'</entry>
309 <entry></entry>
310 <entry>b<subscript>5</subscript></entry>
311 <entry>b<subscript>4</subscript></entry>
312 <entry>b<subscript>3</subscript></entry>
313 <entry>b<subscript>2</subscript></entry>
314 <entry>b<subscript>1</subscript></entry>
315 <entry>b<subscript>0</subscript></entry>
316 <entry>g<subscript>5</subscript></entry>
317 <entry>g<subscript>4</subscript></entry>
318 <entry></entry>
319 <entry>g<subscript>3</subscript></entry>
320 <entry>g<subscript>2</subscript></entry>
321 <entry>g<subscript>1</subscript></entry>
322 <entry>g<subscript>0</subscript></entry>
323 <entry>r<subscript>5</subscript></entry>
324 <entry>r<subscript>4</subscript></entry>
325 <entry>r<subscript>3</subscript></entry>
326 <entry>r<subscript>2</subscript></entry>
327 <entry></entry>
328 <entry>r<subscript>1</subscript></entry>
329 <entry>r<subscript>0</subscript></entry>
330 <entry></entry>
331 <entry></entry>
332 <entry></entry>
333 <entry></entry>
334 <entry></entry>
335 <entry></entry>
336 <entry></entry>
337 <entry></entry>
338 <entry></entry>
339 <entry></entry>
340 <entry></entry>
341 <entry></entry>
342 <entry></entry>
343 <entry></entry>
344 </row>
345 <row id="V4L2-PIX-FMT-BGR24"> 306 <row id="V4L2-PIX-FMT-BGR24">
346 <entry><constant>V4L2_PIX_FMT_BGR24</constant></entry> 307 <entry><constant>V4L2_PIX_FMT_BGR24</constant></entry>
347 <entry>'BGR3'</entry> 308 <entry>'BGR3'</entry>
@@ -404,6 +365,46 @@ for a pixel lie next to each other in memory.</para>
404 <entry>b<subscript>1</subscript></entry> 365 <entry>b<subscript>1</subscript></entry>
405 <entry>b<subscript>0</subscript></entry> 366 <entry>b<subscript>0</subscript></entry>
406 </row> 367 </row>
368 <row id="V4L2-PIX-FMT-BGR666">
369 <entry><constant>V4L2_PIX_FMT_BGR666</constant></entry>
370 <entry>'BGRH'</entry>
371 <entry></entry>
372 <entry>b<subscript>5</subscript></entry>
373 <entry>b<subscript>4</subscript></entry>
374 <entry>b<subscript>3</subscript></entry>
375 <entry>b<subscript>2</subscript></entry>
376 <entry>b<subscript>1</subscript></entry>
377 <entry>b<subscript>0</subscript></entry>
378 <entry>g<subscript>5</subscript></entry>
379 <entry>g<subscript>4</subscript></entry>
380 <entry></entry>
381 <entry>g<subscript>3</subscript></entry>
382 <entry>g<subscript>2</subscript></entry>
383 <entry>g<subscript>1</subscript></entry>
384 <entry>g<subscript>0</subscript></entry>
385 <entry>r<subscript>5</subscript></entry>
386 <entry>r<subscript>4</subscript></entry>
387 <entry>r<subscript>3</subscript></entry>
388 <entry>r<subscript>2</subscript></entry>
389 <entry></entry>
390 <entry>r<subscript>1</subscript></entry>
391 <entry>r<subscript>0</subscript></entry>
392 <entry>-</entry>
393 <entry>-</entry>
394 <entry>-</entry>
395 <entry>-</entry>
396 <entry>-</entry>
397 <entry>-</entry>
398 <entry></entry>
399 <entry>-</entry>
400 <entry>-</entry>
401 <entry>-</entry>
402 <entry>-</entry>
403 <entry>-</entry>
404 <entry>-</entry>
405 <entry>-</entry>
406 <entry>-</entry>
407 </row>
407 <row id="V4L2-PIX-FMT-ABGR32"> 408 <row id="V4L2-PIX-FMT-ABGR32">
408 <entry><constant>V4L2_PIX_FMT_ABGR32</constant></entry> 409 <entry><constant>V4L2_PIX_FMT_ABGR32</constant></entry>
409 <entry>'AR24'</entry> 410 <entry>'AR24'</entry>
diff --git a/Documentation/DocBook/media/v4l/pixfmt-sgrbg8.xml b/Documentation/DocBook/media/v4l/pixfmt-sgrbg8.xml
index 19727ab4c757..7803b8c41b45 100644
--- a/Documentation/DocBook/media/v4l/pixfmt-sgrbg8.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt-sgrbg8.xml
@@ -38,10 +38,10 @@ columns and rows.</para>
38 </row> 38 </row>
39 <row> 39 <row>
40 <entry>start&nbsp;+&nbsp;4:</entry> 40 <entry>start&nbsp;+&nbsp;4:</entry>
41 <entry>R<subscript>10</subscript></entry> 41 <entry>B<subscript>10</subscript></entry>
42 <entry>B<subscript>11</subscript></entry> 42 <entry>G<subscript>11</subscript></entry>
43 <entry>R<subscript>12</subscript></entry> 43 <entry>B<subscript>12</subscript></entry>
44 <entry>B<subscript>13</subscript></entry> 44 <entry>G<subscript>13</subscript></entry>
45 </row> 45 </row>
46 <row> 46 <row>
47 <entry>start&nbsp;+&nbsp;8:</entry> 47 <entry>start&nbsp;+&nbsp;8:</entry>
@@ -52,10 +52,10 @@ columns and rows.</para>
52 </row> 52 </row>
53 <row> 53 <row>
54 <entry>start&nbsp;+&nbsp;12:</entry> 54 <entry>start&nbsp;+&nbsp;12:</entry>
55 <entry>R<subscript>30</subscript></entry> 55 <entry>B<subscript>30</subscript></entry>
56 <entry>B<subscript>31</subscript></entry> 56 <entry>G<subscript>31</subscript></entry>
57 <entry>R<subscript>32</subscript></entry> 57 <entry>B<subscript>32</subscript></entry>
58 <entry>B<subscript>33</subscript></entry> 58 <entry>G<subscript>33</subscript></entry>
59 </row> 59 </row>
60 </tbody> 60 </tbody>
61 </tgroup> 61 </tgroup>
diff --git a/Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml b/Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml
index 30aa63581fe3..a8cc102cde4f 100644
--- a/Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml
@@ -38,7 +38,7 @@
38 <title>Byte Order.</title> 38 <title>Byte Order.</title>
39 <para>Each cell is one byte. 39 <para>Each cell is one byte.
40 <informaltable frame="topbot" colsep="1" rowsep="1"> 40 <informaltable frame="topbot" colsep="1" rowsep="1">
41 <tgroup cols="5" align="center" border="1"> 41 <tgroup cols="5" align="center">
42 <colspec align="left" colwidth="2*" /> 42 <colspec align="left" colwidth="2*" />
43 <tbody valign="top"> 43 <tbody valign="top">
44 <row> 44 <row>
diff --git a/Documentation/DocBook/media/v4l/pixfmt-yuv420m.xml b/Documentation/DocBook/media/v4l/pixfmt-yuv420m.xml
index 60308f1eefdf..e781cc61786c 100644
--- a/Documentation/DocBook/media/v4l/pixfmt-yuv420m.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt-yuv420m.xml
@@ -29,12 +29,12 @@ and Cr planes have half as many pad bytes after their rows. In other
29words, two Cx rows (including padding) is exactly as long as one Y row 29words, two Cx rows (including padding) is exactly as long as one Y row
30(including padding).</para> 30(including padding).</para>
31 31
32 <para><constant>V4L2_PIX_FMT_NV12M</constant> is intended to be 32 <para><constant>V4L2_PIX_FMT_YUV420M</constant> is intended to be
33used only in drivers and applications that support the multi-planar API, 33used only in drivers and applications that support the multi-planar API,
34described in <xref linkend="planar-apis"/>. </para> 34described in <xref linkend="planar-apis"/>. </para>
35 35
36 <example> 36 <example>
37 <title><constant>V4L2_PIX_FMT_YVU420M</constant> 4 &times; 4 37 <title><constant>V4L2_PIX_FMT_YUV420M</constant> 4 &times; 4
38pixel image</title> 38pixel image</title>
39 39
40 <formalpara> 40 <formalpara>
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index 5e0352c50324..fcde4e20205e 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -80,9 +80,9 @@ padding bytes after the last line of an image cross a system page
80boundary. Input devices may write padding bytes, the value is 80boundary. Input devices may write padding bytes, the value is
81undefined. Output devices ignore the contents of padding 81undefined. Output devices ignore the contents of padding
82bytes.</para><para>When the image format is planar the 82bytes.</para><para>When the image format is planar the
83<structfield>bytesperline</structfield> value applies to the largest 83<structfield>bytesperline</structfield> value applies to the first
84plane and is divided by the same factor as the 84plane and is divided by the same factor as the
85<structfield>width</structfield> field for any smaller planes. For 85<structfield>width</structfield> field for the other planes. For
86example the Cb and Cr planes of a YUV 4:2:0 image have half as many 86example the Cb and Cr planes of a YUV 4:2:0 image have half as many
87padding bytes following each line as the Y plane. To avoid ambiguities 87padding bytes following each line as the Y plane. To avoid ambiguities
88drivers must return a <structfield>bytesperline</structfield> value 88drivers must return a <structfield>bytesperline</structfield> value
@@ -182,14 +182,14 @@ see <xref linkend="colorspaces" />.</entry>
182 </entry> 182 </entry>
183 </row> 183 </row>
184 <row> 184 <row>
185 <entry>__u16</entry> 185 <entry>__u32</entry>
186 <entry><structfield>bytesperline</structfield></entry> 186 <entry><structfield>bytesperline</structfield></entry>
187 <entry>Distance in bytes between the leftmost pixels in two adjacent 187 <entry>Distance in bytes between the leftmost pixels in two adjacent
188 lines. See &v4l2-pix-format;.</entry> 188 lines. See &v4l2-pix-format;.</entry>
189 </row> 189 </row>
190 <row> 190 <row>
191 <entry>__u16</entry> 191 <entry>__u16</entry>
192 <entry><structfield>reserved[7]</structfield></entry> 192 <entry><structfield>reserved[6]</structfield></entry>
193 <entry>Reserved for future extensions. Should be zeroed by the 193 <entry>Reserved for future extensions. Should be zeroed by the
194 application.</entry> 194 application.</entry>
195 </row> 195 </row>
@@ -483,8 +483,8 @@ is the Y'CbCr encoding identifier (&v4l2-ycbcr-encoding;) to specify non-standar
483Y'CbCr encodings and the third is the quantization identifier (&v4l2-quantization;) 483Y'CbCr encodings and the third is the quantization identifier (&v4l2-quantization;)
484to specify non-standard quantization methods. Most of the time only the colorspace 484to specify non-standard quantization methods. Most of the time only the colorspace
485field of &v4l2-pix-format; or &v4l2-pix-format-mplane; needs to be filled in. Note 485field of &v4l2-pix-format; or &v4l2-pix-format-mplane; needs to be filled in. Note
486that the default R'G'B' quantization is always full range for all colorspaces, 486that the default R'G'B' quantization is full range for all colorspaces except for
487so this won't be mentioned explicitly for each colorspace description.</para> 487BT.2020 which uses limited range R'G'B' quantization.</para>
488 488
489 <table pgwide="1" frame="none" id="v4l2-colorspace"> 489 <table pgwide="1" frame="none" id="v4l2-colorspace">
490 <title>V4L2 Colorspaces</title> 490 <title>V4L2 Colorspaces</title>
@@ -598,7 +598,8 @@ so this won't be mentioned explicitly for each colorspace description.</para>
598 <row> 598 <row>
599 <entry><constant>V4L2_QUANTIZATION_DEFAULT</constant></entry> 599 <entry><constant>V4L2_QUANTIZATION_DEFAULT</constant></entry>
600 <entry>Use the default quantization encoding as defined by the colorspace. 600 <entry>Use the default quantization encoding as defined by the colorspace.
601This is always full range for R'G'B' and usually limited range for Y'CbCr.</entry> 601This is always full range for R'G'B' (except for the BT.2020 colorspace) and usually
602limited range for Y'CbCr.</entry>
602 </row> 603 </row>
603 <row> 604 <row>
604 <entry><constant>V4L2_QUANTIZATION_FULL_RANGE</constant></entry> 605 <entry><constant>V4L2_QUANTIZATION_FULL_RANGE</constant></entry>
@@ -620,8 +621,8 @@ is mapped to [16&hellip;235]. Cb and Cr are mapped from [-0.5&hellip;0.5] to [16
620 621
621 <section> 622 <section>
622 <title>Detailed Colorspace Descriptions</title> 623 <title>Detailed Colorspace Descriptions</title>
623 <section> 624 <section id="col-smpte-170m">
624 <title id="col-smpte-170m">Colorspace SMPTE 170M (<constant>V4L2_COLORSPACE_SMPTE170M</constant>)</title> 625 <title>Colorspace SMPTE 170M (<constant>V4L2_COLORSPACE_SMPTE170M</constant>)</title>
625 <para>The <xref linkend="smpte170m" /> standard defines the colorspace used by NTSC and PAL and by SDTV 626 <para>The <xref linkend="smpte170m" /> standard defines the colorspace used by NTSC and PAL and by SDTV
626in general. The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_601</constant>. 627in general. The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_601</constant>.
627The default Y'CbCr quantization is limited range. The chromaticities of the primary colors and 628The default Y'CbCr quantization is limited range. The chromaticities of the primary colors and
@@ -666,8 +667,7 @@ as the SMPTE C set, so this colorspace is sometimes called SMPTE C as well.</par
666 <variablelist> 667 <variablelist>
667 <varlistentry> 668 <varlistentry>
668 <term>The transfer function defined for SMPTE 170M is the same as the 669 <term>The transfer function defined for SMPTE 170M is the same as the
669one defined in Rec. 709. Normally L is in the range [0&hellip;1], but for the extended 670one defined in Rec. 709.</term>
670gamut xvYCC encoding values outside that range are allowed.</term>
671 <listitem> 671 <listitem>
672 <para>L' = -1.099(-L)<superscript>0.45</superscript>&nbsp;+&nbsp;0.099&nbsp;for&nbsp;L&nbsp;&le;&nbsp;-0.018</para> 672 <para>L' = -1.099(-L)<superscript>0.45</superscript>&nbsp;+&nbsp;0.099&nbsp;for&nbsp;L&nbsp;&le;&nbsp;-0.018</para>
673 <para>L' = 4.5L&nbsp;for&nbsp;-0.018&nbsp;&lt;&nbsp;L&nbsp;&lt;&nbsp;0.018</para> 673 <para>L' = 4.5L&nbsp;for&nbsp;-0.018&nbsp;&lt;&nbsp;L&nbsp;&lt;&nbsp;0.018</para>
@@ -702,29 +702,10 @@ defined in the <xref linkend="itu601" /> standard and this colorspace is sometim
702though BT.601 does not mention any color primaries.</para> 702though BT.601 does not mention any color primaries.</para>
703 <para>The default quantization is limited range, but full range is possible although 703 <para>The default quantization is limited range, but full range is possible although
704rarely seen.</para> 704rarely seen.</para>
705 <para>The <constant>V4L2_YCBCR_ENC_601</constant> encoding as described above is the
706default for this colorspace, but it can be overridden with <constant>V4L2_YCBCR_ENC_709</constant>,
707in which case the Rec. 709 Y'CbCr encoding is used.</para>
708 <variablelist>
709 <varlistentry>
710 <term>The xvYCC 601 encoding (<constant>V4L2_YCBCR_ENC_XV601</constant>, <xref linkend="xvycc" />) is similar
711to the BT.601 encoding, but it allows for R', G' and B' values that are outside the range
712[0&hellip;1]. The resulting Y', Cb and Cr values are scaled and offset:</term>
713 <listitem>
714 <para>Y'&nbsp;=&nbsp;(219&nbsp;/&nbsp;255)&nbsp;*&nbsp;(0.299R'&nbsp;+&nbsp;0.587G'&nbsp;+&nbsp;0.114B')&nbsp;+&nbsp;(16&nbsp;/&nbsp;255)</para>
715 <para>Cb&nbsp;=&nbsp;(224&nbsp;/&nbsp;255)&nbsp;*&nbsp;(-0.169R'&nbsp;-&nbsp;0.331G'&nbsp;+&nbsp;0.5B')</para>
716 <para>Cr&nbsp;=&nbsp;(224&nbsp;/&nbsp;255)&nbsp;*&nbsp;(0.5R'&nbsp;-&nbsp;0.419G'&nbsp;-&nbsp;0.081B')</para>
717 </listitem>
718 </varlistentry>
719 </variablelist>
720 <para>Y' is clamped to the range [0&hellip;1] and Cb and Cr are clamped
721to the range [-0.5&hellip;0.5]. The non-standard xvYCC 709 encoding can also be used by selecting
722<constant>V4L2_YCBCR_ENC_XV709</constant>. The xvYCC encodings always use full range
723quantization.</para>
724 </section> 705 </section>
725 706
726 <section> 707 <section id="col-rec709">
727 <title id="col-rec709">Colorspace Rec. 709 (<constant>V4L2_COLORSPACE_REC709</constant>)</title> 708 <title>Colorspace Rec. 709 (<constant>V4L2_COLORSPACE_REC709</constant>)</title>
728 <para>The <xref linkend="itu709" /> standard defines the colorspace used by HDTV in general. The default 709 <para>The <xref linkend="itu709" /> standard defines the colorspace used by HDTV in general. The default
729Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_709</constant>. The default Y'CbCr quantization is 710Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_709</constant>. The default Y'CbCr quantization is
730limited range. The chromaticities of the primary colors and the white reference are:</para> 711limited range. The chromaticities of the primary colors and the white reference are:</para>
@@ -803,26 +784,39 @@ rarely seen.</para>
803 <para>The <constant>V4L2_YCBCR_ENC_709</constant> encoding described above is the default 784 <para>The <constant>V4L2_YCBCR_ENC_709</constant> encoding described above is the default
804for this colorspace, but it can be overridden with <constant>V4L2_YCBCR_ENC_601</constant>, in which 785for this colorspace, but it can be overridden with <constant>V4L2_YCBCR_ENC_601</constant>, in which
805case the BT.601 Y'CbCr encoding is used.</para> 786case the BT.601 Y'CbCr encoding is used.</para>
787 <para>Two additional extended gamut Y'CbCr encodings are also possible with this colorspace:</para>
806 <variablelist> 788 <variablelist>
807 <varlistentry> 789 <varlistentry>
808 <term>The xvYCC 709 encoding (<constant>V4L2_YCBCR_ENC_XV709</constant>, <xref linkend="xvycc" />) 790 <term>The xvYCC 709 encoding (<constant>V4L2_YCBCR_ENC_XV709</constant>, <xref linkend="xvycc" />)
809is similar to the Rec. 709 encoding, but it allows for R', G' and B' values that are outside the range 791is similar to the Rec. 709 encoding, but it allows for R', G' and B' values that are outside the range
810[0&hellip;1]. The resulting Y', Cb and Cr values are scaled and offset:</term> 792[0&hellip;1]. The resulting Y', Cb and Cr values are scaled and offset:</term>
811 <listitem> 793 <listitem>
812 <para>Y'&nbsp;=&nbsp;(219&nbsp;/&nbsp;255)&nbsp;*&nbsp;(0.2126R'&nbsp;+&nbsp;0.7152G'&nbsp;+&nbsp;0.0722B')&nbsp;+&nbsp;(16&nbsp;/&nbsp;255)</para> 794 <para>Y'&nbsp;=&nbsp;(219&nbsp;/&nbsp;256)&nbsp;*&nbsp;(0.2126R'&nbsp;+&nbsp;0.7152G'&nbsp;+&nbsp;0.0722B')&nbsp;+&nbsp;(16&nbsp;/&nbsp;256)</para>
813 <para>Cb&nbsp;=&nbsp;(224&nbsp;/&nbsp;255)&nbsp;*&nbsp;(-0.1146R'&nbsp;-&nbsp;0.3854G'&nbsp;+&nbsp;0.5B')</para> 795 <para>Cb&nbsp;=&nbsp;(224&nbsp;/&nbsp;256)&nbsp;*&nbsp;(-0.1146R'&nbsp;-&nbsp;0.3854G'&nbsp;+&nbsp;0.5B')</para>
814 <para>Cr&nbsp;=&nbsp;(224&nbsp;/&nbsp;255)&nbsp;*&nbsp;(0.5R'&nbsp;-&nbsp;0.4542G'&nbsp;-&nbsp;0.0458B')</para> 796 <para>Cr&nbsp;=&nbsp;(224&nbsp;/&nbsp;256)&nbsp;*&nbsp;(0.5R'&nbsp;-&nbsp;0.4542G'&nbsp;-&nbsp;0.0458B')</para>
797 </listitem>
798 </varlistentry>
799 </variablelist>
800 <variablelist>
801 <varlistentry>
802 <term>The xvYCC 601 encoding (<constant>V4L2_YCBCR_ENC_XV601</constant>, <xref linkend="xvycc" />) is similar
803to the BT.601 encoding, but it allows for R', G' and B' values that are outside the range
804[0&hellip;1]. The resulting Y', Cb and Cr values are scaled and offset:</term>
805 <listitem>
806 <para>Y'&nbsp;=&nbsp;(219&nbsp;/&nbsp;256)&nbsp;*&nbsp;(0.299R'&nbsp;+&nbsp;0.587G'&nbsp;+&nbsp;0.114B')&nbsp;+&nbsp;(16&nbsp;/&nbsp;256)</para>
807 <para>Cb&nbsp;=&nbsp;(224&nbsp;/&nbsp;256)&nbsp;*&nbsp;(-0.169R'&nbsp;-&nbsp;0.331G'&nbsp;+&nbsp;0.5B')</para>
808 <para>Cr&nbsp;=&nbsp;(224&nbsp;/&nbsp;256)&nbsp;*&nbsp;(0.5R'&nbsp;-&nbsp;0.419G'&nbsp;-&nbsp;0.081B')</para>
815 </listitem> 809 </listitem>
816 </varlistentry> 810 </varlistentry>
817 </variablelist> 811 </variablelist>
818 <para>Y' is clamped to the range [0&hellip;1] and Cb and Cr are clamped 812 <para>Y' is clamped to the range [0&hellip;1] and Cb and Cr are clamped
819to the range [-0.5&hellip;0.5]. The non-standard xvYCC 601 encoding can also be used by 813to the range [-0.5&hellip;0.5]. The non-standard xvYCC 709 or xvYCC 601 encodings can be used by
820selecting <constant>V4L2_YCBCR_ENC_XV601</constant>. The xvYCC encodings always use full 814selecting <constant>V4L2_YCBCR_ENC_XV709</constant> or <constant>V4L2_YCBCR_ENC_XV601</constant>.
821range quantization.</para> 815The xvYCC encodings always use full range quantization.</para>
822 </section> 816 </section>
823 817
824 <section> 818 <section id="col-srgb">
825 <title id="col-srgb">Colorspace sRGB (<constant>V4L2_COLORSPACE_SRGB</constant>)</title> 819 <title>Colorspace sRGB (<constant>V4L2_COLORSPACE_SRGB</constant>)</title>
826 <para>The <xref linkend="srgb" /> standard defines the colorspace used by most webcams and computer graphics. The 820 <para>The <xref linkend="srgb" /> standard defines the colorspace used by most webcams and computer graphics. The
827default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_SYCC</constant>. The default Y'CbCr quantization 821default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_SYCC</constant>. The default Y'CbCr quantization
828is full range. The chromaticities of the primary colors and the white reference are:</para> 822is full range. The chromaticities of the primary colors and the white reference are:</para>
@@ -898,8 +892,8 @@ encoding, it is not. The <constant>V4L2_YCBCR_ENC_XV601</constant> scales and of
898values before quantization, but this encoding does not do that.</para> 892values before quantization, but this encoding does not do that.</para>
899 </section> 893 </section>
900 894
901 <section> 895 <section id="col-adobergb">
902 <title id="col-adobergb">Colorspace Adobe RGB (<constant>V4L2_COLORSPACE_ADOBERGB</constant>)</title> 896 <title>Colorspace Adobe RGB (<constant>V4L2_COLORSPACE_ADOBERGB</constant>)</title>
903 <para>The <xref linkend="adobergb" /> standard defines the colorspace used by computer graphics 897 <para>The <xref linkend="adobergb" /> standard defines the colorspace used by computer graphics
904that use the AdobeRGB colorspace. This is also known as the <xref linkend="oprgb" /> standard. 898that use the AdobeRGB colorspace. This is also known as the <xref linkend="oprgb" /> standard.
905The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_601</constant>. The default Y'CbCr 899The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_601</constant>. The default Y'CbCr
@@ -970,12 +964,12 @@ clamped to the range [-0.5&hellip;0.5]. This transform is identical to one defin
970SMPTE 170M/BT.601. The Y'CbCr quantization is limited range.</para> 964SMPTE 170M/BT.601. The Y'CbCr quantization is limited range.</para>
971 </section> 965 </section>
972 966
973 <section> 967 <section id="col-bt2020">
974 <title id="col-bt2020">Colorspace BT.2020 (<constant>V4L2_COLORSPACE_BT2020</constant>)</title> 968 <title>Colorspace BT.2020 (<constant>V4L2_COLORSPACE_BT2020</constant>)</title>
975 <para>The <xref linkend="itu2020" /> standard defines the colorspace used by Ultra-high definition 969 <para>The <xref linkend="itu2020" /> standard defines the colorspace used by Ultra-high definition
976television (UHDTV). The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_BT2020</constant>. 970television (UHDTV). The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_BT2020</constant>.
977The default Y'CbCr quantization is limited range. The chromaticities of the primary colors and 971The default R'G'B' quantization is limited range (!), and so is the default Y'CbCr quantization.
978the white reference are:</para> 972The chromaticities of the primary colors and the white reference are:</para>
979 <table frame="none"> 973 <table frame="none">
980 <title>BT.2020 Chromaticities</title> 974 <title>BT.2020 Chromaticities</title>
981 <tgroup cols="3" align="left"> 975 <tgroup cols="3" align="left">
@@ -1032,7 +1026,7 @@ the white reference are:</para>
1032 <term>The luminance (Y') and color difference (Cb and Cr) are obtained with the 1026 <term>The luminance (Y') and color difference (Cb and Cr) are obtained with the
1033following <constant>V4L2_YCBCR_ENC_BT2020</constant> encoding:</term> 1027following <constant>V4L2_YCBCR_ENC_BT2020</constant> encoding:</term>
1034 <listitem> 1028 <listitem>
1035 <para>Y'&nbsp;=&nbsp;0.2627R'&nbsp;+&nbsp;0.6789G'&nbsp;+&nbsp;0.0593B'</para> 1029 <para>Y'&nbsp;=&nbsp;0.2627R'&nbsp;+&nbsp;0.6780G'&nbsp;+&nbsp;0.0593B'</para>
1036 <para>Cb&nbsp;=&nbsp;-0.1396R'&nbsp;-&nbsp;0.3604G'&nbsp;+&nbsp;0.5B'</para> 1030 <para>Cb&nbsp;=&nbsp;-0.1396R'&nbsp;-&nbsp;0.3604G'&nbsp;+&nbsp;0.5B'</para>
1037 <para>Cr&nbsp;=&nbsp;0.5R'&nbsp;-&nbsp;0.4598G'&nbsp;-&nbsp;0.0402B'</para> 1031 <para>Cr&nbsp;=&nbsp;0.5R'&nbsp;-&nbsp;0.4598G'&nbsp;-&nbsp;0.0402B'</para>
1038 </listitem> 1032 </listitem>
@@ -1046,7 +1040,7 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
1046 <varlistentry> 1040 <varlistentry>
1047 <term>Luma:</term> 1041 <term>Luma:</term>
1048 <listitem> 1042 <listitem>
1049 <para>Yc'&nbsp;=&nbsp;(0.2627R&nbsp;+&nbsp;0.6789G&nbsp;+&nbsp;0.0593B)'</para> 1043 <para>Yc'&nbsp;=&nbsp;(0.2627R&nbsp;+&nbsp;0.6780G&nbsp;+&nbsp;0.0593B)'</para>
1050 </listitem> 1044 </listitem>
1051 </varlistentry> 1045 </varlistentry>
1052 </variablelist> 1046 </variablelist>
@@ -1054,7 +1048,7 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
1054 <varlistentry> 1048 <varlistentry>
1055 <term>B'&nbsp;-&nbsp;Yc'&nbsp;&le;&nbsp;0:</term> 1049 <term>B'&nbsp;-&nbsp;Yc'&nbsp;&le;&nbsp;0:</term>
1056 <listitem> 1050 <listitem>
1057 <para>Cbc&nbsp;=&nbsp;(B'&nbsp;-&nbsp;Y')&nbsp;/&nbsp;1.9404</para> 1051 <para>Cbc&nbsp;=&nbsp;(B'&nbsp;-&nbsp;Yc')&nbsp;/&nbsp;1.9404</para>
1058 </listitem> 1052 </listitem>
1059 </varlistentry> 1053 </varlistentry>
1060 </variablelist> 1054 </variablelist>
@@ -1062,7 +1056,7 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
1062 <varlistentry> 1056 <varlistentry>
1063 <term>B'&nbsp;-&nbsp;Yc'&nbsp;&gt;&nbsp;0:</term> 1057 <term>B'&nbsp;-&nbsp;Yc'&nbsp;&gt;&nbsp;0:</term>
1064 <listitem> 1058 <listitem>
1065 <para>Cbc&nbsp;=&nbsp;(B'&nbsp;-&nbsp;Y')&nbsp;/&nbsp;1.5816</para> 1059 <para>Cbc&nbsp;=&nbsp;(B'&nbsp;-&nbsp;Yc')&nbsp;/&nbsp;1.5816</para>
1066 </listitem> 1060 </listitem>
1067 </varlistentry> 1061 </varlistentry>
1068 </variablelist> 1062 </variablelist>
@@ -1086,8 +1080,8 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
1086clamped to the range [-0.5&hellip;0.5]. The Yc'CbcCrc quantization is limited range.</para> 1080clamped to the range [-0.5&hellip;0.5]. The Yc'CbcCrc quantization is limited range.</para>
1087 </section> 1081 </section>
1088 1082
1089 <section> 1083 <section id="col-smpte-240m">
1090 <title id="col-smpte-240m">Colorspace SMPTE 240M (<constant>V4L2_COLORSPACE_SMPTE240M</constant>)</title> 1084 <title>Colorspace SMPTE 240M (<constant>V4L2_COLORSPACE_SMPTE240M</constant>)</title>
1091 <para>The <xref linkend="smpte240m" /> standard was an interim standard used during the early days of HDTV (1988-1998). 1085 <para>The <xref linkend="smpte240m" /> standard was an interim standard used during the early days of HDTV (1988-1998).
1092It has been superseded by Rec. 709. The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_SMPTE240M</constant>. 1086It has been superseded by Rec. 709. The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_SMPTE240M</constant>.
1093The default Y'CbCr quantization is limited range. The chromaticities of the primary colors and the 1087The default Y'CbCr quantization is limited range. The chromaticities of the primary colors and the
@@ -1159,8 +1153,8 @@ following <constant>V4L2_YCBCR_ENC_SMPTE240M</constant> encoding:</term>
1159clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range.</para> 1153clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range.</para>
1160 </section> 1154 </section>
1161 1155
1162 <section> 1156 <section id="col-sysm">
1163 <title id="col-sysm">Colorspace NTSC 1953 (<constant>V4L2_COLORSPACE_470_SYSTEM_M</constant>)</title> 1157 <title>Colorspace NTSC 1953 (<constant>V4L2_COLORSPACE_470_SYSTEM_M</constant>)</title>
1164 <para>This standard defines the colorspace used by NTSC in 1953. In practice this 1158 <para>This standard defines the colorspace used by NTSC in 1953. In practice this
1165colorspace is obsolete and SMPTE 170M should be used instead. The default Y'CbCr encoding 1159colorspace is obsolete and SMPTE 170M should be used instead. The default Y'CbCr encoding
1166is <constant>V4L2_YCBCR_ENC_601</constant>. The default Y'CbCr quantization is limited range. 1160is <constant>V4L2_YCBCR_ENC_601</constant>. The default Y'CbCr quantization is limited range.
@@ -1237,8 +1231,8 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
1237This transform is identical to one defined in SMPTE 170M/BT.601.</para> 1231This transform is identical to one defined in SMPTE 170M/BT.601.</para>
1238 </section> 1232 </section>
1239 1233
1240 <section> 1234 <section id="col-sysbg">
1241 <title id="col-sysbg">Colorspace EBU Tech. 3213 (<constant>V4L2_COLORSPACE_470_SYSTEM_BG</constant>)</title> 1235 <title>Colorspace EBU Tech. 3213 (<constant>V4L2_COLORSPACE_470_SYSTEM_BG</constant>)</title>
1242 <para>The <xref linkend="tech3213" /> standard defines the colorspace used by PAL/SECAM in 1975. In practice this 1236 <para>The <xref linkend="tech3213" /> standard defines the colorspace used by PAL/SECAM in 1975. In practice this
1243colorspace is obsolete and SMPTE 170M should be used instead. The default Y'CbCr encoding 1237colorspace is obsolete and SMPTE 170M should be used instead. The default Y'CbCr encoding
1244is <constant>V4L2_YCBCR_ENC_601</constant>. The default Y'CbCr quantization is limited range. 1238is <constant>V4L2_YCBCR_ENC_601</constant>. The default Y'CbCr quantization is limited range.
@@ -1311,8 +1305,8 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
1311This transform is identical to one defined in SMPTE 170M/BT.601.</para> 1305This transform is identical to one defined in SMPTE 170M/BT.601.</para>
1312 </section> 1306 </section>
1313 1307
1314 <section> 1308 <section id="col-jpeg">
1315 <title id="col-jpeg">Colorspace JPEG (<constant>V4L2_COLORSPACE_JPEG</constant>)</title> 1309 <title>Colorspace JPEG (<constant>V4L2_COLORSPACE_JPEG</constant>)</title>
1316 <para>This colorspace defines the colorspace used by most (Motion-)JPEG formats. The chromaticities 1310 <para>This colorspace defines the colorspace used by most (Motion-)JPEG formats. The chromaticities
1317of the primary colors and the white reference are identical to sRGB. The Y'CbCr encoding is 1311of the primary colors and the white reference are identical to sRGB. The Y'CbCr encoding is
1318<constant>V4L2_YCBCR_ENC_601</constant> with full range quantization where 1312<constant>V4L2_YCBCR_ENC_601</constant> with full range quantization where
diff --git a/Documentation/DocBook/media/v4l/subdev-formats.xml b/Documentation/DocBook/media/v4l/subdev-formats.xml
index c5ea868e3909..bc8d3fb9e4a9 100644
--- a/Documentation/DocBook/media/v4l/subdev-formats.xml
+++ b/Documentation/DocBook/media/v4l/subdev-formats.xml
@@ -440,6 +440,36 @@ see <xref linkend="colorspaces" />.</entry>
440 <entry>b<subscript>1</subscript></entry> 440 <entry>b<subscript>1</subscript></entry>
441 <entry>b<subscript>0</subscript></entry> 441 <entry>b<subscript>0</subscript></entry>
442 </row> 442 </row>
443 <row id="MEDIA-BUS-FMT-RBG888-1X24">
444 <entry>MEDIA_BUS_FMT_RBG888_1X24</entry>
445 <entry>0x100e</entry>
446 <entry></entry>
447 &dash-ent-8;
448 <entry>r<subscript>7</subscript></entry>
449 <entry>r<subscript>6</subscript></entry>
450 <entry>r<subscript>5</subscript></entry>
451 <entry>r<subscript>4</subscript></entry>
452 <entry>r<subscript>3</subscript></entry>
453 <entry>r<subscript>2</subscript></entry>
454 <entry>r<subscript>1</subscript></entry>
455 <entry>r<subscript>0</subscript></entry>
456 <entry>b<subscript>7</subscript></entry>
457 <entry>b<subscript>6</subscript></entry>
458 <entry>b<subscript>5</subscript></entry>
459 <entry>b<subscript>4</subscript></entry>
460 <entry>b<subscript>3</subscript></entry>
461 <entry>b<subscript>2</subscript></entry>
462 <entry>b<subscript>1</subscript></entry>
463 <entry>b<subscript>0</subscript></entry>
464 <entry>g<subscript>7</subscript></entry>
465 <entry>g<subscript>6</subscript></entry>
466 <entry>g<subscript>5</subscript></entry>
467 <entry>g<subscript>4</subscript></entry>
468 <entry>g<subscript>3</subscript></entry>
469 <entry>g<subscript>2</subscript></entry>
470 <entry>g<subscript>1</subscript></entry>
471 <entry>g<subscript>0</subscript></entry>
472 </row>
443 <row id="MEDIA-BUS-FMT-RGB888-1X24"> 473 <row id="MEDIA-BUS-FMT-RGB888-1X24">
444 <entry>MEDIA_BUS_FMT_RGB888_1X24</entry> 474 <entry>MEDIA_BUS_FMT_RGB888_1X24</entry>
445 <entry>0x100a</entry> 475 <entry>0x100a</entry>
@@ -579,6 +609,43 @@ see <xref linkend="colorspaces" />.</entry>
579 <entry>b<subscript>1</subscript></entry> 609 <entry>b<subscript>1</subscript></entry>
580 <entry>b<subscript>0</subscript></entry> 610 <entry>b<subscript>0</subscript></entry>
581 </row> 611 </row>
612 <row id="MEDIA-BUS-FMT-RGB888-1X32-PADHI">
613 <entry>MEDIA_BUS_FMT_RGB888_1X32_PADHI</entry>
614 <entry>0x100f</entry>
615 <entry></entry>
616 <entry>0</entry>
617 <entry>0</entry>
618 <entry>0</entry>
619 <entry>0</entry>
620 <entry>0</entry>
621 <entry>0</entry>
622 <entry>0</entry>
623 <entry>0</entry>
624 <entry>r<subscript>7</subscript></entry>
625 <entry>r<subscript>6</subscript></entry>
626 <entry>r<subscript>5</subscript></entry>
627 <entry>r<subscript>4</subscript></entry>
628 <entry>r<subscript>3</subscript></entry>
629 <entry>r<subscript>2</subscript></entry>
630 <entry>r<subscript>1</subscript></entry>
631 <entry>r<subscript>0</subscript></entry>
632 <entry>g<subscript>7</subscript></entry>
633 <entry>g<subscript>6</subscript></entry>
634 <entry>g<subscript>5</subscript></entry>
635 <entry>g<subscript>4</subscript></entry>
636 <entry>g<subscript>3</subscript></entry>
637 <entry>g<subscript>2</subscript></entry>
638 <entry>g<subscript>1</subscript></entry>
639 <entry>g<subscript>0</subscript></entry>
640 <entry>b<subscript>7</subscript></entry>
641 <entry>b<subscript>6</subscript></entry>
642 <entry>b<subscript>5</subscript></entry>
643 <entry>b<subscript>4</subscript></entry>
644 <entry>b<subscript>3</subscript></entry>
645 <entry>b<subscript>2</subscript></entry>
646 <entry>b<subscript>1</subscript></entry>
647 <entry>b<subscript>0</subscript></entry>
648 </row>
582 </tbody> 649 </tbody>
583 </tgroup> 650 </tgroup>
584 </table> 651 </table>
@@ -2188,11 +2255,15 @@ see <xref linkend="colorspaces" />.</entry>
2188 <entry>y<subscript>1</subscript></entry> 2255 <entry>y<subscript>1</subscript></entry>
2189 <entry>y<subscript>0</subscript></entry> 2256 <entry>y<subscript>0</subscript></entry>
2190 </row> 2257 </row>
2191 <row id="MEDIA-BUS-FMT-UYVY8-1X16"> 2258 <row id="MEDIA-BUS-FMT-UYVY12-2X12">
2192 <entry>MEDIA_BUS_FMT_UYVY8_1X16</entry> 2259 <entry>MEDIA_BUS_FMT_UYVY12_2X12</entry>
2193 <entry>0x200f</entry> 2260 <entry>0x201c</entry>
2194 <entry></entry> 2261 <entry></entry>
2195 &dash-ent-16; 2262 &dash-ent-20;
2263 <entry>u<subscript>11</subscript></entry>
2264 <entry>u<subscript>10</subscript></entry>
2265 <entry>u<subscript>9</subscript></entry>
2266 <entry>u<subscript>8</subscript></entry>
2196 <entry>u<subscript>7</subscript></entry> 2267 <entry>u<subscript>7</subscript></entry>
2197 <entry>u<subscript>6</subscript></entry> 2268 <entry>u<subscript>6</subscript></entry>
2198 <entry>u<subscript>5</subscript></entry> 2269 <entry>u<subscript>5</subscript></entry>
@@ -2201,6 +2272,16 @@ see <xref linkend="colorspaces" />.</entry>
2201 <entry>u<subscript>2</subscript></entry> 2272 <entry>u<subscript>2</subscript></entry>
2202 <entry>u<subscript>1</subscript></entry> 2273 <entry>u<subscript>1</subscript></entry>
2203 <entry>u<subscript>0</subscript></entry> 2274 <entry>u<subscript>0</subscript></entry>
2275 </row>
2276 <row>
2277 <entry></entry>
2278 <entry></entry>
2279 <entry></entry>
2280 &dash-ent-20;
2281 <entry>y<subscript>11</subscript></entry>
2282 <entry>y<subscript>10</subscript></entry>
2283 <entry>y<subscript>9</subscript></entry>
2284 <entry>y<subscript>8</subscript></entry>
2204 <entry>y<subscript>7</subscript></entry> 2285 <entry>y<subscript>7</subscript></entry>
2205 <entry>y<subscript>6</subscript></entry> 2286 <entry>y<subscript>6</subscript></entry>
2206 <entry>y<subscript>5</subscript></entry> 2287 <entry>y<subscript>5</subscript></entry>
@@ -2214,7 +2295,11 @@ see <xref linkend="colorspaces" />.</entry>
2214 <entry></entry> 2295 <entry></entry>
2215 <entry></entry> 2296 <entry></entry>
2216 <entry></entry> 2297 <entry></entry>
2217 &dash-ent-16; 2298 &dash-ent-20;
2299 <entry>v<subscript>11</subscript></entry>
2300 <entry>v<subscript>10</subscript></entry>
2301 <entry>v<subscript>9</subscript></entry>
2302 <entry>v<subscript>8</subscript></entry>
2218 <entry>v<subscript>7</subscript></entry> 2303 <entry>v<subscript>7</subscript></entry>
2219 <entry>v<subscript>6</subscript></entry> 2304 <entry>v<subscript>6</subscript></entry>
2220 <entry>v<subscript>5</subscript></entry> 2305 <entry>v<subscript>5</subscript></entry>
@@ -2223,6 +2308,16 @@ see <xref linkend="colorspaces" />.</entry>
2223 <entry>v<subscript>2</subscript></entry> 2308 <entry>v<subscript>2</subscript></entry>
2224 <entry>v<subscript>1</subscript></entry> 2309 <entry>v<subscript>1</subscript></entry>
2225 <entry>v<subscript>0</subscript></entry> 2310 <entry>v<subscript>0</subscript></entry>
2311 </row>
2312 <row>
2313 <entry></entry>
2314 <entry></entry>
2315 <entry></entry>
2316 &dash-ent-20;
2317 <entry>y<subscript>11</subscript></entry>
2318 <entry>y<subscript>10</subscript></entry>
2319 <entry>y<subscript>9</subscript></entry>
2320 <entry>y<subscript>8</subscript></entry>
2226 <entry>y<subscript>7</subscript></entry> 2321 <entry>y<subscript>7</subscript></entry>
2227 <entry>y<subscript>6</subscript></entry> 2322 <entry>y<subscript>6</subscript></entry>
2228 <entry>y<subscript>5</subscript></entry> 2323 <entry>y<subscript>5</subscript></entry>
@@ -2232,11 +2327,15 @@ see <xref linkend="colorspaces" />.</entry>
2232 <entry>y<subscript>1</subscript></entry> 2327 <entry>y<subscript>1</subscript></entry>
2233 <entry>y<subscript>0</subscript></entry> 2328 <entry>y<subscript>0</subscript></entry>
2234 </row> 2329 </row>
2235 <row id="MEDIA-BUS-FMT-VYUY8-1X16"> 2330 <row id="MEDIA-BUS-FMT-VYUY12-2X12">
2236 <entry>MEDIA_BUS_FMT_VYUY8_1X16</entry> 2331 <entry>MEDIA_BUS_FMT_VYUY12_2X12</entry>
2237 <entry>0x2010</entry> 2332 <entry>0x201d</entry>
2238 <entry></entry> 2333 <entry></entry>
2239 &dash-ent-16; 2334 &dash-ent-20;
2335 <entry>v<subscript>11</subscript></entry>
2336 <entry>v<subscript>10</subscript></entry>
2337 <entry>v<subscript>9</subscript></entry>
2338 <entry>v<subscript>8</subscript></entry>
2240 <entry>v<subscript>7</subscript></entry> 2339 <entry>v<subscript>7</subscript></entry>
2241 <entry>v<subscript>6</subscript></entry> 2340 <entry>v<subscript>6</subscript></entry>
2242 <entry>v<subscript>5</subscript></entry> 2341 <entry>v<subscript>5</subscript></entry>
@@ -2245,6 +2344,16 @@ see <xref linkend="colorspaces" />.</entry>
2245 <entry>v<subscript>2</subscript></entry> 2344 <entry>v<subscript>2</subscript></entry>
2246 <entry>v<subscript>1</subscript></entry> 2345 <entry>v<subscript>1</subscript></entry>
2247 <entry>v<subscript>0</subscript></entry> 2346 <entry>v<subscript>0</subscript></entry>
2347 </row>
2348 <row>
2349 <entry></entry>
2350 <entry></entry>
2351 <entry></entry>
2352 &dash-ent-20;
2353 <entry>y<subscript>11</subscript></entry>
2354 <entry>y<subscript>10</subscript></entry>
2355 <entry>y<subscript>9</subscript></entry>
2356 <entry>y<subscript>8</subscript></entry>
2248 <entry>y<subscript>7</subscript></entry> 2357 <entry>y<subscript>7</subscript></entry>
2249 <entry>y<subscript>6</subscript></entry> 2358 <entry>y<subscript>6</subscript></entry>
2250 <entry>y<subscript>5</subscript></entry> 2359 <entry>y<subscript>5</subscript></entry>
@@ -2258,7 +2367,11 @@ see <xref linkend="colorspaces" />.</entry>
2258 <entry></entry> 2367 <entry></entry>
2259 <entry></entry> 2368 <entry></entry>
2260 <entry></entry> 2369 <entry></entry>
2261 &dash-ent-16; 2370 &dash-ent-20;
2371 <entry>u<subscript>11</subscript></entry>
2372 <entry>u<subscript>10</subscript></entry>
2373 <entry>u<subscript>9</subscript></entry>
2374 <entry>u<subscript>8</subscript></entry>
2262 <entry>u<subscript>7</subscript></entry> 2375 <entry>u<subscript>7</subscript></entry>
2263 <entry>u<subscript>6</subscript></entry> 2376 <entry>u<subscript>6</subscript></entry>
2264 <entry>u<subscript>5</subscript></entry> 2377 <entry>u<subscript>5</subscript></entry>
@@ -2267,6 +2380,16 @@ see <xref linkend="colorspaces" />.</entry>
2267 <entry>u<subscript>2</subscript></entry> 2380 <entry>u<subscript>2</subscript></entry>
2268 <entry>u<subscript>1</subscript></entry> 2381 <entry>u<subscript>1</subscript></entry>
2269 <entry>u<subscript>0</subscript></entry> 2382 <entry>u<subscript>0</subscript></entry>
2383 </row>
2384 <row>
2385 <entry></entry>
2386 <entry></entry>
2387 <entry></entry>
2388 &dash-ent-20;
2389 <entry>y<subscript>11</subscript></entry>
2390 <entry>y<subscript>10</subscript></entry>
2391 <entry>y<subscript>9</subscript></entry>
2392 <entry>y<subscript>8</subscript></entry>
2270 <entry>y<subscript>7</subscript></entry> 2393 <entry>y<subscript>7</subscript></entry>
2271 <entry>y<subscript>6</subscript></entry> 2394 <entry>y<subscript>6</subscript></entry>
2272 <entry>y<subscript>5</subscript></entry> 2395 <entry>y<subscript>5</subscript></entry>
@@ -2276,11 +2399,15 @@ see <xref linkend="colorspaces" />.</entry>
2276 <entry>y<subscript>1</subscript></entry> 2399 <entry>y<subscript>1</subscript></entry>
2277 <entry>y<subscript>0</subscript></entry> 2400 <entry>y<subscript>0</subscript></entry>
2278 </row> 2401 </row>
2279 <row id="MEDIA-BUS-FMT-YUYV8-1X16"> 2402 <row id="MEDIA-BUS-FMT-YUYV12-2X12">
2280 <entry>MEDIA_BUS_FMT_YUYV8_1X16</entry> 2403 <entry>MEDIA_BUS_FMT_YUYV12_2X12</entry>
2281 <entry>0x2011</entry> 2404 <entry>0x201e</entry>
2282 <entry></entry> 2405 <entry></entry>
2283 &dash-ent-16; 2406 &dash-ent-20;
2407 <entry>y<subscript>11</subscript></entry>
2408 <entry>y<subscript>10</subscript></entry>
2409 <entry>y<subscript>9</subscript></entry>
2410 <entry>y<subscript>8</subscript></entry>
2284 <entry>y<subscript>7</subscript></entry> 2411 <entry>y<subscript>7</subscript></entry>
2285 <entry>y<subscript>6</subscript></entry> 2412 <entry>y<subscript>6</subscript></entry>
2286 <entry>y<subscript>5</subscript></entry> 2413 <entry>y<subscript>5</subscript></entry>
@@ -2289,6 +2416,16 @@ see <xref linkend="colorspaces" />.</entry>
2289 <entry>y<subscript>2</subscript></entry> 2416 <entry>y<subscript>2</subscript></entry>
2290 <entry>y<subscript>1</subscript></entry> 2417 <entry>y<subscript>1</subscript></entry>
2291 <entry>y<subscript>0</subscript></entry> 2418 <entry>y<subscript>0</subscript></entry>
2419 </row>
2420 <row>
2421 <entry></entry>
2422 <entry></entry>
2423 <entry></entry>
2424 &dash-ent-20;
2425 <entry>u<subscript>11</subscript></entry>
2426 <entry>u<subscript>10</subscript></entry>
2427 <entry>u<subscript>9</subscript></entry>
2428 <entry>u<subscript>8</subscript></entry>
2292 <entry>u<subscript>7</subscript></entry> 2429 <entry>u<subscript>7</subscript></entry>
2293 <entry>u<subscript>6</subscript></entry> 2430 <entry>u<subscript>6</subscript></entry>
2294 <entry>u<subscript>5</subscript></entry> 2431 <entry>u<subscript>5</subscript></entry>
@@ -2302,7 +2439,11 @@ see <xref linkend="colorspaces" />.</entry>
2302 <entry></entry> 2439 <entry></entry>
2303 <entry></entry> 2440 <entry></entry>
2304 <entry></entry> 2441 <entry></entry>
2305 &dash-ent-16; 2442 &dash-ent-20;
2443 <entry>y<subscript>11</subscript></entry>
2444 <entry>y<subscript>10</subscript></entry>
2445 <entry>y<subscript>9</subscript></entry>
2446 <entry>y<subscript>8</subscript></entry>
2306 <entry>y<subscript>7</subscript></entry> 2447 <entry>y<subscript>7</subscript></entry>
2307 <entry>y<subscript>6</subscript></entry> 2448 <entry>y<subscript>6</subscript></entry>
2308 <entry>y<subscript>5</subscript></entry> 2449 <entry>y<subscript>5</subscript></entry>
@@ -2311,6 +2452,16 @@ see <xref linkend="colorspaces" />.</entry>
2311 <entry>y<subscript>2</subscript></entry> 2452 <entry>y<subscript>2</subscript></entry>
2312 <entry>y<subscript>1</subscript></entry> 2453 <entry>y<subscript>1</subscript></entry>
2313 <entry>y<subscript>0</subscript></entry> 2454 <entry>y<subscript>0</subscript></entry>
2455 </row>
2456 <row>
2457 <entry></entry>
2458 <entry></entry>
2459 <entry></entry>
2460 &dash-ent-20;
2461 <entry>v<subscript>11</subscript></entry>
2462 <entry>v<subscript>10</subscript></entry>
2463 <entry>v<subscript>9</subscript></entry>
2464 <entry>v<subscript>8</subscript></entry>
2314 <entry>v<subscript>7</subscript></entry> 2465 <entry>v<subscript>7</subscript></entry>
2315 <entry>v<subscript>6</subscript></entry> 2466 <entry>v<subscript>6</subscript></entry>
2316 <entry>v<subscript>5</subscript></entry> 2467 <entry>v<subscript>5</subscript></entry>
@@ -2320,11 +2471,15 @@ see <xref linkend="colorspaces" />.</entry>
2320 <entry>v<subscript>1</subscript></entry> 2471 <entry>v<subscript>1</subscript></entry>
2321 <entry>v<subscript>0</subscript></entry> 2472 <entry>v<subscript>0</subscript></entry>
2322 </row> 2473 </row>
2323 <row id="MEDIA-BUS-FMT-YVYU8-1X16"> 2474 <row id="MEDIA-BUS-FMT-YVYU12-2X12">
2324 <entry>MEDIA_BUS_FMT_YVYU8_1X16</entry> 2475 <entry>MEDIA_BUS_FMT_YVYU12_2X12</entry>
2325 <entry>0x2012</entry> 2476 <entry>0x201f</entry>
2326 <entry></entry> 2477 <entry></entry>
2327 &dash-ent-16; 2478 &dash-ent-20;
2479 <entry>y<subscript>11</subscript></entry>
2480 <entry>y<subscript>10</subscript></entry>
2481 <entry>y<subscript>9</subscript></entry>
2482 <entry>y<subscript>8</subscript></entry>
2328 <entry>y<subscript>7</subscript></entry> 2483 <entry>y<subscript>7</subscript></entry>
2329 <entry>y<subscript>6</subscript></entry> 2484 <entry>y<subscript>6</subscript></entry>
2330 <entry>y<subscript>5</subscript></entry> 2485 <entry>y<subscript>5</subscript></entry>
@@ -2333,6 +2488,16 @@ see <xref linkend="colorspaces" />.</entry>
2333 <entry>y<subscript>2</subscript></entry> 2488 <entry>y<subscript>2</subscript></entry>
2334 <entry>y<subscript>1</subscript></entry> 2489 <entry>y<subscript>1</subscript></entry>
2335 <entry>y<subscript>0</subscript></entry> 2490 <entry>y<subscript>0</subscript></entry>
2491 </row>
2492 <row>
2493 <entry></entry>
2494 <entry></entry>
2495 <entry></entry>
2496 &dash-ent-20;
2497 <entry>v<subscript>11</subscript></entry>
2498 <entry>v<subscript>10</subscript></entry>
2499 <entry>v<subscript>9</subscript></entry>
2500 <entry>v<subscript>8</subscript></entry>
2336 <entry>v<subscript>7</subscript></entry> 2501 <entry>v<subscript>7</subscript></entry>
2337 <entry>v<subscript>6</subscript></entry> 2502 <entry>v<subscript>6</subscript></entry>
2338 <entry>v<subscript>5</subscript></entry> 2503 <entry>v<subscript>5</subscript></entry>
@@ -2346,29 +2511,11 @@ see <xref linkend="colorspaces" />.</entry>
2346 <entry></entry> 2511 <entry></entry>
2347 <entry></entry> 2512 <entry></entry>
2348 <entry></entry> 2513 <entry></entry>
2349 &dash-ent-16; 2514 &dash-ent-20;
2350 <entry>y<subscript>7</subscript></entry> 2515 <entry>y<subscript>11</subscript></entry>
2351 <entry>y<subscript>6</subscript></entry> 2516 <entry>y<subscript>10</subscript></entry>
2352 <entry>y<subscript>5</subscript></entry> 2517 <entry>y<subscript>9</subscript></entry>
2353 <entry>y<subscript>4</subscript></entry> 2518 <entry>y<subscript>8</subscript></entry>
2354 <entry>y<subscript>3</subscript></entry>
2355 <entry>y<subscript>2</subscript></entry>
2356 <entry>y<subscript>1</subscript></entry>
2357 <entry>y<subscript>0</subscript></entry>
2358 <entry>u<subscript>7</subscript></entry>
2359 <entry>u<subscript>6</subscript></entry>
2360 <entry>u<subscript>5</subscript></entry>
2361 <entry>u<subscript>4</subscript></entry>
2362 <entry>u<subscript>3</subscript></entry>
2363 <entry>u<subscript>2</subscript></entry>
2364 <entry>u<subscript>1</subscript></entry>
2365 <entry>u<subscript>0</subscript></entry>
2366 </row>
2367 <row id="MEDIA-BUS-FMT-YDYUYDYV8-1X16">
2368 <entry>MEDIA_BUS_FMT_YDYUYDYV8_1X16</entry>
2369 <entry>0x2014</entry>
2370 <entry></entry>
2371 &dash-ent-16;
2372 <entry>y<subscript>7</subscript></entry> 2519 <entry>y<subscript>7</subscript></entry>
2373 <entry>y<subscript>6</subscript></entry> 2520 <entry>y<subscript>6</subscript></entry>
2374 <entry>y<subscript>5</subscript></entry> 2521 <entry>y<subscript>5</subscript></entry>
@@ -2377,28 +2524,16 @@ see <xref linkend="colorspaces" />.</entry>
2377 <entry>y<subscript>2</subscript></entry> 2524 <entry>y<subscript>2</subscript></entry>
2378 <entry>y<subscript>1</subscript></entry> 2525 <entry>y<subscript>1</subscript></entry>
2379 <entry>y<subscript>0</subscript></entry> 2526 <entry>y<subscript>0</subscript></entry>
2380 <entry>d</entry>
2381 <entry>d</entry>
2382 <entry>d</entry>
2383 <entry>d</entry>
2384 <entry>d</entry>
2385 <entry>d</entry>
2386 <entry>d</entry>
2387 <entry>d</entry>
2388 </row> 2527 </row>
2389 <row> 2528 <row>
2390 <entry></entry> 2529 <entry></entry>
2391 <entry></entry> 2530 <entry></entry>
2392 <entry></entry> 2531 <entry></entry>
2393 &dash-ent-16; 2532 &dash-ent-20;
2394 <entry>y<subscript>7</subscript></entry> 2533 <entry>u<subscript>11</subscript></entry>
2395 <entry>y<subscript>6</subscript></entry> 2534 <entry>u<subscript>10</subscript></entry>
2396 <entry>y<subscript>5</subscript></entry> 2535 <entry>u<subscript>9</subscript></entry>
2397 <entry>y<subscript>4</subscript></entry> 2536 <entry>u<subscript>8</subscript></entry>
2398 <entry>y<subscript>3</subscript></entry>
2399 <entry>y<subscript>2</subscript></entry>
2400 <entry>y<subscript>1</subscript></entry>
2401 <entry>y<subscript>0</subscript></entry>
2402 <entry>u<subscript>7</subscript></entry> 2537 <entry>u<subscript>7</subscript></entry>
2403 <entry>u<subscript>6</subscript></entry> 2538 <entry>u<subscript>6</subscript></entry>
2404 <entry>u<subscript>5</subscript></entry> 2539 <entry>u<subscript>5</subscript></entry>
@@ -2408,57 +2543,11 @@ see <xref linkend="colorspaces" />.</entry>
2408 <entry>u<subscript>1</subscript></entry> 2543 <entry>u<subscript>1</subscript></entry>
2409 <entry>u<subscript>0</subscript></entry> 2544 <entry>u<subscript>0</subscript></entry>
2410 </row> 2545 </row>
2411 <row> 2546 <row id="MEDIA-BUS-FMT-UYVY8-1X16">
2412 <entry></entry> 2547 <entry>MEDIA_BUS_FMT_UYVY8_1X16</entry>
2413 <entry></entry> 2548 <entry>0x200f</entry>
2414 <entry></entry>
2415 &dash-ent-16;
2416 <entry>y<subscript>7</subscript></entry>
2417 <entry>y<subscript>6</subscript></entry>
2418 <entry>y<subscript>5</subscript></entry>
2419 <entry>y<subscript>4</subscript></entry>
2420 <entry>y<subscript>3</subscript></entry>
2421 <entry>y<subscript>2</subscript></entry>
2422 <entry>y<subscript>1</subscript></entry>
2423 <entry>y<subscript>0</subscript></entry>
2424 <entry>d</entry>
2425 <entry>d</entry>
2426 <entry>d</entry>
2427 <entry>d</entry>
2428 <entry>d</entry>
2429 <entry>d</entry>
2430 <entry>d</entry>
2431 <entry>d</entry>
2432 </row>
2433 <row>
2434 <entry></entry>
2435 <entry></entry>
2436 <entry></entry> 2549 <entry></entry>
2437 &dash-ent-16; 2550 &dash-ent-16;
2438 <entry>y<subscript>7</subscript></entry>
2439 <entry>y<subscript>6</subscript></entry>
2440 <entry>y<subscript>5</subscript></entry>
2441 <entry>y<subscript>4</subscript></entry>
2442 <entry>y<subscript>3</subscript></entry>
2443 <entry>y<subscript>2</subscript></entry>
2444 <entry>y<subscript>1</subscript></entry>
2445 <entry>y<subscript>0</subscript></entry>
2446 <entry>v<subscript>7</subscript></entry>
2447 <entry>v<subscript>6</subscript></entry>
2448 <entry>v<subscript>5</subscript></entry>
2449 <entry>v<subscript>4</subscript></entry>
2450 <entry>v<subscript>3</subscript></entry>
2451 <entry>v<subscript>2</subscript></entry>
2452 <entry>v<subscript>1</subscript></entry>
2453 <entry>v<subscript>0</subscript></entry>
2454 </row>
2455 <row id="MEDIA-BUS-FMT-UYVY10-1X20">
2456 <entry>MEDIA_BUS_FMT_UYVY10_1X20</entry>
2457 <entry>0x201a</entry>
2458 <entry></entry>
2459 &dash-ent-12;
2460 <entry>u<subscript>9</subscript></entry>
2461 <entry>u<subscript>8</subscript></entry>
2462 <entry>u<subscript>7</subscript></entry> 2551 <entry>u<subscript>7</subscript></entry>
2463 <entry>u<subscript>6</subscript></entry> 2552 <entry>u<subscript>6</subscript></entry>
2464 <entry>u<subscript>5</subscript></entry> 2553 <entry>u<subscript>5</subscript></entry>
@@ -2467,8 +2556,6 @@ see <xref linkend="colorspaces" />.</entry>
2467 <entry>u<subscript>2</subscript></entry> 2556 <entry>u<subscript>2</subscript></entry>
2468 <entry>u<subscript>1</subscript></entry> 2557 <entry>u<subscript>1</subscript></entry>
2469 <entry>u<subscript>0</subscript></entry> 2558 <entry>u<subscript>0</subscript></entry>
2470 <entry>y<subscript>9</subscript></entry>
2471 <entry>y<subscript>8</subscript></entry>
2472 <entry>y<subscript>7</subscript></entry> 2559 <entry>y<subscript>7</subscript></entry>
2473 <entry>y<subscript>6</subscript></entry> 2560 <entry>y<subscript>6</subscript></entry>
2474 <entry>y<subscript>5</subscript></entry> 2561 <entry>y<subscript>5</subscript></entry>
@@ -2482,9 +2569,7 @@ see <xref linkend="colorspaces" />.</entry>
2482 <entry></entry> 2569 <entry></entry>
2483 <entry></entry> 2570 <entry></entry>
2484 <entry></entry> 2571 <entry></entry>
2485 &dash-ent-12; 2572 &dash-ent-16;
2486 <entry>v<subscript>9</subscript></entry>
2487 <entry>v<subscript>8</subscript></entry>
2488 <entry>v<subscript>7</subscript></entry> 2573 <entry>v<subscript>7</subscript></entry>
2489 <entry>v<subscript>6</subscript></entry> 2574 <entry>v<subscript>6</subscript></entry>
2490 <entry>v<subscript>5</subscript></entry> 2575 <entry>v<subscript>5</subscript></entry>
@@ -2493,8 +2578,6 @@ see <xref linkend="colorspaces" />.</entry>
2493 <entry>v<subscript>2</subscript></entry> 2578 <entry>v<subscript>2</subscript></entry>
2494 <entry>v<subscript>1</subscript></entry> 2579 <entry>v<subscript>1</subscript></entry>
2495 <entry>v<subscript>0</subscript></entry> 2580 <entry>v<subscript>0</subscript></entry>
2496 <entry>y<subscript>9</subscript></entry>
2497 <entry>y<subscript>8</subscript></entry>
2498 <entry>y<subscript>7</subscript></entry> 2581 <entry>y<subscript>7</subscript></entry>
2499 <entry>y<subscript>6</subscript></entry> 2582 <entry>y<subscript>6</subscript></entry>
2500 <entry>y<subscript>5</subscript></entry> 2583 <entry>y<subscript>5</subscript></entry>
@@ -2504,13 +2587,11 @@ see <xref linkend="colorspaces" />.</entry>
2504 <entry>y<subscript>1</subscript></entry> 2587 <entry>y<subscript>1</subscript></entry>
2505 <entry>y<subscript>0</subscript></entry> 2588 <entry>y<subscript>0</subscript></entry>
2506 </row> 2589 </row>
2507 <row id="MEDIA-BUS-FMT-VYUY10-1X20"> 2590 <row id="MEDIA-BUS-FMT-VYUY8-1X16">
2508 <entry>MEDIA_BUS_FMT_VYUY10_1X20</entry> 2591 <entry>MEDIA_BUS_FMT_VYUY8_1X16</entry>
2509 <entry>0x201b</entry> 2592 <entry>0x2010</entry>
2510 <entry></entry> 2593 <entry></entry>
2511 &dash-ent-12; 2594 &dash-ent-16;
2512 <entry>v<subscript>9</subscript></entry>
2513 <entry>v<subscript>8</subscript></entry>
2514 <entry>v<subscript>7</subscript></entry> 2595 <entry>v<subscript>7</subscript></entry>
2515 <entry>v<subscript>6</subscript></entry> 2596 <entry>v<subscript>6</subscript></entry>
2516 <entry>v<subscript>5</subscript></entry> 2597 <entry>v<subscript>5</subscript></entry>
@@ -2519,8 +2600,6 @@ see <xref linkend="colorspaces" />.</entry>
2519 <entry>v<subscript>2</subscript></entry> 2600 <entry>v<subscript>2</subscript></entry>
2520 <entry>v<subscript>1</subscript></entry> 2601 <entry>v<subscript>1</subscript></entry>
2521 <entry>v<subscript>0</subscript></entry> 2602 <entry>v<subscript>0</subscript></entry>
2522 <entry>y<subscript>9</subscript></entry>
2523 <entry>y<subscript>8</subscript></entry>
2524 <entry>y<subscript>7</subscript></entry> 2603 <entry>y<subscript>7</subscript></entry>
2525 <entry>y<subscript>6</subscript></entry> 2604 <entry>y<subscript>6</subscript></entry>
2526 <entry>y<subscript>5</subscript></entry> 2605 <entry>y<subscript>5</subscript></entry>
@@ -2534,9 +2613,7 @@ see <xref linkend="colorspaces" />.</entry>
2534 <entry></entry> 2613 <entry></entry>
2535 <entry></entry> 2614 <entry></entry>
2536 <entry></entry> 2615 <entry></entry>
2537 &dash-ent-12; 2616 &dash-ent-16;
2538 <entry>u<subscript>9</subscript></entry>
2539 <entry>u<subscript>8</subscript></entry>
2540 <entry>u<subscript>7</subscript></entry> 2617 <entry>u<subscript>7</subscript></entry>
2541 <entry>u<subscript>6</subscript></entry> 2618 <entry>u<subscript>6</subscript></entry>
2542 <entry>u<subscript>5</subscript></entry> 2619 <entry>u<subscript>5</subscript></entry>
@@ -2545,8 +2622,6 @@ see <xref linkend="colorspaces" />.</entry>
2545 <entry>u<subscript>2</subscript></entry> 2622 <entry>u<subscript>2</subscript></entry>
2546 <entry>u<subscript>1</subscript></entry> 2623 <entry>u<subscript>1</subscript></entry>
2547 <entry>u<subscript>0</subscript></entry> 2624 <entry>u<subscript>0</subscript></entry>
2548 <entry>y<subscript>9</subscript></entry>
2549 <entry>y<subscript>8</subscript></entry>
2550 <entry>y<subscript>7</subscript></entry> 2625 <entry>y<subscript>7</subscript></entry>
2551 <entry>y<subscript>6</subscript></entry> 2626 <entry>y<subscript>6</subscript></entry>
2552 <entry>y<subscript>5</subscript></entry> 2627 <entry>y<subscript>5</subscript></entry>
@@ -2556,13 +2631,11 @@ see <xref linkend="colorspaces" />.</entry>
2556 <entry>y<subscript>1</subscript></entry> 2631 <entry>y<subscript>1</subscript></entry>
2557 <entry>y<subscript>0</subscript></entry> 2632 <entry>y<subscript>0</subscript></entry>
2558 </row> 2633 </row>
2559 <row id="MEDIA-BUS-FMT-YUYV10-1X20"> 2634 <row id="MEDIA-BUS-FMT-YUYV8-1X16">
2560 <entry>MEDIA_BUS_FMT_YUYV10_1X20</entry> 2635 <entry>MEDIA_BUS_FMT_YUYV8_1X16</entry>
2561 <entry>0x200d</entry> 2636 <entry>0x2011</entry>
2562 <entry></entry> 2637 <entry></entry>
2563 &dash-ent-12; 2638 &dash-ent-16;
2564 <entry>y<subscript>9</subscript></entry>
2565 <entry>y<subscript>8</subscript></entry>
2566 <entry>y<subscript>7</subscript></entry> 2639 <entry>y<subscript>7</subscript></entry>
2567 <entry>y<subscript>6</subscript></entry> 2640 <entry>y<subscript>6</subscript></entry>
2568 <entry>y<subscript>5</subscript></entry> 2641 <entry>y<subscript>5</subscript></entry>
@@ -2571,8 +2644,6 @@ see <xref linkend="colorspaces" />.</entry>
2571 <entry>y<subscript>2</subscript></entry> 2644 <entry>y<subscript>2</subscript></entry>
2572 <entry>y<subscript>1</subscript></entry> 2645 <entry>y<subscript>1</subscript></entry>
2573 <entry>y<subscript>0</subscript></entry> 2646 <entry>y<subscript>0</subscript></entry>
2574 <entry>u<subscript>9</subscript></entry>
2575 <entry>u<subscript>8</subscript></entry>
2576 <entry>u<subscript>7</subscript></entry> 2647 <entry>u<subscript>7</subscript></entry>
2577 <entry>u<subscript>6</subscript></entry> 2648 <entry>u<subscript>6</subscript></entry>
2578 <entry>u<subscript>5</subscript></entry> 2649 <entry>u<subscript>5</subscript></entry>
@@ -2586,9 +2657,7 @@ see <xref linkend="colorspaces" />.</entry>
2586 <entry></entry> 2657 <entry></entry>
2587 <entry></entry> 2658 <entry></entry>
2588 <entry></entry> 2659 <entry></entry>
2589 &dash-ent-12; 2660 &dash-ent-16;
2590 <entry>y<subscript>9</subscript></entry>
2591 <entry>y<subscript>8</subscript></entry>
2592 <entry>y<subscript>7</subscript></entry> 2661 <entry>y<subscript>7</subscript></entry>
2593 <entry>y<subscript>6</subscript></entry> 2662 <entry>y<subscript>6</subscript></entry>
2594 <entry>y<subscript>5</subscript></entry> 2663 <entry>y<subscript>5</subscript></entry>
@@ -2597,8 +2666,6 @@ see <xref linkend="colorspaces" />.</entry>
2597 <entry>y<subscript>2</subscript></entry> 2666 <entry>y<subscript>2</subscript></entry>
2598 <entry>y<subscript>1</subscript></entry> 2667 <entry>y<subscript>1</subscript></entry>
2599 <entry>y<subscript>0</subscript></entry> 2668 <entry>y<subscript>0</subscript></entry>
2600 <entry>v<subscript>9</subscript></entry>
2601 <entry>v<subscript>8</subscript></entry>
2602 <entry>v<subscript>7</subscript></entry> 2669 <entry>v<subscript>7</subscript></entry>
2603 <entry>v<subscript>6</subscript></entry> 2670 <entry>v<subscript>6</subscript></entry>
2604 <entry>v<subscript>5</subscript></entry> 2671 <entry>v<subscript>5</subscript></entry>
@@ -2608,13 +2675,11 @@ see <xref linkend="colorspaces" />.</entry>
2608 <entry>v<subscript>1</subscript></entry> 2675 <entry>v<subscript>1</subscript></entry>
2609 <entry>v<subscript>0</subscript></entry> 2676 <entry>v<subscript>0</subscript></entry>
2610 </row> 2677 </row>
2611 <row id="MEDIA-BUS-FMT-YVYU10-1X20"> 2678 <row id="MEDIA-BUS-FMT-YVYU8-1X16">
2612 <entry>MEDIA_BUS_FMT_YVYU10_1X20</entry> 2679 <entry>MEDIA_BUS_FMT_YVYU8_1X16</entry>
2613 <entry>0x200e</entry> 2680 <entry>0x2012</entry>
2614 <entry></entry> 2681 <entry></entry>
2615 &dash-ent-12; 2682 &dash-ent-16;
2616 <entry>y<subscript>9</subscript></entry>
2617 <entry>y<subscript>8</subscript></entry>
2618 <entry>y<subscript>7</subscript></entry> 2683 <entry>y<subscript>7</subscript></entry>
2619 <entry>y<subscript>6</subscript></entry> 2684 <entry>y<subscript>6</subscript></entry>
2620 <entry>y<subscript>5</subscript></entry> 2685 <entry>y<subscript>5</subscript></entry>
@@ -2623,8 +2688,6 @@ see <xref linkend="colorspaces" />.</entry>
2623 <entry>y<subscript>2</subscript></entry> 2688 <entry>y<subscript>2</subscript></entry>
2624 <entry>y<subscript>1</subscript></entry> 2689 <entry>y<subscript>1</subscript></entry>
2625 <entry>y<subscript>0</subscript></entry> 2690 <entry>y<subscript>0</subscript></entry>
2626 <entry>v<subscript>9</subscript></entry>
2627 <entry>v<subscript>8</subscript></entry>
2628 <entry>v<subscript>7</subscript></entry> 2691 <entry>v<subscript>7</subscript></entry>
2629 <entry>v<subscript>6</subscript></entry> 2692 <entry>v<subscript>6</subscript></entry>
2630 <entry>v<subscript>5</subscript></entry> 2693 <entry>v<subscript>5</subscript></entry>
@@ -2638,9 +2701,7 @@ see <xref linkend="colorspaces" />.</entry>
2638 <entry></entry> 2701 <entry></entry>
2639 <entry></entry> 2702 <entry></entry>
2640 <entry></entry> 2703 <entry></entry>
2641 &dash-ent-12; 2704 &dash-ent-16;
2642 <entry>y<subscript>9</subscript></entry>
2643 <entry>y<subscript>8</subscript></entry>
2644 <entry>y<subscript>7</subscript></entry> 2705 <entry>y<subscript>7</subscript></entry>
2645 <entry>y<subscript>6</subscript></entry> 2706 <entry>y<subscript>6</subscript></entry>
2646 <entry>y<subscript>5</subscript></entry> 2707 <entry>y<subscript>5</subscript></entry>
@@ -2649,8 +2710,6 @@ see <xref linkend="colorspaces" />.</entry>
2649 <entry>y<subscript>2</subscript></entry> 2710 <entry>y<subscript>2</subscript></entry>
2650 <entry>y<subscript>1</subscript></entry> 2711 <entry>y<subscript>1</subscript></entry>
2651 <entry>y<subscript>0</subscript></entry> 2712 <entry>y<subscript>0</subscript></entry>
2652 <entry>u<subscript>9</subscript></entry>
2653 <entry>u<subscript>8</subscript></entry>
2654 <entry>u<subscript>7</subscript></entry> 2713 <entry>u<subscript>7</subscript></entry>
2655 <entry>u<subscript>6</subscript></entry> 2714 <entry>u<subscript>6</subscript></entry>
2656 <entry>u<subscript>5</subscript></entry> 2715 <entry>u<subscript>5</subscript></entry>
@@ -2660,14 +2719,11 @@ see <xref linkend="colorspaces" />.</entry>
2660 <entry>u<subscript>1</subscript></entry> 2719 <entry>u<subscript>1</subscript></entry>
2661 <entry>u<subscript>0</subscript></entry> 2720 <entry>u<subscript>0</subscript></entry>
2662 </row> 2721 </row>
2663 <row id="MEDIA-BUS-FMT-YUV10-1X30"> 2722 <row id="MEDIA-BUS-FMT-YDYUYDYV8-1X16">
2664 <entry>MEDIA_BUS_FMT_YUV10_1X30</entry> 2723 <entry>MEDIA_BUS_FMT_YDYUYDYV8_1X16</entry>
2665 <entry>0x2016</entry> 2724 <entry>0x2014</entry>
2666 <entry></entry> 2725 <entry></entry>
2667 <entry>-</entry> 2726 &dash-ent-16;
2668 <entry>-</entry>
2669 <entry>y<subscript>9</subscript></entry>
2670 <entry>y<subscript>8</subscript></entry>
2671 <entry>y<subscript>7</subscript></entry> 2727 <entry>y<subscript>7</subscript></entry>
2672 <entry>y<subscript>6</subscript></entry> 2728 <entry>y<subscript>6</subscript></entry>
2673 <entry>y<subscript>5</subscript></entry> 2729 <entry>y<subscript>5</subscript></entry>
@@ -2676,39 +2732,20 @@ see <xref linkend="colorspaces" />.</entry>
2676 <entry>y<subscript>2</subscript></entry> 2732 <entry>y<subscript>2</subscript></entry>
2677 <entry>y<subscript>1</subscript></entry> 2733 <entry>y<subscript>1</subscript></entry>
2678 <entry>y<subscript>0</subscript></entry> 2734 <entry>y<subscript>0</subscript></entry>
2679 <entry>u<subscript>9</subscript></entry> 2735 <entry>d</entry>
2680 <entry>u<subscript>8</subscript></entry> 2736 <entry>d</entry>
2681 <entry>u<subscript>7</subscript></entry> 2737 <entry>d</entry>
2682 <entry>u<subscript>6</subscript></entry> 2738 <entry>d</entry>
2683 <entry>u<subscript>5</subscript></entry> 2739 <entry>d</entry>
2684 <entry>u<subscript>4</subscript></entry> 2740 <entry>d</entry>
2685 <entry>u<subscript>3</subscript></entry> 2741 <entry>d</entry>
2686 <entry>u<subscript>2</subscript></entry> 2742 <entry>d</entry>
2687 <entry>u<subscript>1</subscript></entry>
2688 <entry>u<subscript>0</subscript></entry>
2689 <entry>v<subscript>9</subscript></entry>
2690 <entry>v<subscript>8</subscript></entry>
2691 <entry>v<subscript>7</subscript></entry>
2692 <entry>v<subscript>6</subscript></entry>
2693 <entry>v<subscript>5</subscript></entry>
2694 <entry>v<subscript>4</subscript></entry>
2695 <entry>v<subscript>3</subscript></entry>
2696 <entry>v<subscript>2</subscript></entry>
2697 <entry>v<subscript>1</subscript></entry>
2698 <entry>v<subscript>0</subscript></entry>
2699 </row> 2743 </row>
2700 <row id="MEDIA-BUS-FMT-AYUV8-1X32"> 2744 <row>
2701 <entry>MEDIA_BUS_FMT_AYUV8_1X32</entry>
2702 <entry>0x2017</entry>
2703 <entry></entry> 2745 <entry></entry>
2704 <entry>a<subscript>7</subscript></entry> 2746 <entry></entry>
2705 <entry>a<subscript>6</subscript></entry> 2747 <entry></entry>
2706 <entry>a<subscript>5</subscript></entry> 2748 &dash-ent-16;
2707 <entry>a<subscript>4</subscript></entry>
2708 <entry>a<subscript>3</subscript></entry>
2709 <entry>a<subscript>2</subscript></entry>
2710 <entry>a<subscript>1</subscript></entry>
2711 <entry>a<subscript>0</subscript></entry>
2712 <entry>y<subscript>7</subscript></entry> 2749 <entry>y<subscript>7</subscript></entry>
2713 <entry>y<subscript>6</subscript></entry> 2750 <entry>y<subscript>6</subscript></entry>
2714 <entry>y<subscript>5</subscript></entry> 2751 <entry>y<subscript>5</subscript></entry>
@@ -2725,6 +2762,42 @@ see <xref linkend="colorspaces" />.</entry>
2725 <entry>u<subscript>2</subscript></entry> 2762 <entry>u<subscript>2</subscript></entry>
2726 <entry>u<subscript>1</subscript></entry> 2763 <entry>u<subscript>1</subscript></entry>
2727 <entry>u<subscript>0</subscript></entry> 2764 <entry>u<subscript>0</subscript></entry>
2765 </row>
2766 <row>
2767 <entry></entry>
2768 <entry></entry>
2769 <entry></entry>
2770 &dash-ent-16;
2771 <entry>y<subscript>7</subscript></entry>
2772 <entry>y<subscript>6</subscript></entry>
2773 <entry>y<subscript>5</subscript></entry>
2774 <entry>y<subscript>4</subscript></entry>
2775 <entry>y<subscript>3</subscript></entry>
2776 <entry>y<subscript>2</subscript></entry>
2777 <entry>y<subscript>1</subscript></entry>
2778 <entry>y<subscript>0</subscript></entry>
2779 <entry>d</entry>
2780 <entry>d</entry>
2781 <entry>d</entry>
2782 <entry>d</entry>
2783 <entry>d</entry>
2784 <entry>d</entry>
2785 <entry>d</entry>
2786 <entry>d</entry>
2787 </row>
2788 <row>
2789 <entry></entry>
2790 <entry></entry>
2791 <entry></entry>
2792 &dash-ent-16;
2793 <entry>y<subscript>7</subscript></entry>
2794 <entry>y<subscript>6</subscript></entry>
2795 <entry>y<subscript>5</subscript></entry>
2796 <entry>y<subscript>4</subscript></entry>
2797 <entry>y<subscript>3</subscript></entry>
2798 <entry>y<subscript>2</subscript></entry>
2799 <entry>y<subscript>1</subscript></entry>
2800 <entry>y<subscript>0</subscript></entry>
2728 <entry>v<subscript>7</subscript></entry> 2801 <entry>v<subscript>7</subscript></entry>
2729 <entry>v<subscript>6</subscript></entry> 2802 <entry>v<subscript>6</subscript></entry>
2730 <entry>v<subscript>5</subscript></entry> 2803 <entry>v<subscript>5</subscript></entry>
@@ -2734,13 +2807,11 @@ see <xref linkend="colorspaces" />.</entry>
2734 <entry>v<subscript>1</subscript></entry> 2807 <entry>v<subscript>1</subscript></entry>
2735 <entry>v<subscript>0</subscript></entry> 2808 <entry>v<subscript>0</subscript></entry>
2736 </row> 2809 </row>
2737 <row id="MEDIA-BUS-FMT-UYVY12-2X12"> 2810 <row id="MEDIA-BUS-FMT-UYVY10-1X20">
2738 <entry>MEDIA_BUS_FMT_UYVY12_2X12</entry> 2811 <entry>MEDIA_BUS_FMT_UYVY10_1X20</entry>
2739 <entry>0x201c</entry> 2812 <entry>0x201a</entry>
2740 <entry></entry> 2813 <entry></entry>
2741 &dash-ent-20; 2814 &dash-ent-12;
2742 <entry>u<subscript>11</subscript></entry>
2743 <entry>u<subscript>10</subscript></entry>
2744 <entry>u<subscript>9</subscript></entry> 2815 <entry>u<subscript>9</subscript></entry>
2745 <entry>u<subscript>8</subscript></entry> 2816 <entry>u<subscript>8</subscript></entry>
2746 <entry>u<subscript>7</subscript></entry> 2817 <entry>u<subscript>7</subscript></entry>
@@ -2751,14 +2822,6 @@ see <xref linkend="colorspaces" />.</entry>
2751 <entry>u<subscript>2</subscript></entry> 2822 <entry>u<subscript>2</subscript></entry>
2752 <entry>u<subscript>1</subscript></entry> 2823 <entry>u<subscript>1</subscript></entry>
2753 <entry>u<subscript>0</subscript></entry> 2824 <entry>u<subscript>0</subscript></entry>
2754 </row>
2755 <row>
2756 <entry></entry>
2757 <entry></entry>
2758 <entry></entry>
2759 &dash-ent-20;
2760 <entry>y<subscript>11</subscript></entry>
2761 <entry>y<subscript>10</subscript></entry>
2762 <entry>y<subscript>9</subscript></entry> 2825 <entry>y<subscript>9</subscript></entry>
2763 <entry>y<subscript>8</subscript></entry> 2826 <entry>y<subscript>8</subscript></entry>
2764 <entry>y<subscript>7</subscript></entry> 2827 <entry>y<subscript>7</subscript></entry>
@@ -2774,9 +2837,7 @@ see <xref linkend="colorspaces" />.</entry>
2774 <entry></entry> 2837 <entry></entry>
2775 <entry></entry> 2838 <entry></entry>
2776 <entry></entry> 2839 <entry></entry>
2777 &dash-ent-20; 2840 &dash-ent-12;
2778 <entry>v<subscript>11</subscript></entry>
2779 <entry>v<subscript>10</subscript></entry>
2780 <entry>v<subscript>9</subscript></entry> 2841 <entry>v<subscript>9</subscript></entry>
2781 <entry>v<subscript>8</subscript></entry> 2842 <entry>v<subscript>8</subscript></entry>
2782 <entry>v<subscript>7</subscript></entry> 2843 <entry>v<subscript>7</subscript></entry>
@@ -2787,14 +2848,6 @@ see <xref linkend="colorspaces" />.</entry>
2787 <entry>v<subscript>2</subscript></entry> 2848 <entry>v<subscript>2</subscript></entry>
2788 <entry>v<subscript>1</subscript></entry> 2849 <entry>v<subscript>1</subscript></entry>
2789 <entry>v<subscript>0</subscript></entry> 2850 <entry>v<subscript>0</subscript></entry>
2790 </row>
2791 <row>
2792 <entry></entry>
2793 <entry></entry>
2794 <entry></entry>
2795 &dash-ent-20;
2796 <entry>y<subscript>11</subscript></entry>
2797 <entry>y<subscript>10</subscript></entry>
2798 <entry>y<subscript>9</subscript></entry> 2851 <entry>y<subscript>9</subscript></entry>
2799 <entry>y<subscript>8</subscript></entry> 2852 <entry>y<subscript>8</subscript></entry>
2800 <entry>y<subscript>7</subscript></entry> 2853 <entry>y<subscript>7</subscript></entry>
@@ -2806,13 +2859,11 @@ see <xref linkend="colorspaces" />.</entry>
2806 <entry>y<subscript>1</subscript></entry> 2859 <entry>y<subscript>1</subscript></entry>
2807 <entry>y<subscript>0</subscript></entry> 2860 <entry>y<subscript>0</subscript></entry>
2808 </row> 2861 </row>
2809 <row id="MEDIA-BUS-FMT-VYUY12-2X12"> 2862 <row id="MEDIA-BUS-FMT-VYUY10-1X20">
2810 <entry>MEDIA_BUS_FMT_VYUY12_2X12</entry> 2863 <entry>MEDIA_BUS_FMT_VYUY10_1X20</entry>
2811 <entry>0x201d</entry> 2864 <entry>0x201b</entry>
2812 <entry></entry> 2865 <entry></entry>
2813 &dash-ent-20; 2866 &dash-ent-12;
2814 <entry>v<subscript>11</subscript></entry>
2815 <entry>v<subscript>10</subscript></entry>
2816 <entry>v<subscript>9</subscript></entry> 2867 <entry>v<subscript>9</subscript></entry>
2817 <entry>v<subscript>8</subscript></entry> 2868 <entry>v<subscript>8</subscript></entry>
2818 <entry>v<subscript>7</subscript></entry> 2869 <entry>v<subscript>7</subscript></entry>
@@ -2823,14 +2874,6 @@ see <xref linkend="colorspaces" />.</entry>
2823 <entry>v<subscript>2</subscript></entry> 2874 <entry>v<subscript>2</subscript></entry>
2824 <entry>v<subscript>1</subscript></entry> 2875 <entry>v<subscript>1</subscript></entry>
2825 <entry>v<subscript>0</subscript></entry> 2876 <entry>v<subscript>0</subscript></entry>
2826 </row>
2827 <row>
2828 <entry></entry>
2829 <entry></entry>
2830 <entry></entry>
2831 &dash-ent-20;
2832 <entry>y<subscript>11</subscript></entry>
2833 <entry>y<subscript>10</subscript></entry>
2834 <entry>y<subscript>9</subscript></entry> 2877 <entry>y<subscript>9</subscript></entry>
2835 <entry>y<subscript>8</subscript></entry> 2878 <entry>y<subscript>8</subscript></entry>
2836 <entry>y<subscript>7</subscript></entry> 2879 <entry>y<subscript>7</subscript></entry>
@@ -2846,9 +2889,7 @@ see <xref linkend="colorspaces" />.</entry>
2846 <entry></entry> 2889 <entry></entry>
2847 <entry></entry> 2890 <entry></entry>
2848 <entry></entry> 2891 <entry></entry>
2849 &dash-ent-20; 2892 &dash-ent-12;
2850 <entry>u<subscript>11</subscript></entry>
2851 <entry>u<subscript>10</subscript></entry>
2852 <entry>u<subscript>9</subscript></entry> 2893 <entry>u<subscript>9</subscript></entry>
2853 <entry>u<subscript>8</subscript></entry> 2894 <entry>u<subscript>8</subscript></entry>
2854 <entry>u<subscript>7</subscript></entry> 2895 <entry>u<subscript>7</subscript></entry>
@@ -2859,14 +2900,6 @@ see <xref linkend="colorspaces" />.</entry>
2859 <entry>u<subscript>2</subscript></entry> 2900 <entry>u<subscript>2</subscript></entry>
2860 <entry>u<subscript>1</subscript></entry> 2901 <entry>u<subscript>1</subscript></entry>
2861 <entry>u<subscript>0</subscript></entry> 2902 <entry>u<subscript>0</subscript></entry>
2862 </row>
2863 <row>
2864 <entry></entry>
2865 <entry></entry>
2866 <entry></entry>
2867 &dash-ent-20;
2868 <entry>y<subscript>11</subscript></entry>
2869 <entry>y<subscript>10</subscript></entry>
2870 <entry>y<subscript>9</subscript></entry> 2903 <entry>y<subscript>9</subscript></entry>
2871 <entry>y<subscript>8</subscript></entry> 2904 <entry>y<subscript>8</subscript></entry>
2872 <entry>y<subscript>7</subscript></entry> 2905 <entry>y<subscript>7</subscript></entry>
@@ -2878,13 +2911,11 @@ see <xref linkend="colorspaces" />.</entry>
2878 <entry>y<subscript>1</subscript></entry> 2911 <entry>y<subscript>1</subscript></entry>
2879 <entry>y<subscript>0</subscript></entry> 2912 <entry>y<subscript>0</subscript></entry>
2880 </row> 2913 </row>
2881 <row id="MEDIA-BUS-FMT-YUYV12-2X12"> 2914 <row id="MEDIA-BUS-FMT-YUYV10-1X20">
2882 <entry>MEDIA_BUS_FMT_YUYV12_2X12</entry> 2915 <entry>MEDIA_BUS_FMT_YUYV10_1X20</entry>
2883 <entry>0x201e</entry> 2916 <entry>0x200d</entry>
2884 <entry></entry> 2917 <entry></entry>
2885 &dash-ent-20; 2918 &dash-ent-12;
2886 <entry>y<subscript>11</subscript></entry>
2887 <entry>y<subscript>10</subscript></entry>
2888 <entry>y<subscript>9</subscript></entry> 2919 <entry>y<subscript>9</subscript></entry>
2889 <entry>y<subscript>8</subscript></entry> 2920 <entry>y<subscript>8</subscript></entry>
2890 <entry>y<subscript>7</subscript></entry> 2921 <entry>y<subscript>7</subscript></entry>
@@ -2895,14 +2926,6 @@ see <xref linkend="colorspaces" />.</entry>
2895 <entry>y<subscript>2</subscript></entry> 2926 <entry>y<subscript>2</subscript></entry>
2896 <entry>y<subscript>1</subscript></entry> 2927 <entry>y<subscript>1</subscript></entry>
2897 <entry>y<subscript>0</subscript></entry> 2928 <entry>y<subscript>0</subscript></entry>
2898 </row>
2899 <row>
2900 <entry></entry>
2901 <entry></entry>
2902 <entry></entry>
2903 &dash-ent-20;
2904 <entry>u<subscript>11</subscript></entry>
2905 <entry>u<subscript>10</subscript></entry>
2906 <entry>u<subscript>9</subscript></entry> 2929 <entry>u<subscript>9</subscript></entry>
2907 <entry>u<subscript>8</subscript></entry> 2930 <entry>u<subscript>8</subscript></entry>
2908 <entry>u<subscript>7</subscript></entry> 2931 <entry>u<subscript>7</subscript></entry>
@@ -2918,9 +2941,7 @@ see <xref linkend="colorspaces" />.</entry>
2918 <entry></entry> 2941 <entry></entry>
2919 <entry></entry> 2942 <entry></entry>
2920 <entry></entry> 2943 <entry></entry>
2921 &dash-ent-20; 2944 &dash-ent-12;
2922 <entry>y<subscript>11</subscript></entry>
2923 <entry>y<subscript>10</subscript></entry>
2924 <entry>y<subscript>9</subscript></entry> 2945 <entry>y<subscript>9</subscript></entry>
2925 <entry>y<subscript>8</subscript></entry> 2946 <entry>y<subscript>8</subscript></entry>
2926 <entry>y<subscript>7</subscript></entry> 2947 <entry>y<subscript>7</subscript></entry>
@@ -2931,14 +2952,6 @@ see <xref linkend="colorspaces" />.</entry>
2931 <entry>y<subscript>2</subscript></entry> 2952 <entry>y<subscript>2</subscript></entry>
2932 <entry>y<subscript>1</subscript></entry> 2953 <entry>y<subscript>1</subscript></entry>
2933 <entry>y<subscript>0</subscript></entry> 2954 <entry>y<subscript>0</subscript></entry>
2934 </row>
2935 <row>
2936 <entry></entry>
2937 <entry></entry>
2938 <entry></entry>
2939 &dash-ent-20;
2940 <entry>v<subscript>11</subscript></entry>
2941 <entry>v<subscript>10</subscript></entry>
2942 <entry>v<subscript>9</subscript></entry> 2955 <entry>v<subscript>9</subscript></entry>
2943 <entry>v<subscript>8</subscript></entry> 2956 <entry>v<subscript>8</subscript></entry>
2944 <entry>v<subscript>7</subscript></entry> 2957 <entry>v<subscript>7</subscript></entry>
@@ -2950,13 +2963,11 @@ see <xref linkend="colorspaces" />.</entry>
2950 <entry>v<subscript>1</subscript></entry> 2963 <entry>v<subscript>1</subscript></entry>
2951 <entry>v<subscript>0</subscript></entry> 2964 <entry>v<subscript>0</subscript></entry>
2952 </row> 2965 </row>
2953 <row id="MEDIA-BUS-FMT-YVYU12-2X12"> 2966 <row id="MEDIA-BUS-FMT-YVYU10-1X20">
2954 <entry>MEDIA_BUS_FMT_YVYU12_2X12</entry> 2967 <entry>MEDIA_BUS_FMT_YVYU10_1X20</entry>
2955 <entry>0x201f</entry> 2968 <entry>0x200e</entry>
2956 <entry></entry> 2969 <entry></entry>
2957 &dash-ent-20; 2970 &dash-ent-12;
2958 <entry>y<subscript>11</subscript></entry>
2959 <entry>y<subscript>10</subscript></entry>
2960 <entry>y<subscript>9</subscript></entry> 2971 <entry>y<subscript>9</subscript></entry>
2961 <entry>y<subscript>8</subscript></entry> 2972 <entry>y<subscript>8</subscript></entry>
2962 <entry>y<subscript>7</subscript></entry> 2973 <entry>y<subscript>7</subscript></entry>
@@ -2967,14 +2978,6 @@ see <xref linkend="colorspaces" />.</entry>
2967 <entry>y<subscript>2</subscript></entry> 2978 <entry>y<subscript>2</subscript></entry>
2968 <entry>y<subscript>1</subscript></entry> 2979 <entry>y<subscript>1</subscript></entry>
2969 <entry>y<subscript>0</subscript></entry> 2980 <entry>y<subscript>0</subscript></entry>
2970 </row>
2971 <row>
2972 <entry></entry>
2973 <entry></entry>
2974 <entry></entry>
2975 &dash-ent-20;
2976 <entry>v<subscript>11</subscript></entry>
2977 <entry>v<subscript>10</subscript></entry>
2978 <entry>v<subscript>9</subscript></entry> 2981 <entry>v<subscript>9</subscript></entry>
2979 <entry>v<subscript>8</subscript></entry> 2982 <entry>v<subscript>8</subscript></entry>
2980 <entry>v<subscript>7</subscript></entry> 2983 <entry>v<subscript>7</subscript></entry>
@@ -2990,9 +2993,7 @@ see <xref linkend="colorspaces" />.</entry>
2990 <entry></entry> 2993 <entry></entry>
2991 <entry></entry> 2994 <entry></entry>
2992 <entry></entry> 2995 <entry></entry>
2993 &dash-ent-20; 2996 &dash-ent-12;
2994 <entry>y<subscript>11</subscript></entry>
2995 <entry>y<subscript>10</subscript></entry>
2996 <entry>y<subscript>9</subscript></entry> 2997 <entry>y<subscript>9</subscript></entry>
2997 <entry>y<subscript>8</subscript></entry> 2998 <entry>y<subscript>8</subscript></entry>
2998 <entry>y<subscript>7</subscript></entry> 2999 <entry>y<subscript>7</subscript></entry>
@@ -3003,14 +3004,6 @@ see <xref linkend="colorspaces" />.</entry>
3003 <entry>y<subscript>2</subscript></entry> 3004 <entry>y<subscript>2</subscript></entry>
3004 <entry>y<subscript>1</subscript></entry> 3005 <entry>y<subscript>1</subscript></entry>
3005 <entry>y<subscript>0</subscript></entry> 3006 <entry>y<subscript>0</subscript></entry>
3006 </row>
3007 <row>
3008 <entry></entry>
3009 <entry></entry>
3010 <entry></entry>
3011 &dash-ent-20;
3012 <entry>u<subscript>11</subscript></entry>
3013 <entry>u<subscript>10</subscript></entry>
3014 <entry>u<subscript>9</subscript></entry> 3007 <entry>u<subscript>9</subscript></entry>
3015 <entry>u<subscript>8</subscript></entry> 3008 <entry>u<subscript>8</subscript></entry>
3016 <entry>u<subscript>7</subscript></entry> 3009 <entry>u<subscript>7</subscript></entry>
@@ -3022,6 +3015,36 @@ see <xref linkend="colorspaces" />.</entry>
3022 <entry>u<subscript>1</subscript></entry> 3015 <entry>u<subscript>1</subscript></entry>
3023 <entry>u<subscript>0</subscript></entry> 3016 <entry>u<subscript>0</subscript></entry>
3024 </row> 3017 </row>
3018 <row id="MEDIA-BUS-FMT-VUY8-1X24">
3019 <entry>MEDIA_BUS_FMT_VUY8_1X24</entry>
3020 <entry>0x201a</entry>
3021 <entry></entry>
3022 &dash-ent-8;
3023 <entry>v<subscript>7</subscript></entry>
3024 <entry>v<subscript>6</subscript></entry>
3025 <entry>v<subscript>5</subscript></entry>
3026 <entry>v<subscript>4</subscript></entry>
3027 <entry>v<subscript>3</subscript></entry>
3028 <entry>v<subscript>2</subscript></entry>
3029 <entry>v<subscript>1</subscript></entry>
3030 <entry>v<subscript>0</subscript></entry>
3031 <entry>u<subscript>7</subscript></entry>
3032 <entry>u<subscript>6</subscript></entry>
3033 <entry>u<subscript>5</subscript></entry>
3034 <entry>u<subscript>4</subscript></entry>
3035 <entry>u<subscript>3</subscript></entry>
3036 <entry>u<subscript>2</subscript></entry>
3037 <entry>u<subscript>1</subscript></entry>
3038 <entry>u<subscript>0</subscript></entry>
3039 <entry>y<subscript>7</subscript></entry>
3040 <entry>y<subscript>6</subscript></entry>
3041 <entry>y<subscript>5</subscript></entry>
3042 <entry>y<subscript>4</subscript></entry>
3043 <entry>y<subscript>3</subscript></entry>
3044 <entry>y<subscript>2</subscript></entry>
3045 <entry>y<subscript>1</subscript></entry>
3046 <entry>y<subscript>0</subscript></entry>
3047 </row>
3025 <row id="MEDIA-BUS-FMT-UYVY12-1X24"> 3048 <row id="MEDIA-BUS-FMT-UYVY12-1X24">
3026 <entry>MEDIA_BUS_FMT_UYVY12_1X24</entry> 3049 <entry>MEDIA_BUS_FMT_UYVY12_1X24</entry>
3027 <entry>0x2020</entry> 3050 <entry>0x2020</entry>
@@ -3262,6 +3285,80 @@ see <xref linkend="colorspaces" />.</entry>
3262 <entry>u<subscript>1</subscript></entry> 3285 <entry>u<subscript>1</subscript></entry>
3263 <entry>u<subscript>0</subscript></entry> 3286 <entry>u<subscript>0</subscript></entry>
3264 </row> 3287 </row>
3288 <row id="MEDIA-BUS-FMT-YUV10-1X30">
3289 <entry>MEDIA_BUS_FMT_YUV10_1X30</entry>
3290 <entry>0x2016</entry>
3291 <entry></entry>
3292 <entry>-</entry>
3293 <entry>-</entry>
3294 <entry>y<subscript>9</subscript></entry>
3295 <entry>y<subscript>8</subscript></entry>
3296 <entry>y<subscript>7</subscript></entry>
3297 <entry>y<subscript>6</subscript></entry>
3298 <entry>y<subscript>5</subscript></entry>
3299 <entry>y<subscript>4</subscript></entry>
3300 <entry>y<subscript>3</subscript></entry>
3301 <entry>y<subscript>2</subscript></entry>
3302 <entry>y<subscript>1</subscript></entry>
3303 <entry>y<subscript>0</subscript></entry>
3304 <entry>u<subscript>9</subscript></entry>
3305 <entry>u<subscript>8</subscript></entry>
3306 <entry>u<subscript>7</subscript></entry>
3307 <entry>u<subscript>6</subscript></entry>
3308 <entry>u<subscript>5</subscript></entry>
3309 <entry>u<subscript>4</subscript></entry>
3310 <entry>u<subscript>3</subscript></entry>
3311 <entry>u<subscript>2</subscript></entry>
3312 <entry>u<subscript>1</subscript></entry>
3313 <entry>u<subscript>0</subscript></entry>
3314 <entry>v<subscript>9</subscript></entry>
3315 <entry>v<subscript>8</subscript></entry>
3316 <entry>v<subscript>7</subscript></entry>
3317 <entry>v<subscript>6</subscript></entry>
3318 <entry>v<subscript>5</subscript></entry>
3319 <entry>v<subscript>4</subscript></entry>
3320 <entry>v<subscript>3</subscript></entry>
3321 <entry>v<subscript>2</subscript></entry>
3322 <entry>v<subscript>1</subscript></entry>
3323 <entry>v<subscript>0</subscript></entry>
3324 </row>
3325 <row id="MEDIA-BUS-FMT-AYUV8-1X32">
3326 <entry>MEDIA_BUS_FMT_AYUV8_1X32</entry>
3327 <entry>0x2017</entry>
3328 <entry></entry>
3329 <entry>a<subscript>7</subscript></entry>
3330 <entry>a<subscript>6</subscript></entry>
3331 <entry>a<subscript>5</subscript></entry>
3332 <entry>a<subscript>4</subscript></entry>
3333 <entry>a<subscript>3</subscript></entry>
3334 <entry>a<subscript>2</subscript></entry>
3335 <entry>a<subscript>1</subscript></entry>
3336 <entry>a<subscript>0</subscript></entry>
3337 <entry>y<subscript>7</subscript></entry>
3338 <entry>y<subscript>6</subscript></entry>
3339 <entry>y<subscript>5</subscript></entry>
3340 <entry>y<subscript>4</subscript></entry>
3341 <entry>y<subscript>3</subscript></entry>
3342 <entry>y<subscript>2</subscript></entry>
3343 <entry>y<subscript>1</subscript></entry>
3344 <entry>y<subscript>0</subscript></entry>
3345 <entry>u<subscript>7</subscript></entry>
3346 <entry>u<subscript>6</subscript></entry>
3347 <entry>u<subscript>5</subscript></entry>
3348 <entry>u<subscript>4</subscript></entry>
3349 <entry>u<subscript>3</subscript></entry>
3350 <entry>u<subscript>2</subscript></entry>
3351 <entry>u<subscript>1</subscript></entry>
3352 <entry>u<subscript>0</subscript></entry>
3353 <entry>v<subscript>7</subscript></entry>
3354 <entry>v<subscript>6</subscript></entry>
3355 <entry>v<subscript>5</subscript></entry>
3356 <entry>v<subscript>4</subscript></entry>
3357 <entry>v<subscript>3</subscript></entry>
3358 <entry>v<subscript>2</subscript></entry>
3359 <entry>v<subscript>1</subscript></entry>
3360 <entry>v<subscript>0</subscript></entry>
3361 </row>
3265 </tbody> 3362 </tbody>
3266 </tgroup> 3363 </tgroup>
3267 </table> 3364 </table>
diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml
index ac0f8d9d2a49..e98caa1c39bd 100644
--- a/Documentation/DocBook/media/v4l/v4l2.xml
+++ b/Documentation/DocBook/media/v4l/v4l2.xml
@@ -136,6 +136,7 @@ Remote Controller chapter.</contrib>
136 <year>2012</year> 136 <year>2012</year>
137 <year>2013</year> 137 <year>2013</year>
138 <year>2014</year> 138 <year>2014</year>
139 <year>2015</year>
139 <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin 140 <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
140Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab, 141Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab,
141 Pawel Osciak</holder> 142 Pawel Osciak</holder>
@@ -152,6 +153,14 @@ structs, ioctls) must be noted in more detail in the history chapter
152applications. --> 153applications. -->
153 154
154 <revision> 155 <revision>
156 <revnumber>3.21</revnumber>
157 <date>2015-02-13</date>
158 <authorinitials>mcc</authorinitials>
159 <revremark>Fix documentation for media controller device nodes and add support for DVB device nodes.
160Add support for Tuner sub-device.
161 </revremark>
162 </revision>
163 <revision>
155 <revnumber>3.19</revnumber> 164 <revnumber>3.19</revnumber>
156 <date>2014-12-05</date> 165 <date>2014-12-05</date>
157 <authorinitials>hv</authorinitials> 166 <authorinitials>hv</authorinitials>
diff --git a/Documentation/DocBook/media/v4l/vidioc-cropcap.xml b/Documentation/DocBook/media/v4l/vidioc-cropcap.xml
index 1f5ed64cd75a..50cb940cbe5c 100644
--- a/Documentation/DocBook/media/v4l/vidioc-cropcap.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-cropcap.xml
@@ -59,6 +59,11 @@ constant except when switching the video standard. Remember this
59switch can occur implicit when switching the video input or 59switch can occur implicit when switching the video input or
60output.</para> 60output.</para>
61 61
62<para>Do not use the multiplanar buffer types. Use <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>
63instead of <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant>
64and use <constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> instead of
65<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant>.</para>
66
62 <para>This ioctl must be implemented for video capture or output devices that 67 <para>This ioctl must be implemented for video capture or output devices that
63support cropping and/or scaling and/or have non-square pixels, and for overlay devices.</para> 68support cropping and/or scaling and/or have non-square pixels, and for overlay devices.</para>
64 69
@@ -73,9 +78,7 @@ support cropping and/or scaling and/or have non-square pixels, and for overlay d
73 <entry>Type of the data stream, set by the application. 78 <entry>Type of the data stream, set by the application.
74Only these types are valid here: 79Only these types are valid here:
75<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>, 80<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>,
76<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant>, 81<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> and
77<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant>,
78<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant> and
79<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>. See <xref linkend="v4l2-buf-type" />.</entry> 82<constant>V4L2_BUF_TYPE_VIDEO_OVERLAY</constant>. See <xref linkend="v4l2-buf-type" />.</entry>
80 </row> 83 </row>
81 <row> 84 <row>
diff --git a/Documentation/DocBook/media/v4l/vidioc-dqevent.xml b/Documentation/DocBook/media/v4l/vidioc-dqevent.xml
index b036f8963353..50ccd33948c1 100644
--- a/Documentation/DocBook/media/v4l/vidioc-dqevent.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-dqevent.xml
@@ -64,7 +64,7 @@
64 <entry>__u32</entry> 64 <entry>__u32</entry>
65 <entry><structfield>type</structfield></entry> 65 <entry><structfield>type</structfield></entry>
66 <entry></entry> 66 <entry></entry>
67 <entry>Type of the event.</entry> 67 <entry>Type of the event, see <xref linkend="event-type" />.</entry>
68 </row> 68 </row>
69 <row> 69 <row>
70 <entry>union</entry> 70 <entry>union</entry>
@@ -154,6 +154,113 @@
154 </tgroup> 154 </tgroup>
155 </table> 155 </table>
156 156
157 <table frame="none" pgwide="1" id="event-type">
158 <title>Event Types</title>
159 <tgroup cols="3">
160 &cs-def;
161 <tbody valign="top">
162 <row>
163 <entry><constant>V4L2_EVENT_ALL</constant></entry>
164 <entry>0</entry>
165 <entry>All events. V4L2_EVENT_ALL is valid only for
166 VIDIOC_UNSUBSCRIBE_EVENT for unsubscribing all events at once.
167 </entry>
168 </row>
169 <row>
170 <entry><constant>V4L2_EVENT_VSYNC</constant></entry>
171 <entry>1</entry>
172 <entry>This event is triggered on the vertical sync.
173 This event has a &v4l2-event-vsync; associated with it.
174 </entry>
175 </row>
176 <row>
177 <entry><constant>V4L2_EVENT_EOS</constant></entry>
178 <entry>2</entry>
179 <entry>This event is triggered when the end of a stream is reached.
180 This is typically used with MPEG decoders to report to the application
181 when the last of the MPEG stream has been decoded.
182 </entry>
183 </row>
184 <row>
185 <entry><constant>V4L2_EVENT_CTRL</constant></entry>
186 <entry>3</entry>
187 <entry><para>This event requires that the <structfield>id</structfield>
188 matches the control ID from which you want to receive events.
189 This event is triggered if the control's value changes, if a
190 button control is pressed or if the control's flags change.
191 This event has a &v4l2-event-ctrl; associated with it. This struct
192 contains much of the same information as &v4l2-queryctrl; and
193 &v4l2-control;.</para>
194
195 <para>If the event is generated due to a call to &VIDIOC-S-CTRL; or
196 &VIDIOC-S-EXT-CTRLS;, then the event will <emphasis>not</emphasis> be sent to
197 the file handle that called the ioctl function. This prevents
198 nasty feedback loops. If you <emphasis>do</emphasis> want to get the
199 event, then set the <constant>V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK</constant>
200 flag.
201 </para>
202
203 <para>This event type will ensure that no information is lost when
204 more events are raised than there is room internally. In that
205 case the &v4l2-event-ctrl; of the second-oldest event is kept,
206 but the <structfield>changes</structfield> field of the
207 second-oldest event is ORed with the <structfield>changes</structfield>
208 field of the oldest event.</para>
209 </entry>
210 </row>
211 <row>
212 <entry><constant>V4L2_EVENT_FRAME_SYNC</constant></entry>
213 <entry>4</entry>
214 <entry>
215 <para>Triggered immediately when the reception of a
216 frame has begun. This event has a
217 &v4l2-event-frame-sync; associated with it.</para>
218
219 <para>If the hardware needs to be stopped in the case of a
220 buffer underrun it might not be able to generate this event.
221 In such cases the <structfield>frame_sequence</structfield>
222 field in &v4l2-event-frame-sync; will not be incremented. This
223 causes two consecutive frame sequence numbers to have n times
224 frame interval in between them.</para>
225 </entry>
226 </row>
227 <row>
228 <entry><constant>V4L2_EVENT_SOURCE_CHANGE</constant></entry>
229 <entry>5</entry>
230 <entry>
231 <para>This event is triggered when a source parameter change is
232 detected during runtime by the video device. It can be a
233 runtime resolution change triggered by a video decoder or the
234 format change happening on an input connector.
235 This event requires that the <structfield>id</structfield>
236 matches the input index (when used with a video device node)
237 or the pad index (when used with a subdevice node) from which
238 you want to receive events.</para>
239
240 <para>This event has a &v4l2-event-src-change; associated
241 with it. The <structfield>changes</structfield> bitfield denotes
242 what has changed for the subscribed pad. If multiple events
243 occurred before application could dequeue them, then the changes
244 will have the ORed value of all the events generated.</para>
245 </entry>
246 </row>
247 <row>
248 <entry><constant>V4L2_EVENT_MOTION_DET</constant></entry>
249 <entry>6</entry>
250 <entry>
251 <para>Triggered whenever the motion detection state for one or more of the regions
252 changes. This event has a &v4l2-event-motion-det; associated with it.</para>
253 </entry>
254 </row>
255 <row>
256 <entry><constant>V4L2_EVENT_PRIVATE_START</constant></entry>
257 <entry>0x08000000</entry>
258 <entry>Base event number for driver-private events.</entry>
259 </row>
260 </tbody>
261 </tgroup>
262 </table>
263
157 <table frame="none" pgwide="1" id="v4l2-event-vsync"> 264 <table frame="none" pgwide="1" id="v4l2-event-vsync">
158 <title>struct <structname>v4l2_event_vsync</structname></title> 265 <title>struct <structname>v4l2_event_vsync</structname></title>
159 <tgroup cols="3"> 266 <tgroup cols="3">
@@ -177,7 +284,7 @@
177 <entry>__u32</entry> 284 <entry>__u32</entry>
178 <entry><structfield>changes</structfield></entry> 285 <entry><structfield>changes</structfield></entry>
179 <entry></entry> 286 <entry></entry>
180 <entry>A bitmask that tells what has changed. See <xref linkend="changes-flags" />.</entry> 287 <entry>A bitmask that tells what has changed. See <xref linkend="ctrl-changes-flags" />.</entry>
181 </row> 288 </row>
182 <row> 289 <row>
183 <entry>__u32</entry> 290 <entry>__u32</entry>
@@ -309,8 +416,8 @@
309 </tgroup> 416 </tgroup>
310 </table> 417 </table>
311 418
312 <table pgwide="1" frame="none" id="changes-flags"> 419 <table pgwide="1" frame="none" id="ctrl-changes-flags">
313 <title>Changes</title> 420 <title>Control Changes</title>
314 <tgroup cols="3"> 421 <tgroup cols="3">
315 &cs-def; 422 &cs-def;
316 <tbody valign="top"> 423 <tbody valign="top">
@@ -318,9 +425,9 @@
318 <entry><constant>V4L2_EVENT_CTRL_CH_VALUE</constant></entry> 425 <entry><constant>V4L2_EVENT_CTRL_CH_VALUE</constant></entry>
319 <entry>0x0001</entry> 426 <entry>0x0001</entry>
320 <entry>This control event was triggered because the value of the control 427 <entry>This control event was triggered because the value of the control
321 changed. Special case: if a button control is pressed, then this 428 changed. Special cases: Volatile controls do no generate this event;
322 event is sent as well, even though there is not explicit value 429 If a control has the <constant>V4L2_CTRL_FLAG_EXECUTE_ON_WRITE</constant>
323 associated with a button control.</entry> 430 flag set, then this event is sent as well, regardless its value.</entry>
324 </row> 431 </row>
325 <row> 432 <row>
326 <entry><constant>V4L2_EVENT_CTRL_CH_FLAGS</constant></entry> 433 <entry><constant>V4L2_EVENT_CTRL_CH_FLAGS</constant></entry>
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-crop.xml b/Documentation/DocBook/media/v4l/vidioc-g-crop.xml
index 75c6a93de3c1..e6c4efb9e8b4 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-crop.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-crop.xml
@@ -70,6 +70,11 @@ structure or returns the &EINVAL; if cropping is not supported.</para>
70<constant>VIDIOC_S_CROP</constant> ioctl with a pointer to this 70<constant>VIDIOC_S_CROP</constant> ioctl with a pointer to this
71structure.</para> 71structure.</para>
72 72
73<para>Do not use the multiplanar buffer types. Use <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>
74instead of <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant>
75and use <constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> instead of
76<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant>.</para>
77
73 <para>The driver first adjusts the requested dimensions against 78 <para>The driver first adjusts the requested dimensions against
74hardware limits, &ie; the bounds given by the capture/output window, 79hardware limits, &ie; the bounds given by the capture/output window,
75and it rounds to the closest possible values of horizontal and 80and it rounds to the closest possible values of horizontal and
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-dv-timings.xml b/Documentation/DocBook/media/v4l/vidioc-g-dv-timings.xml
index c4336577ff06..764b635ed4cf 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-dv-timings.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-dv-timings.xml
@@ -318,10 +318,20 @@ can't generate such frequencies, then the flag will also be cleared.
318 </row> 318 </row>
319 <row> 319 <row>
320 <entry>V4L2_DV_FL_HALF_LINE</entry> 320 <entry>V4L2_DV_FL_HALF_LINE</entry>
321 <entry>Specific to interlaced formats: if set, then field 1 (aka the odd field) 321 <entry>Specific to interlaced formats: if set, then the vertical frontporch
322is really one half-line longer and field 2 (aka the even field) is really one half-line 322of field 1 (aka the odd field) is really one half-line longer and the vertical backporch
323shorter, so each field has exactly the same number of half-lines. Whether half-lines can be 323of field 2 (aka the even field) is really one half-line shorter, so each field has exactly
324detected or used depends on the hardware. 324the same number of half-lines. Whether half-lines can be detected or used depends on
325the hardware.
326 </entry>
327 </row>
328 <row>
329 <entry>V4L2_DV_FL_IS_CE_VIDEO</entry>
330 <entry>If set, then this is a Consumer Electronics (CE) video format.
331Such formats differ from other formats (commonly called IT formats) in that if
332R'G'B' encoding is used then by default the R'G'B' values use limited range
333(i.e. 16-235) as opposed to full range (i.e. 0-255). All formats defined in CEA-861
334except for the 640x480p59.94 format are CE formats.
325 </entry> 335 </entry>
326 </row> 336 </row>
327 </tbody> 337 </tbody>
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml b/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml
index 20460730b02c..77607cc19688 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml
@@ -240,9 +240,9 @@ where padding bytes after the last line of an image cross a system
240page boundary. Capture devices may write padding bytes, the value is 240page boundary. Capture devices may write padding bytes, the value is
241undefined. Output devices ignore the contents of padding 241undefined. Output devices ignore the contents of padding
242bytes.</para><para>When the image format is planar the 242bytes.</para><para>When the image format is planar the
243<structfield>bytesperline</structfield> value applies to the largest 243<structfield>bytesperline</structfield> value applies to the first
244plane and is divided by the same factor as the 244plane and is divided by the same factor as the
245<structfield>width</structfield> field for any smaller planes. For 245<structfield>width</structfield> field for the other planes. For
246example the Cb and Cr planes of a YUV 4:2:0 image have half as many 246example the Cb and Cr planes of a YUV 4:2:0 image have half as many
247padding bytes following each line as the Y plane. To avoid ambiguities 247padding bytes following each line as the Y plane. To avoid ambiguities
248drivers must return a <structfield>bytesperline</structfield> value 248drivers must return a <structfield>bytesperline</structfield> value
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-selection.xml b/Documentation/DocBook/media/v4l/vidioc-g-selection.xml
index 9c04ac8661b1..0bb5c060db27 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-selection.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-selection.xml
@@ -60,8 +60,8 @@
60 60
61<para>To query the cropping (composing) rectangle set &v4l2-selection; 61<para>To query the cropping (composing) rectangle set &v4l2-selection;
62<structfield> type </structfield> field to the respective buffer type. 62<structfield> type </structfield> field to the respective buffer type.
63Do not use multiplanar buffers. Use <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant> 63Do not use the multiplanar buffer types. Use <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>
64instead of <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant>. Use 64instead of <constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant> and use
65<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> instead of 65<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT</constant> instead of
66<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant>. The next step is 66<constant>V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE</constant>. The next step is
67setting the value of &v4l2-selection; <structfield>target</structfield> field 67setting the value of &v4l2-selection; <structfield>target</structfield> field
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-sliced-vbi-cap.xml b/Documentation/DocBook/media/v4l/vidioc-g-sliced-vbi-cap.xml
index bd015d1563ff..d05623c55403 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-sliced-vbi-cap.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-sliced-vbi-cap.xml
@@ -205,7 +205,7 @@ ETS&nbsp;300&nbsp;231, lsb first transmitted.</entry>
205 <row> 205 <row>
206 <entry><constant>V4L2_SLICED_CAPTION_525</constant></entry> 206 <entry><constant>V4L2_SLICED_CAPTION_525</constant></entry>
207 <entry>0x1000</entry> 207 <entry>0x1000</entry>
208 <entry><xref linkend="eia608" /></entry> 208 <entry><xref linkend="cea608" /></entry>
209 <entry>NTSC line 21, 284 (second field 21)</entry> 209 <entry>NTSC line 21, 284 (second field 21)</entry>
210 <entry>Two bytes in transmission order, including parity 210 <entry>Two bytes in transmission order, including parity
211bit, lsb first transmitted.</entry> 211bit, lsb first transmitted.</entry>
diff --git a/Documentation/DocBook/media/v4l/vidioc-querycap.xml b/Documentation/DocBook/media/v4l/vidioc-querycap.xml
index d0c5e604f014..20fda75a012d 100644
--- a/Documentation/DocBook/media/v4l/vidioc-querycap.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-querycap.xml
@@ -102,10 +102,10 @@ The bus_info must start with "PCI:" for PCI boards, "PCIe:" for PCI Express boar
102 <entry>__u32</entry> 102 <entry>__u32</entry>
103 <entry><structfield>version</structfield></entry> 103 <entry><structfield>version</structfield></entry>
104 <entry><para>Version number of the driver.</para> 104 <entry><para>Version number of the driver.</para>
105<para>Starting on kernel 3.1, the version reported is provided per 105<para>Starting with kernel 3.1, the version reported is provided by the
106V4L2 subsystem, following the same Kernel numberation scheme. However, it 106V4L2 subsystem following the kernel numbering scheme. However, it
107should not always return the same version as the kernel, if, for example, 107may not always return the same version as the kernel if, for example,
108an stable or distribution-modified kernel uses the V4L2 stack from a 108a stable or distribution-modified kernel uses the V4L2 stack from a
109newer kernel.</para> 109newer kernel.</para>
110<para>The version number is formatted using the 110<para>The version number is formatted using the
111<constant>KERNEL_VERSION()</constant> macro:</para></entry> 111<constant>KERNEL_VERSION()</constant> macro:</para></entry>
diff --git a/Documentation/DocBook/media/v4l/vidioc-queryctrl.xml b/Documentation/DocBook/media/v4l/vidioc-queryctrl.xml
index 2bd98fd7a4e5..dc83ad70f8dc 100644
--- a/Documentation/DocBook/media/v4l/vidioc-queryctrl.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-queryctrl.xml
@@ -600,7 +600,9 @@ writing a value will cause the device to carry out a given action
600changes continuously. A typical example would be the current gain value if the device 600changes continuously. A typical example would be the current gain value if the device
601is in auto-gain mode. In such a case the hardware calculates the gain value based on 601is in auto-gain mode. In such a case the hardware calculates the gain value based on
602the lighting conditions which can change over time. Note that setting a new value for 602the lighting conditions which can change over time. Note that setting a new value for
603a volatile control will have no effect. The new value will just be ignored.</entry> 603a volatile control will have no effect and no <constant>V4L2_EVENT_CTRL_CH_VALUE</constant>
604will be sent, unless the <constant>V4L2_CTRL_FLAG_EXECUTE_ON_WRITE</constant> flag
605(see below) is also set. Otherwise the new value will just be ignored.</entry>
604 </row> 606 </row>
605 <row> 607 <row>
606 <entry><constant>V4L2_CTRL_FLAG_HAS_PAYLOAD</constant></entry> 608 <entry><constant>V4L2_CTRL_FLAG_HAS_PAYLOAD</constant></entry>
@@ -610,6 +612,14 @@ using one of the pointer fields of &v4l2-ext-control;. This flag is set for cont
610that are an array, string, or have a compound type. In all cases you have to set a 612that are an array, string, or have a compound type. In all cases you have to set a
611pointer to memory containing the payload of the control.</entry> 613pointer to memory containing the payload of the control.</entry>
612 </row> 614 </row>
615 <row>
616 <entry><constant>V4L2_CTRL_FLAG_EXECUTE_ON_WRITE</constant></entry>
617 <entry>0x0200</entry>
618 <entry>The value provided to the control will be propagated to the driver
619even if remains constant. This is required when the control represents an action
620on the hardware. For example: clearing an error flag or triggering the flash. All the
621controls of the type <constant>V4L2_CTRL_TYPE_BUTTON</constant> have this flag set.</entry>
622 </row>
613 </tbody> 623 </tbody>
614 </tgroup> 624 </tgroup>
615 </table> 625 </table>
diff --git a/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-interval.xml b/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-interval.xml
index 2f8f4f0a0235..cff59f5cbf04 100644
--- a/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-interval.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-interval.xml
@@ -67,9 +67,9 @@
67 67
68 <para>To enumerate frame intervals applications initialize the 68 <para>To enumerate frame intervals applications initialize the
69 <structfield>index</structfield>, <structfield>pad</structfield>, 69 <structfield>index</structfield>, <structfield>pad</structfield>,
70 <structfield>code</structfield>, <structfield>width</structfield> and 70 <structfield>which</structfield>, <structfield>code</structfield>,
71 <structfield>height</structfield> fields of 71 <structfield>width</structfield> and <structfield>height</structfield>
72 &v4l2-subdev-frame-interval-enum; and call the 72 fields of &v4l2-subdev-frame-interval-enum; and call the
73 <constant>VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL</constant> ioctl with a pointer 73 <constant>VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL</constant> ioctl with a pointer
74 to this structure. Drivers fill the rest of the structure or return 74 to this structure. Drivers fill the rest of the structure or return
75 an &EINVAL; if one of the input fields is invalid. All frame intervals are 75 an &EINVAL; if one of the input fields is invalid. All frame intervals are
@@ -123,7 +123,12 @@
123 </row> 123 </row>
124 <row> 124 <row>
125 <entry>__u32</entry> 125 <entry>__u32</entry>
126 <entry><structfield>reserved</structfield>[9]</entry> 126 <entry><structfield>which</structfield></entry>
127 <entry>Frame intervals to be enumerated, from &v4l2-subdev-format-whence;.</entry>
128 </row>
129 <row>
130 <entry>__u32</entry>
131 <entry><structfield>reserved</structfield>[8]</entry>
127 <entry>Reserved for future extensions. Applications and drivers must 132 <entry>Reserved for future extensions. Applications and drivers must
128 set the array to zero.</entry> 133 set the array to zero.</entry>
129 </row> 134 </row>
diff --git a/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-size.xml b/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-size.xml
index 79ce42b7c60c..abd545ede67a 100644
--- a/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-size.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-subdev-enum-frame-size.xml
@@ -61,9 +61,9 @@
61 ioctl.</para> 61 ioctl.</para>
62 62
63 <para>To enumerate frame sizes applications initialize the 63 <para>To enumerate frame sizes applications initialize the
64 <structfield>pad</structfield>, <structfield>code</structfield> and 64 <structfield>pad</structfield>, <structfield>which</structfield> ,
65 <structfield>index</structfield> fields of the 65 <structfield>code</structfield> and <structfield>index</structfield>
66 &v4l2-subdev-mbus-code-enum; and call the 66 fields of the &v4l2-subdev-mbus-code-enum; and call the
67 <constant>VIDIOC_SUBDEV_ENUM_FRAME_SIZE</constant> ioctl with a pointer to 67 <constant>VIDIOC_SUBDEV_ENUM_FRAME_SIZE</constant> ioctl with a pointer to
68 the structure. Drivers fill the minimum and maximum frame sizes or return 68 the structure. Drivers fill the minimum and maximum frame sizes or return
69 an &EINVAL; if one of the input parameters is invalid.</para> 69 an &EINVAL; if one of the input parameters is invalid.</para>
@@ -127,7 +127,12 @@
127 </row> 127 </row>
128 <row> 128 <row>
129 <entry>__u32</entry> 129 <entry>__u32</entry>
130 <entry><structfield>reserved</structfield>[9]</entry> 130 <entry><structfield>which</structfield></entry>
131 <entry>Frame sizes to be enumerated, from &v4l2-subdev-format-whence;.</entry>
132 </row>
133 <row>
134 <entry>__u32</entry>
135 <entry><structfield>reserved</structfield>[8]</entry>
131 <entry>Reserved for future extensions. Applications and drivers must 136 <entry>Reserved for future extensions. Applications and drivers must
132 set the array to zero.</entry> 137 set the array to zero.</entry>
133 </row> 138 </row>
diff --git a/Documentation/DocBook/media/v4l/vidioc-subdev-enum-mbus-code.xml b/Documentation/DocBook/media/v4l/vidioc-subdev-enum-mbus-code.xml
index a6b3432449f6..0bcb278fd062 100644
--- a/Documentation/DocBook/media/v4l/vidioc-subdev-enum-mbus-code.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-subdev-enum-mbus-code.xml
@@ -56,8 +56,8 @@
56 </note> 56 </note>
57 57
58 <para>To enumerate media bus formats available at a given sub-device pad 58 <para>To enumerate media bus formats available at a given sub-device pad
59 applications initialize the <structfield>pad</structfield> and 59 applications initialize the <structfield>pad</structfield>, <structfield>which</structfield>
60 <structfield>index</structfield> fields of &v4l2-subdev-mbus-code-enum; and 60 and <structfield>index</structfield> fields of &v4l2-subdev-mbus-code-enum; and
61 call the <constant>VIDIOC_SUBDEV_ENUM_MBUS_CODE</constant> ioctl with a 61 call the <constant>VIDIOC_SUBDEV_ENUM_MBUS_CODE</constant> ioctl with a
62 pointer to this structure. Drivers fill the rest of the structure or return 62 pointer to this structure. Drivers fill the rest of the structure or return
63 an &EINVAL; if either the <structfield>pad</structfield> or 63 an &EINVAL; if either the <structfield>pad</structfield> or
@@ -93,7 +93,12 @@
93 </row> 93 </row>
94 <row> 94 <row>
95 <entry>__u32</entry> 95 <entry>__u32</entry>
96 <entry><structfield>reserved</structfield>[9]</entry> 96 <entry><structfield>which</structfield></entry>
97 <entry>Media bus format codes to be enumerated, from &v4l2-subdev-format-whence;.</entry>
98 </row>
99 <row>
100 <entry>__u32</entry>
101 <entry><structfield>reserved</structfield>[8]</entry>
97 <entry>Reserved for future extensions. Applications and drivers must 102 <entry>Reserved for future extensions. Applications and drivers must
98 set the array to zero.</entry> 103 set the array to zero.</entry>
99 </row> 104 </row>
diff --git a/Documentation/DocBook/media/v4l/vidioc-subscribe-event.xml b/Documentation/DocBook/media/v4l/vidioc-subscribe-event.xml
index d7c9365ecdbe..d0332f610929 100644
--- a/Documentation/DocBook/media/v4l/vidioc-subscribe-event.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-subscribe-event.xml
@@ -60,7 +60,9 @@
60 <row> 60 <row>
61 <entry>__u32</entry> 61 <entry>__u32</entry>
62 <entry><structfield>type</structfield></entry> 62 <entry><structfield>type</structfield></entry>
63 <entry>Type of the event.</entry> 63 <entry>Type of the event, see <xref linkend="event-type" />. Note that
64<constant>V4L2_EVENT_ALL</constant> can be used with VIDIOC_UNSUBSCRIBE_EVENT
65for unsubscribing all events at once.</entry>
64 </row> 66 </row>
65 <row> 67 <row>
66 <entry>__u32</entry> 68 <entry>__u32</entry>
@@ -84,113 +86,6 @@
84 </tgroup> 86 </tgroup>
85 </table> 87 </table>
86 88
87 <table frame="none" pgwide="1" id="event-type">
88 <title>Event Types</title>
89 <tgroup cols="3">
90 &cs-def;
91 <tbody valign="top">
92 <row>
93 <entry><constant>V4L2_EVENT_ALL</constant></entry>
94 <entry>0</entry>
95 <entry>All events. V4L2_EVENT_ALL is valid only for
96 VIDIOC_UNSUBSCRIBE_EVENT for unsubscribing all events at once.
97 </entry>
98 </row>
99 <row>
100 <entry><constant>V4L2_EVENT_VSYNC</constant></entry>
101 <entry>1</entry>
102 <entry>This event is triggered on the vertical sync.
103 This event has a &v4l2-event-vsync; associated with it.
104 </entry>
105 </row>
106 <row>
107 <entry><constant>V4L2_EVENT_EOS</constant></entry>
108 <entry>2</entry>
109 <entry>This event is triggered when the end of a stream is reached.
110 This is typically used with MPEG decoders to report to the application
111 when the last of the MPEG stream has been decoded.
112 </entry>
113 </row>
114 <row>
115 <entry><constant>V4L2_EVENT_CTRL</constant></entry>
116 <entry>3</entry>
117 <entry><para>This event requires that the <structfield>id</structfield>
118 matches the control ID from which you want to receive events.
119 This event is triggered if the control's value changes, if a
120 button control is pressed or if the control's flags change.
121 This event has a &v4l2-event-ctrl; associated with it. This struct
122 contains much of the same information as &v4l2-queryctrl; and
123 &v4l2-control;.</para>
124
125 <para>If the event is generated due to a call to &VIDIOC-S-CTRL; or
126 &VIDIOC-S-EXT-CTRLS;, then the event will <emphasis>not</emphasis> be sent to
127 the file handle that called the ioctl function. This prevents
128 nasty feedback loops. If you <emphasis>do</emphasis> want to get the
129 event, then set the <constant>V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK</constant>
130 flag.
131 </para>
132
133 <para>This event type will ensure that no information is lost when
134 more events are raised than there is room internally. In that
135 case the &v4l2-event-ctrl; of the second-oldest event is kept,
136 but the <structfield>changes</structfield> field of the
137 second-oldest event is ORed with the <structfield>changes</structfield>
138 field of the oldest event.</para>
139 </entry>
140 </row>
141 <row>
142 <entry><constant>V4L2_EVENT_FRAME_SYNC</constant></entry>
143 <entry>4</entry>
144 <entry>
145 <para>Triggered immediately when the reception of a
146 frame has begun. This event has a
147 &v4l2-event-frame-sync; associated with it.</para>
148
149 <para>If the hardware needs to be stopped in the case of a
150 buffer underrun it might not be able to generate this event.
151 In such cases the <structfield>frame_sequence</structfield>
152 field in &v4l2-event-frame-sync; will not be incremented. This
153 causes two consecutive frame sequence numbers to have n times
154 frame interval in between them.</para>
155 </entry>
156 </row>
157 <row>
158 <entry><constant>V4L2_EVENT_SOURCE_CHANGE</constant></entry>
159 <entry>5</entry>
160 <entry>
161 <para>This event is triggered when a source parameter change is
162 detected during runtime by the video device. It can be a
163 runtime resolution change triggered by a video decoder or the
164 format change happening on an input connector.
165 This event requires that the <structfield>id</structfield>
166 matches the input index (when used with a video device node)
167 or the pad index (when used with a subdevice node) from which
168 you want to receive events.</para>
169
170 <para>This event has a &v4l2-event-src-change; associated
171 with it. The <structfield>changes</structfield> bitfield denotes
172 what has changed for the subscribed pad. If multiple events
173 occurred before application could dequeue them, then the changes
174 will have the ORed value of all the events generated.</para>
175 </entry>
176 </row>
177 <row>
178 <entry><constant>V4L2_EVENT_MOTION_DET</constant></entry>
179 <entry>6</entry>
180 <entry>
181 <para>Triggered whenever the motion detection state for one or more of the regions
182 changes. This event has a &v4l2-event-motion-det; associated with it.</para>
183 </entry>
184 </row>
185 <row>
186 <entry><constant>V4L2_EVENT_PRIVATE_START</constant></entry>
187 <entry>0x08000000</entry>
188 <entry>Base event number for driver-private events.</entry>
189 </row>
190 </tbody>
191 </tgroup>
192 </table>
193
194 <table pgwide="1" frame="none" id="event-flags"> 89 <table pgwide="1" frame="none" id="event-flags">
195 <title>Event Flags</title> 90 <title>Event Flags</title>
196 <tgroup cols="3"> 91 <tgroup cols="3">
generated by cgit v1.2.2 (git 2.25.0) at 2025-02-24 04:16:23 -0500