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>
This commit is contained in:
Marc Fonvieille 2004-01-02 22:02:04 +00:00
parent 67a8f07455
commit 10cf2f7a86
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=19431

View file

@ -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: &lt;BrookTree 848A&gt; mem 0xd7000000-0xd7000fff irq 10 at device 10.0 on pci0
iicbb0: &lt;I2C bit-banging driver&gt; on bti2c0
iicbus0: &lt;Philips I2C bus&gt; on iicbb0 master-only
iicbus1: &lt;Philips I2C bus&gt; on iicbb0 master-only
smbus0: &lt;System Management Bus&gt; 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;&nbsp;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>
<!--