1
linux/Documentation/video4linux
Linus Torvalds 6b06d2cc6d Merge branch 'release' of git://git.kernel.org/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6
* 'release' of git://git.kernel.org/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6: (105 commits)
  sonypi: use mutex instead of semaphore
  sony-laptop: remove user visible camera controls as platform attributes
  meye: make meye use sony-laptop instead of sonypi
  sony-laptop: add a meye-usable include file for camera ops
  sony-laptop: complete the motion eye camera support in sony-laptop
  sonypi: try to detect if sony-laptop has already taken one of the known ioports
  sonypi: suggest sonypi users to try sony-laptop instead
  sony-laptop: add edge modem support (also called WWAN)
  sony-laptop: add locking on accesses to the ioport and global vars
  sony-laptop: add camera enable/disable parameter, better handle possible infinite loop
  thinkpad-acpi: make drivers/misc/thinkpad_acpi:fan_mutex static
  ACPI: thinkpad-acpi: add sysfs support to wan and bluetooth subdrivers
  ACPI: thinkpad-acpi: add sysfs support to hotkey subdriver
  ACPI: thinkpad-acpi: improve dock subdriver initialization
  ACPI: thinkpad-acpi: improve debugging for acpi helpers
  ACPI: thinkpad-acpi: improve fan control documentation
  ACPI: thinkpad-acpi: map ENXIO to EINVAL for fan sysfs
  ACPI: thinkpad-acpi: fix a fan watchdog invocation
  ACPI: thinkpad-acpi: do not arm fan watchdog if it would not work
  ACPI: thinkpad-acpi: add a fan-control feature master toggle
  ...
2007-04-29 10:47:25 -07:00
..
bttv Various typo fixes. 2007-02-17 19:07:33 +01:00
cx88 Fix typos in Documentation/: 'Q'-'R' 2006-10-03 22:54:15 +02:00
cx2341x V4L/DVB (5437): Update cx23415 documentation 2007-04-27 15:44:47 -03:00
API.html
cafe_ccic V4L/DVB (4797): Marvell 88ALP01 "cafe" driver 2006-12-10 08:51:13 -02:00
CARDLIST.bttv V4L/DVB (5497): Additional card support for bttv driver 2007-04-27 15:45:25 -03:00
CARDLIST.cx88 V4L/DVB (5431): Cx88: autodetect ADS Tech InstantTV DVB-S 2007-04-27 15:44:44 -03:00
CARDLIST.em28xx
CARDLIST.ivtv V4L/DVB (5409): Add CARDLIST.ivtv and README.ivtv 2007-04-27 15:44:28 -03:00
CARDLIST.saa7134 V4L/DVB (5446): Renamed ASUStek P7131 card [1043:4876] 2007-04-27 15:44:52 -03:00
CARDLIST.tuner V4L/DVB (3830): Fix display name for LG TDVS-H06xF 2006-06-25 01:58:19 -03:00
CARDLIST.usbvision V4L/DVB (5530): Usbvision: remove CustomDevice facility 2007-04-27 15:45:43 -03:00
cpia2_overview.txt
CQcam.txt V4L/DVB (5068): Fix authorship references 2007-02-21 13:34:20 -02:00
et61x251.txt V4L/DVB (5064): ET61X251 driver updates. 2007-02-21 13:34:20 -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
meye.txt meye: make meye use sony-laptop instead of sonypi 2007-04-28 22:06:02 -04:00
not-in-cx2388x-datasheet.txt
ov511.txt V4L/DVB (4042): Documentation: whitespace cleanup 2006-06-25 02:00:38 -03:00
radiotrack.txt
README.cpia
README.cpia2
README.cx88
README.ir
README.ivtv V4L/DVB (5409): Add CARDLIST.ivtv and README.ivtv 2007-04-27 15:44:28 -03:00
README.pvrusb2 Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
README.saa7134
se401.txt
sn9c102.txt V4L/DVB (5474): SN9C1xx driver updates 2007-04-27 15:45:08 -03:00
stv680.txt
v4lgrab.c V4L/DVB (4047): Doc. sources: expose video4linux/ 2006-06-25 02:05:00 -03:00
w9966.txt
w9968cf.txt Fix typos in Documentation/: 'N'-'P' 2006-10-03 22:52:05 +02:00
zc0301.txt V4L/DVB (5063): ZC0301 driver updates. 2007-02-21 13:34:19 -02:00
Zoran V4L/DVB (5068): Fix authorship references 2007-02-21 13:34:20 -02:00
zr364xx.txt V4L/DVB (5257): USB: add zr364xx V4L2 driver 2007-04-27 15:43:17 -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]