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:
parent
67a8f07455
commit
10cf2f7a86
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=19431
1 changed files with 142 additions and 0 deletions
|
@ -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>
|
||||
|
||||
<!--
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue