linux/Documentation/video4linux
Mauro Carvalho Chehab 0e576b76f5 [media] media-entity.h: rename entity.type to entity.function
Entities should have one or more functions. Calling it as a
type proofed to not be correct, as an entity could eventually
have more than one type.

So, rename the field as function.

Please notice that this patch doesn't extend support for
multiple function entities. Such change will happen when
we have real case drivers using it.

No functional changes.

Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
2016-01-11 12:19:00 -02:00
..
bttv doc: fix quite a few typos within Documentation 2012-11-19 14:28:24 +01:00
cx88 Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
cx2341x
4CCs.txt [media] v4l: Document raw bayer 4CC codes 2012-05-14 08:38:17 -03:00
API.html [media] use https://linuxtv.org for LinuxTV URLs 2015-12-04 10:38:59 -02:00
cafe_ccic
CARDLIST.au0828 [media] Documentation: update V4L cardlists 2013-02-08 14:51:36 -02:00
CARDLIST.bttv Documentation: Update cardlists 2014-04-23 09:58:16 -03:00
CARDLIST.cx88 [media] Documentation: Update some card lists 2012-03-08 11:01:36 -03:00
CARDLIST.cx23885 [media] Documentation: update cardlists 2015-06-09 18:43:47 -03:00
CARDLIST.em28xx [media] em28xx: add Terratec Cinergy T XS (MT2060) 2015-11-19 09:29:16 -02:00
CARDLIST.ivtv
CARDLIST.saa7134 [media] saa7134: add Leadtek Winfast TV2100 FM card support 2015-09-25 17:19:17 -03:00
CARDLIST.saa7164 [media] Documentation: update cardlists 2015-06-09 18:43:47 -03:00
CARDLIST.tm6000 [media] move tm6000 to drivers/media/video 2011-09-23 09:32:35 -03:00
CARDLIST.tuner [media] update saa7134 and tuner cardlists 2013-05-21 08:16:19 -03:00
CARDLIST.usbvision [media] Update several cardlists 2011-07-27 17:52:16 -03:00
cpia2_overview.txt [media] Documentation: Add newline at end-of-file to files lacking one 2012-07-30 20:37:01 -03:00
cx18.txt
extract_xc3028.pl [media] extract_xc3028.pl: fix permissions 2013-01-11 13:01:37 -02:00
fimc.txt [media] use https://linuxtv.org for LinuxTV URLs 2015-12-04 10:38:59 -02:00
gspca.txt [media] media: gspca: sn9c20x: add ID for Genius Look 1320 V2 2014-02-28 14:37:43 -03:00
hauppauge-wintv-cx88-ir.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
lifeview.txt
Makefile v4l2-pci-skeleton: Only build if PCI is available 2014-09-26 11:02:58 +02:00
meye.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
not-in-cx2388x-datasheet.txt
omap3isp.txt [media] v4l: Documentation: change path of video drivers 2012-09-25 08:41:30 -03:00
omap4_camera.txt [media] include/media: move platform_data to linux/platform_data/media 2015-11-17 06:58:42 -02:00
pxa_camera.txt Fix common misspellings 2011-03-31 11:26:23 -03:00
radiotrack.txt
README.cpia2 doc: fix a few typos 2012-04-05 17:02:52 -07:00
README.cx88
README.davinci-vpbe [media] v4l: Documentation: change path of video drivers 2012-09-25 08:41:30 -03:00
README.ir
README.ivtv [media] Documentation: README.ivtv: Remove note that ivtvfb is not yet in the kernel 2011-03-21 20:32:28 -03:00
README.pvrusb2 Fix common misspellings 2011-03-31 11:26:23 -03:00
README.saa7134
sh_mobile_ceu_camera.txt [media] V4L: sh_mobile_ceu_camera: fix typos in documentation 2011-04-13 09:56:37 -03:00
si470x.txt [media] radio-si470x doc: add info about v4l2-ctl and sox+alsa 2013-02-13 17:33:20 -02:00
si476x.txt [media] doc: no singing 2013-12-10 17:13:33 -02:00
si4713.txt [media] include/media: move platform_data to linux/platform_data/media 2015-11-17 06:58:42 -02:00
soc-camera.txt [media] platform: Make use of media_bus_format enum 2014-11-14 17:54:08 -02:00
uvcvideo.txt Documentation: Fix multiple typo in Documentation 2012-03-07 16:08:24 +01:00
v4l2-controls.txt [media] media/Documentation: New flag EXECUTE_ON_WRITE 2015-04-08 06:35:16 -03:00
v4l2-framework.txt [media] media-entity.h: rename entity.type to entity.function 2016-01-11 12:19:00 -02:00
v4l2-pci-skeleton.c [media] vb2: drop v4l2_format argument from queue_setup 2015-12-18 13:48:19 -02:00
videobuf [media] v4l: Documentation: change path of video drivers 2012-09-25 08:41:30 -03:00
vivid.txt [media] vivid: move video loopback control to the capture device 2015-06-06 07:33:17 -03:00
Zoran Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
zr364xx.txt


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]