linux/Documentation/video4linux
Linus Torvalds e9ad9b9bd3 The most interesting thing (IMO) this time around is some beginning
infrastructural work to allow documents to be written using restructured
 text.  Maybe someday, in a galaxy far far away, we'll be able to eliminate
 the DocBook dependency and have a much better integrated set of kernel
 docs.  Someday.
 
 Beyond that, there's a new document on security hardening from Kees, the
 movement of some sample code over to samples/, a number of improvements to
 the serial docs from Geert, and the usual collection of corrections, typo
 fixes, etc.
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1
 
 iQIcBAABAgAGBQJXPf/VAAoJEI3ONVYwIuV60pkP/3brq+CavbwptWppESoyZaf7
 mpVSH7sOKicMcfHYYIXHmmg0K5gM4e22ATl39+izUCRZRwRnObXvroH++G5mARLs
 MUDxLvkc/QxDDuCZnUBq5E2gPtuyYpgj1q9fMGB+70ucc/EXYp5cxUhDmbNVrpSG
 KBMoZqKaW/Cf8/4fvRQG/glSR0iwyaQuvvoFAWLHgf8uWN/JPM2Cnv9V2zGQCtzP
 4B4Jzayu2BGKowBd65WUYdpGnccc7OAJFSJDY/Z9x7kVxKyD+VTn7VgxGnXxs88v
 uNmUEMENUpswzuoYEnDHoR0Y2o7jUi2doFKv+eacSmPaMLWL5EMDzcooZ+Vi7HWH
 mvp6GtAZ5qs96OGjsi+gFIw4kY8HGdnpzs7qk/uEdAndfAif5v24YLSQRG2rUCJM
 LxomnAWOJEIWGKJtuJnl16aZkgOcn6soecXw3PJmpxzhwd8BnQzwyZIdaZ98kwjA
 7Enq2Mmw5NBQwGIV2ODUxzoQ3Axj7aJJsDra2n6lPGTGXONGdgNFzk/hGmtQSuIp
 Aeatiy66FF0qKomzs2+EACOFP+eH/IId0yvW83Pj0o9nV25YZiPsw0Z1Tae5n3+g
 zgTFycalaowIwE3YzyH6BwvnMrluiPpUTjSLsmEaviJxE7/o+zrjOvMvallUIVUn
 YkJcia/DtSuc7u7LYkWe
 =2O+a
 -----END PGP SIGNATURE-----

Merge tag 'docs-for-linus' of git://git.lwn.net/linux

Pull Documentation updates from Jon Corbet:
 "A bit busier this time around.

  The most interesting thing (IMO) this time around is some beginning
  infrastructural work to allow documents to be written using
  restructured text.  Maybe someday, in a galaxy far far away, we'll be
  able to eliminate the DocBook dependency and have a much better
  integrated set of kernel docs.  Someday.

  Beyond that, there's a new document on security hardening from Kees,
  the movement of some sample code over to samples/, a number of
  improvements to the serial docs from Geert, and the usual collection
  of corrections, typo fixes, etc"

* tag 'docs-for-linus' of git://git.lwn.net/linux: (55 commits)
  doc: self-protection: provide initial details
  serial: doc: Use port->state instead of info
  serial: doc: Always refer to tty_port->mutex
  Documentation: vm: Spelling s/paltform/platform/g
  Documentation/memcg: update kmem limit doc as codes behavior
  docproc: print a comment about autogeneration for rst output
  docproc: add support for reStructuredText format via --rst option
  docproc: abstract terminating lines at first space
  docproc: abstract docproc directive detection
  docproc: reduce unnecessary indentation
  docproc: add variables for subcommand and filename
  kernel-doc: use rst C domain directives and references for types
  kernel-doc: produce RestructuredText output
  kernel-doc: rewrite usage description, remove duplicated comments
  Doc: correct the location of sysrq.c
  Documentation: fix common spelling mistakes
  samples: v4l: from Documentation to samples directory
  samples: connector: from Documentation to samples directory
  Documentation: xillybus: fix spelling mistake
  Documentation: x86: fix spelling mistakes
  ...
2016-05-19 18:07:25 -07:00
..
bttv Documentation: fix common spelling mistakes 2016-04-28 07:51:59 -06:00
cx88
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] update cx23885 and em28xx cardlists 2016-05-09 14:06:09 -03:00
CARDLIST.em28xx [media] em28xx: add support for Hauppauge WinTV-dualHD DVB tuner 2016-05-09 14:25:39 -03:00
CARDLIST.ivtv
CARDLIST.saa7134 [media] saa7134: Add support for Snazio TvPVR PRO 2016-03-03 09:03:48 -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
lifeview.txt
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 Documentation: fix common spelling mistakes 2016-04-28 07:51:59 -06:00
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] v4l2-ctrls: remove unclaimed v4l2_ctrl_add_ctrl() interface 2016-02-10 09:34:00 -02:00
v4l2-framework.txt [media] samples: v4l: from Documentation to samples directory 2016-05-09 18:34:37 -03:00
videobuf [media] v4l: Documentation: change path of video drivers 2012-09-25 08:41:30 -03:00
vivid.txt [media] Documentation: video4linux: fix spelling mistakes 2016-04-25 09:11:52 -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]