FreeBSD Man Pages

BKTR(4) FreeBSD Kernel Interfaces Manual BKTR(4)
NAMEbktr -- Brooktree Bt848/849/878/879 and Pinnacle PCTV video capture
driver
SYNOPSISdevicebktrdeviceiicbusdeviceiicbbdevicesmbusDESCRIPTION
The bktr driver provides support for PCI video capture and VBI capture on
low cost, high performance boards. The driver is based on the Matrox
Meteor driver and uses the same API. The bktr driver should support most
video cards based on the BrooktreeBt848/849/878/879VideoCaptureChip.
Also supported are most PinnaclePCTV video cards. Furthermore, the
driver supports FMRadio if the tuner supports it.
The driver currently supports the following features:
PCI to PCI dma transfer
clipping
yuv
rgb16
rgb24
rgb32
On the supported cards, tuners and other components are interconnected
with an I2C bus. The Brooktree848 chips act as a master device on the
bus to control them. Therefore, iicbus(4), iicbb(4) and smbus(4) con-
troller declarations are mandatory to activate bktr support.
The following kernel parameters may be used to further configure the
driver:
optionsBROOKTREE_ALLOC_PAGES=xxx specifies the number of contiguous
pages to allocate when successfully probed. The default number of pages
allocated by the kernel is 216. This means that there are (216*4096)
bytes available for use.
optionsBROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PALoptionsBROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
One of these options can be used to set the default video format for the
driver. This fixed random hangs and lockups with the VideoLogic Captiva-
tor PCI card.
The following sysctls may be used to further configure the driver:
sysctlhw.bt848.card=nnnn This can be used to override the card make
which was detected at boot time. `nnnn' is set to an integer from 1 to
23 taken from the following table:
MIRO 1
HAUPPAUGE 2
STB 3
INTEL 4
IMS_TURBO 5
AVER_MEDIA 6
OSPREY 7
NEC_PK 8
IO_GV 9
FLYVIDEO 10
ZOLTRIX 11
KISS 12
VIDEO_HIGHWAY_XTREME 13
ASKEY_DYNALINK_MAGIC_TVIEW 14
LEADTEK 15
TERRATVPLUS 16
IO_BCTV3 17
AOPEN_VA1000 18
PINNACLE_PCTV_RAVE 19
PIXELVIEW_PLAYTV_PAK 20
TERRATVALUE 21
PIXELVIEW_PLAYTV_PRO_REV_4C 22
Bt848_MAX 23
sysctlhw.bt848.tuner=nnnn This can be used to override the tuner make
which was detected at boot time. `nnnn' is set to an integer from 0 to
16 taken from the following table:
NO_TUNER 0
TEMIC_NTSC 1
TEMIC_PAL 2
TEMIC_SECAM 3
PHILIPS_NTSC 4
PHILIPS_PAL 5
PHILIPS_SECAM 6
TEMIC_PALI 7
PHILIPS_PALI 8
PHILIPS_FR1236_NTSC 9 /* These have FM Radio support */
PHILIPS_FR1216_PAL 10 /* These have FM Radio support */
PHILIPS_FR1236_SECAM 11 /* These have FM Radio support */
ALPS_TSCH5 12
ALPS_TSBH1 13
MT2032 14
LG_TPI8PSB12P_PAL 15
Bt848_MAX 16
HARDWARE
The bktr driver supports video capture cards based on the Brooktree
Bt848/849/878/879 chips, as well as Pinnacle PCTV cards, including:
+o AOpen VA1000
+o AVerMedia AVerTV Studio
+o AVerMedia TF/FM-98
+o ATI TV Wonder VE
+o Hauppauge WinCast/TV
+o Hauppauge WinTV-Go-FM
+o Hauppauge WinTV-pci
+o Hauppauge WinTV-radio
+o Intel Smart Video Recorder III
+o KWORLD PCI TV Tuner
+o Miro PC TV
+o Pinnacle PCTV Pro
+o Pinnacle PCTV Rave
+o PixelView PlayTV PAK
+o PixelView PlayTV Pro (rev 4C, 9D)
+o SIGMA TV II
+o STB TV PCI Television Tuner
+o Super TV Tuner
+o TerraTec TValue
+o V-Stream XPERT TV-PVR 878
+o Video Highway XTreme
+o VideoLogic Captivator PCI
FILES
/usr/share/examples/meteor Examples of what you can do with the (simi-
larly designed) Meteor driver.
/usr/ports/multimedia/fxtv A TV and Camera display program utilizing the
bktr driver - requires that TheXWindowSystem and ThePortsCollection also be
installed.
/usr/ports/misc/alevt A program to capture and display Teletext
(VideoText) pages - requires that TheXWindowSystem and ThePortsCollection also
be installed.
/usr/ports/audio/xmradio An FM Radio Tuner for cards which have an FM
Radio tuner fitted - requires that TheXWindowSystem and ThePortsCollection also
be installed. It also requires Motif or the
lesstif port.
SEE ALSOmeteor(4)HISTORY
The bktr driver first appeared in FreeBSD 2.2.
AUTHORS
This driver is based on the work of Jim Lowe <james@miller.cs.uwm.edu>,
Mark Tinguely <tinguely@plains.nodak.edu>, Amancio Hasty
<hasty@star-gate.com>, Roger Hardiman <roger@FreeBSD.org> and a bunch of
other people. Support for Pinnacle PCTV Rave cards was added by Branko
Lankester <branko@euro.net>.
FreeBSD 10.1 January 18, 2006 FreeBSD 10.1