mirror of https://github.com/tLDP/LDP
2799 lines
98 KiB
Plaintext
2799 lines
98 KiB
Plaintext
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <article>
|
|
|
|
<!-- - - - - - - - - - - - - H e a d e r - - - - - - - - - - - - - - -->
|
|
|
|
<artheader>
|
|
|
|
<!-- - - - - - - - - - - - - T i t l e - - - - - - - - - - - - - - -->
|
|
|
|
<title>The BTTV HOWTO</title> <author><firstname>Howard</firstname>
|
|
<surname>Shane</surname> <affiliation>
|
|
<address>
|
|
<email>hshane[AT]austin.rr.com</email>
|
|
</address>
|
|
</affiliation>
|
|
</author>
|
|
|
|
|
|
<!-- - - - - - - - - - - R e v i s i o n H i s t o r y - - - - -
|
|
- -->
|
|
|
|
|
|
<revhistory>
|
|
|
|
<revision>
|
|
<revnumber>0.9</revnumber>
|
|
<date>2005-01-29</date> <authorinitials>jhs</authorinitials>
|
|
<revremark>Initial rewrite</revremark>
|
|
</revision>
|
|
|
|
</revhistory>
|
|
|
|
|
|
<!-- - - - - - - - - - - - - A b s t r a c t - - - - - - - - - - - -
|
|
- -->
|
|
|
|
|
|
<abstract>
|
|
<indexterm> <primary>Bttv</primary> <secondary>Video</secondary> </indexterm>
|
|
|
|
|
|
<para> This document was written to assist the reader in the steps
|
|
necessary to configure and use a video tuner card based on the popular
|
|
Bt848 and Bt878 chipsets within the Linux operating system.
|
|
</para>
|
|
|
|
</abstract>
|
|
|
|
</artheader>
|
|
|
|
|
|
<!-- - - - - - - - - - H e a d e r E n d - - - - - - - - - - - - -
|
|
- --> <!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - -
|
|
- - - - - -->
|
|
|
|
|
|
<sect1 id="intro"> <title>Introduction</title>
|
|
<indexterm><primary>>disk!introduction</primary></indexterm>
|
|
|
|
<para> This document was written to assist the reader in setting up and
|
|
configuring TV tuner cards based on the Bt848 or Bt878 chipsets in the Linux
|
|
operating system.
|
|
|
|
It outlines how to enable the necessary kernel and/or software support and
|
|
various television applications and software methods of capture usable with your device.
|
|
|
|
While there is some attempt to catalog individual cards and features in <xref linkend="mfgr">,
|
|
the ultimate best source of information about your card and its capabilities will be
|
|
found in the printed manual that came with your device or the manufacturer's website.</para>
|
|
|
|
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
|
|
|
|
<sect2 id="copyright"> <title>Copyright Information</title>
|
|
|
|
<para>
|
|
This document is Copyright 2005, by Howard Shane.
|
|
</para>
|
|
|
|
<para> Permission is granted to copy, distribute, and/or modify this
|
|
document under the terms of the GNU Free Documentation License, Version
|
|
1.2 or any later version published by the Free Software Foundation with
|
|
no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
|
|
|
|
A copy of the license can be found in <xref linkend="appendix">. </para>
|
|
|
|
</sect2>
|
|
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
|
|
|
|
<sect2 id="disclaimer"> <title>Disclaimer</title>
|
|
|
|
<para> No liability for the contents of this document can be accepted.
|
|
|
|
Use the concepts, examples and other content entirely at your own risk.
|
|
|
|
There may be technical or other inaccuracies
|
|
that may result in the loss of irreplaceable data.
|
|
|
|
In any case, proceed with caution, and realize that although errors
|
|
are unlikely, the author can accept no responsibility for them.
|
|
</para>
|
|
|
|
<para> All copyrights are held by their respective owners, unless
|
|
specifically noted otherwise.
|
|
|
|
Use of a term in this document should not be regarded as affecting the
|
|
validity of any trademark or service mark. </para>
|
|
|
|
<para> Naming of particular products or brands should not be seen as
|
|
endorsements. </para>
|
|
|
|
</sect2>
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
|
|
<sect2 id="newversions">
|
|
|
|
<title>New Versions</title>
|
|
|
|
<indexterm>
|
|
<primary>(your index root)!news on</primary>
|
|
</indexterm>
|
|
|
|
<para> This is the first release of the initial rewrite. </para>
|
|
|
|
<para> The latest version number of this document can be found <ulink
|
|
url="http://www.tldp.org/HOWTO/BTTV.html">here</ulink>. </para>
|
|
|
|
|
|
</sect2>
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
|
|
|
|
<sect2 id="credits"> <title>Credits</title>
|
|
|
|
<para>
|
|
Eric Sandeen deserves profuse thanks for writing the original Bttv-HOWTO
|
|
and allowing me to assume its maintenance. Thanks also to Greg Watson for
|
|
use of the script in <xref linkend="recording"></para>
|
|
|
|
<para> Also, I would like to thank Marla, without whose encouragement
|
|
this project would not have been possible.</para>
|
|
|
|
</sect2>
|
|
<sect2 id="feedback"> <title>Feedback</title> <para> Please send any
|
|
information you may feel important to the following email
|
|
address: <email>hshane[AT]austin.rr.com</email>, whether you have a
|
|
correction, addition or update. I welcome suggestions on how to improve
|
|
this document. </para> </sect2>
|
|
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
|
|
|
|
<sect2 id="conventions"> <title>Conventions Used in this Document</title>
|
|
|
|
<para> The following conventions are used in this document and are
|
|
outlined here for those who may not yet have a complete understanding
|
|
of how to access and control the underlying operating system in Linux,
|
|
which is usually via the Bash shell. </para>
|
|
|
|
<para> First, filenames are referenced in a paragraph like so:
|
|
<filename>/path/file</filename> </para>
|
|
|
|
<para> Commands in Linux are executed (or 'called') at the command prompt,
|
|
otherwise known as the 'command line.'
|
|
|
|
If you are in the non-graphical (text-based) environment, you will usually
|
|
be presented with the Bash shell prompt which is a dollar sign: </para>
|
|
|
|
<para>
|
|
<screen>
|
|
$</screen>
|
|
</para>
|
|
|
|
<para>
|
|
...or the hash mark:
|
|
</para>
|
|
|
|
<para>
|
|
<screen>
|
|
#</screen>
|
|
</para>
|
|
|
|
<para> ...if you have logged in as root or have otherwise acquired root, or
|
|
'superuser' privileges.
|
|
|
|
You can also access the Bash shell in the X window
|
|
system, otherwise known as X or X11, with an <ulink
|
|
url="http://invisible-island.net/xterm/">xterm</ulink> or similar
|
|
X-terminal-emulator.
|
|
|
|
Commands to be performed at the Bash prompt, but referenced in a paragraph
|
|
of this document, usually look like this: <command>do this now</command>
|
|
</para>
|
|
<para> Commands and/or the resulting output of commands may also be
|
|
outlined with screen output in their own paragraph or heading: </para>
|
|
|
|
<para>
|
|
<screen>
|
|
$ date
|
|
Sun Jul 27 22:37:11 CDT 2003</screen> </para>
|
|
|
|
<para>
|
|
When a command is written in front of the Bash prompt (e.g.,
|
|
<command>$ date</command> above), it is assumed the [Return]
|
|
or [Enter] key has been pressed after the command, possibly
|
|
followed by the output on a new line as shown in the preceding example.</para>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<sect1 id="hardware">
|
|
<title>The BTTV Hardware</title>
|
|
|
|
<sect2 id="about">
|
|
<title>Bttv Basics</title>
|
|
<para>
|
|
If you haven't figured it out by now, this document deals with the Linux-specific
|
|
configuration of frame grabber cards that include the
|
|
<ulink url="http://www.conexant.com">Conexant</ulink> Bt848 and related family
|
|
of video decoder chips, collectively referred to as the <quote>Bt8x8</quote> chipset.
|
|
You can probably see the Bt8x8 chip (it's usually labelled as such) embedded on your
|
|
TV card upon inspection, in addition to other chips which you should probably make note of
|
|
before installation in case there are problems later.
|
|
The <quote>Bt</quote> stands for Brooktree, after the original manufacturer of
|
|
the chipset, now a part of Conexant. The Bt8x8 family has enjoyed remarkable longevity in a world where
|
|
<ulink url="http://en.wikipedia.org/wiki/Moore%27s_law">Moore's Law</ulink> is the rule,
|
|
the first ISA boards manufactured in the mid-1990s. There are several chips in this family, including the Bt848,
|
|
Bt848A, Bt849, Bt878 and Bt879, and as a rule are all supported by the
|
|
<ulink url="http://linux.bytesex.org/v4l2/bttv.html">BTTV driver</ulink> for which
|
|
this document is named.</para>
|
|
|
|
<para>In addition to the Bt8x8 decoder chip, these cards vary by accompanying components such as the tuner and sound decoder, and may include an optional videotext decoder, radio tuner, and/or hardware mpeg encoder.</para>
|
|
|
|
<para>Note that the next generation of bt8x8, the
|
|
<ulink url="http://linux.bytesex.org/v4l2/cx88.html">
|
|
Conexant 2388x</ulink>, is now supported by a driver in the Linux 2.6 kernel. The configuration
|
|
of hardware with that chipset is beyond the scope of this document (but similar).</para>
|
|
|
|
<para>In general, any PCI card with a Bt8x8 chipset should work with the Linux Bttv driver.
|
|
TV cards known NOT to work include the following:</para>
|
|
<para>
|
|
<itemizedlist spacing=compact>
|
|
<listitem><para>Cards with a Zoran 36057/36067 PCI controller chipset, which are instead
|
|
supported by <ulink url= "http://mjpeg.sf.net/driver-zoran/">this driver</ulink>,
|
|
and includes the following models:</para>
|
|
<itemizedlist spacing=compact>
|
|
<listitem><para>Iomega Buz</para></listitem>
|
|
<listitem><para>Pinnacle DC10+</para></listitem>
|
|
<listitem><para>Linux Media Labs LML33</para></listitem>
|
|
</itemizedlist></listitem>
|
|
<listitem><para>Cards with a Philips SAA7130/7134 controller</para></listitem>
|
|
<listitem><para>Multimedia eXtension Board cards, manufactured by Siemens-Nixdorf</para></listitem>
|
|
<listitem><para>Hexium HV-PCI6, Orion or Gemini framegrabber cards</para></listitem>
|
|
<listitem><para>Any ISA-based TV card</para></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
|
|
<para>If you are uncertain which chipset your TV card has, use the <command>lspci</command> command.
|
|
An example of such output for a Bt8x8 card might look similar to the following:</para>
|
|
<screen>
|
|
0000:02:0a.0 Multimedia video controller: Brooktree Corporation Bt878 Video
|
|
Capture (rev 02)
|
|
0000:02:0a.1 Multimedia controller: Brooktree Corporation Bt878 Audio Capture
|
|
(rev 02)
|
|
</screen>
|
|
<para>A list of hardware (mostly PCI cards) compatible with the Bttv driver is found in <xref linkend="cards"></para>
|
|
</sect2>
|
|
<sect2 id="soundconn">
|
|
<title>The Sound Output</title>
|
|
<para>
|
|
Your card may have come with a short external audio connector with two male ends.
|
|
This is for connecting your Bttv audio out to your sound card's input jack so you
|
|
won't require an extra set of speakers. Some cards may also have a 4-pin socket for
|
|
output of your Bt8x8 audio signals directly to your sound card within your computer
|
|
case. You can connect this to your "CDROM" input with reasonable certainty that you
|
|
will be able to control the input with your mixer from your primary sound card as
|
|
well as record (see <xref linkend="recording"> for more information on recording).
|
|
Alternatively you can use external speakers connected to the line out of your Bt8x8 card.
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
<sect1 id="hw">
|
|
<title>Enabling Support for Your Bt8x8 Hardware in Linux</title>
|
|
|
|
<sect2 id="driver-intro">
|
|
<title>The Bttv Driver</title>
|
|
<para>
|
|
Drivers for Bt8x8-based hardware have been a part of the <ulink url="http://www.kernel.org/">Linux</ulink>
|
|
<ulink url="http://en.wikipedia.org/wiki/Kernel_%28computer_science%29">kernel</ulink> since version 2.2.0,
|
|
and are likely to be already enabled in your running kernel if you have not recompiled or
|
|
otherwise replaced your system's stock kernel with a custom version. If unavailable, Bt8x8 support can
|
|
be enabled two ways:
|
|
</para>
|
|
<para>
|
|
<itemizedlist>
|
|
<listitem><para>by recompiling your kernel using the source code using
|
|
downloaded kernel-source from your distribution or fetched directly from
|
|
<ulink url="http://www.kernel.org">the kernel source repository</ulink></para></listitem>
|
|
<listitem><para>the Bttv driver can be fetched directly from <ulink url="http://bytesex.org/bttv.html">
|
|
the Bttv home page</ulink> and then patching your available kernel source, which
|
|
should only be necessary if you have a kernel version prior to 2.2.0 or later than 2.0.35;
|
|
earlier versions are not likely to work.</para></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
<sect3 id="kernel-modules">
|
|
<title>Module or In-Kernel?</title>
|
|
<para>
|
|
It is likely the stock kernel that was installed on your Linux system, if unmodified, already
|
|
supports Bt8x8-based hardware. The driver will exist either as a
|
|
loadable module or within the already running kernel. An easy way to tell is to use the
|
|
<command>dmesg</command> command piped into <command>less</command> (for easy viewing)
|
|
to look for an acknowledgement that the
|
|
driver in question was loaded when your system started up:</para>
|
|
|
|
<para>
|
|
<screen>
|
|
$ dmesg | less
|
|
</screen>
|
|
</para>
|
|
<para>
|
|
...which may yield something like the following, depending on your exact Bt8x8
|
|
chipset features and kernel version (in this case, 2.6):
|
|
</para>
|
|
<para>
|
|
<screen>
|
|
Jan 26 19:40:04 localhost kernel: bttv: driver version 0.9.15 loaded
|
|
Jan 26 19:40:04 localhost kernel: bttv: using 8 buffers with 2080k
|
|
(520 pages) each for capture
|
|
Jan 26 19:40:04 localhost kernel: bttv: Bt8xx card found (0).
|
|
Jan 26 19:40:04 localhost kernel: ACPI: PCI interrupt 0000:02:09.0[A] ->
|
|
GSI 17 (level, low) -> IRQ 17
|
|
Jan 26 19:40:04 localhost kernel: bttv0: Bt878 (rev 2) at 0000:02:09.0,
|
|
irq: 17, latency: 32, mmio: 0xe7000000
|
|
Jan 26 19:40:04 localhost kernel: bttv0: detected: Hauppauge WinTV
|
|
[card=10], PCI subsystem ID is 0070:13eb
|
|
Jan 26 19:40:04 localhost kernel: bttv0: using: Hauppauge (bt878) [card=10,
|
|
autodetected]
|
|
Jan 26 19:40:04 localhost kernel: bttv0: using tuner=2
|
|
Jan 26 19:40:04 localhost kernel: tuner: chip found at addr 0xc2 i2c-bus
|
|
bt878 #0 [sw]
|
|
Jan 26 19:40:04 localhost kernel: tuner: type set to 2 (Philips NTSC
|
|
(FI1236, FM1236 and compatibles)) by bt878 #0 [sw]
|
|
</screen>
|
|
</para>
|
|
<para>
|
|
If you don't see it, the particular driver module you are interested in may
|
|
be available but not necessarily loaded at that time. If you know what the module is named,
|
|
try using <filename>find</filename>; in this example we are looking for the 'bttv' module:</para>
|
|
<screen>
|
|
$ find /lib/modules -name bttv.o
|
|
</screen>
|
|
<para>Note that up until the 2.4 series modules had the suffix <filename>.o
|
|
</filename>; for 2.6+ series kernels this was replaced with <filename>.ko</filename>.</para>
|
|
<para>
|
|
You can get a list of all modules available by typing the following at the command line:</para>
|
|
<para>
|
|
<screen>
|
|
$ ls -R /lib/modules/`uname -r`/kernel </screen>
|
|
</para>
|
|
|
|
<para> Where <command>`uname -r`</command>, surrounded by forward tick marks, is your kernel version number.
|
|
|
|
The following output is an example of what you might find in a Bttv-ready kernel, where everything is
|
|
loaded as a module (edited for brevity):</para>
|
|
|
|
<para>
|
|
<screen>
|
|
/lib/modules/2.6.8/kernel/drivers/media/video:
|
|
btcx-risc.ko ir-kbd-i2c.ko tda9875.ko tvaudio.ko video-buf.ko
|
|
bttv.ko msp3400.ko tda9887.ko v4l1-compat.ko videodev.ko
|
|
ir-kbd-gpio.ko tda7432.ko tuner.ko v4l2-common.ko
|
|
</screen>
|
|
</para>
|
|
<para>
|
|
Again, your output may vary by the currently running kernel capabilities.
|
|
</para>
|
|
<para>
|
|
Once you know which module your hardware needs you can find out if it is already loaded
|
|
by typing at the command line or in a terminal window:
|
|
</para>
|
|
<para>
|
|
<screen>
|
|
# lsmod
|
|
</screen></para>
|
|
|
|
<para> As shown by the prompt above, you will need to have root privileges
|
|
to do this.
|
|
|
|
You should get output similar to, but not necessarily limited to the following:</para>
|
|
<para>
|
|
<screen>
|
|
snd_bt87x 11400 0
|
|
tuner 18832 0
|
|
tvaudio 20428 0
|
|
msp3400 22100 0
|
|
bttv 145804 0
|
|
video_buf 17476 1 bttv
|
|
i2c_algo_bit 8904 1 bttv
|
|
v4l2_common 4928 1 bttv
|
|
videodev 7232 2 quickcam,bttv
|
|
</screen>
|
|
</para>
|
|
<para> Most stock kernels are compiled with <filename>kmod</filename>,
|
|
which enables automatic loading of necessary modules when the appropriate
|
|
hardware is detected. It may not always do so, however, so if you don't
|
|
have the particular module you're seeking loaded and
|
|
you think the module may be available, try loading
|
|
it manually with <command>modprobe</command>, as in the
|
|
following example (using the <filename>bttv</filename> module):</para>
|
|
|
|
<para>
|
|
<screen>
|
|
# modprobe -v bttv
|
|
</screen>
|
|
</para>
|
|
</sect3>
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="recompile">
|
|
<title>No Bttv module or in-kernel support found?</title>
|
|
|
|
<para>If your running kernel or precompiled distribution kernel inexplicably
|
|
doesn't have Bt8x8 support enabled or available, your can always acquire new
|
|
kernel source code from the Linux <ulink url="http://www.kernel.org">
|
|
kernel.org</ulink> source code repository. If you are unfamiliar with the
|
|
prerequisites and procedure of compiling your own kernel, I direct you to the <ulink
|
|
url="http://www.tldp.org/HOWTO/Kernel-HOWTO.html">Kernel HOWTO</ulink>
|
|
for more information. </para>
|
|
<para>
|
|
If you do recompile, the Bttv driver itself will obviously need to be enabled,
|
|
and is found in the heading entitled "Multimedia Devices" -> "Video for Linux"
|
|
in the 2.4 and earlier kernels in menuconfig or xconfig, or alternatively in
|
|
"Device Drivers" -> "Multimedia Devices" -> "Video for Linux" -> "BT848 Video
|
|
For Linux" in the 2.6+ series.
|
|
</para>
|
|
<note><para>You will need <filename>i2c</filename> subsystem support
|
|
enabled as well as <filename>i2c-algo-bit</filename>.</para></note>
|
|
|
|
<para>Device support (<filename>i2c-dev</filename>) is not required for Bt8x8
|
|
support. Earlier than kernel version 2.3.34 i2c is not present in the kernel
|
|
source and a patch must be fetched and applied to your source, found at the
|
|
<ulink url="http://secure.netroedge.com/~lm78/download.html">lm_sensors homepage</ulink>.
|
|
</para>
|
|
<para>
|
|
If you are running a 2.4 series kernel, <command>btaudio</command>
|
|
in the OSS "Sound" category is optional if you want to use external speakers
|
|
attached to the card's audio out jack, and either (or both) OSS or
|
|
ALSA sound system btaudio drivers in the 2.6+ series.
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 id="tuning">
|
|
<title>Configuration Requirements for Use of your Bttv Hardware</title>
|
|
<para>
|
|
Once you know your kernel is enabled you can proceed to some minor tuning that
|
|
may already be done for you depending on your system and distributor and
|
|
distribution features.</para>
|
|
|
|
<sect3 id="dev">
|
|
<title>Device Files</title>
|
|
<para>
|
|
If you are using
|
|
<ulink url="http://www.atnf.csiro.au/people/rgooch/linux/docs/devfs.html">
|
|
Device Filesystem</ulink> (devfs) or
|
|
<ulink url="http://www.kernel.org/pub/linux/utils/kernel/hotplug/udev.html">
|
|
udev</ulink> your work in this respect may be done for you dynamically, but
|
|
at the same time the devices may not exist until they are recognized by the
|
|
kernel (i.e., the necessary modules loaded), so be sure you have taken care
|
|
of the previously outlined prerequisites first.
|
|
</para>
|
|
<para>The Linux kernel requires a virtual device node be created to access
|
|
and control a particular piece of hardware. This node may have already been
|
|
created for you automatically; <command>ls -l /dev/video*</command> (with an
|
|
asterisk) or alternatively <command>find /dev -name video*</command> or even
|
|
visual inspection of the <filename>/dev</filename> directory with your
|
|
favorite file manager can give you an idea if the video devices exist. If
|
|
so you can proceed to <xref linkend="permissions">; if not you will need to
|
|
create them manually.</para>
|
|
|
|
<para>An easy way to create them, if available with your Linux distribution,
|
|
is use of the <filename>MAKEDEV</filename> script, which may be located in
|
|
<filename>/dev</filename> or the usual places for storing executable commands
|
|
(<filename>/bin</filename>,<filename>/sbin</filename> and so on). The manual
|
|
page for <filename>MAKEDEV</filename> (<command>man MAKEDEV</command>) can
|
|
guide you further, but be aware of the device-specific command options. If
|
|
<filename>MAKEDEV</filename> doesn't work or doesn't exist, or you just prefer
|
|
doing things the hard way, move on to the next paragraph.
|
|
</para>
|
|
|
|
<para>
|
|
A device can be created as a block (such as a drive), a FIFO
|
|
(file-in-file-out or pipe, as in xconsole) or a character device, which
|
|
represents other hardware.
|
|
|
|
Each device has a major and a minor number <quote>coordinate</quote>
|
|
to tell the kernel what it is and where to access it.
|
|
|
|
These numbers are not arbitrary. The major number 81 with minor number 0, 1,
|
|
2, and so on are by convention assigned to Video4linux devices, including TV
|
|
tuner boards and webcams. In order to create the video device
|
|
<filename>/dev/video0</filename>, use <command>mknod</command> at the command
|
|
line:
|
|
</para>
|
|
<para>
|
|
<screen>
|
|
# mknod /dev/video0 c 81 0
|
|
</screen>
|
|
</para>
|
|
<para>
|
|
where <command>c</command> represents a character device.</para>
|
|
|
|
<para>
|
|
|
|
You can use the following script, which I
|
|
have borrowed from the kernel source (located in
|
|
<filename>linux/Documentation/video4linux/bttv/MAKEDEV</filename> of
|
|
the source tree):</para>
|
|
|
|
<para>
|
|
<screen>
|
|
#!/bin/bash
|
|
function makedev () {
|
|
for dev in 0 1 2 3; do echo "/dev/$1$dev:
|
|
char 81 $[ $2 + $dev ]" rm -f /dev/$1$dev
|
|
mknod /dev/$1$dev c 81 $[ $2 + $dev ] chmod
|
|
666 /dev/$1$dev
|
|
done
|
|
|
|
# symlink for default device
|
|
rm -f /dev/$1 ln -s /dev/${1}0 /dev/$1
|
|
}
|
|
|
|
# see http://roadrunner.swansea.uk.linux.org/v4lapi.shtml
|
|
echo "*** new device names ***" makedev video
|
|
0 makedev radio 64 makedev vtx 192 makedev vbi 224
|
|
# "*** old device names (for compatibility only) ***"
|
|
#makedev bttv 0 #makedev bttv-fm 64 #makedev bttv-vbi 224
|
|
</screen>
|
|
</para>
|
|
|
|
<para> Simply copy and paste the above into your favorite editing program,
|
|
save it as MAKEDEV or whatever name you like, make it executable
|
|
(i.e., <command>chmod u+x MAKEDEV</command>), and then execute it as root: </para>
|
|
|
|
<para>
|
|
|
|
<screen>
|
|
# ./MAKEDEV
|
|
</screen>
|
|
</para>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="permissions">
|
|
|
|
<title>Groups and Permissions</title>
|
|
|
|
<para> It is a good idea to be sure that your user account can access
|
|
the device once all modules are loaded and device nodes created.
|
|
|
|
The most security-conscious way to do that is to add access for a
|
|
particular group.
|
|
|
|
On my system, the members of the group 'video' are allowed to use the
|
|
webcam, scanner and other photographic devices.
|
|
|
|
The way to accomplish this is to first change the ownership of the
|
|
devices in <filename>/dev</filename> like so (as root): </para>
|
|
|
|
<para>
|
|
<screen>
|
|
# chown root.video /dev/usb/video*
|
|
</screen>
|
|
</para>
|
|
|
|
<para> ...where <command>root.video</command> are the owner and group
|
|
the device will now belong to.
|
|
|
|
Obviously, the specific command will vary by your system and the type
|
|
of device.
|
|
|
|
It is important that you change the ownership of the device node itself
|
|
and not the symlink; symlinks' ownerships are affected only by changing
|
|
the parent devices or files they point to. </para>
|
|
|
|
<para> To see if your user account is a member of the group in question,
|
|
as root issue the following command:
|
|
|
|
<screen>
|
|
# grep -e video /etc/group</screen>
|
|
|
|
You should see something like the following:</para>
|
|
|
|
<para>
|
|
<screen>
|
|
video:x:44:
|
|
</screen>
|
|
</para>
|
|
|
|
<para> ...where '44' is the group number.
|
|
|
|
Since no members follow the last colon in the 'video' group, we can add
|
|
them, let's say user 'jhs' with the command</para>
|
|
|
|
<para>
|
|
<screen>
|
|
# adduser jhs video
|
|
</screen>
|
|
</para>
|
|
|
|
<para> After this, it's simply a matter of allowing read and write access
|
|
for the user in question of the device like so: </para>
|
|
|
|
<para>
|
|
<screen>
|
|
# chmod g+rw /dev/v4l/video0
|
|
</screen>
|
|
</para>
|
|
|
|
<para> ...where <command>g+rw</command> means add <command>r</command>ead
|
|
and <command>w</command>rite access for <command>g</command>roup.
|
|
|
|
See the documentation for chmod (<command>man chmod</command> or
|
|
<command>info chmod</command>) for further info.</para>
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<!-- - - - - - - - - - - S e c t i o n B r e a k - - - - - - - - - -
|
|
- -->
|
|
|
|
|
|
<sect1 id="modprobe">
|
|
<title>Loading the Modules</title><para>
|
|
This section is only for those whose modules don't load automatically and/or
|
|
correctly. For a complete list of options by module, see <xref linkend="options">.</para>
|
|
<sect2 id="btmod">
|
|
<title>The Bttv Module</title>
|
|
|
|
<para>
|
|
Once your card is installed, you can load the bttv module if your kernel
|
|
hasn't already done it for you. Using the
|
|
<command>modprobe</command> command as root, type
|
|
|
|
<screen>
|
|
# modprobe bttv</screen>
|
|
|
|
The modules <filename>videodev</filename> and <filename>i2c</filename> may be
|
|
required prior to this if you are running a pre-2.4 series kernel. By default,
|
|
the <command>bttv</command> will try to autodetect your card type; you can inspect <command>/var/log/messages</command> to see what it finds. If it doesn't
|
|
autodetect properly,
|
|
you can add the <command>card=#</command> option to the end of the previous command
|
|
to force a your particular card type, a list of which are found in <xref linkend="cards">
|
|
or on your system in
|
|
<ulink url="file:///usr/src/linux/Documentation/video4linux/bttv/Cards">your
|
|
kernel source Documentation</ulink> if installed in the usual place
|
|
(<filename>/usr/src/linux</filename>. If you get in trouble and need
|
|
to remove the module, you can use <command>rmmod</command>:
|
|
<screen>
|
|
$ rmmod bttv</screen>
|
|
You can then reload the module with the appropriate options.</para>
|
|
</sect2>
|
|
<sect2 id="tunmod">
|
|
<title>The Tuner Module</title>
|
|
|
|
<para>
|
|
If necessary, load the tuner module, with
|
|
<screen>
|
|
# modprobe tuner
|
|
</screen>
|
|
If the tuner is not correctly identified you may need to supply the
|
|
magic number for tuner-type:
|
|
<screen>
|
|
# modprobe tuner type=#
|
|
</screen>
|
|
</para>
|
|
<para>
|
|
You may need to dig into your case to see which tuner you have if you can't
|
|
find the maker and model in the printed specifications that came with your
|
|
hardware, or if this information is otherwise unavailable. It should be marked
|
|
with the brand name and may support one or more of the three major broadcast
|
|
standards in use in the world, whether
|
|
<ulink url="http://en.wikipedia.org/wiki/NTSC">NTSC</ulink>,
|
|
<ulink url="http://en.wikipedia.org/wiki/PAL">PAL</ulink> or
|
|
<ulink url="http://en.wikipedia.org/wiki/SECAM">SECAM</ulink>. In general,
|
|
chipsets manufactured for the US market are NTSC; for Europe, PAL, and Asia
|
|
PAL or SECAM. Some countries support more than one standard.
|
|
</para>
|
|
<para>
|
|
Once you have identified your tuner, select the value of <command>n</command> from
|
|
the following list:
|
|
</para>
|
|
<para>
|
|
<literallayout>
|
|
<command>tuner=</command><emphasis>n</emphasis> <command>type of tuner chip</command>
|
|
--------------------------------------------------------------
|
|
|
|
<command>tuner=0</command> Temic PAL (4002 FH5)
|
|
<command>tuner=1</command> Philips PAL_I (FI1246 and compatibles)
|
|
<command>tuner=2</command> Philips NTSC (FI1236,FM1236 and compatibles)
|
|
<command>tuner=3</command> Philips (SECAM+PAL_BG) (FI1216MF, FM1216MF, FR1216MF)
|
|
<command>tuner=4</command> NoTuner
|
|
<command>tuner=5</command> Philips PAL_BG (FI1216 and compatibles)
|
|
<command>tuner=6</command> Temic NTSC (4032 FY5)
|
|
<command>tuner=7</command> Temic PAL_I (4062 FY5)
|
|
<command>tuner=8</command> Temic NTSC (4036 FY5)
|
|
<command>tuner=9</command> Alps HSBH1
|
|
<command>tuner=10</command> Alps TSBE1
|
|
<command>tuner=11</command> Alps TSBB5
|
|
<command>tuner=12</command> Alps TSBE5
|
|
<command>tuner=13</command> Alps TSBC5
|
|
<command>tuner=14</command> Temic PAL_BG (4006FH5)
|
|
<command>tuner=15</command> Alps TSCH6
|
|
<command>tuner=16</command> Temic PAL_DK (4016 FY5)
|
|
<command>tuner=17</command> Philips NTSC_M (MK2)
|
|
<command>tuner=18</command> Temic PAL_I (4066 FY5)
|
|
<command>tuner=19</command> Temic PAL* auto (4006 FN5)
|
|
<command>tuner=20</command> Temic PAL_BG (4009 FR5) or PAL_I (4069 FR5)
|
|
<command>tuner=21</command> Temic NTSC (4039 FR5)
|
|
<command>tuner=22</command> Temic PAL/SECAM multi (4046 FM5)
|
|
<command>tuner=23</command> Philips PAL_DK (FI1256 and compatibles)
|
|
<command>tuner=24</command> Philips PAL/SECAM multi (FQ1216ME)
|
|
<command>tuner=25</command> LG PAL_I+FM (TAPC-I001D)
|
|
<command>tuner=26</command> LG PAL_I (TAPC-I701D)
|
|
<command>tuner=27</command> LG NTSC+FM (TPI8NSR01F)
|
|
<command>tuner=28</command> LG PAL_BG+FM (TPI8PSB01D)
|
|
<command>tuner=29</command> LG PAL_BG (TPI8PSB11D)
|
|
<command>tuner=30</command> Temic PAL* auto + FM (4009 FN5)
|
|
<command>tuner=31</command> SHARP NTSC_JP (2U5JF5540)
|
|
<command>tuner=32</command> Samsung PAL TCPM9091PD27
|
|
<command>tuner=33</command> MT20xx universal
|
|
<command>tuner=34</command> Temic PAL_BG (4106 FH5)
|
|
<command>tuner=35</command> Temic PAL_DK/SECAM_L (4012 FY5)
|
|
<command>tuner=36</command> Temic NTSC (4136 FY5)
|
|
<command>tuner=37</command> LG PAL (newer TAPC series)
|
|
<command>tuner=38</command> Philips PAL/SECAM multi (FM1216ME MK3)
|
|
<command>tuner=39</command> LG NTSC (newer TAPC series)
|
|
<command>tuner=40</command> HITACHI V7-J180AT
|
|
<command>tuner=41</command> Philips PAL_MK (FI1216 MK)
|
|
<command>tuner=42</command> Philips 1236D ATSC/NTSC
|
|
<command>tuner=43</command> Philips NTSC MK3 (FM1236MK3 or FM1236/F)
|
|
<command>tuner=44</command> Philips 4 in 1 (ATI TV Wonder Pro/Conexant)
|
|
<command>tuner=45</command> Microtune 4049 FM5
|
|
</literallayout>
|
|
</para>
|
|
</sect2>
|
|
<sect2 id="snd"><title>Other Modules</title>
|
|
<para>Don't forget to load any other modules you may need, including
|
|
<command>btaudio</command> if you plan on recording or capturing audio to
|
|
another application.
|
|
</para>
|
|
</sect2>
|
|
|
|
<Sect2 id="auto"><title>Automating the Module Loading Process</title>
|
|
<para>
|
|
After you know which modules and options you need, you can automate the
|
|
process by putting the information into <filename>/etc/conf.modules</filename> or
|
|
<filename>/etc/modules.conf</filename>, depending on your distribution. Then,
|
|
running an application which needs the driver will cause it to be loaded
|
|
automatically with the appropriate options. The following is an example entry:
|
|
<screen>
|
|
# TV
|
|
alias char-major-81 bttv
|
|
pre-install bttv modprobe -k tuner; modprobe -k msp3400
|
|
options bttv radio=1 card=3
|
|
options tuner type=2
|
|
</screen>
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="apps"><title>Television Applications</title>
|
|
<para>
|
|
Now that your kernel is configured, your devices have been configured, and your
|
|
modules are inserted, you will also need an application to actually view or
|
|
capture the images from your card.
|
|
</para>
|
|
<sect2 id="console"><title>Console-Based Applications</title>
|
|
<sect3 id="fbtv"><title>FbTV</title>
|
|
<para>Fbtv is a console-only mode TV viewing program available for viewing on
|
|
a framebuffer-video enabled system with a Bt8x8 card. If you don't know what
|
|
a framebuffer is you can read the
|
|
<ulink url="http://tldp.org/HOWTO/Framebuffer-HOWTO.html">Framebuffer HOWTO
|
|
</ulink>. Fbtv is available from the Bttv homepage with
|
|
<ulink url="http://linux.bytesex.org/xawtv/">Xawtv</ulink>.
|
|
</para>
|
|
</sect3>
|
|
<sect3 id="aatv"><title>AATV</title>
|
|
<para><ulink url="http://n00n.free.fr/aatv/">AATV</ulink> is a simple program
|
|
to watch TV on a text console under Linux using aalib and a Bt8x8 card. While
|
|
the graphics are enabled in ascii graphics only, the advantage is that you
|
|
(or anyone) can watch television from anywhere over the internet using your
|
|
local Bt8x8 hardware.</para>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="gui"><title>GUI-based Applications</title>
|
|
<para>The following applications require a graphical user interface such as GNOME, KDE etc.
|
|
</para>
|
|
<sect3 id="xawtv"><title>Xawtv</title>
|
|
<para><ulink url="http://linux.bytesex.org/xawtv/">Xawtv</ulink> is arguably the best-known Linux application used for viewing TV from video sources including Bt8x8 devices; most Linux distributions have packaged
|
|
versions. If you're not sure of your device configuration you probably ought
|
|
to start with Xawtv and the <command>-hwscan</command>
|
|
option to check for suitable devices:
|
|
<screen>
|
|
$ xawtv -hwscan
|
|
This is xawtv-3.94, running on Linux/i686 (2.6.8)
|
|
looking for available devices
|
|
port 139-139
|
|
type : Xvideo, image scaler
|
|
name : NV17 Video Overlay
|
|
|
|
port 140-140
|
|
type : Xvideo, image scaler
|
|
name : NV17 Video Texture
|
|
|
|
port 141-172
|
|
type : Xvideo, image scaler
|
|
name : NV05 Video Blitter
|
|
|
|
port 173-173 [ -xvport 173 ]
|
|
type : Xvideo, video overlay
|
|
name : NVIDIA Video Interface Port
|
|
|
|
/dev/video0: OK [ -device /dev/video0 ]
|
|
type : v4l2
|
|
name : BT878 video (Hauppauge (bt878))
|
|
flags: overlay capture tuner
|
|
</screen>
|
|
Now that you know your Bt8x8 device is available, try starting Xawtv:
|
|
<screen>
|
|
$ xawtv -device /dev/video0
|
|
</screen>
|
|
Note that some Nvidia cards may confuse xawtv, so if you have one of these be
|
|
sure to use the <command>-device</command> switch as above.
|
|
</para>
|
|
</sect3>
|
|
<sect3 id="motv"><title>Motv</title>
|
|
<para>Motv is a Motif-based rewrite of Xawtv. Other than a more attractive
|
|
interface, and is also found at <ulink url="http://www.bytesex.org/">
|
|
the Xawtv homepage</ulink>. It is otherwise identical to Xawtv.</para>
|
|
</sect3>
|
|
<sect3 id="tvtime"><title>TVtime</title>
|
|
<para>TVtime is the ultimate application for those who want to watch TV using
|
|
an application that doesn't get in the way and requires little or no
|
|
configuration 'out of the box.' The homepage can be found at
|
|
<ulink url="http://tvtime.sourceforge.net/">the sourceforge TVtime homepage</ulink>.</para>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
|
|
|
|
<appendix id="options"><title>Optional Arguments for Loading Modules</title>
|
|
<literallayout>
|
|
|
|
<command>videodev.o</command>
|
|
-----------------------------
|
|
|
|
This is the basic video4linux module, all video
|
|
drivers (incl. bttv) register themselves here.
|
|
|
|
|
|
|
|
<command>i2c.o</command>
|
|
------------------------
|
|
|
|
The generic i2c module. It does much of the i2c bus
|
|
management, all other modules (except videodev.o)
|
|
use this one.
|
|
|
|
modprobe args:
|
|
<command>scan=1</command> scan the bus for i2c devices
|
|
<command>verbose=0</command> shut up i2c
|
|
<command>i2c_debug=1</command> for debugging, it sticks the
|
|
whole (software) i2c bus traffic to the syslog
|
|
|
|
|
|
<command>bttv.o</command>
|
|
-------------------------
|
|
|
|
The bt848 (grabber chip) driver.
|
|
|
|
modprobe args:
|
|
<command>remap=adr</command> remap Bt848 memory to address less than 20
|
|
<command>vidmem=base</command> frame buffer address over 20 (of
|
|
graphic card)
|
|
<command>triton1=0/1</command> for Triton1 compatibility; Triton1 is
|
|
automatically recognized but this might also help with other chipsets
|
|
<command>pll=0/1/2</command> pll settings (<command>0</command>: don't use PLL; <command>1</command>: 28 MHz crystal installed
|
|
<command>2</command>: 35 MHz crystal installed
|
|
<command>radio=0/1</command> card supports radio
|
|
<command>card=</command><emphasis>n</emphasis> card type: see the next section for the complete list;
|
|
remap, card, radio and pll accept up to four comma-separated arguments
|
|
(for multiple boards). The CARD and PLL defines from the Makefile
|
|
are used as defaults.
|
|
|
|
|
|
|
|
<command>msp3400.o</command>
|
|
----------------------------
|
|
|
|
The driver for the msp34xx sound processor chips. If you have a
|
|
stereo card, you probably want to modprobe this one.
|
|
|
|
modprobe args:
|
|
<command>debug=1/2</command> print some debug info to the syslog, 2 is more verbose.
|
|
|
|
|
|
|
|
<command>*tea6300.o</command>
|
|
-----------------------------
|
|
|
|
The driver for the tea6300 fader chip. If you have a stereo
|
|
card and the msp3400.o doesn't work, you might want to try this
|
|
one. This chip is seen on most STB TV/FM cards (usually from
|
|
Gateway OEM sold surplus on auction sites).
|
|
|
|
modprobe args:
|
|
<command>debug=1</command> print some debug info to the syslog.
|
|
|
|
|
|
|
|
<command>*tda8425.o</command>
|
|
-----------------------------
|
|
|
|
The driver for the tda8425 fader chip. This driver used to be
|
|
part of bttv.c, so if your sound used to work but does not
|
|
anymore, try loading this module.
|
|
|
|
modprobe args:
|
|
<command>debug=1</command> print some debug info to the syslog.
|
|
|
|
|
|
|
|
<command>*tda9855.o</command>
|
|
-----------------------------
|
|
|
|
The driver for the tda9855 stereo decoder / audio processor chip.
|
|
|
|
modprobe args:
|
|
<command>debug=1</command> print some debug info to the syslog.
|
|
|
|
|
|
|
|
<command>*dpl3518.o</command>
|
|
-----------------------------
|
|
|
|
Driver for the dpl3518a Dolby Pro Logic Processor.
|
|
|
|
modprobe args:
|
|
<command>debug=1</command> print some debug info to the syslog.
|
|
|
|
|
|
|
|
<command>tuner.o</command>
|
|
--------------------------
|
|
|
|
The tuner driver. You need this unless you want to use only
|
|
with a camera or external tuner.
|
|
|
|
modprobe args:
|
|
<command>debug=1</command> print some debug info to the syslog
|
|
<command>type=</command><emphasis>n</emphasis> type of the tuner chip. n as seen in <xref linkend="modprobe">
|
|
|
|
|
|
|
|
<command>i2c_chardev.o</command>
|
|
--------------------------------
|
|
|
|
Provides a character device for i2c bus access. Works for 2.1.x
|
|
only, not compiled by default.
|
|
|
|
</literallayout>
|
|
</appendix>
|
|
|
|
<appendix id="cards">
|
|
<title>Bt8x8 Cards by Number</title>
|
|
<para>These are the option numbers for cards for use with
|
|
<command>modprobe</command>.This does not boast to be a complete list by any
|
|
means; it is copied nearly verbatim from the kernel source documentation for
|
|
bttv. If your card is not listed it may or may not be supported depending on
|
|
the chipset and accompanying components with which it is constructed.</para>
|
|
<para>
|
|
<literallayout>
|
|
<command>card=</command><emphasis>n</emphasis> <command>card type</command>
|
|
-------------------------------------------------------
|
|
|
|
<command>card=0</command> UNKNOWN/GENERIC
|
|
<command>card=1</command> MIRO PCTV
|
|
<command>card=2</command> Hauppauge (bt848)
|
|
<command>card=3</command> STB, Gateway P/N 6000699 (bt848)
|
|
<command>card=4</command> Intel Create and Share PCI/ Smart Video Recorder III
|
|
<command>card=5</command> Diamond DTV2000
|
|
<command>card=6</command> AVerMedia TVPhone
|
|
<command>card=7</command> MATRIX-Vision MV-Delta
|
|
<command>card=8</command> Lifeview FlyVideo II (Bt848) LR26 / MAXI TV Video PCI2 LR26
|
|
<command>card=9</command> IMS/IXmicro TurboTV
|
|
<command>card=10</command> Hauppauge (bt878)
|
|
<command>card=11</command> MIRO PCTV pro
|
|
<command>card=12</command> ADS Technologies Channel Surfer TV (bt848)
|
|
<command>card=13</command> AVerMedia TVCapture 98
|
|
<command>card=14</command> Aimslab Video Highway Xtreme (VHX)
|
|
<command>card=15</command> Zoltrix TV-Max
|
|
<command>card=16</command> Prolink Pixelview PlayTV (bt878)
|
|
<command>card=17</command> Leadtek WinView 601
|
|
<command>card=18</command> AVEC Intercapture
|
|
<command>card=19</command> Lifeview FlyVideo II EZ /FlyKit LR38 Bt848 (capture only)
|
|
<command>card=20</command> CEI Raffles Card
|
|
<command>card=21</command> Lifeview FlyVideo 98/ Lucky Star Image World ConferenceTV LR50
|
|
<command>card=22</command> Askey CPH050/ Phoebe Tv Master + FM
|
|
<command>card=23</command> Modular Technology MM201/MM202/MM205/MM210/MM215 PCTV, bt878
|
|
<command>card=24</command> Askey CPH05X/06X (bt878) [many vendors]
|
|
<command>card=25</command> Terratec TerraTV+ Version 1.0 (Bt848)/ Terra TValue Version 1.0/ Vobis TV-Boostar
|
|
<command>card=26</command> Hauppauge WinCam newer (bt878)
|
|
<command>card=27</command> Lifeview FlyVideo 98/ MAXI TV Video PCI2 LR50
|
|
<command>card=28</command> Terratec TerraTV+ Version 1.1 (bt878)
|
|
<command>card=29</command> Imagenation PXC200
|
|
<command>card=30</command> Lifeview FlyVideo 98 LR50
|
|
<command>card=31</command> Formac iProTV, Formac ProTV I (bt848)
|
|
<command>card=32</command> Intel Create and Share PCI/ Smart Video Recorder III
|
|
<command>card=33</command> Terratec TerraTValue Version Bt878
|
|
<command>card=34</command> Leadtek WinFast 2000/ WinFast 2000 XP
|
|
<command>card=35</command> Lifeview FlyVideo 98 LR50 / Chronos Video Shuttle II
|
|
<command>card=36</command> Lifeview FlyVideo 98FM LR50 / Typhoon TView TV/FM Tuner
|
|
<command>card=37</command> Prolink PixelView PlayTV pro
|
|
<command>card=38</command> Askey CPH06X TView99
|
|
<command>card=39</command> Pinnacle PCTV Studio/Rave
|
|
<command>card=40</command> STB TV PCI FM, Gateway P/N 6000704 (bt878), 3Dfx VoodooTV 100
|
|
<command>card=41</command> AVerMedia TVPhone 98
|
|
<command>card=42</command> ProVideo PV951
|
|
<command>card=43</command> Little OnAir TV
|
|
<command>card=44</command> Sigma TVII-FM
|
|
<command>card=45</command> MATRIX-Vision MV-Delta 2
|
|
<command>card=46</command> Zoltrix Genie TV/FM
|
|
<command>card=47</command> Terratec TV/Radio+
|
|
<command>card=48</command> Askey CPH03x/ Dynalink Magic TView
|
|
<command>card=49</command> IODATA GV-BCTV3/PCI
|
|
<command>card=50</command> Prolink PV-BT878P+4E / PixelView PlayTV PAK / Lenco MXTV-9578 CP
|
|
<command>card=51</command> Eagle Wireless Capricorn2 (bt878A)
|
|
<command>card=52</command> Pinnacle PCTV Studio Pro
|
|
<command>card=53</command> Typhoon TView RDS + FM Stereo / KNC1 TV Station RDS
|
|
<command>card=54</command> Lifeview FlyVideo 2000 /FlyVideo A2/ Lifetec LT 9415 TV [LR90]
|
|
<command>card=55</command> Askey CPH031/ BESTBUY Easy TV
|
|
<command>card=56</command> Lifeview FlyVideo 98FM LR50
|
|
<command>card=57</command> GrandTec 'Grand Video Capture' (Bt848)
|
|
<command>card=58</command> Askey CPH060/ Phoebe TV Master Only (No FM)
|
|
<command>card=59</command> Askey CPH03x TV Capturer
|
|
<command>card=60</command> Modular Technology MM100PCTV
|
|
<command>card=61</command> AG Electronics GMV1
|
|
<command>card=62</command> Askey CPH061/ BESTBUY Easy TV (bt878)
|
|
<command>card=63</command> ATI TV-Wonder
|
|
<command>card=64</command> ATI TV-Wonder VE
|
|
<command>card=65</command> Lifeview FlyVideo 2000S LR90
|
|
<command>card=66</command> Terratec TValueRadio
|
|
<command>card=67</command> IODATA GV-BCTV4/PCI
|
|
<command>card=68</command> 3Dfx VoodooTV FM (Euro), VoodooTV 200 (USA)
|
|
<command>card=69</command> Active Imaging AIMMS
|
|
<command>card=70</command> Prolink Pixelview PV-BT878P+ (Rev.4C,8E)
|
|
<command>card=71</command> Lifeview FlyVideo 98EZ (capture only) LR51
|
|
<command>card=72</command> Prolink Pixelview PV-BT878P+9B (PlayTV Pro rev.9B FM+NICAM)
|
|
<command>card=73</command> Sensoray 311
|
|
<command>card=74</command> RemoteVision MX (RV605)
|
|
<command>card=75</command> Powercolor MTV878/ MTV878R/ MTV878F
|
|
<command>card=76</command> Canopus WinDVR PCI (COMPAQ Presario 3524JP, 5112JP)
|
|
<command>card=77</command> GrandTec Multi Capture Card (Bt878)
|
|
<command>card=78</command> Jetway TV/Capture JW-TV878-FBK, Kworld KW-TV878RF
|
|
<command>card=79</command> DSP Design TCVIDEO
|
|
<command>card=80</command> Hauppauge WinTV PVR
|
|
<command>card=81</command> IODATA GV-BCTV5/PCI
|
|
<command>card=82</command> Osprey 100/150 (878)
|
|
<command>card=83</command> Osprey 100/150 (848)
|
|
<command>card=84</command> Osprey 101 (848)
|
|
<command>card=85</command> Osprey 101/151
|
|
<command>card=86</command> Osprey 101/151 w/ svid
|
|
<command>card=87</command> Osprey 200/201/250/251
|
|
<command>card=88</command> Osprey 200/250
|
|
<command>card=89</command> Osprey 210/220
|
|
<command>card=90</command> Osprey 500
|
|
<command>card=91</command> Osprey 540
|
|
<command>card=92</command> Osprey 2000
|
|
<command>card=93</command> IDS Eagle
|
|
<command>card=94</command> Pinnacle PCTV Sat
|
|
<command>card=95</command> Formac ProTV II (bt878)
|
|
<command>card=96</command> MachTV
|
|
<command>card=97</command> Euresys Picolo
|
|
<command>card=98</command> ProVideo PV150
|
|
<command>card=99</command> AD-TVK503
|
|
<command>card=100</command> Hercules Smart TV Stereo
|
|
<command>card=101</command> Pace TV & Radio Card
|
|
<command>card=102</command> IVC-200
|
|
<command>card=103</command> Grand X-Guard / Trust 814PCI
|
|
<command>card=104</command> Nebula Electronics DigiTV
|
|
<command>card=105</command> ProVideo PV143
|
|
<command>card=106</command> PHYTEC VD-009-X1 MiniDIN (bt878)
|
|
<command>card=107</command> PHYTEC VD-009-X1 Combi (bt878)
|
|
<command>card=108</command> PHYTEC VD-009 MiniDIN (bt878)
|
|
<command>card=109</command> PHYTEC VD-009 Combi (bt878)
|
|
<command>card=110</command> IVC-100
|
|
<command>card=111</command> IVC-120G
|
|
<command>card=112</command> pcHDTV HD-2000 TV
|
|
<command>card=113</command> Twinhan DST + clones
|
|
<command>card=114</command> Winfast VC100
|
|
<command>card=115</command> Teppro TEV-560/InterVision IV-560
|
|
<command>card=116</command> SIMUS GVC1100
|
|
<command>card=117</command> NGS NGSTV+
|
|
<command>card=118</command> LMLBT4
|
|
<command>card=119</command> Tekram M205 PRO
|
|
<command>card=120</command> Conceptronic CONTVFMi
|
|
</literallayout>
|
|
</para>
|
|
</appendix>
|
|
|
|
|
|
<appendix id="mfgr">
|
|
<title>Cards and Features by Manufacturer</title>
|
|
<para>
|
|
<literallayout>
|
|
MATRIX Vision
|
|
-------------
|
|
|
|
MV-Delta
|
|
- Bt848A
|
|
- 4 Composite inputs, 1 S-VHS input (shared with 4th composite)
|
|
- EEPROM
|
|
|
|
http://www.matrix-vision.de/
|
|
|
|
This card has no tuner but supports all 4 composite (1 shared with an
|
|
S-VHS input) of the Bt848A.
|
|
Very nice card if you only have satellite TV but several tuners connected
|
|
to the card via composite.
|
|
|
|
Many thanks to Matrix-Vision for giving us 2 cards for free which made
|
|
Bt848a/Bt849 single crystal operation support possible!!!
|
|
|
|
|
|
|
|
Miro/Pinnacle PCTV
|
|
------------------
|
|
|
|
- Bt848
|
|
some (all??) come with 2 crystals for PAL/SECAM and NTSC
|
|
- PAL, SECAM or NTSC TV tuner (Philips or TEMIC)
|
|
- MSP34xx sound decoder on add on board
|
|
decoder is supported but AFAIK does not yet work
|
|
(other sound MUX setting in GPIO port needed??? somebody who fixed this???)
|
|
- 1 tuner, 1 composite and 1 S-VHS input
|
|
- tuner type is autodetected
|
|
|
|
http://www.miro.de/
|
|
http://www.miro.com/
|
|
|
|
|
|
Many thanks for the free card which made first NTSC support possible back
|
|
in 1997!
|
|
|
|
|
|
Hauppauge Win/TV pci
|
|
--------------------
|
|
|
|
There are many different versions of the Hauppauge cards with different
|
|
tuners (TV+Radio ...), teletext decoders.
|
|
Note that even cards with same model numbers have (depending on the revision)
|
|
different chips on it.
|
|
|
|
- Bt848 (and others but always in 2 crystal operation???)
|
|
newer cards have a Bt878
|
|
- PAL, SECAM, NTSC or tuner with or without Radio support
|
|
|
|
e.g.:
|
|
PAL:
|
|
TDA5737: VHF, hyperband and UHF mixer/oscillator for TV and VCR 3-band tuners
|
|
TSA5522: 1.4 GHz I2C-bus controlled synthesizer, I2C 0xc2-0xc3
|
|
|
|
NTSC:
|
|
TDA5731: VHF, hyperband and UHF mixer/oscillator for TV and VCR 3-band tuners
|
|
TSA5518: no datasheet available on Philips site
|
|
- Philips SAA5246 or SAA5284 ( or no) Teletext decoder chip
|
|
with buffer RAM (e.g. Winbond W24257AS-35: 32Kx8 CMOS static RAM)
|
|
SAA5246 (I2C 0x22) is supported
|
|
- 256 bytes EEPROM: Microchip 24LC02B or Philips 8582E2Y
|
|
with configuration information
|
|
I2C address 0xa0 (24LC02B also responds to 0xa2-0xaf)
|
|
- 1 tuner, 1 composite and (depending on model) 1 S-VHS input
|
|
- 14052B: mux for selection of sound source
|
|
- sound decoder: TDA9800, MSP34xx (stereo cards)
|
|
|
|
|
|
Askey CPH-Series
|
|
----------------
|
|
Developed by TelSignal(?), OEMed by many vendors (Typhoon, Anubis, Dynalink)
|
|
|
|
Card series:
|
|
CPH01x: BT848 capture only
|
|
CPH03x: BT848
|
|
CPH05x: BT878 with FM
|
|
CPH06x: BT878 (w/o FM)f/
|
|
CPH07x: BT878 capture only
|
|
|
|
TV standards:
|
|
CPH0x0: NTSC-M/M
|
|
CPH0x1: PAL-B/G
|
|
CPH0x2: PAL-I/I
|
|
CPH0x3: PAL-D/K
|
|
CPH0x4: SECAM-L/L
|
|
CPH0x5: SECAM-B/G
|
|
CPH0x6: SECAM-D/K
|
|
CPH0x7: PAL-N/N
|
|
CPH0x8: PAL-B/H
|
|
CPH0x9: PAL-M/M
|
|
|
|
CPH03x was often sold as "TV capturer".
|
|
|
|
Identifying:
|
|
1) 878 cards can be identified by PCI Subsystem-ID:
|
|
144f:3000 = CPH06x
|
|
144F:3002 = CPH05x w/ FM
|
|
144F:3005 = CPH06x_LC (w/o remote control)
|
|
1) The cards have a sticker with "CPH"-model on the back.
|
|
2) These cards have a number printed on the PCB just above the tuner metal box:
|
|
"80-CP2000300-x" = CPH03X
|
|
"80-CP2000500-x" = CPH05X
|
|
"80-CP2000600-x" = CPH06X / CPH06x_LC
|
|
|
|
Askey sells these cards as "Magic TView series", Brand "MagicXpress".
|
|
Other OEM often call these "Tview", "TView99" or else.
|
|
|
|
Lifeview Flyvideo Series:
|
|
-------------------------
|
|
The naming of these series differs in time and space.
|
|
|
|
Identifying:
|
|
1) Some models can be identified by PCI subsystem ID:
|
|
1852:1852 = Flyvideo 98 FM
|
|
1851:1850 = Flyvideo 98
|
|
1851:1851 = Flyvideo 98 EZ (capture only)
|
|
2) There is a print on the PCB:
|
|
LR25 = Flyvideo (Zoran ZR36120, SAA7110A)
|
|
LR26 Rev.N = Flyvideo II (Bt848)
|
|
Rev.O = Flyvideo II (Bt878)
|
|
LR37 Rev.C = Flyvideo EZ (Capture only, ZR36120 + SAA7110)
|
|
LR38 Rev.A1= Flyvideo II EZ (Bt848 capture only)
|
|
LR50 Rev.Q = Flyvideo 98 (w/eeprom and PCI subsystem ID)
|
|
Rev.W = Flyvideo 98 (no eeprom)
|
|
LR51 Rev.E = Flyvideo 98 EZ (capture only)
|
|
LR90 = Flyvideo 2000 (Bt878)
|
|
Flyvideo 2000S (Bt878) w/Stereo TV (Package incl. LR91 daughterboard)
|
|
LR91 = Stereo daughter card for LR90
|
|
LR97 = Flyvideo DVBS
|
|
LR99 Rev.E = Low profile card for OEM integration (only internal audio!) bt878
|
|
LR136 = Flyvideo 2100/3100 (Low profile, SAA7130/SAA7134)
|
|
LR137 = Flyvideo DV2000/DV3000 (SAA7130/SAA7134 + IEEE1394)
|
|
LR138 Rev.C= Flyvideo 2000 (SAA7130)
|
|
or Flyvideo 3000 (SAA7134) w/Stereo TV
|
|
These exist in variations w/FM and w/Remote sometimes denoted
|
|
by suffixes "FM" and "R".
|
|
|
|
Lifeview.com.tw states (Feb. 2002):
|
|
"The FlyVideo2000 and FlyVideo2000s product name have renamed to FlyVideo98."
|
|
Their Bt8x8 cards are listed as discontinued.
|
|
Flyvideo 2000S was probably sold as Flyvideo 3000 in some countries(Europe?).
|
|
The new Flyvideo 2000/3000 are SAA7130/SAA7134 based.
|
|
|
|
"Flyvideo II" had been the name for the 848 cards, nowadays (in Germany)
|
|
this name is re-used for LR50 Rev.W.
|
|
The Lifeview website mentioned Flyvideo III at some time, but such a card
|
|
has not yet been seen (perhaps it was the German name for LR90 [stereo]).
|
|
These cards are sold by many OEMs too.
|
|
|
|
FlyVideo A2 (Elta 8680)= LR90 Rev.F (w/Remote, w/o FM, stereo TV by tda9821) {Germany}
|
|
Lifeview 3000 (Elta 8681) as sold by Plus(April 2002), Germany = LR138 w/ saa7134
|
|
|
|
|
|
Typhoon TV card series:
|
|
-----------------------
|
|
These can be CPH, Flyvideo, Pixelview or KNC1 series.
|
|
Typhoon is the brand of Anubis.
|
|
Model 50680 got re-used, some model no. had different contents over time.
|
|
|
|
Models:
|
|
50680 "TV Tuner PCI Pal BG"(old,red package)=can be CPH03x(bt848) or CPH06x(bt878)
|
|
50680 "TV Tuner Pal BG" (blue package)= Pixelview PV-BT878P+ (Rev 9B)
|
|
50681 "TV Tuner PCI Pal I" (variant of 50680)
|
|
50682 "TView TV/FM Tuner Pal BG" = Flyvideo 98FM (LR50 Rev.Q)
|
|
Note: The package has a picture of CPH05x (which would be a real TView)
|
|
50683 "TV Tuner PCI SECAM" (variant of 50680)
|
|
50684 "TV Tuner Pal BG" = Pixelview 878TV(Rev.3D)
|
|
50686 "TV Tuner" = KNC1 TV Station
|
|
50687 "TV Tuner stereo" = KNC1 TV Station pro
|
|
50688 "TV Tuner RDS" (black package) = KNC1 TV Station RDS
|
|
50689 TV SAT DVB-S CARD CI PCI (SAA7146AH, SU1278?) = "KNC1 TV Station DVB-S"
|
|
50692 "TV/FM Tuner" (small PCB)
|
|
50694 TV TUNER CARD RDS (PHILIPS CHIPSET SAA7134HL)
|
|
50696 TV TUNER STEREO (PHILIPS CHIPSET SAA7134HL, MK3ME Tuner)
|
|
50804 PC-SAT TV/Audio Karte = Techni-PC-Sat (ZORAN 36120PQC, Tuner:Alps)
|
|
50866 TVIEW SAT RECEIVER+ADR
|
|
50868 "TV/FM Tuner Pal I" (variant of 50682)
|
|
50999 "TV/FM Tuner Secam" (variant of 50682)
|
|
|
|
|
|
Guillemot
|
|
---------
|
|
Maxi-TV PCI (ZR36120)
|
|
Maxi TV Video 2 = LR50 Rev.Q (FI1216MF, PAL BG+SECAM)
|
|
Maxi TV Video 3 = CPH064 (PAL BG + SECAM)
|
|
|
|
Mentor
|
|
------
|
|
Mentor TV card ("55-878TV-U1") = Pixelview 878TV(Rev.3F) (w/FM w/Remote)
|
|
|
|
Prolink
|
|
-------
|
|
TV cards:
|
|
PixelView Play TV pro - (Model: PV-BT878P+ REV 8E)
|
|
PixelView Play TV pro - (Model: PV-BT878P+ REV 9D)
|
|
PixelView Play TV pro - (Model: PV-BT878P+ REV 4C / 8D / 10A )
|
|
PixelView Play TV - (Model: PV-BT848P+)
|
|
878TV - (Model: PV-BT878TV)
|
|
|
|
Multimedia TV packages (card + software pack):
|
|
PixelView Play TV Theater - (Model: PV-M4200) = PixelView Play TV pro + Software
|
|
PixelView Play TV PAK - (Model: PV-BT878P+ REV 4E)
|
|
PixelView Play TV/VCR - (Model: PV-M3200 REV 4C / 8D / 10A )
|
|
PixelView Studio PAK - (Model: M2200 REV 4C / 8D / 10A )
|
|
PixelView PowerStudio PAK - (Model: PV-M3600 REV 4E)
|
|
PixelView DigitalVCR PAK - (Model: PV-M2400 REV 4C / 8D / 10A )
|
|
|
|
PixelView PlayTV PAK II (TV/FM card + usb camera) PV-M3800
|
|
PixelView PlayTV XP PV-M4700,PV-M4700(w/FM)
|
|
PixelView PlayTV DVR PV-M4600 package contents:PixelView PlayTV pro, windvr & videoMail s/w
|
|
|
|
Further Cards:
|
|
PV-BT878P+rev.9B (Play TV Pro, opt. w/FM w/NICAM)
|
|
PV-BT878P+rev.2F
|
|
PV-BT878P Rev.1D (bt878, capture only)
|
|
|
|
XCapture PV-CX881P (cx23881)
|
|
PlayTV HD PV-CX881PL+, PV-CX881PL+(w/FM) (cx23881)
|
|
|
|
DTV3000 PV-DTV3000P+ DVB-S CI = Twinhan VP-1030
|
|
DTV2000 DVB-S = Twinhan VP-1020
|
|
|
|
Video Conferencing:
|
|
PixelView Meeting PAK - (Model: PV-BT878P)
|
|
PixelView Meeting PAK Lite - (Model: PV-BT878P)
|
|
PixelView Meeting PAK plus - (Model: PV-BT878P+rev 4C/8D/10A)
|
|
PixelView Capture - (Model: PV-BT848P)
|
|
|
|
PixelView PlayTV USB pro
|
|
Model No. PV-NT1004+, PV-NT1004+ (w/FM) = NT1004 USB decoder chip + SAA7113 video decoder chip
|
|
|
|
Dynalink
|
|
--------
|
|
These are CPH series.
|
|
|
|
Phoebemicro
|
|
-----------
|
|
TV Master = CPH030 or CPH060
|
|
TV Master FM = CPH050
|
|
|
|
Genius/Kye
|
|
----------
|
|
Video Wonder/Genius Internet Video Kit = LR37 Rev.C
|
|
Video Wonder Pro II (848 or 878) = LR26
|
|
|
|
Tekram
|
|
------
|
|
VideoCap C205 (Bt848)
|
|
VideoCap C210 (zr36120 +Philips)
|
|
CaptureTV M200 (ISA)
|
|
CaptureTV M205 (Bt848)
|
|
|
|
Lucky Star
|
|
----------
|
|
Image World Conference TV = LR50 Rev. Q
|
|
|
|
Leadtek
|
|
-------
|
|
WinView 601 (Bt848)
|
|
WinView 610 (Zoran)
|
|
WinFast2000
|
|
WinFast2000 XP
|
|
|
|
KNC One
|
|
-------
|
|
TV-Station
|
|
TV-Station SE (+Software Bundle)
|
|
TV-Station pro (+TV stereo)
|
|
TV-Station FM (+Radio)
|
|
TV-Station RDS (+RDS)
|
|
TV Station SAT (analog satellite)
|
|
TV-Station DVB-S
|
|
|
|
newer Cards have saa7134, but model name stayed the same?
|
|
|
|
Provideo
|
|
--------
|
|
PV951 or PV-951 (also are sold as:
|
|
Boeder TV-FM Video Capture Card
|
|
Titanmedia Supervision TV-2400
|
|
Provideo PV951 TF
|
|
3DeMon PV951
|
|
MediaForte TV-Vision PV951
|
|
Yoko PV951
|
|
Vivanco Tuner Card PCI Art.-Nr.: 68404
|
|
) now named PV-951T
|
|
|
|
Surveillance Series
|
|
PV-141
|
|
PV-143
|
|
PV-147
|
|
PV-148 (capture only)
|
|
PV-150
|
|
PV-151
|
|
|
|
TV-FM Tuner Series
|
|
PV-951TDV (tv tuner + 1394)
|
|
PV-951T/TF
|
|
PV-951PT/TF
|
|
PV-956T/TF Low Profile
|
|
PV-911
|
|
|
|
Highscreen
|
|
----------
|
|
TV Karte = LR50 Rev.S
|
|
TV-Boostar = Terratec Terra TV+ Version 1.0 (Bt848, tda9821) "ceb105.pcb"
|
|
|
|
Zoltrix
|
|
-------
|
|
Face to Face Capture (Bt848 capture only) (PCB "VP-2848")
|
|
Face To Face TV MAX (Bt848) (PCB "VP-8482 Rev1.3")
|
|
Genie TV (Bt878) (PCB "VP-8790 Rev 2.1")
|
|
Genie Wonder Pro
|
|
|
|
AVerMedia
|
|
---------
|
|
AVer FunTV Lite (ISA, AV3001 chipset) "M101.C"
|
|
AVerTV
|
|
AVerTV Stereo
|
|
AVerTV Studio (w/FM)
|
|
AVerMedia TV98 with Remote
|
|
AVerMedia TV/FM98 Stereo
|
|
AVerMedia TVCAM98
|
|
TVCapture (Bt848)
|
|
TVPhone (Bt848)
|
|
TVCapture98 (="AVerMedia TV98" in USA) (Bt878)
|
|
TVPhone98 (Bt878, w/FM)
|
|
|
|
PCB PCI-ID Model-Name Eeprom Tuner Sound Country
|
|
--------------------------------------------------------------------
|
|
M101.C ISA !
|
|
M108-B Bt848 -- FR1236 US (2),(3)
|
|
M1A8-A Bt848 AVer TV-Phone FM1216 --
|
|
M168-T 1461:0003 AVerTV Studio 48:17 FM1216 TDA9840T D (1) w/FM w/Remote
|
|
M168-U 1461:0004 TVCapture98 40:11 FI1216 -- D w/Remote
|
|
M168II-B 1461:0003 Medion MD9592 48:16 FM1216 TDA9873H D w/FM
|
|
|
|
(1) Daughterboard MB68-A with TDA9820T and TDA9840T
|
|
(2) Sony NE41S soldered (stereo sound?)
|
|
(3) Daughterboard M118-A w/ pic 16c54 and 4 MHz quartz
|
|
|
|
US site has different drivers for (as of 09/2002):
|
|
EZ Capture/InterCam PCI (BT-848 chip)
|
|
EZ Capture/InterCam PCI (BT-878 chip)
|
|
TV-Phone (BT-848 chip)
|
|
TV98 (BT-848 chip)
|
|
TV98 With Remote (BT-848 chip)
|
|
TV98 (BT-878 chip)
|
|
TV98 With Remote (BT-878)
|
|
TV/FM98 (BT-878 chip)
|
|
AVerTV
|
|
AverTV Stereo
|
|
AVerTV Studio
|
|
|
|
DE hat diverse Treiber fuer diese Modelle (Stand 09/2002):
|
|
TVPhone (848) mit Philips tuner FR12X6 (w/ FM radio)
|
|
TVPhone (848) mit Philips tuner FM12X6 (w/ FM radio)
|
|
TVCapture (848) w/Philips tuner FI12X6
|
|
TVCapture (848) non-Philips tuner
|
|
TVCapture98 (Bt878)
|
|
TVPhone98 (Bt878)
|
|
AVerTV und TVCapture98 w/VCR (Bt 878)
|
|
AVerTVStudio und TVPhone98 w/VCR (Bt878)
|
|
AVerTV GO Serie (Kein SVideo Input)
|
|
AVerTV98 (BT-878 chip)
|
|
AVerTV98 mit Fernbedienung (BT-878 chip)
|
|
AVerTV/FM98 (BT-878 chip)
|
|
|
|
VDOmate (www.averm.com.cn) = M168U ?
|
|
|
|
Aimslab
|
|
-------
|
|
Video Highway or "Video Highway TR200" (ISA)
|
|
Video Highway Xtreme (aka "VHX") (Bt848, FM w/ TEA5757)
|
|
|
|
IXMicro (former: IMS=Integrated Micro Solutions)
|
|
-------
|
|
IXTV BT848 (=TurboTV)
|
|
IXTV BT878
|
|
IMS TurboTV (Bt848)
|
|
|
|
Lifetec/Medion/Tevion/Aldi
|
|
--------------------------
|
|
LT9306/MD9306 = CPH061
|
|
LT9415/MD9415 = LR90 Rev.F or Rev.G
|
|
MD9592 = Avermedia TVphone98 (PCI_ID=1461:0003), PCB-Rev=M168II-B (w/TDA9873H)
|
|
MD9717 = KNC One (Rev D4, saa7134, FM1216 MK2 tuner)
|
|
MD5044 = KNC One (Rev D4, saa7134, FM1216ME MK3 tuner)
|
|
|
|
Modular Technologies (www.modulartech.com) UK
|
|
---------------------------------------------
|
|
MM100 PCTV (Bt848)
|
|
MM201 PCTV (Bt878, Bt832) w/ Quartzsight camera
|
|
MM202 PCTV (Bt878, Bt832, tda9874)
|
|
MM205 PCTV (Bt878)
|
|
MM210 PCTV (Bt878) (Galaxy TV, Galaxymedia ?)
|
|
|
|
Terratec
|
|
--------
|
|
Terra TV+ Version 1.0 (Bt848), "ceb105.PCB" printed on the PCB, TDA9821
|
|
Terra TV+ Version 1.1 (Bt878), "LR74 Rev.E" printed on the PCB, TDA9821
|
|
Terra TValueRadio, "LR102 Rev.C" printed on the PCB
|
|
Terra TV/Radio+ Version 1.0, "80-CP2830100-0" TTTV3 printed on the PCB,
|
|
"CPH010-E83" on the back, SAA6588T, TDA9873H
|
|
Terra TValue Version BT878, "80-CP2830110-0 TTTV4" printed on the PCB,
|
|
"CPH011-D83" on back
|
|
Terra TValue Version 1.0 "ceb105.PCB" (really identical to Terra TV+ Version 1.0)
|
|
Terra TValue New Revision "LR102 Rec.C"
|
|
Terra Active Radio Upgrade (tea5757h, saa6588t)
|
|
|
|
LR74 is a newer PCB revision of ceb105 (both incl. connector for Active Radio Upgrade)
|
|
|
|
Cinergy 400 (saa7134), "E877 11(S)", "PM820092D" printed on PCB
|
|
Cinergy 600 (saa7134)
|
|
|
|
Technisat
|
|
---------
|
|
Discos ADR PC-Karte ISA (no TV!)
|
|
Discos ADR PC-Karte PCI (probably no TV?)
|
|
Techni-PC-Sat (Sat. analog)
|
|
Rev 1.2 (zr36120, vpx3220, stv0030, saa5246, BSJE3-494A)
|
|
Mediafocus I (zr36120/zr36125, drp3510, Sat. analog + ADR Radio)
|
|
Mediafocus II (saa7146, Sat. analog)
|
|
SatADR Rev 2.1 (saa7146a, saa7113h, stv0056a, msp3400c, drp3510a, BSKE3-307A)
|
|
SkyStar 1 DVB (AV7110) = Technotrend Premium
|
|
SkyStar 2 DVB (B2C2) (=Sky2PC)
|
|
|
|
Siemens
|
|
-------
|
|
Multimedia eXtension Board (MXB) (SAA7146, SAA7111)
|
|
|
|
Stradis
|
|
-------
|
|
SDM275,SDM250,SDM026,SDM025 (SAA7146, IBMMPEG2): MPEG2 decoder only
|
|
|
|
Powercolor
|
|
----------
|
|
MTV878
|
|
Package comes with different contents:
|
|
a) pcb "MTV878" (CARD=75)
|
|
b) Pixelview Rev. 4_
|
|
MTV878R w/Remote Control
|
|
MTV878F w/Remote Control w/FM radio
|
|
|
|
Pinnacle
|
|
--------
|
|
Mirovideo PCTV (Bt848)
|
|
Mirovideo PCTV SE (Bt848)
|
|
Mirovideo PCTV Pro (Bt848 + Daughterboard for TV Stereo and FM)
|
|
Studio PCTV Rave (Bt848 Version = Mirovideo PCTV)
|
|
Studio PCTV Rave (Bt878 package w/o infrared)
|
|
Studio PCTV (Bt878)
|
|
Studio PCTV Pro (Bt878 stereo w/ FM)
|
|
Pinnacle PCTV (Bt878, MT2032)
|
|
Pinnacle PCTV Pro (Bt878, MT2032)
|
|
Pinncale PCTV Sat (bt878a, HM1821/1221) ["Conexant CX24110 with CX24108 tuner, aka HM1221/HM1811"]
|
|
Pinnacle PCTV Sat XE
|
|
|
|
M(J)PEG capture and playback:
|
|
DC1+ (ISA)
|
|
DC10 (zr36057, zr36060, saa7110, adv7176)
|
|
DC10+ (zr36067, zr36060, saa7110, adv7176)
|
|
DC20 (ql16x24b,zr36050, zr36016, saa7110, saa7187 ...)
|
|
DC30 (zr36057, zr36050, zr36016, vpx3220, adv7176, ad1843, tea6415, miro FST97A1)
|
|
DC30+ (zr36067, zr36050, zr36016, vpx3220, adv7176)
|
|
DC50 (zr36067, zr36050, zr36016, saa7112, adv7176 (2 pcs.?), ad1843, miro FST97A1, Lattice ???)
|
|
|
|
Lenco
|
|
-----
|
|
MXR-9565 (=Technisat Mediafocus?)
|
|
MXR-9571 (Bt848) (=CPH031?)
|
|
MXR-9575
|
|
MXR-9577 (Bt878) (=Prolink 878TV Rev.3x)
|
|
MXTV-9578CP (Bt878) (= Prolink PV-BT878P+4E)
|
|
|
|
Iomega
|
|
------
|
|
Buz (zr36067, zr36060, saa7111, saa7185)
|
|
|
|
LML
|
|
---
|
|
LML33 (zr36067, zr36060, bt819, bt856)
|
|
|
|
Grandtec
|
|
--------
|
|
Grand Video Capture (Bt848)
|
|
Multi Capture Card (Bt878)
|
|
|
|
Koutech
|
|
-------
|
|
KW-606 (Bt848)
|
|
KW-607 (Bt848 capture only)
|
|
KW-606RSF
|
|
KW-607A (capture only)
|
|
KW-608 (Zoran capture only)
|
|
|
|
IODATA (jp)
|
|
------
|
|
GV-BCTV/PCI
|
|
GV-BCTV2/PCI
|
|
GV-BCTV3/PCI
|
|
GV-BCTV4/PCI
|
|
GV-VCP/PCI (capture only)
|
|
GV-VCP2/PCI (capture only)
|
|
|
|
Canopus (jp)
|
|
-------
|
|
WinDVR = Kworld "KW-TVL878RF"
|
|
|
|
www.sigmacom.co.kr
|
|
------------------
|
|
Sigma Cyber TV II
|
|
|
|
www.sasem.co.kr
|
|
---------------
|
|
Litte OnAir TV
|
|
|
|
hama
|
|
----
|
|
TV/Radio-Tuner Card, PCI (Model 44677) = CPH051
|
|
|
|
Sigma Designs
|
|
-------------
|
|
Hollywood plus (em8300, em9010, adv7175), (PCB "M340-10") MPEG DVD decoder
|
|
|
|
Formac
|
|
------
|
|
iProTV (Card for iMac Mezzanine slot, Bt848+SCSI)
|
|
ProTV (Bt848)
|
|
ProTV II = ProTV Stereo (Bt878) ["stereo" means FM stereo, tv is still mono]
|
|
|
|
ATI
|
|
---
|
|
TV-Wonder
|
|
TV-Wonder VE
|
|
|
|
Diamond Multimedia
|
|
------------------
|
|
DTV2000 (Bt848, tda9875)
|
|
|
|
Aopen
|
|
-----
|
|
VA1000 Plus (w/ Stereo)
|
|
VA1000 Lite
|
|
VA1000 (=LR90)
|
|
|
|
Intel
|
|
-----
|
|
Smart Video Recorder (ISA full-length)
|
|
Smart Video Recorder pro (ISA half-length)
|
|
Smart Video Recorder III (Bt848)
|
|
|
|
STB
|
|
---
|
|
STB Gateway 6000704 (bt878)
|
|
STB Gateway 6000699 (bt848)
|
|
STB Gateway 6000402 (bt848)
|
|
STB TV130 PCI
|
|
|
|
Videologic
|
|
----------
|
|
Captivator Pro/TV (ISA?)
|
|
Captivator PCI/VC (Bt848 bundled with camera) (capture only)
|
|
|
|
Technotrend
|
|
------------
|
|
TT-SAT PCI (PCB "Sat-PCI Rev.:1.3.1"; zr36125, vpx3225d, stc0056a, Tuner:BSKE6-155A
|
|
TT-DVB-Sat
|
|
revisions 1.1, 1.3, 1.5, 1.6 and 2.1
|
|
This card is sold as OEM from:
|
|
Siemens DVB-s Card
|
|
Hauppauge WinTV DVB-S
|
|
Technisat SkyStar 1 DVB
|
|
Galaxis DVB Sat
|
|
Now this card is called TT-PCline Premium Family
|
|
TT-Budget (saa7146, bsru6-701a)
|
|
This card is sold as OEM from:
|
|
Hauppauge WinTV Nova
|
|
Satelco Standard PCI (DVB-S)
|
|
TT-DVB-C PCI
|
|
|
|
Teles
|
|
-----
|
|
DVB-s (Rev. 2.2, BSRV2-301A, data only?)
|
|
|
|
Remote Vision
|
|
-------------
|
|
MX RV605 (Bt848 capture only)
|
|
|
|
Boeder
|
|
------
|
|
PC ChatCam (Model 68252) (Bt848 capture only)
|
|
Tv/Fm Capture Card (Model 68404) = PV951
|
|
|
|
Media-Surfer (esc-kathrein.de)
|
|
-------------------------------
|
|
Sat-Surfer (ISA)
|
|
Sat-Surfer PCI = Techni-PC-Sat
|
|
Cable-Surfer 1
|
|
Cable-Surfer 2
|
|
Cable-Surfer PCI (zr36120)
|
|
Audio-Surfer (ISA Radio card)
|
|
|
|
Jetway (www.jetway.com.tw)
|
|
--------------------------
|
|
JW-TV 878M
|
|
JW-TV 878 = KWorld KW-TV878RF
|
|
|
|
Galaxis
|
|
-------
|
|
Galaxis DVB Card S CI
|
|
Galaxis DVB Card C CI
|
|
Galaxis DVB Card S
|
|
Galaxis DVB Card C
|
|
Galaxis plug.in S [neuer Name: Galaxis DVB Card S CI
|
|
|
|
Hauppauge
|
|
---------
|
|
many many WinTV models ...
|
|
WinTV DVBs = Technotrend Premium 1.3
|
|
WinTV NOVA = Technotrend Budget 1.1 "S-DVB DATA"
|
|
WinTV NOVA-CI "SDVBACI"
|
|
WinTV Nova USB (=Technotrend USB 1.0)
|
|
WinTV-Nexus-s (=Technotrend Premium 2.1 or 2.2)
|
|
WinTV PVR
|
|
WinTV PVR 250
|
|
WinTV PVR 450
|
|
|
|
US models
|
|
990 WinTV-PVR-350 (249USD) (iTVC15 chipset + radio)
|
|
980 WinTV-PVR-250 (149USD) (iTVC15 chipset)
|
|
880 WinTV-PVR-PCI (199USD) (KFIR chipset + bt878)
|
|
881 WinTV-PVR-USB
|
|
190 WinTV-GO
|
|
191 WinTV-GO-FM
|
|
404 WinTV
|
|
401 WinTV-radio
|
|
495 WinTV-Theater
|
|
602 WinTV-USB
|
|
621 WinTV-USB-FM
|
|
600 USB-Live
|
|
698 WinTV-HD
|
|
697 WinTV-D
|
|
564 WinTV-Nexus-S
|
|
|
|
Deutsche Modelle
|
|
603 WinTV GO
|
|
719 WinTV Primio-FM
|
|
718 WinTV PCI-FM
|
|
497 WinTV Theater
|
|
569 WinTV USB
|
|
568 WinTV USB-FM
|
|
882 WinTV PVR
|
|
981 WinTV PVR 250
|
|
891 WinTV-PVR-USB
|
|
541 WinTV Nova
|
|
488 WinTV Nova-Ci
|
|
564 WinTV-Nexus-s
|
|
727 WinTV-DVB-c
|
|
545 Common Interface
|
|
898 WinTV-Nova-USB
|
|
|
|
UK models
|
|
607 WinTV Go
|
|
693,793 WinTV Primio FM
|
|
647,747 WinTV PCI FM
|
|
498 WinTV Theater
|
|
883 WinTV PVR
|
|
893 WinTV PVR USB (Duplicate entry)
|
|
566 WinTV USB (UK)
|
|
573 WinTV USB FM
|
|
429 Impact VCB (bt848)
|
|
600 USB Live (Video-In 1x Comp, 1xSVHS)
|
|
542 WinTV Nova
|
|
717 WinTV DVB-S
|
|
909 Nova-t PCI
|
|
893 Nova-t USB (Duplicate entry)
|
|
802 MyTV
|
|
804 MyView
|
|
809 MyVideo
|
|
872 MyTV2Go FM
|
|
|
|
|
|
546 WinTV Nova-S CI
|
|
543 WinTV Nova
|
|
907 Nova-S USB
|
|
908 Nova-T USB
|
|
717 WinTV Nexus-S
|
|
157 DEC3000-s Standalone + USB
|
|
|
|
Spain
|
|
685 WinTV-Go
|
|
690 WinTV-PrimioFM
|
|
416 WinTV-PCI Nicam Estereo
|
|
677 WinTV-PCI-FM
|
|
699 WinTV-Theater
|
|
683 WinTV-USB
|
|
678 WinTV-USB-FM
|
|
983 WinTV-PVR-250
|
|
883 WinTV-PVR-PCI
|
|
993 WinTV-PVR-350
|
|
893 WinTV-PVR-USB
|
|
728 WinTV-DVB-C PCI
|
|
832 MyTV2Go
|
|
869 MyTV2Go-FM
|
|
805 MyVideo (USB)
|
|
|
|
|
|
Matrix-Vision
|
|
-------------
|
|
MATRIX-Vision MV-Delta
|
|
MATRIX-Vision MV-Delta 2
|
|
MVsigma-SLC (Bt848)
|
|
|
|
Conceptronic (.net)
|
|
------------
|
|
TVCON FM, TV card w/ FM = CPH05x
|
|
TVCON = CPH06x
|
|
|
|
BestData
|
|
--------
|
|
HCC100 = VCC100rev1 + camera
|
|
VCC100 rev1 (bt848)
|
|
VCC100 rev2 (bt878)
|
|
|
|
Gallant (www.gallantcom.com) www.minton.com.tw
|
|
-----------------------------------------------
|
|
Intervision IV-510 (capture only bt8x8)
|
|
Intervision IV-550 (bt8x8)
|
|
Intervision IV-100 (zoran)
|
|
Intervision IV-1000 (bt8x8)
|
|
|
|
Asonic (www.asonic.com.cn) (website down)
|
|
-----------------------------------------
|
|
SkyEye tv 878
|
|
|
|
Hoontech
|
|
--------
|
|
878TV/FM
|
|
|
|
Teppro (www.itcteppro.com.tw)
|
|
-----------------------------
|
|
ITC PCITV (Card Ver 1.0) "Teppro TV1/TVFM1 Card"
|
|
ITC PCITV (Card Ver 2.0)
|
|
ITC PCITV (Card Ver 3.0) = "PV-BT878P+ (REV.9D)"
|
|
ITC PCITV (Card Ver 4.0)
|
|
TEPPRO IV-550 (For BT848 Main Chip)
|
|
ITC DSTTV (bt878, satellite)
|
|
ITC VideoMaker (saa7146, StreamMachine sm2110, tvtuner) "PV-SM2210P+ (REV:1C)"
|
|
|
|
Kworld (www.kworld.com.tw)
|
|
--------------------------
|
|
PC TV Station
|
|
KWORLD KW-TV878R TV (no radio)
|
|
KWORLD KW-TV878RF TV (w/ radio)
|
|
|
|
KWORLD KW-TVL878RF (low profile)
|
|
|
|
KWORLD KW-TV713XRF (saa7134)
|
|
|
|
|
|
MPEG TV Station (same cards as above plus WinDVR Software MPEG en/decoder)
|
|
KWORLD KW-TV878R -Pro TV (no Radio)
|
|
KWORLD KW-TV878RF-Pro TV (w/ Radio)
|
|
KWORLD KW-TV878R -Ultra TV (no Radio)
|
|
KWORLD KW-TV878RF-Ultra TV (w/ Radio)
|
|
|
|
|
|
|
|
JTT/ Justy Corp.http://www.justy.co.jp/ (www.jtt.com.jp website down)
|
|
---------------------------------------------------------------------
|
|
JTT-02 (JTT TV) "TV watchmate pro" (bt848)
|
|
|
|
ADS www.adstech.com
|
|
-------------------
|
|
Channel Surfer TV ( CHX-950 )
|
|
Channel Surfer TV+FM ( CHX-960FM )
|
|
|
|
AVEC www.prochips.com
|
|
---------------------
|
|
AVEC Intercapture (bt848, tea6320)
|
|
|
|
NoBrand
|
|
-------
|
|
TV Excel = Australian Name for "PV-BT878P+ 8E" or "878TV Rev.3_"
|
|
|
|
Mach www.machspeed.com
|
|
----
|
|
Mach TV 878
|
|
|
|
Eline www.eline-net.com/
|
|
-----
|
|
Eline Vision TVMaster / TVMaster FM (ELV-TVM/ ELV-TVM-FM) = LR26 (bt878)
|
|
Eline Vision TVMaster-2000 (ELV-TVM-2000, ELV-TVM-2000-FM)= LR138 (saa713x)
|
|
|
|
Spirit http://www.spiritmodems.com.au/
|
|
------
|
|
Spirit TV Tuner/Video Capture Card (bt848)
|
|
|
|
Boser www.boser.com.tw
|
|
-----
|
|
HS-878 Mini PCI Capture Add-on Card
|
|
HS-879 Mini PCI 3D Audio and Capture Add-on Card (w/ ES1938 Solo-1)
|
|
|
|
Satelco www.citycom-gmbh.de, www.satelco.de
|
|
-------
|
|
TV-FM =KNC1 saa7134
|
|
Standard PCI (DVB-S) = Technotrend Budget
|
|
Standard PCI (DVB-S) w/ CI
|
|
Satelco Highend PCI (DVB-S) = Technotrend Premium
|
|
|
|
|
|
Sensoray www.sensoray.com
|
|
--------
|
|
Sensoray 311 (PC/104 bus)
|
|
Sensoray 611 (PCI)
|
|
|
|
CEI (Chartered Electronics Industries Pte Ltd [CEI] [FCC ID HBY])
|
|
---
|
|
TV Tuner - HBY-33A-RAFFLES Brooktree Bt848KPF + Philips
|
|
TV Tuner MG9910 - HBY33A-TVO CEI + Philips SAA7110 + OKI M548262 + ST STV8438CV
|
|
Primetime TV (ISA)
|
|
acquired by Singapore Technologies
|
|
now operating as Chartered Semiconductor Manufacturing
|
|
Manufacturer of video cards is listed as:
|
|
Cogent Electronics Industries [CEI]
|
|
|
|
AITech
|
|
------
|
|
Wavewatcher TV (ISA)
|
|
AITech WaveWatcher TV-PCI = can be LR26 (Bt848) or LR50 (BT878)
|
|
WaveWatcher TVR-202 TV/FM Radio Card (ISA)
|
|
|
|
MAXRON
|
|
------
|
|
Maxron MaxTV/FM Radio (KW-TV878-FNT) = Kworld or JW-TV878-FBK
|
|
|
|
www.ids-imaging.de
|
|
------------------
|
|
Falcon Series (capture only)
|
|
In USA: http://www.theimagingsource.com/
|
|
DFG/LC1
|
|
|
|
www.sknet-web.co.jp
|
|
-------------------
|
|
SKnet Monster TV (saa7134)
|
|
|
|
A-Max www.amaxhk.com (Colormax, Amax, Napa)
|
|
-------------------
|
|
APAC Viewcomp 878
|
|
|
|
Cybertainment
|
|
-------------
|
|
CyberMail AV Video Email Kit w/ PCI Capture Card (capture only)
|
|
CyberMail Xtreme
|
|
These are Flyvideo
|
|
|
|
VCR (http://www.vcrinc.com/)
|
|
---
|
|
Video Catcher 16
|
|
|
|
Twinhan
|
|
-------
|
|
DST Card/DST-IP (bt878, twinhan asic) VP-1020
|
|
Sold as:
|
|
KWorld DVBS Satellite TV-Card
|
|
Powercolor DSTV Satellite Tuner Card
|
|
Prolink Pixelview DTV2000
|
|
Provideo PV-911 Digital Satellite TV Tuner Card With Common Interface ?
|
|
DST-CI Card (DVB Satellite) VP-1030
|
|
DCT Card (DVB cable)
|
|
|
|
MSI
|
|
---
|
|
MSI TV@nywhere Tuner Card (MS-8876) (CX23881/883) Not Bt878 compatible.
|
|
MS-8401 DVB-S
|
|
|
|
Focus www.focusinfo.com
|
|
-----
|
|
InVideo PCI (bt878)
|
|
|
|
Sdisilk www.sdisilk.com/
|
|
-------
|
|
SDI Silk 100
|
|
SDI Silk 200 SDI Input Card
|
|
|
|
www.euresys.com
|
|
PICOLO series
|
|
|
|
PMC/Pace
|
|
www.pacecom.co.uk website closed
|
|
|
|
Mercury www.kobian.com (UK and FR)
|
|
LR50
|
|
LR138RBG-Rx == LR138
|
|
|
|
TEC sound (package and manuals don't have any other manufacturer info) TecSound
|
|
Though educated Googling found: www.techmakers.com
|
|
TV-Mate = Zoltrix VP-8482
|
|
|
|
Lorenzen www.lorenzen.de
|
|
--------
|
|
SL DVB-S PCI = Technotrend Budget PCI (su1278 or bsru version)
|
|
|
|
Origo (.uk) www.origo2000.com
|
|
PC TV Card = LR50
|
|
|
|
I/O Magic www.iomagic.com
|
|
---------
|
|
PC PVR - Desktop TV Personal Video Recorder DR-PCTV100 = Pinnacle ROB2D-51009464 4.0 + Cyberlink PowerVCR II
|
|
|
|
Arowana
|
|
-------
|
|
TV-Karte / Poso Power TV (?) = Zoltrix VP-8482 (?)
|
|
|
|
iTVC15 boards:
|
|
-------------
|
|
kuroutoshikou.com ITVC15
|
|
yuan.com MPG160 PCI TV (Internal PCI MPEG2 encoder card plus TV-tuner)
|
|
|
|
Asus www.asuscom.com
|
|
Asus TV Tuner Card 880 NTSC (low profile, cx23880)
|
|
Asus TV (saa7134)
|
|
|
|
Hoontech
|
|
--------
|
|
http://www.hoontech.com/korean/download/down_driver_list03.html
|
|
HART Vision 848 (H-ART Vision 848)
|
|
HART Vision 878 (H-Art Vision 878)
|
|
|
|
</literallayout></para>
|
|
</appendix>
|
|
|
|
<appendix id="recording"><title>Recording Video and Sound with Bttv</title>
|
|
<para>
|
|
In addition to the applications referenced in <xref linkend="apps">, recording
|
|
can be managed from the command line. The issues discussed here with regard
|
|
to sound capture deal only with the default kernel-2.6 and higher sound system:
|
|
the <ulink url="http://www.alsa-project.org/">Advanced Linux Sound Architecture</ulink>.</para>
|
|
<para>
|
|
The easy part is grabbing the video, for which we will use <command>streamer</command>,
|
|
available with the <ulink url="http://linux.bytesex.org/xawtv/">Xawtv suite</ulink>.
|
|
Sound is another matter, however. You will need to access your mixer settings
|
|
using <command>amixer</command>, the ALSA command-line mixer that should be
|
|
available in the ALSA-tools package available from your Linux distributor.
|
|
See <command>man amixer</command> to follow the command line options.
|
|
</para>
|
|
<para>
|
|
Your recording can be managed either using your primary soundcard if you have
|
|
your Bt8x8 audio output connected to a mixer conduit that allows for capture
|
|
(e.g. the 4-pin analog CDROM input slot), or the Bt8x8 card itself using the
|
|
<command>btaudio</command> module. The following steps utilize the latter.
|
|
First, identify the individual cards on your system (requires <filename>/proc</filename> filesystem):
|
|
<screen>
|
|
$ cat /proc/asound/pcm
|
|
00-00: Intel ICH : NVidia CK8S : playback 1 : capture 1
|
|
00-01: Intel ICH - MIC ADC : NVidia CK8S - MIC ADC : capture 1
|
|
00-02: Intel ICH - IEC958 : NVidia CK8S - IEC958 : playback 1
|
|
01-00: Bt87x Digital : Bt87x Digital : capture 1
|
|
01-01: Bt87x Analog : Bt87x Analog : capture 1
|
|
</screen>
|
|
The first column indicates the system numbering of your available sound devices, i.e.,
|
|
card 0 is the soundcard and card 01, or 1, is the Bt8x8.
|
|
</para>
|
|
<para>
|
|
Next, identify the mixer controls for the Bt8x8 card.
|
|
<screen>
|
|
$ amixer -c 1 controls
|
|
numid=3,iface=MIXER,name='Capture Source'
|
|
numid=2,iface=MIXER,name='Capture Boost'
|
|
numid=1,iface=MIXER,name='Capture Volume'
|
|
</screen>
|
|
Then identify the item settings of each:
|
|
<screen>
|
|
$ amixer -c 1 cget name='Capture Source'
|
|
numid=3,iface=MIXER,name='Capture Source'
|
|
; type=ENUMERATED,access=rw---,values=1,items=3
|
|
; Item #0 'TV Tuner'
|
|
; Item #1 'FM'
|
|
; Item #2 'Mic/Line'
|
|
: values=1
|
|
|
|
$ amixer -c 1 cget name='Capture Boost'
|
|
numid=2,iface=MIXER,name='Capture Boost'
|
|
; type=BOOLEAN,access=rw---,values=1
|
|
values=on
|
|
|
|
$ amixer -c 1 cget name='Capture Volume'
|
|
numid=1,iface=MIXER,name='Capture Volume'
|
|
; type=INTEGER,access=rw---,values=1,min=0,max=15,step=0
|
|
: values=0
|
|
</screen>
|
|
Use <command>cset</command> for the capture source:
|
|
<screen>
|
|
$ amixer -c 1 cset name='Capture Source' 0
|
|
</screen>
|
|
...and to set the volume:
|
|
<screen>
|
|
$ amixer -c 1 cset name="Capture Volume' 15
|
|
</screen>
|
|
...and you should be ready.</para>
|
|
<para>
|
|
Now try to record something:
|
|
<screen>
|
|
$ streamer -p 4 -t 1:00 -r 24 -q -o test.avi -j 90 -f mjpeg -F mono16
|
|
</screen>
|
|
...and you should be recording a sound-enabled avi file. Press [Ctrl]-C to
|
|
cancel early. Next step is to automate the recording for your very own
|
|
home-brewed <trademark>Tivo</trademark>!
|
|
</para>
|
|
<para>
|
|
I offer the following script as an example program for automating recording;
|
|
you can copy and paste it into a file and make it executable (<command>chmod
|
|
u+x record-tv.sh</command>).</para> <warning><para>This script (and any
|
|
recording from your Bttv device for that matter) generates extremely large
|
|
files, on the order of several GB per hour, so be sure you have lots of free
|
|
disk space available.</para></warning>
|
|
<para>
|
|
<screen>
|
|
#!/bin/bash
|
|
# ================= record-tv.sh ============================
|
|
# = copyright 2003 by Greg Watson gwatsonATlinuxlogin.com =
|
|
# = GPL2 License, minor modifications by Howard Shane =
|
|
# = hshaneATaustin.rr.com , under same license =
|
|
# = usage record-tv.sh prefix-filename record-time channel =
|
|
# = Example: ./record-tv.sh enterprise 61:00 20 =
|
|
# ============================================================
|
|
# Version 0.9
|
|
# Last Mod: Wed Feb 20 11:27 CST 2005
|
|
|
|
# Output directory
|
|
OUTPUT=$HOME/vcr
|
|
# Streamer location
|
|
STREAMER=/usr/bin/streamer
|
|
# Alsa Mixer
|
|
AMIXER=/usr/bin/amixer
|
|
# v4lctl path
|
|
V4LCTL=/usr/bin/v4lctl
|
|
# Capture Volume to ensure sound is recorded (80%)
|
|
CAPTURE_VOLUME=100
|
|
|
|
# Tvtime settings file for color/brightness/contrast values
|
|
TVTIME=$HOME/.tvtime/tvtime.xml
|
|
|
|
# End of Config
|
|
###############
|
|
|
|
# check if I'm running TV, if so just exit
|
|
if [ `ps -C tvtime | grep -c tvtime` -gt 0 ]; then
|
|
echo "TVtime is running, aborting recording."
|
|
exit
|
|
fi
|
|
|
|
# If the filename prefix wasn't given, set it to 'recording'
|
|
if [ -z $1 ]; then
|
|
PREFIX="recording"
|
|
else
|
|
PREFIX=$1
|
|
fi
|
|
|
|
# if time is blank, record for 30 minutes
|
|
if [ -z $2 ]; then
|
|
TIME="30:00"
|
|
else
|
|
TIME=$2
|
|
fi
|
|
|
|
if [ ! -z $3 ]; then
|
|
$V4LCTL setchannel $3
|
|
fi
|
|
|
|
# Check for vcr dir
|
|
if [ ! -x $OUTPUT ]; then
|
|
mkdir $OUTPUT
|
|
fi
|
|
|
|
DATE=`date +%m-%d-%Y-%H:%M`
|
|
|
|
# Set the AC97 volume to 0 (so we don't hear the sounds)
|
|
# Get mixer values first
|
|
PLAY_VOL=`$AMIXER -c 0 cget name='Master Playback Volume' | grep : | sed 's/^.*=\([^,]*\).*$/\1/'`
|
|
CAP_VOL=`$AMIXER -c 0 cget name='PCM Playback Volume' | grep : | sed 's/^.*=\([^,]*\).*$/\1/'`
|
|
#
|
|
$AMIXER -c 0 -q cset name='CD Playback Volume' 100
|
|
$AMIXER -c 0 -q cset name='Capture Volume' 1
|
|
|
|
# if tvtime.xml is set, then grab settings out of it
|
|
if [ -f $TVTIME ]; then
|
|
CONTRAST=`cat ${TVTIME} | grep DefaultContrast | sed 's/^.*value="\([^"]*\).*$/\1/'`
|
|
BRIGHTNESS=`cat ${TVTIME} | grep DefaultBrightness | sed 's/^.*value="\([^"]*\).*$/\1/'`
|
|
COLOR=`cat ${TVTIME} | grep DefaultColour | sed 's/^.*value="\([^"]*\).*$/\1/'`
|
|
HUE=`cat ${TVTIME} | grep DefaultHue | sed 's/^.*value="\([^"]*\).*$/\1/'`
|
|
|
|
$V4LCTL bright ${BRIGHTNESS}% color ${COLOR}% contrast ${CONTRAST}% hue ${HUE}%
|
|
fi
|
|
|
|
$STREAMER -p 4 -q -t ${TIME} -r 24 -q -o ${OUTPUT}/${PREFIX}-${DATE}-${TIME}.avi -j 90 -f mjpeg -F mono16
|
|
|
|
# Sometimes streamer doesn't always re-mute audio, mute it again just to be sure
|
|
$V4LCTL volume mute on
|
|
|
|
# Restore volumes
|
|
$AMIXER -q cset name='Master Playback Volume' $PLAY_VOL
|
|
$AMIXER -q cset name='PCM Playback Volume' $CAP_VOL
|
|
#
|
|
# EOF
|
|
</screen>
|
|
</para>
|
|
</appendix>
|
|
|
|
|
|
<appendix id="fm"><title>Enabling The FM Radio for Radio-Equipped Cards</title>
|
|
<para>
|
|
FM radio tuners are easily enabled when inserting modules. Simply
|
|
<screen>
|
|
$ modprobe bttv radio=1
|
|
</screen>
|
|
...or add a similar option to your <filename>/etc/modules.conf</filename>
|
|
and you should be set the next time you restart or load the module. You will
|
|
also need an application to access the radio. I suggest the
|
|
console based <command>radio</command>, available with the
|
|
<ulink url="http://linux.bytesex.org/xawtv/">Xawtv suite</ulink>, or
|
|
<ulink url="http://www.stanford.edu/~blp/fmtools/">fmtools</ulink>.
|
|
For graphical programs, try <ulink url="http://mfcn.ilo.de/gnomeradio/">gnomeradio</ulink>
|
|
or <ulink url="http://foobazco.org/projects/gradio/">gradio</ulink> or <ulink url="http://www.xmms.org/">xmms</ulink>
|
|
with the <ulink url="http://silicone.free.fr/xmms-FMRadio/">FMRadio plug-in</ulink>.
|
|
</para>
|
|
<para>
|
|
Also, you can't listen to radio at the same time as watching TV with your Bttv
|
|
card (unless you have more than one card, that is).
|
|
</para>
|
|
</appendix>
|
|
|
|
<appendix id="appendix"> <title>Gnu Free Documentation License</title>
|
|
|
|
<para>
|
|
Version 1.2, November 2002
|
|
</para>
|
|
|
|
<para>
|
|
Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
|
|
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone
|
|
is permitted to copy and distribute verbatim copies of this
|
|
license document but changing it is not allowed.
|
|
</para>
|
|
|
|
<para> 0. PREAMBLE </para>
|
|
|
|
<para>
|
|
The purpose of this License is to make a manual, textbook,
|
|
or other functional and useful document "free" in the sense of
|
|
freedom: to assure everyone the effective freedom to copy and
|
|
redistribute it, with or without modifying it, either commercially
|
|
or noncommercially. Secondarily, this License preserves for the
|
|
author and publisher a way to get credit for their work, while
|
|
not being considered responsible for modifications made by others.
|
|
</para>
|
|
|
|
<para>
|
|
This License is a kind of "copyleft", which means that derivative
|
|
works of the document must themselves be free in the same sense.
|
|
It complements the GNU General Public License, which is a copyleft
|
|
cense designed for free software.
|
|
</para>
|
|
|
|
<para>
|
|
We have designed this License in order to use it for manuals for
|
|
free software, because free software needs free documentation: a
|
|
free program should come with manuals providing the same freedoms
|
|
that the software does. But this License is not limited to
|
|
software manuals; it can be used for any textual work, regardless
|
|
of subject matter or whether it is published as a printed book.
|
|
We recommend this License principally for works in which its
|
|
purpose is instruction or reference.
|
|
</para>
|
|
|
|
<para> 1. APPLICABILITY AND DEFINITIONS </para>
|
|
|
|
<para>
|
|
This License applies to any manual or other work, in any medium,
|
|
that contains a notice placed by the copyright holder saying
|
|
it can be distributed under the terms of this License. Such a
|
|
notice grants a world-wide, royalty-free license, unlimited in
|
|
duration, to use that work under the conditions stated herein.
|
|
The "Document", below, refers to any such manual or work.
|
|
Any member of the public is a licensee and is addressed as "you".
|
|
You accept the license if you copy, modify, or distribute the
|
|
work in a way, thus requiring permission under copyright law.
|
|
</para>
|
|
|
|
<para>
|
|
A "Modified Version" of the Document means any work containing
|
|
the Document or a portion of it, either copied verbatim, or with
|
|
modifications and/or translated into another language.
|
|
</para>
|
|
|
|
<para>
|
|
A "Secondary Section" is a named appendix or a front-matter
|
|
section of the Document that deals exclusively with the
|
|
relationship of the publishers or authors of the Document to the
|
|
Document's overall subject (or to related matters) and contains
|
|
nothing that could fall directly within that overall subject.
|
|
(Thus, if the Document is in part a textbook of mathematics,
|
|
a Secondary Section may not explain any mathematics.) The
|
|
relationship could be a matter of historical connection with
|
|
the subject or with related matters, or of legal, commercial,
|
|
philosophical, ethical, or political position regarding them.
|
|
</para>
|
|
|
|
<para>
|
|
The "Invariant Sections" are certain Secondary Sections in which
|
|
titles are designated, as being those of Invariant Sections,
|
|
in the notice that says that the Document is released under
|
|
this License. If a section does not fit the above definition of
|
|
Secondary, then it is not allowed to be designated as Invariant.
|
|
The Document may contain zero Invariant Sections. If the Document
|
|
does not identify any Invariant Sections, then there are none.
|
|
</para>
|
|
|
|
<para>
|
|
The "Cover Texts" are certain short passages of text that are
|
|
listed, as Front-Cover Texts or Back-Cover Texts, in the notice
|
|
that says that the Document is released under this License.
|
|
A Front-Cover Text may be at most five words, and a Back-Cover
|
|
Text may be at most 25 words.
|
|
</para>
|
|
|
|
<para>
|
|
A "Transparent" copy of the Document means a machine-readable
|
|
copy, represented in a format where its specification is available
|
|
to the general public, that is suitable for revising the document
|
|
straightforwardly with generic text editors or (for images
|
|
composed of pixels) generic paint programs or (for drawings) some
|
|
widely available drawing editor, and that is suitable for input
|
|
to text formatters or for automatic translation to a variety of
|
|
formats suitable for input to text formatters. A copy made in an
|
|
otherwise Transparent file format in which its markup, or absence
|
|
of markup, has been arranged to thwart or discourage subsequent
|
|
modification by readers is not Transparent. An image format
|
|
is not Transparent if used for any substantial amount of text.
|
|
A copy that is not "Transparent" is called "Opaque".
|
|
</para>
|
|
|
|
<para>
|
|
Examples of suitable formats for Transparent copies include
|
|
plain ASCII without markup, Texinfo input format, LaTeX
|
|
input format, SGML or XML using a publicly available DTD, and
|
|
standard-conforming simple HTML, PostScript or PDF designed for
|
|
human modification. Examples of transparent image formats include
|
|
PNG, XCF, and JPG. Opaque formats include proprietary formats
|
|
that can be read and edited only by proprietary word processors,
|
|
SGML or XML for which the DTD and/or processing tools are not
|
|
generally available, and the machine-generated HTML, PostScript
|
|
or PDF produced by some word processors for output purposes only.
|
|
</para>
|
|
|
|
<para>
|
|
The "Title Page" means, for a printed book, the title page itself,
|
|
plus such following pages as are needed to hold, legibly, the
|
|
material this License requires to appear in the title page.
|
|
For works in formats, which do not have any title page as such,
|
|
"Title Page" means the text near the most prominent appearance of
|
|
the work's title, preceding the beginning of the body of the text.
|
|
</para>
|
|
|
|
<para>
|
|
A section "Entitled XYZ" means a named subunit of the Document
|
|
in which its title either is precisely XYZ or contains XYZ
|
|
in parentheses following text that translates XYZ in another
|
|
language. (Here XYZ stands for a specific section name mentioned
|
|
below, such as "Acknowledgements", "Dedications", "Endorsements",
|
|
or "History".) To "Preserve the Title" of such a section,
|
|
when you modify the Document, means that it remains a section
|
|
"Entitled XYZ", according to this definition.
|
|
</para>
|
|
|
|
<para>
|
|
The Document may include Warranty Disclaimers next to the notice
|
|
which states that this License applies to the Document. These
|
|
Warranty Disclaimers are considered to be included by reference
|
|
in this License, but only as regards disclaiming warranties:
|
|
any other implication that these Warranty Disclaimers may have
|
|
is void and has no effect on the meaning of this License.
|
|
</para>
|
|
|
|
<para> 2. VERBATIM COPYING </para>
|
|
|
|
<para>
|
|
You may copy and distribute the Document in any medium, either
|
|
commercially or noncommercially, provided that this License, the
|
|
copyright notices, and the license notice saying this License
|
|
applies to the Document are reproduced in all copies, and that
|
|
you add no other conditions whatsoever to those of this License.
|
|
You may not use technical measures to obstruct or control the
|
|
reading or further copying of the copies you make or distribute.
|
|
However, you may accept compensation in exchange for copies.
|
|
If you distribute a large enough number of copies you must also
|
|
follow the conditions in section 3.
|
|
</para>
|
|
|
|
<para>
|
|
You may also lend copies, under the same conditions stated above,
|
|
and you may publicly display copies.
|
|
</para>
|
|
|
|
<para> 3. COPYING IN QUANTITY </para>
|
|
|
|
<para>
|
|
If you publish printed copies (or copies in media that commonly
|
|
have printed covers) of the Document, numbering more than 100,
|
|
and the Document's license notice requires Cover Texts, you must
|
|
enclose the copies in covers that carry, clearly and legibly,
|
|
all these Cover Texts: Front-Cover Texts on the front cover,
|
|
and Back-Cover Texts on the back cover. Both covers must also
|
|
clearly and legibly identify you as the publisher of these copies.
|
|
The front cover must present the full title with all words of the
|
|
title equally prominent and visible. You may add other material
|
|
on the covers in addition. Copying with changes limited to the
|
|
covers, as long as they preserve the title of the Document and
|
|
satisfy these conditions, can be treated as verbatim copying in
|
|
other respects.
|
|
</para>
|
|
|
|
<para>
|
|
If the required texts for either cover are too voluminous to
|
|
fit legibly, you should put the first ones listed (as many as
|
|
fit reasonably) on the actual cover, and continue the rest onto
|
|
adjacent pages.
|
|
</para>
|
|
|
|
<para>
|
|
If you publish or distribute Opaque copies of the
|
|
Document numbering more than 100, you must either include a
|
|
machine-readable Transparent copy along with each Opaque copy,
|
|
or state in or with each Opaque copy a computer-network location
|
|
from which the general network-using public has access to download
|
|
using public-standard network protocols a complete Transparent
|
|
copy of the Document, free of added material. If you use the
|
|
latter option, you must take reasonably prudent steps, when
|
|
you begin distribution of Opaque copies in quantity, to ensure
|
|
that this Transparent copy will remain thus accessible at the
|
|
stated location until at least one year after the last time you
|
|
distribute an Opaque copy (directly or through your agents or
|
|
retailers) of that edition to the public.
|
|
</para>
|
|
|
|
<para>
|
|
It is requested, but not required, that you contact the authors
|
|
of the Document well before redistributing any large number of
|
|
copies, to give them a chance to provide you with an updated
|
|
version of the Document.
|
|
</para>
|
|
|
|
<para> 4. MODIFICATIONS </para>
|
|
|
|
<para>
|
|
You may copy and distribute a Modified Version of the Document
|
|
under the conditions of sections 2 and 3 above, provided that
|
|
you release the Modified Version under precisely this License,
|
|
with the Modified Version filling the role of the Document,
|
|
thus licensing distribution and modification of the Modified
|
|
Version to whoever possesses a copy of it. In addition, you
|
|
must do these things in the Modified Version:
|
|
</para>
|
|
|
|
<para>
|
|
A. Use in the Title Page (and on the covers, if any) a title
|
|
distinct from that of the Document, and from those of previous
|
|
versions (which should, if there were any, be listed in the
|
|
History section of the Document). You may use the same title
|
|
as a previous version if the original publisher of that version
|
|
gives permission.
|
|
</para>
|
|
|
|
<para>
|
|
B. List on the Title Page, as authors, one or more persons or
|
|
entities responsible for authorship of the modifications in the
|
|
Modified Version, together with at least five of the principal
|
|
authors of the Document (all of its principal authors, if it has
|
|
fewer than five), unless they release you from this requirement.
|
|
</para>
|
|
|
|
<para>
|
|
C. State on the Title page the name of the publisher of the
|
|
Modified Version, as the publisher.
|
|
</para>
|
|
|
|
<para>
|
|
D. Preserve all the copyright notices of the Document.
|
|
</para>
|
|
|
|
<para>
|
|
E. Add an appropriate copyright notice for your modifications
|
|
adjacent to the other copyright notices.
|
|
</para>
|
|
|
|
<para>
|
|
F. Include, immediately after the copyright notices, a license
|
|
notice giving the public permission to use the Modified Version
|
|
under the terms of this License, in the form shown in the
|
|
Addendum below.
|
|
</para>
|
|
|
|
<para>
|
|
G. Preserve in that license notice the full lists of Invariant
|
|
Sections and required Cover Texts given in the Document's
|
|
license notice.
|
|
</para>
|
|
|
|
<para>
|
|
H. Include an unaltered copy of this License.
|
|
</para>
|
|
|
|
<para>
|
|
I. Preserve the section Entitled "History", Preserve its Title,
|
|
and add to it an item stating at least the title, year, new
|
|
authors, and publisher of the Modified Version as given on
|
|
the Title Page. If there is no section Entitled "History"
|
|
in the Document, create one stating the title, year, authors,
|
|
and publisher of the Document as given on its Title Page, then
|
|
add an item describing the Modified Version as stated in the
|
|
previous sentence.
|
|
</para>
|
|
|
|
<para>
|
|
J. Preserve the network location, if any, given in the Document
|
|
for public access to a Transparent copy of the Document and
|
|
likewise the network locations given in the Document for previous
|
|
versions it was based on. These may be placed in the "History"
|
|
section. You may omit a network location for a work that was
|
|
published at least four years before the Document itself, or
|
|
if the original publisher of the version it refers to gives
|
|
permission.
|
|
</para>
|
|
|
|
<para>
|
|
K. For any section Entitled "Acknowledgements" or "Dedications",
|
|
Preserve the Title of the section, and preserve in the section all
|
|
the substance and tone of each of the contributor acknowledgements
|
|
and/or dedications given therein.
|
|
</para>
|
|
|
|
<para>
|
|
L. Preserve all the Invariant Sections of the Document, unaltered
|
|
in their text and in their titles. Section numbers or the
|
|
equivalent are not considered part of the section titles.
|
|
</para>
|
|
|
|
<para>
|
|
M. Delete any section Entitled "Endorsements". Such a section
|
|
may not be included in the Modified Version.
|
|
</para>
|
|
|
|
<para>
|
|
N. Do not retitle any existing section to be Entitled
|
|
"Endorsements" or to conflict in title with any Invariant Section.
|
|
</para>
|
|
|
|
<para>
|
|
O. Preserve any Warranty Disclaimers. If the Modified Version
|
|
includes new front-matter sections or appendices that qualify
|
|
as Secondary Sections and contain no material copied from the
|
|
Document, you may at your option designate some or all of these
|
|
sections as invariant. To do this, add their titles to the list
|
|
of Invariant Sections in the Modified Version's license notice.
|
|
These titles must be distinct from any other section titles.
|
|
You may add a section Entitled "Endorsements", provided it
|
|
contains nothing but endorsements of your Modified Version by
|
|
various parties--for example, statements of peer review or that
|
|
the text has been approved by an organization as the authoritative
|
|
definition of a standard.
|
|
</para>
|
|
|
|
<para>
|
|
You may add a passage of up to five words as a Front-Cover
|
|
Text, and a passage of up to 25 words as a Back-Cover Text,
|
|
to the end of the list of Cover Texts in the Modified Version.
|
|
Only one passage of Front-Cover Text and one of Back-Cover Text
|
|
may be added by (or through arrangements made by) any one entity.
|
|
If the Document already includes a cover text for the same cover,
|
|
previously added by you or by arrangement made by the same
|
|
entity you are acting on behalf of, you may not add another;
|
|
but you may replace the old one, on explicit permission from
|
|
the previous publisher that added the old one.
|
|
</para>
|
|
|
|
<para>
|
|
The author(s) and publisher(s) of the Document do not by this
|
|
License give permission to use their names for publicity for or
|
|
to assert or imply endorsement of any Modified Version.
|
|
</para>
|
|
|
|
<para> 5. COMBINING DOCUMENTS </para>
|
|
|
|
<para>
|
|
You may combine the Document with other documents released under
|
|
this License, under the terms defined in section 4 above for
|
|
modified versions, provided that you include in the combination
|
|
all of the Invariant Sections of all of the original documents,
|
|
unmodified, and list them all as Invariant Sections of your
|
|
combined work in its license notice, and that you preserve all
|
|
their Warranty Disclaimers.
|
|
</para>
|
|
|
|
<para>
|
|
The combined work need only contain one copy of this License,
|
|
and multiple identical Invariant Sections may be replaced with
|
|
a single copy. If there are multiple Invariant Sections with
|
|
the same name but different contents, make the title of each
|
|
such section unique by adding at the end of it, in parentheses,
|
|
the name of the original author or publisher of that section if
|
|
known, or else a unique number. Make the same adjustment to the
|
|
section titles in the list of Invariant Sections in the license
|
|
notice of the combined work.
|
|
</para>
|
|
|
|
<para>
|
|
In the combination, you must combine any sections Entitled
|
|
"History" in the various original documents, forming one section
|
|
Entitled "History"; likewise combine any sections Entitled
|
|
"Acknowledgements", and any sections Entitled "Dedications".
|
|
You must delete all sections Entitled "Endorsements".
|
|
</para>
|
|
|
|
<para> 6. COLLECTIONS OF DOCUMENTS </para>
|
|
|
|
<para>
|
|
You may make a collection consisting of the Document and other
|
|
documents released under this License, and replace the individual
|
|
copies of this License in the various documents with a single
|
|
copy that is included in the collection, provided that you follow
|
|
the rules of this License for verbatim copying of each of the
|
|
documents in all other respects.
|
|
</para>
|
|
|
|
<para>
|
|
You may extract a single document from such a collection and
|
|
distribute it individually under this License, provided you
|
|
insert a copy of this License into the extracted document and
|
|
follow this License in all other respects regarding verbatim
|
|
copying of that document.
|
|
</para>
|
|
|
|
<para> 7. AGGREGATION WITH INDEPENDENT WORKS </para>
|
|
|
|
<para>
|
|
A compilation of the Document or its derivatives with other
|
|
separate and independent documents or works, in or on a volume of
|
|
a storage or distribution medium, is called an "aggregate" if the
|
|
copyright resulting from the compilation is not used to limit the
|
|
legal rights of the compilation's users beyond what the individual
|
|
works permit. When the Document is included in an aggregate,
|
|
this License does not apply to the other works in the aggregate
|
|
which are not themselves derivative works of the Document.
|
|
</para>
|
|
|
|
<para>
|
|
If the Cover Text requirement of section 3 is applicable to these
|
|
copies of the Document, then if the Document is less than one
|
|
half of the entire aggregate, the Document's Cover Texts may be
|
|
placed on covers that bracket the Document within the aggregate,
|
|
or the electronic equivalent of covers if the Document is in
|
|
electronic form. Otherwise, they must appear on printed covers
|
|
that bracket the whole aggregate.
|
|
</para>
|
|
|
|
<para> 8. TRANSLATION </para>
|
|
|
|
<para>
|
|
Translation is considered a kind of modification, so you may
|
|
distribute translations of the Document under the terms of
|
|
section 4. Replacing Invariant Sections with translations
|
|
requires special permission from their copyright holders, but
|
|
you may include translations of some or all Invariant Sections
|
|
in addition to the original versions of these Invariant Sections.
|
|
You may include a translation of this License, and all the license
|
|
notices in the Document, and any Warranty Disclaimers, provided
|
|
that you also include the original English version of this License
|
|
and the original versions of those notices and disclaimers.
|
|
In case of a disagreement between the translation and the
|
|
original version of this License or a notice or disclaimer,
|
|
the original version will prevail.
|
|
</para>
|
|
|
|
<para>
|
|
If a section in the Document is Entitled "Acknowledgements",
|
|
"Dedications", or "History", the requirement (section 4) to
|
|
Preserve its Title (section 1) will typically require changing
|
|
the actual title.
|
|
</para>
|
|
|
|
<para> 9. TERMINATION </para>
|
|
|
|
<para>
|
|
You may not copy, modify, sublicense, or distribute the Document
|
|
except as expressly provided for under this License. Any other
|
|
attempt to copy, modify, sublicense, or distribute the Document
|
|
is void and will automatically terminate your rights under
|
|
this License. However, parties who have received copies, or
|
|
rights, from you under this License will not have their licenses
|
|
terminated so long as such parties remain in full compliance.
|
|
</para>
|
|
|
|
<para> 10. FUTURE REVISIONS OF THIS LICENSE </para>
|
|
|
|
<para>
|
|
The Free Software Foundation may publish new, revised versions of
|
|
the GNU Free Documentation License from time to time. Such new
|
|
versions will be similar in spirit to the present version
|
|
but may differ in detail to address new problems or concerns.
|
|
See http://www.gnu.org/copyleft/.
|
|
</para>
|
|
|
|
<para>
|
|
Each version of the License is given a distinguishing version
|
|
number. If the Document specifies that a particular numbered
|
|
version of this License "or any later version" applies to it,
|
|
you have the option of following the terms and conditions either
|
|
of that specified version or of any later version that has
|
|
been published (not as a draft) by the Free Software Foundation.
|
|
If the Document does not specify a version number of this License,
|
|
you may choose any version ever published (not as a draft)
|
|
by the Free Software Foundation.
|
|
</para>
|
|
|
|
<para> ADDENDUM: How to use this License for your documents </para>
|
|
|
|
<para>
|
|
To use this License in a document you have written, include
|
|
a copy of the License in the document and put the following
|
|
copyright and license notices just after the title page:
|
|
</para>
|
|
|
|
<para>
|
|
Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
|
|
distribute, and/or modify this document under the terms of the
|
|
GNU Free Documentation License, Version 1.2 or any later version
|
|
published by the Free Software Foundation; with no Invariant
|
|
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy
|
|
of the license is included in the section entitled "GNU Free
|
|
Documentation License".
|
|
</para>
|
|
|
|
<para>
|
|
If you have Invariant Sections, Front-Cover Texts and Back-Cover
|
|
Texts, replace the "with...Texts." line with this: with the
|
|
Invariant Sections being LIST THEIR TITLES, with the Front-Cover
|
|
Texts being LIST, and with the Back-Cover Texts being LIST.
|
|
If you have Invariant Sections without Cover Texts, or some other
|
|
combination of the three, merge those two alternatives to suit
|
|
the situation.
|
|
</para>
|
|
|
|
<para>
|
|
If your document contains nontrivial examples of program code,
|
|
we recommend releasing these examples in parallel under your
|
|
choice of free software license, such as the GNU General Public
|
|
License, to permit their use in free software.
|
|
</para>
|
|
</appendix>
|
|
|
|
</article>
|
|
|
|
<!-- Keep this comment at the end of the file Local variables:
|
|
mode: sgml sgml-omittag:t sgml-shorttag:t sgml-namecase-general:t
|
|
sgml-general-insert-case:lower sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:nil
|
|
sgml-parent-document:nil sgml-exposed-tags:nil sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil End: -->
|