aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
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
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')
-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
-rw-r--r--Documentation/devicetree/bindings/media/rcar_vin.txt2
-rw-r--r--Documentation/video4linux/vivid.txt15
6 files changed, 90 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;
diff --git a/Documentation/devicetree/bindings/media/rcar_vin.txt b/Documentation/devicetree/bindings/media/rcar_vin.txt
index ba61782c2af9..9dafe6b06cd2 100644
--- a/Documentation/devicetree/bindings/media/rcar_vin.txt
+++ b/Documentation/devicetree/bindings/media/rcar_vin.txt
@@ -6,6 +6,8 @@ family of devices. The current blocks are always slaves and suppot one input
6channel which can be either RGB, YUYV or BT656. 6channel which can be either RGB, YUYV or BT656.
7 7
8 - compatible: Must be one of the following 8 - compatible: Must be one of the following
9 - "renesas,vin-r8a7794" for the R8A7794 device
10 - "renesas,vin-r8a7793" for the R8A7793 device
9 - "renesas,vin-r8a7791" for the R8A7791 device 11 - "renesas,vin-r8a7791" for the R8A7791 device
10 - "renesas,vin-r8a7790" for the R8A7790 device 12 - "renesas,vin-r8a7790" for the R8A7790 device
11 - "renesas,vin-r8a7779" for the R8A7779 device 13 - "renesas,vin-r8a7779" for the R8A7779 device
diff --git a/Documentation/video4linux/vivid.txt b/Documentation/video4linux/vivid.txt
index e5a940e3d304..6cfc8541a362 100644
--- a/Documentation/video4linux/vivid.txt
+++ b/Documentation/video4linux/vivid.txt
@@ -640,6 +640,21 @@ Colorspace: selects which colorspace should be used when generating the image.
640 Changing the colorspace will result in the V4L2_EVENT_SOURCE_CHANGE 640 Changing the colorspace will result in the V4L2_EVENT_SOURCE_CHANGE
641 to be sent since it emulates a detected colorspace change. 641 to be sent since it emulates a detected colorspace change.
642 642
643Y'CbCr Encoding: selects which Y'CbCr encoding should be used when generating
644 a Y'CbCr image. This only applies if the CSC Colorbar test pattern is
645 selected, and if the format is set to a Y'CbCr format as opposed to an
646 RGB format.
647
648 Changing the Y'CbCr encoding will result in the V4L2_EVENT_SOURCE_CHANGE
649 to be sent since it emulates a detected colorspace change.
650
651Quantization: selects which quantization should be used for the RGB or Y'CbCr
652 encoding when generating the test pattern. This only applies if the CSC
653 Colorbar test pattern is selected.
654
655 Changing the quantization will result in the V4L2_EVENT_SOURCE_CHANGE
656 to be sent since it emulates a detected colorspace change.
657
643Limited RGB Range (16-235): selects if the RGB range of the HDMI source should 658Limited RGB Range (16-235): selects if the RGB range of the HDMI source should
644 be limited or full range. This combines with the Digital Video 'Rx RGB 659 be limited or full range. This combines with the Digital Video 'Rx RGB
645 Quantization Range' control and can be used to test what happens if 660 Quantization Range' control and can be used to test what happens if