Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-tvcard.mdwn
1 \r
2 \r
3 ## 16.5 Setting Up TV Cards \r
4 \r
5 ***Original contribution by Josef El-Rayes. Enhanced and adapted by Marc Fonvieille. ***\r
6 \r
7 ### 16.5.1 Introduction \r
8 \r
9 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 input and some of these cards come with a FM radio tuner.\r
10 \r
11 DragonFly 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 [bktr(4)](http://leaf.dragonflybsd.org/cgi/web-man?command#bktr&section4) driver. You must also ensure the board comes with a supported tuner, consult the [bktr(4)](http://leaf.dragonflybsd.org/cgi/web-man?command=bktr&section=4) manual page for a list of supported tuners.\r
12 \r
13 ### 16.5.2 Adding the Driver \r
14 \r
15 To use your card, you will need to load the [bktr(4)](http://leaf.dragonflybsd.org/cgi/web-man?command#bktr&section4) driver, this can be done by adding the following line to the `/boot/loader.conf` file like this:\r
16 \r
17     \r
18     bktr_load="YES"\r
19 \r
20 \r
21 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:\r
22 \r
23     \r
24     device      bktr\r
25     device      iicbus\r
26     device      iicbb\r
27     device      smbus\r
28 \r
29 \r
30 These additional device drivers are necessary because of the card components being interconnected via an I2C bus. Then build and install a new kernel.\r
31 \r
32 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:\r
33 \r
34     \r
35     bktr0: <BrookTree 848A> mem 0xd7000000-0xd7000fff irq 10 at device 10.0 on pci0\r
36     iicbb0: <I2C bit-banging driver on bti2c0\r
37     iicbus0: <Philips I2C bus> on iicbb0 master-only\r
38     iicbus1: <Philips I2C bus> on iicbb0 master-only>\r
39     smbus0: <System Management Bus&> on bti2c0\r
40     bktr0: Pinnacle/Miro TV, Philips SECAM tuner.\r
41 \r
42 \r
43 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 [sysctl(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#sysctl&section8) 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:\r
44 \r
45     \r
46     options OVERRIDE_TUNER=6\r
47 \r
48 \r
49 or you can directly use [sysctl(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#sysctl&section8):\r
50 \r
51     \r
52     # sysctl hw.bt848.tuner=6\r
53 \r
54 \r
55 See the [bktr(4)](http://leaf.dragonflybsd.org/cgi/web-man?command#bktr&section4) manual page and the `/usr/src/sys/config/LINT` file for more details on the available options.\r
56 \r
57 ### 16.5.3 Useful Applications \r
58 \r
59 To use your TV card you need to install one of the following applications:\r
60 \r
61
62 * [multimedia/fxtv](http://pkgsrc.se/multimedia/fxtv) provides TV-in-a-window and image/audio/video capture capabilities.\r
63
64 * [multimedia/xawtv](http://pkgsrc.se/multimedia/xawtv) is also a TV application, with the same features as  **fxtv** .\r
65
66 * [multimedia/alevt](http://pkgsrc.se/multimedia/alevt) decodes and displays Videotext/Teletext.\r
67
68 * [audio/xmradio](http://pkgsrc.se/audio/xmradio), an application to use the FM radio tuner coming with some TV cards.\r
69 \r
70 More applications are available in the pkgsrcĀ® tree.\r
71 \r
72 ### 16.5.4 Troubleshooting \r
73 \r
74 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 [bktr(4)](http://leaf.dragonflybsd.org/cgi/web-man?command#bktr&section4) driver 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 [DragonFly User related mailing list](http://leaf.dragonflybsd.org/mailarchive/).\r
75 \r
76 \r
77 \r
78 CategoryHandbook\r
79 CategoryHandbook-multimedia\r