This is the README for the ivtv module suite.

----------------------------------------------------------

NOTE: the main ivtv driver is now included in the kernel since 2.6.22.
The ivtvfb framebuffer driver is included in the kernel since 2.6.24.
This means that the ivtv and ivtvfb drivers are no longer part of this
subversion repository, instead they are maintained in the v4l-dvb
repository at www.linuxtv.org.

However, one driver (saa717x) is not yet in the kernel (although it
will appear in 2.6.26) and is still part of this repository, as are
the test tools and ivtv utilities.

NOTE: These drivers and tools are for use with kernel 2.6.25 only,
for older kernels see www.ivtvdriver.org.

----------------------------------------------------------

The primary goal of the IVTV project is to provide a "clean room" Linux 
Open Source driver implementation for video capture cards based on the 
iCompression iTVC15 or Conexant CX23415/CX23416 MPEG Codec.

The following cards are supported:

Hauppauge WinTV PVR-250
Hauppauge WinTV PVR-350
Hauppauge WinTV PVR-150
Hauppauge WinTV PVR-500
AVerMedia M179
Yuan MPG600/Kuroutoshikou iTVC16-STVLP
Yuan MPG160/Kuroutoshikou iTVC15-STVLP
Yuan PG600/DiamondMM PVR-550 (CX Falcon 2)
Adaptec AVC-2410
Adaptec AVC-2010
Nagase Transgear 5000TV
AOpen VA2000MAX-STN6
Yuan MPG600GR/Kuroutoshikou CX23416GYC-STVLP
I/O Data GV-MVP/RX
I/O Data GV-MVP/RX2E
Gotview PCI DVD (preliminary support only)
Gotview PCI DVD2 Deluxe
Yuan MPC622
Digital Cowboy DCT-MTVP1
Yuan PG600V2/GotView PCI DVD Lite
Club3D ZAP-TV1x01
AverTV MCE 116 Plus
Digital Cowboy DCT-MTVP1
Yuan PG600V2/GotView PCI DVD Lite
Club3D ZAP-TV1x01
AverTV MCE 116 Plus
ASUS Falcon2
AverMedia PVR-150 Plus
AverMedia EZMaker PCI Deluxe

A special note regarding the PVR-500: this card basically consists of two
PVR-150 cards on one board but with the following difference: Radio,
Composite video and S-video are only hooked up to the first PVR-150 instance.

The Hauppauge cable set that you can buy for their cards to add an additional
Composite/S-Video input is also supported.

Features:
 * Hardware mpeg2 capture of broadcast video (and sound) via the tuner or
   S-Video/Composite and audio line-in.
 * Hardware mpeg2 capture of FM radio where hardware support exists
 * Supports NTSC, PAL, SECAM with stereo sound
 * Supports SAP and bilingual transmissions.
 * Supports raw VBI (closed captions and teletext).
 * Supports raw YUV and PCM input.

Additional features for the PVR-350 (CX23415 based):
 * Provides hardware mpeg2 playback
 * Provides comprehensive OSD (On Screen Display: ie. graphics overlaying the
   video signal)
 * Provides a framebuffer (allowing X applications to appear on the video
   device)
 * Supports raw YUV output.

IMPORTANT: In case of problems first read this page:
	   http://www.ivtvdriver.org/index.php/Troubleshooting


doc/ - contains documentation :)
   /README.install      Installation info
   /README.devices      /dev/xxxx devices
   /README.utils        Included utilities
   /README.lirc         Infrared remote control
   /README.vbi          VBI (Teletext, widescreen, close captioning, etc.)
   /README.radio        The FM Radio
   /video-quality.txt   Some notes on video quality
i2c-drivers/ - the saa717x driver
utils/ - some useful (and required) tools for managing the hardware
test/ - some useful test tools for testing the hardware

Also see:

Homepage + Wiki
http://www.ivtvdriver.org

Subversion repository:
http://ivtvdriver.org/svn/ivtv

Download area:
http://dl.ivtvdriver.org

Mail Archives
http://www.gossamer-threads.com/lists/ivtv/devel/
http://www.gossamer-threads.com/lists/ivtv/users/

IRC
irc://irc.freenode.net/ivtv-dev

Donations
http://www.ivtvdriver.org/index.php/IVTV:Site_support
