diff options
author | Marc Fonvieille <blackend@FreeBSD.org> | 2004-01-02 22:02:04 +0000 |
---|---|---|
committer | Marc Fonvieille <blackend@FreeBSD.org> | 2004-01-02 22:02:04 +0000 |
commit | 10cf2f7a8643b103207e034814d0d0f6a9c0dc13 (patch) | |
tree | f09674f313cdf674af50bd7e46a9adf255999096 /en_US.ISO8859-1/books/handbook/multimedia | |
parent | 67a8f074559f22ca85e8edde2b9f3ebb4c08bd04 (diff) | |
download | doc-10cf2f7a8643b103207e034814d0d0f6a9c0dc13.tar.gz doc-10cf2f7a8643b103207e034814d0d0f6a9c0dc13.zip |
Add a section about TV cards configuration. I quite totally rewrote the
submission, but I kept the submitter in section credits.
PR: docs/60749
Submitted by: Josef El-Rayes <josef@daemon.li>
Notes
Notes:
svn path=/head/; revision=19431
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/multimedia')
-rw-r--r-- | en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml | 142 |
1 files changed, 142 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml index ceeb2c362f..5197af264c 100644 --- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml @@ -1443,6 +1443,148 @@ zoom=yes</programlisting> </sect2> </sect1> + + <sect1 id="tvcard"> + <sect1info> + <authorgroup> + <author> + <firstname>Josef</firstname> + <surname>El-Rayes</surname> + <contrib>Original contribution by </contrib> + </author> + </authorgroup> + <authorgroup> + <author> + <firstname>Marc</firstname> + <surname>Fonvieille</surname> + <contrib>Enhanced and adapted by </contrib> + <!-- 02 January 2004 --> + </author> + </authorgroup> + </sect1info> + + <title>Setting Up TV Cards</title> + <indexterm> + <primary>TV cards</primary> + </indexterm> + + <sect2> + <title>Introduction</title> + + <para>TV cards allow you to watch broadcast or cable TV on your + computer. Most of them accept composite video via an RCA or + S-video inputs and some of these cards come with a FM + radio tuner.</para> + + <para>&os; provides support for PCI-based TV cards using a + Brooktre Bt848/849/878/879 or a Conexant CN-878/Fusion 878a + Video Capture Chip with the &man.bktr.4; driver. You must + also ensure the board comes with a supported tuner, consult + the &man.bktr.4; manual page for a list of supported + tuners.</para> + </sect2> + + <sect2> + <title>Adding the Driver</title> + + <para>To use your card, you will need to load the &man.bktr.4; + driver, this can be done by adding the following line to the + <filename>/boot/loader.conf</filename> file like this:</para> + + <programlisting>bktr_load="YES"</programlisting> + + <para>Alternatively, you may statically compile the support for + the TV card in your kernel, in that case add the following + lines to your kernel configuration:</para> + + <programlisting>device bktr +device iicbus +device iicbb +device smbus</programlisting> + + <para>These additional device drivers are necessary because of the + components being interconnected via an I2C bus. Then build + and install a new kernel.</para> + + <para>Once the support was added to your system, you have to + reboot your machine. During the boot process, your TV card + should show up, like this:</para> + + <programlisting>bktr0: <BrookTree 848A> mem 0xd7000000-0xd7000fff irq 10 at device 10.0 on pci0 +iicbb0: <I2C bit-banging driver> on bti2c0 +iicbus0: <Philips I2C bus> on iicbb0 master-only +iicbus1: <Philips I2C bus> on iicbb0 master-only +smbus0: <System Management Bus> on bti2c0 +bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting> + + <para>Of course these messages can differ according to your + hardware. However you should check if the tuner is correctly + detected; it is still possible to override some of the + detected parameters with &man.sysctl.8; MIBs and kernel + configuration file options. For example, if you want to force + the tuner to a Philips SECAM tuner, you should add the + following line to your kernel configuration file:</para> + + <programlisting>options OVERRIDE_TUNER=6</programlisting> + + <para>or you can directly use &man.sysctl.8;:</para> + + <screen>&prompt.root; <userinput>sysctl hw.bt848.tuner=6</userinput></screen> + + <para>See the &man.bktr.4; manual page and the + <filename>/usr/src/sys/conf/NOTES</filename> file for more + details on the available options. (If you are under + &os; 4.X, <filename>/usr/src/sys/conf/NOTES</filename> is + replaced with + <filename>/usr/src/sys/i386/conf/LINT</filename>.)</para> + </sect2> + + <sect2> + <title>Useful Applications</title> + + <para>To use your TV card you need to install one of the + following applications:</para> + + <itemizedlist> + <listitem> + <para><filename role="package">multimedia/fxtv</filename> + provides TV-in-a-window and image/audio/video capture + capabilities.</para> + </listitem> + <listitem> + <para><filename role="package">multimedia/xawtv</filename> + is also a TV application, with the same features as + <application>fxtv</application>.</para> + </listitem> + <listitem> + <para><filename role="package">misc/alevt</filename>decodes + and displays Videotext/Teletext.</para> + </listitem> + <listitem> + <para><filename role="package">audio/xmradio</filename>, a FM + radio tuner for cards that come with a FM radio tuner.</para> + </listitem> + <listitem> + <para><filename role="package">audio/wmtune</filename>, a handy + dockapp for radio tuners.</para> + </listitem> + </itemizedlist> + + <para>More applications are available in the &os; Ports + Collection.</para> + </sect2> + + <sect2> + <title>Troubleshooting</title> + + <para>If you encounter any problem with your TV card, you should + check at first if the video capture chip and the tuner are + really supported by the &man.bktr.4; and if you used the right + configuration options. For more support and various questions + about your TV card you may want to contact and use the + archives of the &a.multimedia.name; mailing list.</para> + </sect2> + </sect1> </chapter> <!-- |