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
|
|
|
.\"
|
2005-01-02 13:56:02 +00:00
|
|
|
.Dd January 2, 2005
|
2001-02-20 11:07:27 +00:00
|
|
|
.Dt BKTR 4
|
2001-07-10 15:31:11 +00:00
|
|
|
.Os
|
1998-03-09 10:56:22 +00:00
|
|
|
.Sh NAME
|
2004-12-29 14:25:41 +00:00
|
|
|
.Nm bktr
|
|
|
|
|
.Nd Brooktree Bt848/849/878/879 and Pinnacle PCTV video capture driver
|
1998-03-09 10:56:22 +00:00
|
|
|
.Sh SYNOPSIS
|
2000-11-20 18:41:33 +00:00
|
|
|
.Cd device bktr
|
1998-11-04 22:13:35 +00:00
|
|
|
.Pp
|
2000-11-20 18:41:33 +00:00
|
|
|
.Cd device iicbus
|
|
|
|
|
.Cd device iicbb
|
|
|
|
|
.Cd 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
|
2003-06-28 23:53:39 +00:00
|
|
|
capture on low cost, high performance boards.
|
|
|
|
|
The driver is based on the Matrox Meteor driver and uses the same API.
|
2004-12-29 14:25:41 +00:00
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
driver should support most video cards based on the
|
2001-02-01 16:38:02 +00:00
|
|
|
.Em "Brooktree Bt848/849/878/879 Video Capture Chip" .
|
2004-12-29 14:25:41 +00:00
|
|
|
Also supported are most
|
|
|
|
|
.Em "Pinnacle PCTV"
|
|
|
|
|
video cards.
|
|
|
|
|
Furthermore, the driver supports
|
1999-09-22 17:36:43 +00:00
|
|
|
.Em FM Radio
|
2002-03-28 17:03:21 +00:00
|
|
|
if the tuner supports it.
|
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
|
2004-12-29 14:25:41 +00:00
|
|
|
On the supported cards, tuners and other components are interconnected
|
|
|
|
|
with an I2C bus.
|
1998-11-04 22:13:35 +00:00
|
|
|
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
|
2004-12-29 14:25:41 +00:00
|
|
|
controller declarations are mandatory to activate
|
|
|
|
|
.Nm
|
|
|
|
|
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
|
2003-06-28 23:53:39 +00:00
|
|
|
probed.
|
|
|
|
|
The default number of pages allocated by the kernel is 216.
|
1998-03-09 10:56:22 +00:00
|
|
|
This means that there are (216*4096) bytes available for use.
|
2000-05-12 08:28:01 +00:00
|
|
|
.Bd -unfilled
|
2005-01-15 12:23:59 +00:00
|
|
|
.Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
|
|
|
|
|
.Cd 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
|
2000-12-29 09:18:45 +00:00
|
|
|
.El
|
2004-12-29 14:25:41 +00:00
|
|
|
.Sh HARDWARE
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
driver supports video capture cards based on the
|
|
|
|
|
Brooktree Bt848/849/878/879 chips, as well as
|
|
|
|
|
Pinnacle PCTV cards, including:
|
|
|
|
|
.Pp
|
|
|
|
|
.Bl -bullet -compact
|
|
|
|
|
.It
|
|
|
|
|
AOpen VA1000
|
|
|
|
|
.It
|
|
|
|
|
AVerMedia AVerTV Studio
|
|
|
|
|
.It
|
|
|
|
|
AVerMedia TF/FM-98
|
|
|
|
|
.It
|
|
|
|
|
ATI TV Wonder VE
|
|
|
|
|
.It
|
|
|
|
|
Hauppauge WinCast/TV
|
|
|
|
|
.It
|
|
|
|
|
Hauppauge WinTV-Go-FM
|
|
|
|
|
.It
|
|
|
|
|
Hauppauge WinTV-pci
|
|
|
|
|
.It
|
|
|
|
|
Hauppauge WinTV-radio
|
|
|
|
|
.It
|
|
|
|
|
Intel Smart Video Recorder III
|
|
|
|
|
.It
|
|
|
|
|
KWORLD PCI TV Tuner
|
|
|
|
|
.It
|
|
|
|
|
Miro PC TV
|
|
|
|
|
.It
|
|
|
|
|
Pinnacle PCTV Pro
|
|
|
|
|
.It
|
|
|
|
|
Pinnacle PCTV Rave
|
|
|
|
|
.It
|
2005-01-02 12:03:04 +00:00
|
|
|
PixelView PlayTV PAK
|
|
|
|
|
.It
|
2004-12-29 14:25:41 +00:00
|
|
|
SIGMA TV II
|
|
|
|
|
.It
|
|
|
|
|
STB TV PCI Television Tuner
|
|
|
|
|
.It
|
|
|
|
|
Super TV Tuner
|
|
|
|
|
.It
|
|
|
|
|
V-Stream XPERT TV-PVR 878
|
|
|
|
|
.It
|
|
|
|
|
Video Highway XTreme
|
|
|
|
|
.It
|
|
|
|
|
VideoLogic Captivator PCI
|
|
|
|
|
.El
|
1999-08-15 10:48:36 +00:00
|
|
|
.Sh AUTHORS
|
2000-11-22 09:35:58 +00:00
|
|
|
.An -nosplit
|
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 ,
|
2004-05-14 20:07:49 +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.
|
2004-12-29 14:25:41 +00:00
|
|
|
Support for Pinnacle PCTV Rave cards was added by
|
|
|
|
|
.An Branko Lankester Aq branko@euro.net .
|
1998-03-09 10:56:22 +00:00
|
|
|
.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.
|
2003-10-21 23:36:46 +00:00
|
|
|
.It Pa /usr/ports/multimedia/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
|
2004-07-03 18:29:24 +00:00
|
|
|
An FM Radio Tuner for cards which have an FM Radio tuner fitted - requires that
|
1999-09-22 17:36:43 +00:00
|
|
|
.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 .
|
