linux/Documentation/video4linux
Randy Dunlap a22f1cbc2d V4L/DVB (4047): Doc. sources: expose video4linux/
Documentation/video4linux/:
Expose example and tool source files in the Documentation/ directory in
their own files instead of being buried (almost hidden) in readme/txt files.
This will make them more visible/usable to users who may need
to use them, to developers who may need to test with them, and
to janitors who would update them if they were more visible.
Also, if any of these possibly should not be in the kernel tree at
all, it will be clearer that they are here and we can discuss if
they should be removed.

Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>
2006-06-25 02:05:00 -03:00
..
bttv V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
cx88 V4L/DVB (3809b): Added missing docs at kernel tree 2006-06-25 01:59:48 -03:00
cx2341x V4L/DVB (3809b): Added missing docs at kernel tree 2006-06-25 01:59:48 -03:00
API.html [PATCH] v4l: 851: fixed broken api link and indentation 2005-11-09 07:56:24 -08:00
CARDLIST.bttv V4L/DVB (3340): Add bttv card MagicTV (rebranded MachTV) 2006-01-11 19:40:09 -02:00
CARDLIST.cx88 V4L/DVB (4038): New cx88 card #50: NPG Tech RealTV 2006-06-25 02:00:37 -03:00
CARDLIST.em28xx V4L/DVB (3280): Changed description of KWorld PVR TV 2800RF 2006-02-07 06:25:41 -02:00
CARDLIST.saa7134 V4L/DVB (3646): Added support for the new Lifeview hybrid cardbus modules 2006-04-02 04:55:22 -03:00
CARDLIST.tuner V4L/DVB (3830): Fix display name for LG TDVS-H06xF 2006-06-25 01:58:19 -03:00
cpia2_overview.txt V4L/DVB (3376): Add cpia2 camera support 2006-02-27 00:09:05 -03:00
CQcam.txt V4L/DVB (4047): Doc. sources: expose video4linux/ 2006-06-25 02:05:00 -03:00
et61x251.txt V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
hauppauge-wintv-cx88-ir.txt [PATCH] Video for Linux Documentation 2005-06-24 00:06:38 -07:00
ibmcam.txt V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
lifeview.txt [PATCH] v4l: 801: whitespaces cleanups 2005-11-09 07:56:21 -08:00
meye.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
not-in-cx2388x-datasheet.txt [PATCH] v4l: Documentation 2005-07-12 16:01:05 -07:00
ov511.txt V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
radiotrack.txt V4L/DVB (3599c): Whitespace cleanups under Documentation/video4linux 2006-03-25 09:29:32 -03:00
README.cpia V4L/DVB (3599c): Whitespace cleanups under Documentation/video4linux 2006-03-25 09:29:32 -03:00
README.cpia2 V4L/DVB (3399a): cpia2/cpia2_v4l.c cleanups 2006-03-03 12:15:29 -03:00
README.cx88 [PATCH] v4l: 800: whitespace cleanups 2005-11-09 07:56:20 -08:00
README.ir Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
README.saa7134 [PATCH] v4l: 777: updated script to function in new tree layout 2005-11-09 07:56:18 -08:00
se401.txt V4L/DVB (3653h): Move usb v4l docs into Documentation/video4linux 2006-04-02 04:55:56 -03:00
sn9c102.txt V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
stv680.txt V4L/DVB (3653h): Move usb v4l docs into Documentation/video4linux 2006-04-02 04:55:56 -03:00
v4lgrab.c V4L/DVB (4047): Doc. sources: expose video4linux/ 2006-06-25 02:05:00 -03:00
w9966.txt V4L/DVB (3599c): Whitespace cleanups under Documentation/video4linux 2006-03-25 09:29:32 -03:00
w9968cf.txt V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
zc0301.txt V4L/DVB (3838): ZC0301 driver updates 2006-06-25 01:58:24 -03:00
Zoran V4L/DVB (3916): AverMedia 6 Eyes AVS6EYES support 2006-06-25 01:59:28 -03:00
zr36120.txt V4L/DVB (3599c): Whitespace cleanups under Documentation/video4linux 2006-03-25 09:29:32 -03:00


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]