Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ab11ca34 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:
 - some V4L2 API updates needed by embedded devices
 - DVB API extensions for ATSC-MH delivery system, used in US for mobile
   TV
 - new tuners for fc0011/0012/0013 and tua9001
 - a new dvb driver for af9033/9035
 - a new ATSC-MH frontend (lg2160)
 - new remote controller keymaps
 - Removal of a few legacy webcam driver that got replaced by gspca on
   several kernel versions ago
 - a new driver for Exynos 4/5 webcams(s5pp fimc-lite)
 - a new webcam sensor driver (smiapp)
 - a new video input driver for embedded (sta2x1xx)
 - several improvements, fixes, cleanups, etc inside the drivers.

Manually fix up conflicts due to err() -> dev_err() conversion in
drivers/staging/media/easycap/easycap_main.c

* 'v4l_for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media: (484 commits)
  [media] saa7134-cards: Remove a PCI entry added by mistake
  [media] radio-sf16fmi: add support for SF16-FMD
  [media] rc-loopback: remove duplicate line
  [media] patch for Asus My Cinema PS3-100 (1043:48cd)
  [media] au0828: Move the Kconfig knob under V4L_USB_DRIVERS
  [media] em28xx: simple comment fix
  [media] [resend] radio-sf16fmr2: add PnP support for SF16-FMD2
  [media] smiapp: Use v4l2_ctrl_new_int_menu() instead of v4l2_ctrl_new_custom()
  [media] smiapp: Add support for 8-bit uncompressed formats
  [media] smiapp: Allow generic quirk registers
  [media] smiapp: Use non-binning limits if the binning limit is zero
  [media] smiapp: Initialise rval in smiapp_read_nvm()
  [media] smiapp: Round minimum pre_pll up rather than down in ip_clk_freq check
  [media] smiapp: Use 8-bit reads only before identifying the sensor
  [media] smiapp: Quirk for sensors that only do 8-bit reads
  [media] smiapp: Pass struct sensor to register writing commands instead of i2c_client
  [media] smiapp: Allow using external clock from the clock framework
  [media] zl10353: change .read_snr() to report SNR as a 0.1 dB
  [media] media: add support to gspca/pac7302.c for 093a:2627 (Genius FaceCam 300)
  [media] m88rs2000 - only flip bit 2 on reg 0x70 on 16th try
  ...
parents f9369910 71006fb2

Documentation/DocBook/media/Makefile

+3 −1
Original line number Diff line number Diff line
@@ -70,6 +70,8 @@ IOCTLS = \ 
	VIDIOC_SUBDEV_ENUM_MBUS_CODE \

	VIDIOC_SUBDEV_ENUM_FRAME_SIZE \

	VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL \

	VIDIOC_SUBDEV_G_SELECTION \

	VIDIOC_SUBDEV_S_SELECTION \



TYPES = \

	$(shell perl -ne 'print "$$1 " if /^typedef\s+[^\s]+\s+([^\s]+)\;/' $(srctree)/include/linux/videodev2.h) \
@@ -193,7 +195,7 @@ DVB_DOCUMENTED = \ 
#



