Date: Wed, 31 Dec 2003 01:54:25 +0100 (CET) From: Josef El-Rayes <josef@daemon.li> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/60749: [patch] handbook/multimedia: add chapter about tv cards Message-ID: <20031231005425.C24B96D0@jenny.daemon.li> Resent-Message-ID: <200312310100.hBV10bN6032828@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031231005425.C24B96D0>