linux/Documentation/video4linux
Tobias Lorenz 6aadf82eb8 V4L/DVB (9482): Documentation, especially regarding audio and informational links
This patch adds a recommendation to select SND_USB_AUDIO for listing and
adds a documentation file for si470x.

Signed-off-by: Tobias Lorenz <tobias.lorenz@gmx.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
2008-11-11 08:11:24 -02:00
..
bttv Rationalise Randy's address a bit 2008-10-30 11:38:47 -07:00
cx88
cx2341x
.gitignore .gitignore updates 2008-10-30 11:38:45 -07:00
API.html
cafe_ccic
CARDLIST.au0828 V4L/DVB (9247): au0828: add support for another USB id for Hauppauge HVR950Q 2008-10-17 17:26:39 -03:00
CARDLIST.bttv V4L/DVB (8628): bttv: Add support for Encore ENLTV2-FM 2008-10-12 09:36:47 -02:00
CARDLIST.cx88 V4L/DVB (9186): Added support for Prof 7300 DVB-S/S2 cards 2008-10-13 12:41:21 -02:00
CARDLIST.cx23885 V4L/DVB (8807): Add DVB support for the Leadtek Winfast PxDVR3200 H 2008-10-12 09:36:55 -02:00
CARDLIST.em28xx V4L/DVB (8936): em28xx-cards: Add vendor/product id for EM2820_BOARD_PROLINK_PLAYTV_USB2 2008-10-12 09:36:59 -02:00
CARDLIST.ivtv
CARDLIST.saa7134 V4L/DVB (9113): saa7134: fixes for the Asus Tiger Revision 1.00 2008-10-12 09:37:14 -02:00
CARDLIST.tuner V4L/DVB (9268): tuner: add FMD1216MEX tuner 2008-10-17 17:29:09 -03:00
CARDLIST.usbvision
cpia2_overview.txt
CQcam.txt
cx18.txt V4L/DVB (8168): cx18: Upgrade to newer firmware & update cx18 documentation. 2008-07-20 07:15:30 -03:00
et61x251.txt
extract_xc3028.pl
gspca.txt V4L/DVB (9091): gspca: Subdriver m5602 (ALi) added. 2008-10-12 09:37:13 -02:00
hauppauge-wintv-cx88-ir.txt
ibmcam.txt
lifeview.txt
m5602.txt V4L/DVB (9091): gspca: Subdriver m5602 (ALi) added. 2008-10-12 09:37:13 -02:00
Makefile docsrc: build Documentation/ sources 2008-08-12 16:07:30 -07:00
meye.txt
not-in-cx2388x-datasheet.txt
ov511.txt
radiotrack.txt
README.cpia
README.cpia2
README.cx88 V4L/DVB (9369): Documentation update for cx88 2008-11-11 08:11:23 -02:00
README.ir
README.ivtv
README.pvrusb2
README.saa7134
se401.txt
si470x.txt V4L/DVB (9482): Documentation, especially regarding audio and informational links 2008-11-11 08:11:24 -02:00
sn9c102.txt Documentation cleanup: trivial misspelling, punctuation, and grammar corrections. 2008-07-26 12:00:06 -07:00
soc-camera.txt V4L/DVB (8799): soc-camera: add API documentation 2008-10-12 09:36:55 -02:00
stv680.txt
v4lgrab.c
w9966.txt
w9968cf.txt remove mention of CONFIG_KMOD from documentation 2008-07-22 19:24:29 +10:00
zc0301.txt
Zoran
zr364xx.txt


What is it?
===========

This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
boards.  See http://www.semiconductors.philips.com/pip/saa7134hl for a
description.


Status
======

Almost everything is working.  video, sound, tuner, radio, mpeg ts, ...

As with bttv, card-specific tweaks are needed.  Check CARDLIST for a
list of known TV cards and saa7134-cards.c for the drivers card
configuration info.


Build
=====

Pick up videodev + v4l2 patches from http://bytesex.org/patches/.
Configure, build, install + boot the new kernel.  You'll need at least
these config options:

	CONFIG_I2C=m
	CONFIG_VIDEO_DEV=m

Type "make" to build the driver now.  "make install" installs the
driver.  "modprobe saa7134" should load it.  Depending on the card you
might have to pass card=<nr> as insmod option, check CARDLIST for
valid choices.


Changes / Fixes
===============

Please mail me unified diffs ("diff -u") with your changes, and don't
forget to tell me what it changes / which problem it fixes / whatever
it is good for ...


Known Problems
==============

* The tuner for the flyvideos isn't detected automatically and the
  default might not work for you depending on which version you have.
  There is a tuner= insmod option to override the driver's default.

Card Variations:
================

Cards can use either of these two crystals (xtal):
 - 32.11 MHz -> .audio_clock=0x187de7
 - 24.576MHz -> .audio_clock=0x200000
(xtal * .audio_clock = 51539600)

Some details about 30/34/35:

 - saa7130 - low-price chip, doesn't have mute, that is why all those
 cards should have .mute field defined in their tuner structure.

 - saa7134 - usual chip

 - saa7133/35 - saa7135 is probably a marketing decision, since all those
 chips identifies itself as 33 on pci.

Credits
=======

andrew.stevens@philips.com + werner.leeb@philips.com for providing
saa7134 hardware specs and sample board.


Have fun,

  Gerd

--
Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]