diff options
Diffstat (limited to 'Documentation/DocBook/v4l/compat.xml')
-rw-r--r-- | Documentation/DocBook/v4l/compat.xml | 50 |
1 files changed, 36 insertions, 14 deletions
diff --git a/Documentation/DocBook/v4l/compat.xml b/Documentation/DocBook/v4l/compat.xml index 54447f0d0784..9f7cd4f25792 100644 --- a/Documentation/DocBook/v4l/compat.xml +++ b/Documentation/DocBook/v4l/compat.xml | |||
@@ -21,11 +21,15 @@ API.</para> | |||
21 | <title>Opening and Closing Devices</title> | 21 | <title>Opening and Closing Devices</title> |
22 | 22 | ||
23 | <para>For compatibility reasons the character device file names | 23 | <para>For compatibility reasons the character device file names |
24 | recommended for V4L2 video capture, overlay, radio, teletext and raw | 24 | recommended for V4L2 video capture, overlay, radio and raw |
25 | vbi capture devices did not change from those used by V4L. They are | 25 | vbi capture devices did not change from those used by V4L. They are |
26 | listed in <xref linkend="devices" /> and below in <xref | 26 | listed in <xref linkend="devices" /> and below in <xref |
27 | linkend="v4l-dev" />.</para> | 27 | linkend="v4l-dev" />.</para> |
28 | 28 | ||
29 | <para>The teletext devices (minor range 192-223) have been removed in | ||
30 | V4L2 and no longer exist. There is no hardware available anymore for handling | ||
31 | pure teletext. Instead raw or sliced VBI is used.</para> | ||
32 | |||
29 | <para>The V4L <filename>videodev</filename> module automatically | 33 | <para>The V4L <filename>videodev</filename> module automatically |
30 | assigns minor numbers to drivers in load order, depending on the | 34 | assigns minor numbers to drivers in load order, depending on the |
31 | registered device type. We recommend that V4L2 drivers by default | 35 | registered device type. We recommend that V4L2 drivers by default |
@@ -66,13 +70,6 @@ not compatible with V4L or V4L2.</para> </footnote>, | |||
66 | <entry>64-127</entry> | 70 | <entry>64-127</entry> |
67 | </row> | 71 | </row> |
68 | <row> | 72 | <row> |
69 | <entry>Teletext decoder</entry> | ||
70 | <entry><para><filename>/dev/vtx</filename>, | ||
71 | <filename>/dev/vtx0</filename> to | ||
72 | <filename>/dev/vtx31</filename></para></entry> | ||
73 | <entry>192-223</entry> | ||
74 | </row> | ||
75 | <row> | ||
76 | <entry>Raw VBI capture</entry> | 73 | <entry>Raw VBI capture</entry> |
77 | <entry><para><filename>/dev/vbi</filename>, | 74 | <entry><para><filename>/dev/vbi</filename>, |
78 | <filename>/dev/vbi0</filename> to | 75 | <filename>/dev/vbi0</filename> to |
@@ -1714,8 +1711,8 @@ ioctl would enumerate the available audio inputs. An ioctl to | |||
1714 | determine the current audio input, if more than one combines with the | 1711 | determine the current audio input, if more than one combines with the |
1715 | current video input, did not exist. So | 1712 | current video input, did not exist. So |
1716 | <constant>VIDIOC_G_AUDIO</constant> was renamed to | 1713 | <constant>VIDIOC_G_AUDIO</constant> was renamed to |
1717 | <constant>VIDIOC_G_AUDIO_OLD</constant>, this ioctl will be removed in | 1714 | <constant>VIDIOC_G_AUDIO_OLD</constant>, this ioctl was removed on |
1718 | the future. The &VIDIOC-ENUMAUDIO; ioctl was added to enumerate | 1715 | Kernel 2.6.39. The &VIDIOC-ENUMAUDIO; ioctl was added to enumerate |
1719 | audio inputs, while &VIDIOC-G-AUDIO; now reports the current audio | 1716 | audio inputs, while &VIDIOC-G-AUDIO; now reports the current audio |
1720 | input.</para> | 1717 | input.</para> |
1721 | <para>The same changes were made to &VIDIOC-G-AUDOUT; and | 1718 | <para>The same changes were made to &VIDIOC-G-AUDOUT; and |
@@ -1729,7 +1726,7 @@ must be updated to successfully compile again.</para> | |||
1729 | <para>The &VIDIOC-OVERLAY; ioctl was incorrectly defined with | 1726 | <para>The &VIDIOC-OVERLAY; ioctl was incorrectly defined with |
1730 | write-read parameter. It was changed to write-only, while the write-read | 1727 | write-read parameter. It was changed to write-only, while the write-read |
1731 | version was renamed to <constant>VIDIOC_OVERLAY_OLD</constant>. The old | 1728 | version was renamed to <constant>VIDIOC_OVERLAY_OLD</constant>. The old |
1732 | ioctl will be removed in the future. Until further the "videodev" | 1729 | ioctl was removed on Kernel 2.6.39. Until further the "videodev" |
1733 | kernel module will automatically translate to the new version, so drivers | 1730 | kernel module will automatically translate to the new version, so drivers |
1734 | must be recompiled, but not applications.</para> | 1731 | must be recompiled, but not applications.</para> |
1735 | </listitem> | 1732 | </listitem> |
@@ -1747,7 +1744,7 @@ surface can be seen.</para> | |||
1747 | defined with write-only parameter, inconsistent with other ioctls | 1744 | defined with write-only parameter, inconsistent with other ioctls |
1748 | modifying their argument. They were changed to write-read, while a | 1745 | modifying their argument. They were changed to write-read, while a |
1749 | <constant>_OLD</constant> suffix was added to the write-only versions. | 1746 | <constant>_OLD</constant> suffix was added to the write-only versions. |
1750 | The old ioctls will be removed in the future. Drivers and | 1747 | The old ioctls were removed on Kernel 2.6.39. Drivers and |
1751 | applications assuming a constant parameter need an update.</para> | 1748 | applications assuming a constant parameter need an update.</para> |
1752 | </listitem> | 1749 | </listitem> |
1753 | </orderedlist> | 1750 | </orderedlist> |
@@ -1818,8 +1815,8 @@ yet to be addressed, for details see <xref | |||
1818 | <para>The &VIDIOC-CROPCAP; ioctl was incorrectly defined | 1815 | <para>The &VIDIOC-CROPCAP; ioctl was incorrectly defined |
1819 | with read-only parameter. It is now defined as write-read ioctl, while | 1816 | with read-only parameter. It is now defined as write-read ioctl, while |
1820 | the read-only version was renamed to | 1817 | the read-only version was renamed to |
1821 | <constant>VIDIOC_CROPCAP_OLD</constant>. The old ioctl will be removed | 1818 | <constant>VIDIOC_CROPCAP_OLD</constant>. The old ioctl was removed |
1822 | in the future.</para> | 1819 | on Kernel 2.6.39.</para> |
1823 | </listitem> | 1820 | </listitem> |
1824 | </orderedlist> | 1821 | </orderedlist> |
1825 | </section> | 1822 | </section> |
@@ -2345,6 +2342,31 @@ more information.</para> | |||
2345 | </listitem> | 2342 | </listitem> |
2346 | </orderedlist> | 2343 | </orderedlist> |
2347 | </section> | 2344 | </section> |
2345 | <section> | ||
2346 | <title>V4L2 in Linux 2.6.37</title> | ||
2347 | <orderedlist> | ||
2348 | <listitem> | ||
2349 | <para>Remove the vtx (videotext/teletext) API. This API was no longer | ||
2350 | used and no hardware exists to verify the API. Nor were any userspace applications found | ||
2351 | that used it. It was originally scheduled for removal in 2.6.35. | ||
2352 | </para> | ||
2353 | </listitem> | ||
2354 | </orderedlist> | ||
2355 | </section> | ||
2356 | <section> | ||
2357 | <title>V4L2 in Linux 2.6.39</title> | ||
2358 | <orderedlist> | ||
2359 | <listitem> | ||
2360 | <para>The old VIDIOC_*_OLD symbols and V4L1 support were removed.</para> | ||
2361 | </listitem> | ||
2362 | <listitem> | ||
2363 | <para>Multi-planar API added. Does not affect the compatibility of | ||
2364 | current drivers and applications. See | ||
2365 | <link linkend="planar-apis">multi-planar API</link> | ||
2366 | for details.</para> | ||
2367 | </listitem> | ||
2368 | </orderedlist> | ||
2369 | </section> | ||
2348 | 2370 | ||
2349 | <section id="other"> | 2371 | <section id="other"> |
2350 | <title>Relation of V4L2 to other Linux multimedia APIs</title> | 2372 | <title>Relation of V4L2 to other Linux multimedia APIs</title> |