linux/Documentation/video4linux
Linus Torvalds 1da177e4c3 Linux-2.6.12-rc2
Initial git repository build. I'm not bothering with the full history,
even though we have it. We can create a separate "historical" git
archive of that later if we want to, and in the meantime it's about
3.2GB when imported into git - space that would just make the early
git days unnecessarily complicated, when we don't have a lot of good
infrastructure for it.

Let it rip!
2005-04-16 15:20:36 -07:00
..
bttv Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
API.html Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
CARDLIST.bttv Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
CARDLIST.saa7134 Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
CARDLIST.tuner Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
CQcam.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
meye.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
radiotrack.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
README.cpia Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
README.cx88 Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
README.ir Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
README.saa7134 Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
w9966.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
Zoran Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
zr36120.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07: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)


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]