2 .\" $FreeBSD: src/share/man/man4/bktr.4,v 1.9.2.9 2002/03/29 09:55:39 schweikh Exp $
3 .\" $DragonFly: src/share/man/man4/bktr.4,v 1.7 2007/05/12 23:22:36 swildner Exp $
10 .Nd Brooktree Bt848/849/878/879 video capture driver
20 driver provides support for PCI
24 capture on low cost, high performance boards.
25 The driver is based on the Matrox Meteor driver and uses the same API.
28 driver should support most video cards
30 .Em "Brooktree Bt848/849/878/879 Video Capture Chip" .
31 The driver also supports
33 if the tuner supports it.
35 The driver currently supports the following features:
36 .Bd -unfilled -offset indent
37 PCI to PCI dma transfer
45 On the supported cards, tuners and other components are interconnected
47 The Brooktree848 chips act as a master device on the bus to control them.
53 controller declarations are mandatory to activate
57 The following kernel parameters may be used to further configure the driver:
59 .Cd options "BROOKTREE_ALLOC_PAGES=xxx"
60 specifies the number of contiguous pages to allocate when successfully
62 The default number of pages allocated by the kernel is 216.
63 This means that there are (216*4096) bytes available for use.
65 .Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
66 .Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
68 One of these options can be used to set the default video format for the driver.
69 This fixed random hangs and lockups with the VideoLogic Captivator PCI card.
71 The following sysctls may be used to further configure the driver:
73 .Em sysctl hw.bt848.card=nnnn
74 This can be used to override the card make which was detected at boot time.
76 is set to an integer from 1 to 13 taken from the following table:
78 .Bl -tag -compact -width 22n
103 .It VIDEO_HIGHWAY_XTREME
107 .Em sysctl hw.bt848.tuner=nnnn
108 This can be used to override the tuner make which was detected at boot time.
110 is set to an integer from 1 to 13 taken from the following table:
112 .Bl -tag -compact -width 22n
131 .It PHILIPS_FR1236_NTSC
132 9 /* These have FM Radio support */
133 .It PHILIPS_FR1216_PAL
134 10 /* These have FM Radio support */
135 .It PHILIPS_FR1236_SECAM
136 11 /* These have FM Radio support */
145 driver supports video capture cards based on the
146 Brooktree Bt848/849/878/879 chips, including:
150 Hauppauge Wincast TV and WinTV/PCI
152 STB TV PCI Television Tuner
156 Intel Smart Video Recorder III
162 VideoLogic Captivator PCI
165 .Bl -tag -width /usr/share/examples/meteor -compact
166 .It Pa /usr/share/examples/meteor
167 Examples of what you can do with the (similarly designed) Meteor driver.
168 .It Pa /usr/pkgsrc/multimedia/fxtv
169 A TV and Camera display program utilizing the
171 driver - requires that
172 .Em The X Window System
174 .Em The pkgsrc Collection
176 .It Pa /usr/pkgsrc/multimedia/alevt
177 A program to capture and display Teletext (VideoText) pages - requires that
178 .Em The X Window System
180 .Em The pkgsrc Collection
182 .It Pa /usr/pkgsrc/audio/xmradio
183 An FM Radio Tuner for cards which have an FM Radio tuner fitted - requires that
184 .Em The X Window System
186 .Em The pkgsrc Collection
199 driver first appeared in
203 This driver is based on the work of
204 .An Jim Lowe Aq james@miller.cs.uwm.edu ,
205 .An Mark Tinguely Aq tinguely@plains.nodak.edu ,
206 .An Amancio Hasty Aq hasty@star-gate.com ,
207 .An Roger Hardiman Aq roger@FreeBSD.org
208 and a bunch of other people.