1998-03-09 10:56:22 +00:00
|
|
|
.\"
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
1998-03-09 10:56:22 +00:00
|
|
|
.\"
|
|
|
|
|
.Dd January 28, 1998
|
|
|
|
|
.Dt BKTR 4 i386
|
|
|
|
|
.Os FreeBSD 2.2
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm brooktree
|
|
|
|
|
.Nd video capture driver
|
|
|
|
|
.Sh SYNOPSIS
|
2000-01-23 17:00:18 +00:00
|
|
|
.Nm device bktr
|
1998-11-04 22:13:35 +00:00
|
|
|
.Pp
|
2000-01-23 17:00:18 +00:00
|
|
|
.Nm device iicbus
|
|
|
|
|
.Nm device iicbb
|
|
|
|
|
.Nm device smbus
|
1998-03-09 10:56:22 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.Nm bktr
|
|
|
|
|
driver provides support for PCI
|
|
|
|
|
.Em video
|
1999-09-22 17:36:43 +00:00
|
|
|
capture and
|
|
|
|
|
.Em VBI
|
|
|
|
|
capture on low cost, high performance boards. The driver based on
|
|
|
|
|
the Matrox Meteor driver and uses the same API. The bktr driver should support most video cards
|
1998-03-09 10:56:22 +00:00
|
|
|
based on the
|
1999-09-22 17:36:43 +00:00
|
|
|
.Em Brooktree Bt848/849/878/879 Video Capture Chip.
|
|
|
|
|
The driver also supports
|
|
|
|
|
.Em FM Radio
|
|
|
|
|
if the Tuner supports it.
|
1998-03-09 10:56:22 +00:00
|
|
|
.Pp
|
|
|
|
|
Specifically, the following cards are known to work:
|
2000-05-12 08:28:01 +00:00
|
|
|
.Bd -unfilled -offset indent
|
1999-09-22 17:36:43 +00:00
|
|
|
.Em Hauppage Wincast TV and WinTV/PCI
|
1998-03-09 10:56:22 +00:00
|
|
|
.Em STB TV PCI Television Tuner
|
|
|
|
|
.Em Miro PC TV
|
|
|
|
|
.Em Intel Smart Video Recorder III
|
1999-09-22 17:36:43 +00:00
|
|
|
.Em AverMedia cards
|
|
|
|
|
.Em Video Highway XTreme
|
|
|
|
|
.Em VideoLogic Captivator PCI
|
2000-05-12 08:28:01 +00:00
|
|
|
.Ed
|
1998-03-09 10:56:22 +00:00
|
|
|
.Pp
|
|
|
|
|
The driver currently supports the following features:
|
2000-05-12 08:28:01 +00:00
|
|
|
.Bd -unfilled -offset indent
|
1998-03-09 10:56:22 +00:00
|
|
|
PCI to PCI dma transfer
|
|
|
|
|
clipping
|
|
|
|
|
yuv
|
|
|
|
|
rgb16
|
|
|
|
|
rgb24
|
|
|
|
|
rgb32
|
2000-05-12 08:28:01 +00:00
|
|
|
.Ed
|
1998-03-09 10:56:22 +00:00
|
|
|
.Pp
|
1998-11-04 22:13:35 +00:00
|
|
|
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,
|
|
|
|
|
.Xr iicbus 4 ,
|
|
|
|
|
.Xr iicbb 4
|
|
|
|
|
and
|
|
|
|
|
.Xr smbus 4
|
1999-09-22 17:36:43 +00:00
|
|
|
controller declarations are mandatory to activate bktr support.
|
1998-11-04 22:13:35 +00:00
|
|
|
.Pp
|
1998-03-09 10:56:22 +00:00
|
|
|
The following kernel parameters may be used to further configure the driver:
|
|
|
|
|
.Pp
|
|
|
|
|
.Em 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.
|
2000-05-12 08:28:01 +00:00
|
|
|
.Bd -unfilled
|
1999-09-22 17:36:43 +00:00
|
|
|
.Em options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
|
|
|
|
|
.Em options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
|
2000-05-12 08:28:01 +00:00
|
|
|
.Ed
|
2000-03-03 14:05:08 +00:00
|
|
|
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.
|
1999-09-22 17:36:43 +00:00
|
|
|
.Pp
|
|
|
|
|
The following sysctls may be used to further configure the driver:
|
|
|
|
|
.Pp
|
|
|
|
|
.Em sysctl hw.bt848.card=nnnn
|
|
|
|
|
This can be used to override the card make which was detected at boot time.
|
2000-11-17 15:40:57 +00:00
|
|
|
.Ql nnnn
|
|
|
|
|
is set to an integer from 1 to 13 taken from the following table:
|
2000-05-12 08:28:01 +00:00
|
|
|
.Pp
|
|
|
|
|
.Bl -tag -compact -width 22n
|
|
|
|
|
.It MIRO
|
|
|
|
|
1
|
|
|
|
|
.It HAUPPAUGE
|
|
|
|
|
2
|
|
|
|
|
.It STB
|
|
|
|
|
3
|
|
|
|
|
.It INTEL
|
|
|
|
|
4
|
|
|
|
|
.It IMS_TURBO
|
|
|
|
|
5
|
|
|
|
|
.It AVER_MEDIA
|
|
|
|
|
6
|
|
|
|
|
.It OSPREY
|
|
|
|
|
7
|
|
|
|
|
.It NEC_PK
|
|
|
|
|
8
|
|
|
|
|
.It IO_GV
|
|
|
|
|
9
|
|
|
|
|
.It FLYVIDEO
|
|
|
|
|
10
|
|
|
|
|
.It ZOLTRIX
|
|
|
|
|
11
|
|
|
|
|
.It KISS
|
|
|
|
|
12
|
|
|
|
|
.It VIDEO_HIGHWAY_XTREME
|
|
|
|
|
13
|
|
|
|
|
.El
|
1999-09-22 17:36:43 +00:00
|
|
|
.Pp
|
|
|
|
|
.Em sysctl hw.bt848.tuner=nnnn
|
|
|
|
|
This can be used to override the tuner make which was detected at boot time.
|
2000-11-17 15:40:57 +00:00
|
|
|
.Ql nnnn
|
|
|
|
|
is set to an integer from 1 to 13 taken from the following table:
|
2000-05-12 08:28:01 +00:00
|
|
|
.Pp
|
|
|
|
|
.Bl -tag -compact -width 22n
|
|
|
|
|
.It NO_TUNER
|
|
|
|
|
0
|
|
|
|
|
.It TEMIC_NTSC
|
|
|
|
|
1
|
|
|
|
|
.It TEMIC_PAL
|
|
|
|
|
2
|
|
|
|
|
.It TEMIC_SECAM
|
|
|
|
|
3
|
|
|
|
|
.It PHILIPS_NTSC
|
|
|
|
|
4
|
|
|
|
|
.It PHILIPS_PAL
|
|
|
|
|
5
|
|
|
|
|
.It PHILIPS_SECAM
|
|
|
|
|
6
|
|
|
|
|
.It TEMIC_PALI
|
|
|
|
|
7
|
|
|
|
|
.It PHILIPS_PALI
|
|
|
|
|
8
|
|
|
|
|
.It PHILIPS_FR1236_NTSC
|
|
|
|
|
9 /* These have FM Radio support */
|
|
|
|
|
.It PHILIPS_FR1216_PAL
|
|
|
|
|
10 /* These have FM Radio support */
|
|
|
|
|
.It PHILIPS_FR1236_SECAM
|
|
|
|
|
11 /* These have FM Radio support */
|
|
|
|
|
.It ALPS_TSCH5
|
|
|
|
|
12
|
|
|
|
|
.It ALPS_TSBH1
|
|
|
|
|
13
|
1999-09-22 17:36:43 +00:00
|
|
|
.Pp
|
1999-08-15 10:48:36 +00:00
|
|
|
.Sh AUTHORS
|
1998-03-09 10:56:22 +00:00
|
|
|
This driver is based on the work of
|
|
|
|
|
.An Jim Lowe Aq james@miller.cs.uwm.edu ,
|
|
|
|
|
.An Mark Tinguely Aq tinguely@plains.nodak.edu ,
|
1999-09-22 17:36:43 +00:00
|
|
|
.An Amancio Hasty Aq hasty@star-gate.com ,
|
2000-05-12 08:28:01 +00:00
|
|
|
.An Roger Hardiman Aq roger@FreeBSD.org
|
1998-03-09 10:56:22 +00:00
|
|
|
and a bunch of other people.
|
|
|
|
|
.Sh FILES
|
|
|
|
|
.Bl -tag -width /usr/share/examples/meteor -compact
|
|
|
|
|
.It Pa /usr/share/examples/meteor
|
|
|
|
|
Examples of what you can do with the (similarly designed) Meteor driver.
|
|
|
|
|
.It Pa /usr/ports/graphics/fxtv
|
1999-09-22 17:36:43 +00:00
|
|
|
A TV and Camera display program utilizing the bktr driver - requires that
|
1998-03-09 10:56:22 +00:00
|
|
|
.Em The X Window System
|
|
|
|
|
and
|
|
|
|
|
.Em The Ports Collection
|
|
|
|
|
also be installed.
|
1999-09-22 17:36:43 +00:00
|
|
|
.It Pa /usr/ports/misc/alevt
|
|
|
|
|
A program to capture and display Teletext (VideoText) pages - requires that
|
|
|
|
|
.Em The X Window System
|
|
|
|
|
and
|
|
|
|
|
.Em The Ports Collection
|
|
|
|
|
also be installed.
|
|
|
|
|
.It Pa /usr/ports/audio/xmradio
|
|
|
|
|
An FM Radio Tuner for cards which have an FM Radio tuner fitted. - requires that
|
|
|
|
|
.Em The X Window System
|
|
|
|
|
and
|
|
|
|
|
.Em The Ports Collection
|
2000-03-03 14:05:08 +00:00
|
|
|
also be installed.
|
|
|
|
|
It also requires
|
1999-09-22 17:36:43 +00:00
|
|
|
.Em Motif
|
|
|
|
|
or the
|
|
|
|
|
.Em lesstif
|
|
|
|
|
port.
|
1998-03-09 10:56:22 +00:00
|
|
|
.El
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr meteor 4
|
|
|
|
|
.Sh HISTORY
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
driver first appeared in
|
|
|
|
|
.Fx 2.2 .
|
