home | help
BKTR(4) 		     Kernel Interfaces Manual			 BKTR(4)

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  Me-
     teor  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  dec-
     larations are mandatory to activate bktr support.

     The  following  kernel parameters may be used to further configure the dri-
     ver:

     options BROOKTREE_ALLOC_PAGES=xxx specifies the number of contiguous  pages
     to  allocate  when  successfully probed.  The default number of pages allo-
     cated 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  in-
				 stalled.
     /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  in-
				 stalled.  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>.

FreeBSD 7.1			January 18, 2006			 BKTR(4)

home | help