Commit 27c053aa authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge branch 'v4l_for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media 

Pull media updates from Mauro Carvalho Chehab:
 "This series contains:
   - Exynos s5p-mfc driver got support for VP8 encoder
   - Some SoC drivers gained support for asynchronous registration
     (needed for DT)
   - The RC subsystem gained support for RC activity LED;
   - New drivers added: a video decoder(adv7842), a video encoder
     (adv7511), a new GSPCA driver (stk1135) and support for Renesas
     R-Car (vsp1)
   - the first SDR kernel driver: mirics msi3101.  Due to some troubles
     with the driver, and because the API is still under discussion, it
     will be merged at staging for 3.12.  Need to rework on it
   - usual new boards additions, fixes, cleanups and driver
     improvements"

* 'v4l_for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media: (242 commits)
  [media] cx88: Fix regression: CX88_AUDIO_WM8775 can't be 0
  [media] exynos4-is: Fix entity unregistration on error path
  [media] exynos-gsc: Register v4l2 device
  [media] exynos4-is: Fix fimc-lite bayer formats
  [media] em28xx: fix assignment of the eeprom data
  [media] hdpvr: fix iteration over uninitialized lists in hdpvr_probe()
  [media] usbtv: Throw corrupted frames away
  [media] usbtv: Fix deinterlacing
  [media] v4l2: added missing mutex.h include to v4l2-ctrls.h
  [media] DocBook: upgrade media_api DocBook version to 4.2
  [media] ml86v7667: fix compile warning: 'ret' set but not used
  [media] s5p-g2d: Fix registration failure
  [media] media: coda: Fix DT driver data pointer for i.MX27
  [media] s5p-mfc: Fix input/output format reporting
  [media] v4l: vsp1: Fix mutex double lock at streamon time
  [media] v4l: vsp1: Add support for RT clock
  [media] v4l: vsp1: Initialize media device bus_info field
  [media] davinci: vpif_capture: fix error return code in vpif_probe()
  [media] davinci: vpif_display: fix error return code in vpif_probe()
  [media] MAINTAINERS: add entries for adv7511 and adv7842
  ...
parents a09e9a7a f66b2a1c

Documentation/DocBook/media/v4l/controls.xml

+163 −5
Original line number Diff line number Diff line
@@ -722,17 +722,22 @@ for more details.</para> 
    </section>



    <section id="mpeg-controls">

      <title>MPEG Control Reference</title>

      <title>Codec Control Reference</title>



      <para>Below all controls within the MPEG control class are

      <para>Below all controls within the Codec control class are

described. First the generic controls, then controls specific for

certain hardware.</para>



      <para>Note: These controls are applicable to all codecs and

not just MPEG. The defines are prefixed with V4L2_CID_MPEG/V4L2_MPEG

as the controls were originally made for MPEG codecs and later

extended to cover all encoding formats.</para>



      <section>

	<title>Generic MPEG Controls</title>

	<title>Generic Codec Controls</title>



	<table pgwide="1" frame="none" id="mpeg-control-id">

	  <title>MPEG Control IDs</title>

	  <title>Codec Control IDs</title>

	  <tgroup cols="4">

	    <colspec colname="c1" colwidth="1*" />

	    <colspec colname="c2" colwidth="6*" />
@@ -752,7 +757,7 @@ certain hardware.</para> 
	      <row>

		<entry spanname="id"><constant>V4L2_CID_MPEG_CLASS</constant>&nbsp;</entry>

		<entry>class</entry>

	      </row><row><entry spanname="descr">The MPEG class

	      </row><row><entry spanname="descr">The Codec class

descriptor. Calling &VIDIOC-QUERYCTRL; for this control will return a

description of this control class. This description can be used as the

caption of a Tab page in a GUI, for example.</entry>
@@ -3009,6 +3014,159 @@ in by the application. 0 = do not insert, 1 = insert packets.</entry> 
	  </tgroup>

	</table>

      </section>



    <section>

      <title>VPX Control Reference</title>



      <para>The VPX controls include controls for encoding parameters

      of VPx video codec.</para>



      <table pgwide="1" frame="none" id="vpx-control-id">

      <title>VPX Control IDs</title>



      <tgroup cols="4">

        <colspec colname="c1" colwidth="1*" />

        <colspec colname="c2" colwidth="6*" />

        <colspec colname="c3" colwidth="2*" />

        <colspec colname="c4" colwidth="6*" />

        <spanspec namest="c1" nameend="c2" spanname="id" />

        <spanspec namest="c2" nameend="c4" spanname="descr" />

        <thead>

          <row>

            <entry spanname="id" align="left">ID</entry>

            <entry align="left">Type</entry>

          </row><row rowsep="1"><entry spanname="descr" align="left">Description</entry>

          </row>

        </thead>

        <tbody valign="top">

          <row><entry></entry></row>



	      <row><entry></entry></row>

	      <row id="v4l2-vpx-num-partitions">

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS</constant></entry>

		<entry>enum v4l2_vp8_num_partitions</entry>

	      </row>

	      <row><entry spanname="descr">The number of token partitions to use in VP8 encoder.

