</sect1> 

 <sect1 id="tvcard">

   <sect1info>

     <authorgroup>

       <author>

         <firstname>Josef</firstname>

         <surname>El-Rayes</surname>

         <contrib>Contributed by</contrib>

         <!-- 30 December 2003 -->

       </author>

     </authorgroup>

   </sect1info>

   <title>Setup and Use of TV Cards</title>

    <sect2 id="tvcard-setup">

      <title>Set up the driver</title>

      <para>Most pci-based tv cards come with a Brooktree Bt848/849/878/879

	Video Capture Chip, which is supported by the &man.bktr.4; driver.

	FM tuner chips are also supported.  To have your kernel support

	your card just add the &man.bktr.4; driver 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.  Additionally, you

	should add an entry whether you are going to use PAL or NTSC, to

	avoid possible problems with your card.</para>

      <programlisting>

	options        BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL

	options        BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC

      </programlisting>

      <para>On booting, the driver tries to detect your card automatically.

	If this fails, you can set your card manually in your kernel

	configuration file:</para>

      <programlisting>

	options BKTR_OVERRIDE CARD=1

      </programlisting>

      <para>or by using &man.sysctl.8;:</para>

      <screen>&prompt.root; <userinput>sysctl -w hw.bt848.card=1</userinput></screen>

      <para>See the manpage for details on what type to set.</para>

    </sect2>

    <sect2 id="tvcard-use">

      <title>Useful applications</title>

      <para>To actually enjoy 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

	    fxtv.</para>

	</listitem>

	<listitem>

	  <para><filename role="package">multimedia/nxtvepg</filename>,

	    a Decoder, Browser and Analyzer for the Nextview Electronic

	    Programme Guide.</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>

    </sect2>