1
linux/Documentation/video4linux
Alan Cox ab33d5071d V4L/DVB (3376): Add cpia2 camera support
There has been a CPIA2 driver out of kernel for a long time and it has
been pretty clean for some time too. This is an import of the
sourceforge driver which has been stripped of
- 2.4 back compatibility
- 2.4 old style MJPEG ioctls
A couple of functions have been made static and the docs have been
repackaged into Documentation/video4linux.  The rvmalloc/free functions now
match the cpia driver again.  Other than that this is the code as is.
Tested on x86-64 with a QX5 microscope.

Signed-off-by: Alan Cox <alan@redhat.com>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>
2006-02-27 00:09:05 -03:00
..
bttv [PATCH] v4l: 800: whitespace cleanups 2005-11-09 07:56:20 -08:00
API.html [PATCH] v4l: 851: fixed broken api link and indentation 2005-11-09 07:56:24 -08:00
CARDLIST.bttv V4L/DVB (3340): Add bttv card MagicTV (rebranded MachTV) 2006-01-11 19:40:09 -02:00
CARDLIST.cx88 V4L/DVB (3316): Add initial support for KWorld HardwareMpegTV XPert 2006-02-07 06:49:14 -02: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 (3365): Kworld ATSC110: cleanups 2006-02-27 00:08:36 -03:00
CARDLIST.tuner V4L/DVB (3291): Added support for xc3028 analogue tuner (Hauppauge HVR900, Terratec Hybrid XS) 2006-02-27 00:07:27 -03:00
cpia2_overview.txt V4L/DVB (3376): Add cpia2 camera support 2006-02-27 00:09:05 -03:00
CQcam.txt
hauppauge-wintv-cx88-ir.txt
lifeview.txt [PATCH] v4l: 801: whitespaces cleanups 2005-11-09 07:56:21 -08:00
meye.txt
not-in-cx2388x-datasheet.txt
radiotrack.txt
README.cpia
README.cpia2 V4L/DVB (3376): Add cpia2 camera support 2006-02-27 00:09:05 -03:00
README.cx88 [PATCH] v4l: 800: whitespace cleanups 2005-11-09 07:56:20 -08:00
README.ir
README.saa7134 [PATCH] v4l: 777: updated script to function in new tree layout 2005-11-09 07:56:18 -08:00
w9966.txt
Zoran [PATCH] Spelling fixes for Documentation/ 2005-09-10 10:06:28 -07:00
zr36120.txt [PATCH] kernel Doc/ URL corrections 2005-11-22 09:14:30 -08: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]