Possible values are:</entry>

	      </row>

	      <row>

		<entrytbl spanname="descr" cols="2">

		  <tbody valign="top">

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION</constant></entry>

		      <entry>1 coefficient partition</entry>

		    </row>

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS</constant></entry>

		      <entry>2 coefficient partitions</entry>

		    </row>

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS</constant></entry>

		      <entry>4 coefficient partitions</entry>

		    </row>

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS</constant></entry>

		      <entry>8 coefficient partitions</entry>

	            </row>

                  </tbody>

		</entrytbl>

	      </row>



	      <row><entry></entry></row>

	      <row>

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4</constant></entry>

		<entry>boolean</entry>

	      </row>

	      <row><entry spanname="descr">Setting this prevents intra 4x4 mode in the intra mode decision.</entry>

	      </row>



	      <row><entry></entry></row>

	      <row id="v4l2-vpx-num-ref-frames">

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES</constant></entry>

		<entry>enum v4l2_vp8_num_ref_frames</entry>

	      </row>

	      <row><entry spanname="descr">The number of reference pictures for encoding P frames.

Possible values are:</entry>

	      </row>

	      <row>

		<entrytbl spanname="descr" cols="2">

		  <tbody valign="top">

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME</constant></entry>

		      <entry>Last encoded frame will be searched</entry>

		    </row>

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME</constant></entry>

		      <entry>Two frames will be searched among the last encoded frame, the golden frame

and the alternate reference (altref) frame. The encoder implementation will decide which two are chosen.</entry>

		    </row>

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME</constant></entry>

		      <entry>The last encoded frame, the golden frame and the altref frame will be searched.</entry>

		    </row>

                  </tbody>

		</entrytbl>

	      </row>



	      <row><entry></entry></row>

	      <row>

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL</constant></entry>

		<entry>integer</entry>

	      </row>

	      <row><entry spanname="descr">Indicates the loop filter level. The adjustment of the loop

filter level is done via a delta value against a baseline loop filter value.</entry>

	      </row>



	      <row><entry></entry></row>

	      <row>

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS</constant></entry>

		<entry>integer</entry>

	      </row>

	      <row><entry spanname="descr">This parameter affects the loop filter. Anything above

zero weakens the deblocking effect on the loop filter.</entry>

	      </row>



	      <row><entry></entry></row>

	      <row>

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD</constant></entry>

		<entry>integer</entry>

	      </row>

	      <row><entry spanname="descr">Sets the refresh period for the golden frame. The period is defined

in number of frames. For a value of 'n', every nth frame starting from the first key frame will be taken as a golden frame.

For eg. for encoding sequence of 0, 1, 2, 3, 4, 5, 6, 7 where the golden frame refresh period is set as 4, the frames

0, 4, 8 etc will be taken as the golden frames as frame 0 is always a key frame.</entry>

	      </row>



	      <row><entry></entry></row>

	      <row id="v4l2-vpx-golden-frame-sel">

		<entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL</constant></entry>

		<entry>enum v4l2_vp8_golden_frame_sel</entry>

	      </row>

	      <row><entry spanname="descr">Selects the golden frame for encoding.

Possible values are:</entry>

	      </row>

	      <row>

		<entrytbl spanname="descr" cols="2">

		  <tbody valign="top">

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV</constant></entry>

		      <entry>Use the (n-2)th frame as a golden frame, current frame index being 'n'.</entry>

		    </row>

		    <row>

		      <entry><constant>V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD</constant></entry>

		      <entry>Use the previous specific frame indicated by

V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD as a golden frame.</entry>

		    </row>

                  </tbody>

		</entrytbl>

	      </row>



          <row><entry></entry></row>

        </tbody>

      </tgroup>

      </table>



      </section>

    </section>



    <section id="camera-controls">

