linux/Documentation/video4linux
Linus Torvalds 3e74683137 Merge branch 'for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-2.6
* 'for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-2.6: (345 commits)
  V4L/DVB (13542): ir-keytable: Allow dynamic table change
  V4L/DVB (13541): atbm8830: replace 64-bit division and floating point usage
  V4L/DVB (13540): ir-common: Cleanup get key evdev code
  V4L/DVB (13539): ir-common: add __func__ for debug messages
  V4L/DVB (13538): ir-common: Use a dynamic keycode table
  V4L/DVB (13537): ir: Prepare the code for dynamic keycode table allocation
  V4L/DVB (13536): em28xx: Use the full RC5 code on HVR-950 Remote Controller
  V4L/DVB (13535): ir-common: Add a hauppauge new table with the complete RC5 code
  V4L/DVB (13534): ir-common: Remove some unused fields/structs
  V4L/DVB (13533): ir: use dynamic tables, instead of static ones
  V4L/DVB (13532): ir-common: Add infrastructure to use a dynamic keycode table
  V4L/DVB (13531): ir-common: rename the debug routine to allow exporting it
  V4L/DVB (13458): go7007: subdev conversion
  V4L/DVB (13457): s2250: subdev conversion
  V4L/DVB (13456): s2250: Change module structure
  V4L/DVB (13528): em28xx: add support for em2800 VC211A card
  em28xx: don't reduce scale to half size for em2800
  em28xx: don't load audio modules when AC97 is mis-detected
  em28xx: em2800 chips support max width of 640
  V4L/DVB (13523): dvb-bt8xx: fix compile warning
  ...

Fix up trivial conflicts due to spelling fixes from the trivial tree in
	Documentation/video4linux/gspca.txt
	drivers/media/video/cx18/cx18-mailbox.h
2009-12-09 19:50:49 -08:00
..
bttv V4L/DVB (11051): v4l-dvb: replace remaining references to the old mailinglist. 2009-03-30 12:43:23 -03:00
cx88
cx2341x V4L/DVB (10487): doc: update hm12 documentation. 2009-03-30 12:42:41 -03:00
.gitignore .gitignore updates 2008-10-30 11:38:45 -07:00
API.html V4L/DVB (10128): modify V4L documentation to be a valid XHTML 2008-12-30 09:40:39 -02:00
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 (11124): Add support for ProVideo PV-183 to bttv 2009-03-30 12:43:31 -03:00
CARDLIST.cx88 V4L/DVB (13407): Add Prof 7301 PCI DVB-S2 card 2009-12-05 18:41:43 -02:00
CARDLIST.cx23885 V4L/DVB (13375): cx23885: Add support for Mygica X8558Pro DMB-TH 2009-12-05 18:41:34 -02:00
CARDLIST.em28xx V4L/DVB (13528): em28xx: add support for em2800 VC211A card 2009-12-05 18:42:17 -02:00
CARDLIST.ivtv
CARDLIST.saa7134 V4L/DVB (13204): saa7134: add support for the Leadtek DTV1000S 2009-12-05 18:40:52 -02:00
CARDLIST.saa7164 V4L/DVB (12946): SAA7164: Add support for a new HVR-2250 hardware revision 2009-09-19 00:15:24 -03:00
CARDLIST.tuner V4L/DVB (12964): tuner-core: add support for NXP TDA18271 without TDA829X demod 2009-09-19 00:16:01 -03:00
CARDLIST.usbvision
cpia2_overview.txt
CQcam.txt V4L/DVB (12370): v4l doc: fix cqcam source code path 2009-09-12 12:18:28 -03:00
cx18.txt trivial: Miscellaneous documentation typo fixes 2009-06-12 18:01:47 +02:00
et61x251.txt
extract_xc3028.pl
gspca.txt Merge branch 'for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-2.6 2009-12-09 19:50:49 -08: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
meye.txt
not-in-cx2388x-datasheet.txt
ov511.txt
pxa_camera.txt V4L/DVB (11613): pxa_camera: Documentation of the FSM 2009-06-16 18:20:44 -03:00
radiotrack.txt
README.cpia
README.cpia2
README.cx88 V4L/DVB (9370): Update README.cx88 with the current status 2008-12-29 17:53:13 -02:00
README.ir
README.ivtv
README.pvrusb2
README.saa7134
se401.txt
si470x.txt V4L/DVB (10530): Documentation and code cleanups 2009-03-30 12:42:45 -03:00
si4713.txt V4L/DVB (13476): spec: remove old dvb-spec and v4l2-spec directories 2009-12-05 18:42:04 -02:00
sn9c102.txt
soc-camera.txt V4L/DVB (12534): soc-camera: V4L2 API compliant scaling (S_FMT) and cropping (S_CROP) 2009-09-19 00:19:17 -03:00
stv680.txt
v4l2-framework.txt V4L/DVB (12725): v4l: warn when desired devnodenr is in use & add _no_warn function 2009-09-19 00:19:34 -03:00
v4lgrab.c Documentation/: fix warnings from -Wmissing-prototypes in HOSTCFLAGS 2009-09-23 07:39:28 -07:00
w9966.txt
w9968cf.txt
zc0301.txt
Zoran V4L/DVB (10931): zoran: Drop the lock_norm module parameter 2009-03-30 12:43:16 -03:00
zr364xx.txt V4L/DVB (13438): zr364xx: add support for Trust Powerc@m 910Z 2009-12-05 18:41:54 -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]