kernel-ark/Documentation/video4linux
Randy Dunlap 3794f3e812 docsrc: build Documentation/ sources
Currently source files in the Documentation/ sub-dir can easily bit-rot
since they are not generally buildable, either because they are hidden in
text files or because there are no Makefile rules for them.  This needs to
be fixed so that the source files remain usable and good examples of code
instead of bad examples.

Add the ability to build source files that are in the Documentation/ dir.
Add to Kconfig as "BUILD_DOCSRC" config symbol.

Use "CONFIG_BUILD_DOCSRC=1 make ..." to build objects from the
Documentation/ sources.  Or enable BUILD_DOCSRC in the *config system.
However, this symbol depends on HEADERS_CHECK since the header files need
to be installed (for userspace builds).

Built (using cross-tools) for x86-64, i386, alpha, ia64, sparc32,
sparc64, powerpc, sh, m68k, & mips.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Reviewed-by: Sam Ravnborg <sam@ravnborg.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2008-08-12 16:07:30 -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 (6095): ivtv: fix VIDIOC_G_ENC_INDEX flag handling 2007-09-14 13:13:40 -03:00
API.html
cafe_ccic V4L/DVB (4797): Marvell 88ALP01 "cafe" driver 2006-12-10 08:51:13 -02:00
CARDLIST.au0828 V4L/DVB (8530): au0828: add support for new revision of HVR950Q 2008-07-27 11:07:32 -03:00
CARDLIST.bttv V4L/DVB (7368): bttv: added support for Kozumi KTV-01C card 2008-04-24 14:07:51 -03:00
CARDLIST.cx88 V4L/DVB (7990): Fix entry for PowerColor RA 330 and make it run with firmware version 2.7 2008-06-05 06:35:56 -03:00
CARDLIST.cx23885 V4L/DVB (7986): cx23885: add initial support for DViCO FusionHDTV7 Dual Express 2008-07-20 07:08:09 -03:00
CARDLIST.em28xx V4L/DVB (8541): em28xx: HVR-950 entry is duplicated. 2008-07-27 18:07:50 -03:00
CARDLIST.ivtv V4L/DVB (6763): ivtv: add AVerMedia EZMaker PCI Deluxe support 2008-01-25 19:03:23 -02:00
CARDLIST.saa7134 V4L/DVB (8319): saa7134: Add support for analog only ASUSTeK P7131 2008-07-20 07:24:45 -03:00
CARDLIST.tuner V4L/DVB (7042): xc5000: Tuner analog support 2008-01-25 19:05:05 -02:00
CARDLIST.usbvision V4L/DVB (6994): usbvision: add Pinnacle Studio PCTV USB (NTSC) FM V3 2008-01-25 19:04:46 -02:00
cpia2_overview.txt
CQcam.txt V4L/DVB (5068): Fix authorship references 2007-02-21 13:34:20 -02:00
cx18.txt V4L/DVB (8168): cx18: Upgrade to newer firmware & update cx18 documentation. 2008-07-20 07:15:30 -03:00
et61x251.txt V4L/DVB (5064): ET61X251 driver updates. 2007-02-21 13:34:20 -02:00
extract_xc3028.pl V4L/DVB (7651): tuner-xc2028: Several fixes to SCODE 2008-04-24 14:09:44 -03:00
gspca.txt V4L/DVB (8572): gspca: Webcam 0c45:6143 in documentation. 2008-08-06 06:57:16 -03: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
Makefile docsrc: build Documentation/ sources 2008-08-12 16:07:30 -07:00
meye.txt documentation: convert the Documentation directory to UTF-8 2007-05-09 08:58:19 +02:00
not-in-cx2388x-datasheet.txt
ov511.txt documentation: convert the Documentation directory to UTF-8 2007-05-09 08:58:19 +02: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
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: convert the Documentation directory to UTF-8 2007-05-09 08:58:19 +02:00
README.saa7134
se401.txt V4L/DVB (3653h): Move usb v4l docs into Documentation/video4linux 2006-04-02 04:55:56 -03:00
sn9c102.txt Documentation cleanup: trivial misspelling, punctuation, and grammar corrections. 2008-07-26 12:00:06 -07: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 remove mention of CONFIG_KMOD from documentation 2008-07-22 19:24:29 +10:00
zc0301.txt V4L/DVB (5063): ZC0301 driver updates. 2007-02-21 13:34:19 -02:00
Zoran documentation: convert the Documentation directory to UTF-8 2007-05-09 08:58:19 +02:00
zr364xx.txt V4L/DVB (7081): zr364xx: add support for Creative DiVi CAM 516 2008-02-18 11:14:54 -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]