Documentation/DocBook/media/v4l/lirc_device_interface.xml

+3 −1
Original line number Diff line number Diff line
@@ -46,7 +46,9 @@ describing an IR signal are read from the chardev.</para> 
values. Pulses and spaces are only marked implicitly by their position. The

data must start and end with a pulse, therefore, the data must always include

an uneven number of samples. The write function must block until the data has

been transmitted by the hardware.</para>

been transmitted by the hardware. If more data is provided than the hardware

can send, the driver returns EINVAL.</para>



</section>



<section id="lirc_ioctl">

Documentation/DocBook/media/v4l/pixfmt-nv16m.xml

0 → 100644
+171 −0
Original line number Diff line number Diff line 
    <refentry>

      <refmeta>

	<refentrytitle>V4L2_PIX_FMT_NV16M ('NM16'), V4L2_PIX_FMT_NV61M ('NM61')</refentrytitle>

	&manvol;

      </refmeta>

      <refnamediv>

	<refname id="V4L2-PIX-FMT-NV16M"><constant>V4L2_PIX_FMT_NV16M</constant></refname>

	<refname id="V4L2-PIX-FMT-NV61M"><constant>V4L2_PIX_FMT_NV61M</constant></refname>

	<refpurpose>Variation of <constant>V4L2_PIX_FMT_NV16</constant> and <constant>V4L2_PIX_FMT_NV61</constant> with planes

	  non contiguous in memory. </refpurpose>

      </refnamediv>

      <refsect1>

	<title>Description</title>



	<para>This is a multi-planar, two-plane version of the YUV 4:2:0 format.

The three components are separated into two sub-images or planes.

<constant>V4L2_PIX_FMT_NV16M</constant> differs from <constant>V4L2_PIX_FMT_NV16

</constant> in that the two planes are non-contiguous in memory, i.e. the chroma

plane does not necessarily immediately follows the luma plane.

The luminance data occupies the first plane. The Y plane has one byte per pixel.

In the second plane there is chrominance data with alternating chroma samples.

The CbCr plane is the same width and height, in bytes, as the Y plane.

Each CbCr pair belongs to four pixels. For example,

Cb<subscript>0</subscript>/Cr<subscript>0</subscript> belongs to

Y'<subscript>00</subscript>, Y'<subscript>01</subscript>,

Y'<subscript>10</subscript>, Y'<subscript>11</subscript>.

<constant>V4L2_PIX_FMT_NV61M</constant> is the same as <constant>V4L2_PIX_FMT_NV16M</constant>

except the Cb and Cr bytes are swapped, the CrCb plane starts with a Cr byte.</para>



	<para><constant>V4L2_PIX_FMT_NV16M</constant> and

<constant>V4L2_PIX_FMT_NV61M</constant> are intended to be used only in drivers

and applications that support the multi-planar API, described in

