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

NAME
     brooktree -- 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.
     The driver also supports FM Radio if the tuner supports it.

     Specifically, the following cards are known to work:

	   Hauppauge Wincast TV and WinTV/PCI
	   STB TV PCI Television Tuner
	   Miro PC TV
	   Intel Smart Video Recorder III
	   AverMedia cards
	   Video Highway XTreme
	   VideoLogic Captivator PCI

     The driver currently supports the following features:

	   PCI to PCI dma transfer
	   clipping
	   yuv
	   rgb16
	   rgb24
	   rgb32

     On  these 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  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 13  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

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

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.

FILES
     /usr/share/examples/meteor  Examples of what you can do with the (similarly
				 designed) Meteor driver.
     /usr/ports/graphics/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
				 installed.   It  also	requires  Motif  or  the
				 lesstif port.

SEE ALSO
     meteor(4)

HISTORY
     The brooktree driver first appeared in FreeBSD 2.2.

FreeBSD 4.9			January 28, 1998			 BKTR(4)

home | help