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>

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: &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>
 
 <!--