9 .Nd Brooktree Bt848/849/878/879 and Pinnacle PCTV video capture driver
19 driver provides support for PCI
23 capture on low cost, high performance boards.
24 The driver is based on the Matrox Meteor driver and uses the same API.
27 driver should support most video cards based on the
28 .Em "Brooktree Bt848/849/878/879 Video Capture Chip" .
29 Also supported are most
32 Furthermore, the driver supports
34 if the tuner supports it.
36 The driver currently supports the following features:
37 .Bd -unfilled -offset indent
38 PCI to PCI dma transfer
46 On the supported cards, tuners and other components are interconnected
48 The Brooktree848 chips act as a master device on the bus to control them.
54 controller declarations are mandatory to activate
58 The following kernel parameters may be used to further configure the driver:
60 .Em options "BROOKTREE_ALLOC_PAGES=xxx"
61 specifies the number of contiguous pages to allocate when successfully
63 The default number of pages allocated by the kernel is 216.
64 This means that there are (216*4096) bytes available for use.
66 .Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
67 .Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
69 One of these options can be used to set the default video format for the driver.
70 This fixed random hangs and lockups with the VideoLogic Captivator PCI card.
72 The following sysctls may be used to further configure the driver:
74 .Em sysctl hw.bt848.card=nnnn
75 This can be used to override the card make which was detected at boot time.
77 is set to an integer from 1 to 23 taken from the following table:
79 .Bl -tag -compact -width 30n
104 .It VIDEO_HIGHWAY_XTREME
106 .It ASKEY_DYNALINK_MAGIC_TVIEW
116 .It PINNACLE_PCTV_RAVE
118 .It PIXELVIEW_PLAYTV_PAK
122 .It PIXELVIEW_PLAYTV_PRO_REV_4C
128 .Em sysctl hw.bt848.tuner=nnnn
129 This can be used to override the tuner make which was detected at boot time.
131 is set to an integer from 0 to 16 taken from the following table:
133 .Bl -tag -compact -width 22n
152 .It PHILIPS_FR1236_NTSC
153 9 /* These have FM Radio support */
154 .It PHILIPS_FR1216_PAL
155 10 /* These have FM Radio support */
156 .It PHILIPS_FR1236_SECAM
157 11 /* These have FM Radio support */
164 .It LG_TPI8PSB12P_PAL
172 driver supports video capture cards based on the
173 Brooktree Bt848/849/878/879 chips, as well as
174 Pinnacle PCTV cards, including:
180 AVerMedia AVerTV Studio
188 Hauppauge WinTV-Go-FM
192 Hauppauge WinTV-radio
194 Intel Smart Video Recorder III
206 PixelView PlayTV Pro (rev 4C, 9D)
210 STB TV PCI Television Tuner
216 V-Stream XPERT TV-PVR 878
220 VideoLogic Captivator PCI
223 .Bl -tag -width /usr/share/examples/meteor -compact
224 .It Pa /usr/share/examples/meteor
225 Examples of what you can do with the (similarly designed) Meteor driver.
226 .It Pa /usr/ports/multimedia/fxtv
227 A TV and Camera display program utilizing the bktr driver - requires that
228 .Em The X Window System
230 .Em The Ports Collection
232 .It Pa /usr/ports/misc/alevt
233 A program to capture and display Teletext (VideoText) pages - requires that
234 .Em The X Window System
236 .Em The Ports Collection
238 .It Pa /usr/ports/audio/xmradio
239 An FM Radio Tuner for cards which have an FM Radio tuner fitted - requires that
240 .Em The X Window System
242 .Em The Ports Collection
255 driver first appeared in
259 This driver is based on the work of
260 .An Jim Lowe Aq james@miller.cs.uwm.edu ,
261 .An Mark Tinguely Aq tinguely@plains.nodak.edu ,
262 .An Amancio Hasty Aq hasty@star-gate.com ,
263 .An Roger Hardiman Aq roger@FreeBSD.org
264 and a bunch of other people.
265 Support for Pinnacle PCTV Rave cards was added by
266 .An Branko Lankester Aq branko@euro.net .