aha/Documentation/video4linux
Linus Torvalds 708e16892e Merge git://git.kernel.org/pub/scm/linux/kernel/git/bunk/trivial
* git://git.kernel.org/pub/scm/linux/kernel/git/bunk/trivial: (39 commits)
  Add missing maintainer countries in CREDITS
  Fix bytes <-> kilobytes  typo in Kconfig for ramdisk
  fix a typo in Documentation/pi-futex.txt
  BUG_ON conversion for fs/xfs/
  BUG_ON() conversion in fs/nfsd/
  BUG_ON conversion for fs/reiserfs
  BUG_ON cleanups in arch/i386
  BUG_ON cleanup in drivers/net/tokenring/
  BUG_ON cleanup for drivers/md/
  kerneldoc-typo in led-class.c
  debugfs: spelling fix
  rcutorture: Fix incorrect description of default for nreaders parameter
  parport: Remove space in function calls
  Michal Wronski: update contact info
  Spelling fix: "control" instead of "cotrol"
  reboot parameter in Documentation/kernel-parameters.txt
  Fix copy&waste bug in comment in scripts/kernel-doc
  remove duplicate "until" from kernel/workqueue.c
  ite_gpio fix tabbage
  fix file specification in comments
  ...

Fixed trivial path conflicts due to removed files:
   arch/mips/dec/boot/decstation.c, drivers/char/ite_gpio.c
2006-10-03 16:35:11 -07:00
..
bttv V4L/DVB (4609): Improved i2c performance on software bitbang algoritm 2006-09-26 12:30:35 -03:00
cx88 Fix typos in Documentation/: 'Q'-'R' 2006-10-03 22:54:15 +02:00
cx2341x Fix typos in Documentation/: 'N'-'P' 2006-10-03 22:52:05 +02:00
API.html [PATCH] v4l: 851: fixed broken api link and indentation 2005-11-09 07:56:24 -08:00
CARDLIST.bttv V4L/DVB (4209): Added some BTTV PCI IDs for newer boards 2006-06-25 02:05:25 -03:00
CARDLIST.cx88 V4L/DVB (4689): Adding support for Nova-T-PCI PCI ID 0070:9000 2006-10-03 15:14:56 -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 (4671): Support for SAA7134-based AVerTV Hybrid A16AR 2006-10-03 15:14:11 -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 Fix "can not" in Documentation and Kconfig 2006-10-03 22:53:09 +02:00
hauppauge-wintv-cx88-ir.txt Fix typos in Documentation/: 'Q'-'R' 2006-10-03 22:54:15 +02: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 Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02: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.pvrusb2 Documentation: remove duplicated words 2006-10-03 22:57:56 +02: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 Fix typos in Documentation/: 'H'-'M' 2006-10-03 22:50:39 +02: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 Fix typos in Documentation/: 'N'-'P' 2006-10-03 22:52:05 +02:00
zc0301.txt V4L/DVB (3838): ZC0301 driver updates 2006-06-25 01:58:24 -03:00
Zoran Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
zr36120.txt Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02: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]