Provided by: freebsd-manpages_7.0-2_all bug

NAME

     bktr - Brooktree Bt848/849/878/879 and Pinnacle PCTV video capture driver

SYNOPSIS

     device bktr

     device iicbus
     device iicbb
     device smbus

DESCRIPTION

     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 Brooktree Bt848/849/878/879 Video Capture Chip.
     Also supported are most Pinnacle PCTV video cards.  Furthermore, the
     driver supports FM Radio 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)
     controller declarations are mandatory to activate bktr support.

     The following kernel parameters may be used to further configure the
     driver:

     options BROOKTREE_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.

     options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
     options BROOKTREE_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
     Captivator PCI card.

     The following sysctls may be used to further configure the driver:

     sysctl hw.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

     sysctl hw.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 1 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:

     ·   AOpen VA1000
     ·   AVerMedia AVerTV Studio
     ·   AVerMedia TF/FM-98
     ·   ATI TV Wonder VE
     ·   Hauppauge WinCast/TV
     ·   Hauppauge WinTV-Go-FM
     ·   Hauppauge WinTV-pci
     ·   Hauppauge WinTV-radio
     ·   Intel Smart Video Recorder III
     ·   KWORLD PCI TV Tuner
     ·   Miro PC TV
     ·   Pinnacle PCTV Pro
     ·   Pinnacle PCTV Rave
     ·   PixelView PlayTV PAK
     ·   PixelView PlayTV Pro (rev 4C, 9D)
     ·   SIGMA TV II
     ·   STB TV PCI Television Tuner
     ·   Super TV Tuner
     ·   TerraTec TValue
     ·   V-Stream XPERT TV-PVR 878
     ·   Video Highway XTreme
     ·   VideoLogic Captivator PCI

FILES

     /usr/share/examples/meteor  Examples of what you can do with the
                                 (similarly designed) Meteor driver.
     /usr/ports/multimedia/fxtv  A TV and Camera display program utilizing the
                                 bktr driver - requires that The X Window
                                 System and The Ports Collection also be
                                 installed.
     /usr/ports/misc/alevt       A program to capture and display Teletext
                                 (VideoText) pages - requires that The X
                                 Window System and The Ports Collection also
                                 be installed.
     /usr/ports/audio/xmradio    An FM Radio Tuner for cards which have an FM
                                 Radio tuner fitted - requires that The X
                                 Window System and The Ports Collection also
                                 be installed.  It also requires Motif or the
                                 lesstif port.

SEE ALSO

     meteor(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〉.