<xref linkend="planar-apis"/>. </para>



	<example>

	  <title><constant>V4L2_PIX_FMT_NV16M</constant> 4 &times; 4 pixel image</title>



	  <formalpara>

	    <title>Byte Order.</title>

	    <para>Each cell is one byte.

		<informaltable frame="none">

		<tgroup cols="5" align="center">

		  <colspec align="left" colwidth="2*" />

		  <tbody valign="top">

		    <row>

		      <entry>start0&nbsp;+&nbsp;0:</entry>

		      <entry>Y'<subscript>00</subscript></entry>

		      <entry>Y'<subscript>01</subscript></entry>

		      <entry>Y'<subscript>02</subscript></entry>

		      <entry>Y'<subscript>03</subscript></entry>

		    </row>

		    <row>

		      <entry>start0&nbsp;+&nbsp;4:</entry>

		      <entry>Y'<subscript>10</subscript></entry>

		      <entry>Y'<subscript>11</subscript></entry>

		      <entry>Y'<subscript>12</subscript></entry>

		      <entry>Y'<subscript>13</subscript></entry>

		    </row>

		    <row>

		      <entry>start0&nbsp;+&nbsp;8:</entry>

		      <entry>Y'<subscript>20</subscript></entry>

		      <entry>Y'<subscript>21</subscript></entry>

		      <entry>Y'<subscript>22</subscript></entry>

		      <entry>Y'<subscript>23</subscript></entry>

		    </row>

		    <row>

		      <entry>start0&nbsp;+&nbsp;12:</entry>

		      <entry>Y'<subscript>30</subscript></entry>

		      <entry>Y'<subscript>31</subscript></entry>

		      <entry>Y'<subscript>32</subscript></entry>

		      <entry>Y'<subscript>33</subscript></entry>

		    </row>

		    <row>

		      <entry></entry>

		    </row>

		    <row>

		      <entry>start1&nbsp;+&nbsp;0:</entry>

		      <entry>Cb<subscript>00</subscript></entry>

		      <entry>Cr<subscript>00</subscript></entry>

		      <entry>Cb<subscript>02</subscript></entry>

		      <entry>Cr<subscript>02</subscript></entry>

		    </row>

		    <row>

		      <entry>start1&nbsp;+&nbsp;4:</entry>

		      <entry>Cb<subscript>10</subscript></entry>

		      <entry>Cr<subscript>10</subscript></entry>

		      <entry>Cb<subscript>12</subscript></entry>

		      <entry>Cr<subscript>12</subscript></entry>

		    </row>

		    <row>

		      <entry>start1&nbsp;+&nbsp;8:</entry>

		      <entry>Cb<subscript>20</subscript></entry>

		      <entry>Cr<subscript>20</subscript></entry>

		      <entry>Cb<subscript>22</subscript></entry>

		      <entry>Cr<subscript>22</subscript></entry>

		    </row>

		    <row>

		      <entry>start1&nbsp;+&nbsp;12:</entry>

		      <entry>Cb<subscript>30</subscript></entry>

		      <entry>Cr<subscript>30</subscript></entry>

		      <entry>Cb<subscript>32</subscript></entry>

		      <entry>Cr<subscript>32</subscript></entry>

		    </row>

		  </tbody>

		</tgroup>

		</informaltable>

	      </para>

	  </formalpara>



	  <formalpara>

	    <title>Color Sample Location.</title>

	    <para>

		<informaltable frame="none">

		<tgroup cols="7" align="center">

		  <tbody valign="top">

		    <row>

		      <entry></entry>

		      <entry>0</entry><entry></entry><entry>1</entry><entry></entry>

		      <entry>2</entry><entry></entry><entry>3</entry>

		    </row>

		    <row>

		      <entry>0</entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry>

		    </row>

		    <row>

		      <entry></entry>

		      <entry></entry><entry>C</entry><entry></entry><entry></entry>

		      <entry></entry><entry>C</entry><entry></entry>

		    </row>

		    <row>

		      <entry>1</entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry>

		    </row>

		    <row>

		      <entry></entry>

		      <entry></entry><entry>C</entry><entry></entry><entry></entry>

		      <entry></entry><entry>C</entry><entry></entry>

		    </row>

		    <row>

		      <entry></entry>

		    </row>

		    <row>

		      <entry>2</entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry>

		    </row>

		    <row>

		      <entry></entry>

		      <entry></entry><entry>C</entry><entry></entry><entry></entry>

		      <entry></entry><entry>C</entry><entry></entry>

		    </row>

		    <row>

		      <entry>3</entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry><entry></entry>

		      <entry>Y</entry><entry></entry><entry>Y</entry>

		    </row>

		    <row>

		      <entry></entry>

		      <entry></entry><entry>C</entry><entry></entry><entry></entry>

		      <entry></entry><entry>C</entry><entry></entry>

		    </row>

		  </tbody>

		</tgroup>

		</informaltable>

	      </para>

	  </formalpara>

	</example>

      </refsect1>

    </refentry>

Documentation/DocBook/media/v4l/pixfmt.xml

+4 −3
Original line number Diff line number Diff line
@@ -391,9 +391,9 @@ clamp (double x) 
	else               return r;

}



y1 = (255 / 219.0) * (Y1 - 16);

pb = (255 / 224.0) * (Cb - 128);

pr = (255 / 224.0) * (Cr - 128);

y1 = (Y1 - 16) / 219.0;

pb = (Cb - 128) / 224.0;

pr = (Cr - 128) / 224.0;



r = 1.0 * y1 + 0     * pb + 1.402 * pr;

g = 1.0 * y1 - 0.344 * pb - 0.714 * pr;
@@ -718,6 +718,7 @@ information.</para> 
    &sub-nv12m;

    &sub-nv12mt;

    &sub-nv16;

    &sub-nv16m;

    &sub-nv24;

    &sub-m420;

  </section>

Documentation/DocBook/media/v4l/subdev-formats.xml

+245 −366

File changed.

Preview size limit exceeded, changes collapsed.

CRA Git | Maintained and supported by SUSTech CRA and CCSE