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 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:

       •   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/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/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>.

Debian                                          January 18, 2006                                         BKTR(4)