Documentation/media/uapi/v4l/dev-teletext.rst

   1 .. Permission is granted to copy, distribute and/or modify this
   2 .. document under the terms of the GNU Free Documentation License,
   3 .. Version 1.1 or any later version published by the Free Software
   4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
   5 .. and no Back-Cover Texts. A copy of the license is included at
   6 .. Documentation/media/uapi/fdl-appendix.rst.
   7 ..
   8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
   9
  10 .. _ttx:
  11
  12 ******************
  13 Teletext Interface
  14 ******************
  15
  16 This interface was aimed at devices receiving and demodulating Teletext
  17 data [:ref:`ets300706`, :ref:`itu653`], evaluating the Teletext
  18 packages and storing formatted pages in cache memory. Such devices are
  19 usually implemented as microcontrollers with serial interface
  20 (I\ :sup:`2`\ C) and could be found on old TV cards, dedicated Teletext
  21 decoding cards and home-brew devices connected to the PC parallel port.
  22
  23 The Teletext API was designed by Martin Buck. It was defined in the
  24 kernel header file ``linux/videotext.h``, the specification is available
  25 from
  26 `ftp://ftp.gwdg.de/pub/linux/misc/videotext/ <ftp://ftp.gwdg.de/pub/linux/misc/videotext/>`__.
  27 (Videotext is the name of the German public television Teletext
  28 service.)
  29
  30 Eventually the Teletext API was integrated into the V4L API with
  31 character device file names ``/dev/vtx0`` to ``/dev/vtx31``, device
  32 major number 81, minor numbers 192 to 223.
  33
  34 However, teletext decoders were quickly replaced by more generic VBI
  35 demodulators and those dedicated teletext decoders no longer exist. For
  36 many years the vtx devices were still around, even though nobody used
  37 them. So the decision was made to finally remove support for the
  38 Teletext API in kernel 2.6.37.
  39
  40 Modern devices all use the :ref:`raw <raw-vbi>` or
  41 :ref:`sliced` VBI API.