This patch does the following:

- correctly comments author info
- renames 8.5 to TV Cards and removes Introduction header
- minor word-smithing
- fixes acronym tags

Approved by:	bcr (mentor)
This commit is contained in:
Dru Lavigne 2013-10-11 12:18:18 +00:00
parent 3cc821b490
commit 181f2d4d16
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42937

View file

@ -6,6 +6,7 @@
-->
<chapter id="multimedia">
<!--
<chapterinfo>
<authorgroup>
<author>
@ -15,6 +16,7 @@
</author>
</authorgroup>
</chapterinfo>
-->
<title>Multimedia</title>
@ -1297,6 +1299,7 @@ zoom=yes</programlisting>
</sect1>
<sect1 id="tvcard">
<!--
<sect1info>
<authorgroup>
<author>
@ -1309,31 +1312,28 @@ zoom=yes</programlisting>
<author>
<firstname>Marc</firstname>
<surname>Fonvieille</surname>
<contrib>Enhanced and adapted by </contrib>
<!-- 02 January 2004 -->
<contrib>Enhanced and adapted by in January 2004</contrib>
</author>
</authorgroup>
</sect1info>
-->
<title>Setting Up TV Cards</title>
<title>TV Cards</title>
<indexterm>
<primary>TV cards</primary>
</indexterm>
<sect2>
<title>Introduction</title>
<para>TV cards allow can be used to watch broadcast or cable TV on
a computer. Most cards accept composite video via an RCA or
S-video input and some cards include a FM radio tuner.</para>
<para>TV cards can be used to watch broadcast or cable TV on
a computer. Most cards accept composite video via an <acronym>RCA</acronym> or
S-video input and some cards include a <acronym>FM</acronym> radio tuner.</para>
<para>&os; provides support for PCI-based TV cards using a
Brooktree Bt848/849/878/879 or a Conexant CN-878/Fusion 878a
video capture chip with the &man.bktr.4; driver. Ensure the
board comes with a supported tuner. Consult &man.bktr.4; for a
Brooktree Bt848/849/878/879
video capture chip with the &man.bktr.4; driver. This driver
supports most Pinnacle PCTV video cards. Before purchasing a TV card,
onsult &man.bktr.4; for a
list of supported tuners.</para>
</sect2>
<sect2>
<title>Loading the Driver</title>
@ -1358,7 +1358,7 @@ device smbus</programlisting>
components are interconnected via an I2C bus. Then, build and
install a new kernel.</para>
<para>To test the driver, reboot the system. The TV card
<para>To test that the tuner is correctly detected, reboot the system. The TV card
should appear in the boot messages, as seen in this
example:</para>
@ -1369,11 +1369,10 @@ 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>The messages will differ according to the hardware. Check
the messages to determine 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, to force the tuner to a Philips
<para>The messages will differ according to the hardware.
If necessary, it is possible to override some of the detected
parameters using &man.sysctl.8; or custom kernel configuration
options. For example, to force the tuner to a Philips
SECAM tuner, add the following line to a custom kernel
configuration file:</para>
@ -1383,9 +1382,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
<screen>&prompt.root; <userinput>sysctl hw.bt848.tuner=6</userinput></screen>
<para>Refer to &man.bktr.4; and
<filename>/usr/src/sys/conf/NOTES</filename> for more
details on the available options.</para>
<para>Refer to &man.bktr.4; for a description
of the available &man.sysctl.8; parameters and kernel options.</para>
</sect2>
<sect2>
@ -1421,8 +1419,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
<para>If any problems are encountered with the TV card,
check that the video capture chip and the tuner are
supported by &man.bktr.4; and that the right configuration
options were used. For more support and various questions
about TV cards, refer to the archives of the
options were used. For more support or to ask questions
about supported TV cards, refer to the
&a.multimedia.name; mailing list.</para>
</sect2>
</sect1>
@ -1430,68 +1428,64 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
<sect1 id="mythtv">
<title>MythTV</title>
<para>MythTV is a popular, open source <acronym
role="Personal Video Recorder">PVR</acronym>
<para>MythTV is a popular, open source Personal Video Recorder
(<acronym>PVR</acronym>)
application. This section demonstrates how to install and
setup MythTV on &os;. Refer to the <ulink
url="http://www.mythtv.org/wiki/">MythTV wiki</ulink> for
setup MythTV on &os;. Refer to <ulink
url="http://www.mythtv.org/wiki/">mythtv.org/wiki</ulink> for
more information on how to use MythTV.</para>
<para>MythTV requires a frontend and a backend; however,
it allows the user to have the frontend and backend on
<para>MythTV requires a frontend and a backend. These components
can either be installed on the same system or on
different machines.</para>
<para>For the frontend, <filename
role="package">multimedia/mythtv-frontend</filename> is
required, as well as an X server, which can be found in
<filename role="package">x11/xorg</filename>. Ideally, the
frontend computer also has a video card that supports <acronym
role="X-Video Motion Compensation">XvMC</acronym> and,
optionally, a <acronym role="Linux Infrared Remote
Control">LIRC</acronym>-compatible remote.</para>
<para>The frontend can be installed on &os; using the <filename
role="package">multimedia/mythtv-frontend</filename> package or port.
<application>&xorg;</application> must also be installed and configured as described in
<xref linkend="x11"/>. Ideally, this
system has a video card that supports X-Video Motion Compensation
(<acronym>XvMC</acronym>) and,
optionally, a Linux Infrared Remote Control
(<acronym>LIRC</acronym>)-compatible remote.</para>
<para>For the backend, <filename
role="package">multimedia/mythtv</filename> is required,
along with the &mysql; database server. Optionally a tuner
and storage for any recorded data. The &mysql; package should
be automatically installed as a dependency when installing
<filename role="package">multimedia/mythtv</filename>.</para>
<para>To install both the backend and the frontend on &os;, use the <filename
role="package">multimedia/mythtv</filename> package or port.
A &mysql; database server is also required and should
automatically be installed as a dependency.
Optionally, this system should have a tuner card
and sufficient storage to hold recorded data.</para>
<sect2>
<title>Hardware</title>
<para>MythTV is designed to utilize <acronym
role="Video for Linux">V4L</acronym> to access video input
devices such as encoders and tuners. At this time, MythTV
works best with <acronym role="Universal Serial
Bus">USB</acronym> DVB-S/C/T cards supported by <filename
role="package">multimedia/webcamd</filename>, as it provides
a <acronym
role="Video for Linux">V4L</acronym> userland application.
Any <acronym role="Digital Video Broadcasting">DVB</acronym>
<para>MythTV uses Video for Linux (<acronym>V4L</acronym>) to access video input
devices such as encoders and tuners. In &os;, MythTV
works best with <acronym>USB</acronym> DVB-S/C/T cards as they are well supported by the <filename
role="package">multimedia/webcamd</filename> package or port which provides
a <acronym>V4L</acronym> userland application.
Any Digital Video Broadcasting (<acronym>DVB</acronym>)
card supported by <application>webcamd</application> should
work with MythTV. A list of known working cards can be
found <ulink
url="http://wiki.freebsd.org/WebcamCompat">here</ulink>.
found at <ulink
url="http://wiki.freebsd.org/WebcamCompat">wiki.freebsd.org/WebcamCompat</ulink>.
Drivers are also available for Hauppauge cards in the
following ports: <filename
<filename
role="package">multimedia/pvr250</filename> and <filename
role="package">multimedia/pvrxxx</filename>, but they
role="package">multimedia/pvrxxx</filename> ports, but they
provide a non-standard driver interface that does not work
with versions of MythTV greater than 0.23. Due to licensing
restrictions, no packages are available and these two ports
must be compiled.</para>
<para>The <ulink url="http://wiki.freebsd.org/HTPC">HTPC
wiki page</ulink> contains a list of all available <acronym
role="Digital Video Broadcasting">DVB</acronym>
<para>The <ulink url="http://wiki.freebsd.org/HTPC">wiki.freebsd.org/HTPC</ulink>
page contains a list of all available <acronym>DVB</acronym>
drivers.</para>
</sect2>
<sect2>
<title>Setting up MythTV</title>
<title>Setting up the MythTV Backend</title>
<para>To install the MythTV port:</para>
<para>To install MythTV using the port:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/multimedia/mythtv</userinput>
&prompt.root; <userinput>make install</userinput></screen>
@ -1500,11 +1494,11 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
<screen>&prompt.root; <userinput>mysql -uroot -p &lt; /usr/local/share/mythtv/database/mc.sql</userinput></screen>
<para>Configure the backend:</para>
<para>Then, configure the backend:</para>
<screen>&prompt.root; <userinput>mythtv-setup</userinput></screen>
<para>Start the backend:</para>
<para>Finally, start the backend:</para>
<screen>&prompt.root; <userinput>echo 'mythbackend_enable="YES"' &gt;&gt; /etc/rc.conf</userinput>
&prompt.root; <userinput>service mythbackend start</userinput></screen>
@ -1512,16 +1506,17 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
</sect1>
<sect1 id="scanners">
<!--
<sect1info>
<authorgroup>
<author>
<firstname>Marc</firstname>
<surname>Fonvieille</surname>
<contrib>Written by </contrib>
<!-- 04 August 2004 -->
<contrib>Written by in August 2004</contrib>
</author>
</authorgroup>
</sect1info>
-->
<title>Image Scanners</title>