install_media_images = \

	$(Q)cp $(OBJIMGFILES) $(MEDIA_OBJ_DIR)/media_api

	$(Q)cp $(OBJIMGFILES) $(MEDIA_SRC_DIR)/v4l/*.svg $(MEDIA_OBJ_DIR)/media_api



$(MEDIA_OBJ_DIR)/%: $(MEDIA_SRC_DIR)/%.b64

	$(Q)base64 -d $< >$@

Documentation/DocBook/media/dvb/dvbproperty.xml

+160 −0
Original line number Diff line number Diff line
@@ -531,6 +531,139 @@ typedef enum fe_delivery_system { 
				here are referring to what can be found in the TMCC-structure -

				independent of the mode.</para>

		</section>

		<section id="DTV-ATSCMH-FIC-VER">

			<title><constant>DTV_ATSCMH_FIC_VER</constant></title>

			<para>Version number of the FIC (Fast Information Channel) signaling data.</para>

			<para>FIC is used for relaying information to allow rapid service acquisition by the receiver.</para>

			<para>Possible values: 0, 1, 2, 3, ..., 30, 31</para>

		</section>

		<section id="DTV-ATSCMH-PARADE-ID">

			<title><constant>DTV_ATSCMH_PARADE_ID</constant></title>

			<para>Parade identification number</para>

			<para>A parade is a collection of up to eight MH groups, conveying one or two ensembles.</para>

			<para>Possible values: 0, 1, 2, 3, ..., 126, 127</para>

		</section>

		<section id="DTV-ATSCMH-NOG">

			<title><constant>DTV_ATSCMH_NOG</constant></title>

			<para>Number of MH groups per MH subframe for a designated parade.</para>

			<para>Possible values: 1, 2, 3, 4, 5, 6, 7, 8</para>

		</section>

		<section id="DTV-ATSCMH-TNOG">

			<title><constant>DTV_ATSCMH_TNOG</constant></title>

			<para>Total number of MH groups including all MH groups belonging to all MH parades in one MH subframe.</para>

			<para>Possible values: 0, 1, 2, 3, ..., 30, 31</para>

		</section>

		<section id="DTV-ATSCMH-SGN">

			<title><constant>DTV_ATSCMH_SGN</constant></title>

			<para>Start group number.</para>

			<para>Possible values: 0, 1, 2, 3, ..., 14, 15</para>

		</section>

		<section id="DTV-ATSCMH-PRC">

			<title><constant>DTV_ATSCMH_PRC</constant></title>

			<para>Parade repetition cycle.</para>

			<para>Possible values: 1, 2, 3, 4, 5, 6, 7, 8</para>

		</section>

		<section id="DTV-ATSCMH-RS-FRAME-MODE">

			<title><constant>DTV_ATSCMH_RS_FRAME_MODE</constant></title>

			<para>RS frame mode.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_rs_frame_mode {

	ATSCMH_RSFRAME_PRI_ONLY  = 0,

	ATSCMH_RSFRAME_PRI_SEC   = 1,

} atscmh_rs_frame_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-RS-FRAME-ENSEMBLE">

			<title><constant>DTV_ATSCMH_RS_FRAME_ENSEMBLE</constant></title>

			<para>RS frame ensemble.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_rs_frame_ensemble {

	ATSCMH_RSFRAME_ENS_PRI   = 0,

	ATSCMH_RSFRAME_ENS_SEC   = 1,

} atscmh_rs_frame_ensemble_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-RS-CODE-MODE-PRI">

			<title><constant>DTV_ATSCMH_RS_CODE_MODE_PRI</constant></title>

			<para>RS code mode (primary).</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_rs_code_mode {

	ATSCMH_RSCODE_211_187    = 0,

	ATSCMH_RSCODE_223_187    = 1,

	ATSCMH_RSCODE_235_187    = 2,

} atscmh_rs_code_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-RS-CODE-MODE-SEC">

			<title><constant>DTV_ATSCMH_RS_CODE_MODE_SEC</constant></title>

			<para>RS code mode (secondary).</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_rs_code_mode {

	ATSCMH_RSCODE_211_187    = 0,

	ATSCMH_RSCODE_223_187    = 1,

	ATSCMH_RSCODE_235_187    = 2,

} atscmh_rs_code_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-SCCC-BLOCK-MODE">

			<title><constant>DTV_ATSCMH_SCCC_BLOCK_MODE</constant></title>

			<para>Series Concatenated Convolutional Code Block Mode.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_sccc_block_mode {

	ATSCMH_SCCC_BLK_SEP      = 0,

	ATSCMH_SCCC_BLK_COMB     = 1,

} atscmh_sccc_block_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-SCCC-CODE-MODE-A">

			<title><constant>DTV_ATSCMH_SCCC_CODE_MODE_A</constant></title>

			<para>Series Concatenated Convolutional Code Rate.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_sccc_code_mode {

	ATSCMH_SCCC_CODE_HLF     = 0,

	ATSCMH_SCCC_CODE_QTR     = 1,

} atscmh_sccc_code_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-SCCC-CODE-MODE-B">

			<title><constant>DTV_ATSCMH_SCCC_CODE_MODE_B</constant></title>

			<para>Series Concatenated Convolutional Code Rate.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_sccc_code_mode {

	ATSCMH_SCCC_CODE_HLF     = 0,

	ATSCMH_SCCC_CODE_QTR     = 1,

} atscmh_sccc_code_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-SCCC-CODE-MODE-C">

			<title><constant>DTV_ATSCMH_SCCC_CODE_MODE_C</constant></title>

			<para>Series Concatenated Convolutional Code Rate.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_sccc_code_mode {

	ATSCMH_SCCC_CODE_HLF     = 0,

	ATSCMH_SCCC_CODE_QTR     = 1,

} atscmh_sccc_code_mode_t;

</programlisting>

		</section>

		<section id="DTV-ATSCMH-SCCC-CODE-MODE-D">

			<title><constant>DTV_ATSCMH_SCCC_CODE_MODE_D</constant></title>

			<para>Series Concatenated Convolutional Code Rate.</para>

			<para>Possible values are:</para>

<programlisting>

typedef enum atscmh_sccc_code_mode {

	ATSCMH_SCCC_CODE_HLF     = 0,

	ATSCMH_SCCC_CODE_QTR     = 1,

} atscmh_sccc_code_mode_t;

</programlisting>

		</section>

	</section>

	<section id="DTV-API-VERSION">

	<title><constant>DTV_API_VERSION</constant></title>
@@ -774,6 +907,33 @@ typedef enum fe_hierarchy { 
				<listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>

			</itemizedlist>

		</section>

		<section id="atscmh-params">

			<title>ATSC-MH delivery system</title>

			<para>The following parameters are valid for ATSC-MH:</para>

			<itemizedlist mark='opencircle'>

				<listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-FIC-VER"><constant>DTV_ATSCMH_FIC_VER</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-PARADE-ID"><constant>DTV_ATSCMH_PARADE_ID</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-NOG"><constant>DTV_ATSCMH_NOG</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-TNOG"><constant>DTV_ATSCMH_TNOG</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-SGN"><constant>DTV_ATSCMH_SGN</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-PRC"><constant>DTV_ATSCMH_PRC</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-RS-FRAME-MODE"><constant>DTV_ATSCMH_RS_FRAME_MODE</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-RS-FRAME-ENSEMBLE"><constant>DTV_ATSCMH_RS_FRAME_ENSEMBLE</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-CODE-MODE-PRI"><constant>DTV_ATSCMH_CODE_MODE_PRI</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-CODE-MODE-SEC"><constant>DTV_ATSCMH_CODE_MODE_SEC</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-SCCC-BLOCK-MODE"><constant>DTV_ATSCMH_SCCC_BLOCK_MODE</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE_MODE-A"><constant>DTV_ATSCMH_SCCC_CODE_MODE_A</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE_MODE-B"><constant>DTV_ATSCMH_SCCC_CODE_MODE_B</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE_MODE-C"><constant>DTV_ATSCMH_SCCC_CODE_MODE_C</constant></link></para></listitem>

				<listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE_MODE-D"><constant>DTV_ATSCMH_SCCC_CODE_MODE_D</constant></link></para></listitem>

			</itemizedlist>

		</section>

	</section>

	<section id="frontend-property-cable-systems">

	<title>Properties used on cable delivery systems</title>

Documentation/DocBook/media/v4l/biblio.xml

+29 −0
Original line number Diff line number Diff line
@@ -197,4 +197,33 @@ in the frequency range from 87,5 to 108,0 MHz</title> 
      <title>NTSC-4: United States RBDS Standard</title>

    </biblioentry>



    <biblioentry id="iso12232">

      <abbrev>ISO&nbsp;12232:2006</abbrev>

      <authorgroup>

	<corpauthor>International Organization for Standardization

(<ulink url="http://www.iso.org">http://www.iso.org</ulink>)</corpauthor>

      </authorgroup>

      <title>Photography &mdash; Digital still cameras &mdash; Determination

      of exposure index, ISO speed ratings, standard output sensitivity, and

      recommended exposure index</title>

    </biblioentry>



    <biblioentry id="cea861">

      <abbrev>CEA-861-E</abbrev>

      <authorgroup>

	<corpauthor>Consumer Electronics Association

(<ulink url="http://www.ce.org">http://www.ce.org</ulink>)</corpauthor>

      </authorgroup>

      <title>A DTV Profile for Uncompressed High Speed Digital Interfaces</title>

    </biblioentry>



    <biblioentry id="vesadmt">

      <abbrev>VESA&nbsp;DMT</abbrev>

      <authorgroup>

	<corpauthor>Video Electronics Standards Association

(<ulink url="http://www.vesa.org">http://www.vesa.org</ulink>)</corpauthor>

      </authorgroup>

      <title>VESA and Industry Standards and Guidelines for Computer Display Monitor Timing (DMT)</title>

    </biblioentry>



  </bibliography>

Documentation/DocBook/media/v4l/common.xml

+23 −15
Original line number Diff line number Diff line
@@ -724,42 +724,50 @@ if (-1 == ioctl (fd, &VIDIOC-S-STD;, &amp;std_id)) { 
}

      </programlisting>

    </example>

  </section>

  <section id="dv-timings">

	<title>Digital Video (DV) Timings</title>

	<para>

	The video standards discussed so far has been dealing with Analog TV and the

	The video standards discussed so far have been dealing with Analog TV and the

corresponding video timings. Today there are many more different hardware interfaces

such as High Definition TV interfaces (HDMI), VGA, DVI connectors etc., that carry

video signals and there is a need to extend the API to select the video timings

for these interfaces. Since it is not possible to extend the &v4l2-std-id; due to

the limited bits available, a new set of IOCTLs is added to set/get video timings at

the limited bits available, a new set of IOCTLs was added to set/get video timings at

the input and output: </para><itemizedlist>

	<listitem>

	<para>DV Presets: Digital Video (DV) presets. These are IDs representing a

	<para>DV Timings: This will allow applications to define detailed

video timings for the interface. This includes parameters such as width, height,

polarities, frontporch, backporch etc. The <filename>linux/v4l2-dv-timings.h</filename>

header can be used to get the timings of the formats in the <xref linkend="cea861" /> and

<xref linkend="vesadmt" /> standards.

	</para>

	</listitem>

	<listitem>

	<para>DV Presets: Digital Video (DV) presets (<emphasis role="bold">deprecated</emphasis>).

	These are IDs representing a

video timing at the input/output. Presets are pre-defined timings implemented

by the hardware according to video standards. A __u32 data type is used to represent

a preset unlike the bit mask that is used in &v4l2-std-id; allowing future extensions

to support as many different presets as needed.</para>

	</listitem>

	<listitem>

	<para>Custom DV Timings: This will allow applications to define more detailed

custom video timings for the interface. This includes parameters such as width, height,

polarities, frontporch, backporch etc.

	</para>

to support as many different presets as needed. This API is deprecated in favor of the DV Timings

API.</para>

	</listitem>

	</itemizedlist>

	<para>To enumerate and query the attributes of the DV timings supported by a device,

	applications use the &VIDIOC-ENUM-DV-TIMINGS; and &VIDIOC-DV-TIMINGS-CAP; ioctls.

	To set DV timings for the device, applications use the

&VIDIOC-S-DV-TIMINGS; ioctl and to get current DV timings they use the

&VIDIOC-G-DV-TIMINGS; ioctl. To detect the DV timings as seen by the video receiver applications

use the &VIDIOC-QUERY-DV-TIMINGS; ioctl.</para>

	<para>To enumerate and query the attributes of DV presets supported by a device,

applications use the &VIDIOC-ENUM-DV-PRESETS; ioctl. To get the current DV preset,

applications use the &VIDIOC-G-DV-PRESET; ioctl and to set a preset they use the

&VIDIOC-S-DV-PRESET; ioctl.</para>

	<para>To set custom DV timings for the device, applications use the

&VIDIOC-S-DV-TIMINGS; ioctl and to get current custom DV timings they use the

&VIDIOC-G-DV-TIMINGS; ioctl.</para>

&VIDIOC-S-DV-PRESET; ioctl. To detect the preset as seen by the video receiver applications

use the &VIDIOC-QUERY-DV-PRESET; ioctl.</para>

	<para>Applications can make use of the <xref linkend="input-capabilities" /> and

<xref linkend="output-capabilities"/> flags to decide what ioctls are available to set the

video timings for the device.</para>

  </section>

  </section>



  &sub-controls;

Documentation/DocBook/media/v4l/compat.xml

+75 −0
Original line number Diff line number Diff line
@@ -2407,6 +2407,54 @@ details.</para> 
	  <para>Added <link linkend="jpeg-controls">JPEG compression control

	  class</link>.</para>

        </listitem>

        <listitem>

	  <para>Extended the DV Timings API:

	  &VIDIOC-ENUM-DV-TIMINGS;, &VIDIOC-QUERY-DV-TIMINGS; and

	  &VIDIOC-DV-TIMINGS-CAP;.</para>

        </listitem>

      </orderedlist>

    </section>



    <section>

      <title>V4L2 in Linux 3.5</title>

      <orderedlist>

        <listitem>

	  <para>Added integer menus, the new type will be

	  V4L2_CTRL_TYPE_INTEGER_MENU.</para>

        </listitem>

        <listitem>

	  <para>Added selection API for V4L2 subdev interface:

	  &VIDIOC-SUBDEV-G-SELECTION; and

	  &VIDIOC-SUBDEV-S-SELECTION;.</para>

        </listitem>

        <listitem>

	  <para> Added <constant>V4L2_COLORFX_ANTIQUE</constant>,

	  <constant>V4L2_COLORFX_ART_FREEZE</constant>,

	  <constant>V4L2_COLORFX_AQUA</constant>,

	  <constant>V4L2_COLORFX_SILHOUETTE</constant>,

	  <constant>V4L2_COLORFX_SOLARIZATION</constant>,

	  <constant>V4L2_COLORFX_VIVID</constant> and

	  <constant>V4L2_COLORFX_ARBITRARY_CBCR</constant> menu items

	  to the <constant>V4L2_CID_COLORFX</constant> control.</para>

        </listitem>

        <listitem>

	  <para> Added <constant>V4L2_CID_COLORFX_CBCR</constant> control.</para>

        </listitem>

        <listitem>

	  <para> Added camera controls <constant>V4L2_CID_AUTO_EXPOSURE_BIAS</constant>,

	  <constant>V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE</constant>,

	  <constant>V4L2_CID_IMAGE_STABILIZATION</constant>,

	  <constant>V4L2_CID_ISO_SENSITIVITY</constant>,

	  <constant>V4L2_CID_ISO_SENSITIVITY_AUTO</constant>,

	  <constant>V4L2_CID_EXPOSURE_METERING</constant>,

	  <constant>V4L2_CID_SCENE_MODE</constant>,

	  <constant>V4L2_CID_3A_LOCK</constant>,

	  <constant>V4L2_CID_AUTO_FOCUS_START</constant>,

	  <constant>V4L2_CID_AUTO_FOCUS_STOP</constant>,

	  <constant>V4L2_CID_AUTO_FOCUS_STATUS</constant> and

	  <constant>V4L2_CID_AUTO_FOCUS_RANGE</constant>.

	  </para>

        </listitem>

      </orderedlist>

    </section>
@@ -2505,6 +2553,10 @@ and may change in the future.</para> 
        </listitem>

        <listitem>

	  <para>&VIDIOC-ENCODER-CMD; and &VIDIOC-TRY-ENCODER-CMD;

ioctls.</para>

        </listitem>

        <listitem>

	  <para>&VIDIOC-DECODER-CMD; and &VIDIOC-TRY-DECODER-CMD;

ioctls.</para>

        </listitem>

        <listitem>
@@ -2514,6 +2566,10 @@ ioctls.</para> 
        <listitem>

	  <para>&VIDIOC-DBG-G-CHIP-IDENT; ioctl.</para>

        </listitem>

        <listitem>

	  <para>&VIDIOC-ENUM-DV-TIMINGS;, &VIDIOC-QUERY-DV-TIMINGS; and

	  &VIDIOC-DV-TIMINGS-CAP; ioctls.</para>

        </listitem>

        <listitem>

	  <para>Flash API. <xref linkend="flash-controls" /></para>

        </listitem>
@@ -2523,6 +2579,14 @@ ioctls.</para> 
        <listitem>

	  <para>Selection API. <xref linkend="selection-api" /></para>

        </listitem>

        <listitem>

	  <para>Sub-device selection API: &VIDIOC-SUBDEV-G-SELECTION;

	  and &VIDIOC-SUBDEV-S-SELECTION; ioctls.</para>

        </listitem>

        <listitem>

	  <para><link linkend="v4l2-auto-focus-area"><constant>

	  V4L2_CID_AUTO_FOCUS_AREA</constant></link> control.</para>

        </listitem>

      </itemizedlist>

    </section>
@@ -2538,6 +2602,17 @@ interfaces and should not be implemented in new drivers.</para> 
<constant>VIDIOC_S_MPEGCOMP</constant> ioctls. Use Extended Controls,

<xref linkend="extended-controls" />.</para>

        </listitem>

        <listitem>

	  <para>&VIDIOC-G-DV-PRESET;, &VIDIOC-S-DV-PRESET;, &VIDIOC-ENUM-DV-PRESETS; and

	  &VIDIOC-QUERY-DV-PRESET; ioctls. Use the DV Timings API (<xref linkend="dv-timings" />).</para>

        </listitem>

        <listitem>

	  <para><constant>VIDIOC_SUBDEV_G_CROP</constant> and

	  <constant>VIDIOC_SUBDEV_S_CROP</constant> ioctls. Use

	  <constant>VIDIOC_SUBDEV_G_SELECTION</constant> and

	  <constant>VIDIOC_SUBDEV_S_SELECTION</constant>, <xref

	  linkend="vidioc-subdev-g-selection" />.</para>

        </listitem>

      </itemizedlist>

    </section>

  </section>