docs/60749: [patch] handbook/multimedia: add chapter about tv cards

[Josef El-Rayes]

>Number:         60749
>Category:       docs
>Synopsis:       [patch] handbook/multimedia: add chapter about tv cards
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 30 17:00:36 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Josef El-Rayes
>Release:        FreeBSD 4.9-STABLE i386
>Organization:
>Environment:
System: FreeBSD jenny.daemon.li 4.9-STABLE FreeBSD 4.9-STABLE #5: Sun Nov 16 23:10:01 CET 2003 josef at jenny.daemon.li:/usr/obj/usr/src/sys/JENNY i386


	
>Description:
  this patch adds a chapter about tv cards. based on bktr manpage
  and bktr_card.h.
	
>How-To-Repeat:
	
>Fix:

	

--- chapter.sgml.diff begins here ---
--- chapter.sgml.orig	Wed Dec 31 01:45:11 2003
+++ chapter.sgml	Wed Dec 31 01:51:35 2003
@@ -1442,6 +1442,97 @@
     </itemizedlist>
 
   </sect2>
+ </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>
  </sect1>
 </chapter>
 
--- chapter.sgml.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: