aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2014-12-18 23:14:49 -0500
committerLinus Torvalds <torvalds@linux-foundation.org>2014-12-18 23:14:49 -0500
commit0ec28c37c21a2b4393692e832e11a7573ac545e2 (patch)
tree91ef6e8adc34f6b0395cb5f95d6a8383ad2b8471 /Documentation/DocBook
parent4c929feed7e9ce69efbe85e3932393db67fbce76 (diff)
parent427ae153c65ad7a08288d86baf99000569627d03 (diff)
Merge tag 'media/v3.19-2' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media
Pull second set of media updates from Mauro Carvalho Chehab: - Move drivers for really old legacy hardware to staging. Those are using obsolete media kAPIs and are for hardware that nobody uses for years. Simply not worth porting them to the new kAPIs. Of course, if anyone pops up to fix, we can move them back from there - While not too late, do some API fixups at the new colorspace API, added for v3.19 - Some improvements for rcar_vin driver - Some fixups at cx88 and vivid drivers - Some Documentation fixups * tag 'media/v3.19-2' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media: [media] bq/c-qcam, w9966, pms: move to staging in preparation for removal [media] tlg2300: move to staging in preparation for removal [media] vino/saa7191: move to staging in preparation for removal [media] MAINTAINERS: vivi -> vivid [media] cx88: remove leftover start_video_dma() call [media] cx88: add missing alloc_ctx support [media] v4l2-ioctl: WARN_ON if querycap didn't fill device_caps [media] vivid: fix CROP_BOUNDS typo for video output [media] DocBook media: update version number and document changes [media] vivid.txt: document new controls [media] DocBook media: add missing ycbcr_enc and quantization fields [media] v4l2-mediabus.h: use two __u16 instead of two __u32 [media] rcar_vin: Fix interrupt enable in progressive [media] rcar_vin: Enable VSYNC field toggle mode [media] rcar_vin: Add scaling support [media] rcar_vin: Add DT support for r8a7793 and r8a7794 SoCs [media] rcar_vin: Add YUYV capture format support
Diffstat (limited to 'Documentation/DocBook')
-rw-r--r--Documentation/DocBook/media/v4l/compat.xml12
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt.xml36
-rw-r--r--Documentation/DocBook/media/v4l/subdev-formats.xml18
-rw-r--r--Documentation/DocBook/media/v4l/v4l2.xml11
4 files changed, 73 insertions, 4 deletions
diff --git a/Documentation/DocBook/media/v4l/compat.xml b/Documentation/DocBook/media/v4l/compat.xml
index 0a2debfa68f6..350dfb3d71ea 100644
--- a/Documentation/DocBook/media/v4l/compat.xml
+++ b/Documentation/DocBook/media/v4l/compat.xml
@@ -2579,6 +2579,18 @@ fields changed from _s32 to _u32.
2579 </orderedlist> 2579 </orderedlist>
2580 </section> 2580 </section>
2581 2581
2582 <section>
2583 <title>V4L2 in Linux 3.19</title>
2584 <orderedlist>
2585 <listitem>
2586 <para>Rewrote Colorspace chapter, added new &v4l2-ycbcr-encoding;
2587and &v4l2-quantization; fields to &v4l2-pix-format;, &v4l2-pix-format-mplane;
2588and &v4l2-mbus-framefmt;.
2589 </para>
2590 </listitem>
2591 </orderedlist>
2592 </section>
2593
2582 <section id="other"> 2594 <section id="other">
2583 <title>Relation of V4L2 to other Linux multimedia APIs</title> 2595 <title>Relation of V4L2 to other Linux multimedia APIs</title>
2584 2596
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index ccf6053c1ae4..d5eca4b8f74b 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -138,9 +138,25 @@ applicable values.</para></entry>
138 <row> 138 <row>
139 <entry>__u32</entry> 139 <entry>__u32</entry>
140 <entry><structfield>flags</structfield></entry> 140 <entry><structfield>flags</structfield></entry>
141 <entry>Flags set by the application or driver, see <xref 141 <entry>Flags set by the application or driver, see <xref
142linkend="format-flags" />.</entry> 142linkend="format-flags" />.</entry>
143 </row> 143 </row>
144 <row>
145 <entry>&v4l2-ycbcr-encoding;</entry>
146 <entry><structfield>ycbcr_enc</structfield></entry>
147 <entry>This information supplements the
148<structfield>colorspace</structfield> and must be set by the driver for
149capture streams and by the application for output streams,
150see <xref linkend="colorspaces" />.</entry>
151 </row>
152 <row>
153 <entry>&v4l2-quantization;</entry>
154 <entry><structfield>quantization</structfield></entry>
155 <entry>This information supplements the
156<structfield>colorspace</structfield> and must be set by the driver for
157capture streams and by the application for output streams,
158see <xref linkend="colorspaces" />.</entry>
159 </row>
144 </tbody> 160 </tbody>
145 </tgroup> 161 </tgroup>
146 </table> 162 </table>
@@ -232,9 +248,25 @@ codes can be used.</entry>
232 <entry>Flags set by the application or driver, see <xref 248 <entry>Flags set by the application or driver, see <xref
233linkend="format-flags" />.</entry> 249linkend="format-flags" />.</entry>
234 </row> 250 </row>
251 <row>
252 <entry>&v4l2-ycbcr-encoding;</entry>
253 <entry><structfield>ycbcr_enc</structfield></entry>
254 <entry>This information supplements the
255<structfield>colorspace</structfield> and must be set by the driver for
256capture streams and by the application for output streams,
257see <xref linkend="colorspaces" />.</entry>
258 </row>
259 <row>
260 <entry>&v4l2-quantization;</entry>
261 <entry><structfield>quantization</structfield></entry>
262 <entry>This information supplements the
263<structfield>colorspace</structfield> and must be set by the driver for
264capture streams and by the application for output streams,
265see <xref linkend="colorspaces" />.</entry>
266 </row>
235 <row> 267 <row>
236 <entry>__u8</entry> 268 <entry>__u8</entry>
237 <entry><structfield>reserved[10]</structfield></entry> 269 <entry><structfield>reserved[8]</structfield></entry>
238 <entry>Reserved for future extensions. Should be zeroed by the 270 <entry>Reserved for future extensions. Should be zeroed by the
239 application.</entry> 271 application.</entry>
240 </row> 272 </row>
diff --git a/Documentation/DocBook/media/v4l/subdev-formats.xml b/Documentation/DocBook/media/v4l/subdev-formats.xml
index 18730b96e1e6..c5ea868e3909 100644
--- a/Documentation/DocBook/media/v4l/subdev-formats.xml
+++ b/Documentation/DocBook/media/v4l/subdev-formats.xml
@@ -34,8 +34,24 @@
34 <xref linkend="colorspaces" /> for details.</entry> 34 <xref linkend="colorspaces" /> for details.</entry>
35 </row> 35 </row>
36 <row> 36 <row>
37 <entry>&v4l2-ycbcr-encoding;</entry>
38 <entry><structfield>ycbcr_enc</structfield></entry>
39 <entry>This information supplements the
40<structfield>colorspace</structfield> and must be set by the driver for
41capture streams and by the application for output streams,
42see <xref linkend="colorspaces" />.</entry>
43 </row>
44 <row>
45 <entry>&v4l2-quantization;</entry>
46 <entry><structfield>quantization</structfield></entry>
47 <entry>This information supplements the
48<structfield>colorspace</structfield> and must be set by the driver for
49capture streams and by the application for output streams,
50see <xref linkend="colorspaces" />.</entry>
51 </row>
52 <row>
37 <entry>__u32</entry> 53 <entry>__u32</entry>
38 <entry><structfield>reserved</structfield>[7]</entry> 54 <entry><structfield>reserved</structfield>[6]</entry>
39 <entry>Reserved for future extensions. Applications and drivers must 55 <entry>Reserved for future extensions. Applications and drivers must
40 set the array to zero.</entry> 56 set the array to zero.</entry>
41 </row> 57 </row>
diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml
index 7cfe618f754d..ac0f8d9d2a49 100644
--- a/Documentation/DocBook/media/v4l/v4l2.xml
+++ b/Documentation/DocBook/media/v4l/v4l2.xml
@@ -152,6 +152,15 @@ structs, ioctls) must be noted in more detail in the history chapter
152applications. --> 152applications. -->
153 153
154 <revision> 154 <revision>
155 <revnumber>3.19</revnumber>
156 <date>2014-12-05</date>
157 <authorinitials>hv</authorinitials>
158 <revremark>Rewrote Colorspace chapter, added new &v4l2-ycbcr-encoding; and &v4l2-quantization; fields
159to &v4l2-pix-format;, &v4l2-pix-format-mplane; and &v4l2-mbus-framefmt;.
160 </revremark>
161 </revision>
162
163 <revision>
155 <revnumber>3.17</revnumber> 164 <revnumber>3.17</revnumber>
156 <date>2014-08-04</date> 165 <date>2014-08-04</date>
157 <authorinitials>lp, hv</authorinitials> 166 <authorinitials>lp, hv</authorinitials>
@@ -539,7 +548,7 @@ and discussions on the V4L mailing list.</revremark>
539</partinfo> 548</partinfo>
540 549
541<title>Video for Linux Two API Specification</title> 550<title>Video for Linux Two API Specification</title>
542 <subtitle>Revision 3.17</subtitle> 551 <subtitle>Revision 3.19</subtitle>
543 552
544 <chapter id="common"> 553 <chapter id="common">
545 &sub-common; 554 &sub-common;