3.\"
4.Dd January 28, 1998
5.Dt BKTR 4 i386
6.Os FreeBSD
7.Sh NAME
8.Nm brooktree
9.Nd video capture driver
10.Sh SYNOPSIS
11.Cd device bktr
12.Pp
13.Cd device iicbus
14.Cd device iicbb
15.Cd device smbus
16.Sh DESCRIPTION
17The
18.Nm bktr
19driver provides support for PCI
20.Em video
21capture and
22.Em VBI
23capture on low cost, high performance boards. The driver based on
24the Matrox Meteor driver and uses the same API. The bktr driver should support most video cards
25based on the
26.Em Brooktree Bt848/849/878/879 Video Capture Chip.
27The driver also supports
28.Em FM Radio
29if the Tuner supports it.
30.Pp
31Specifically, the following cards are known to work:
32.Bd -unfilled -offset indent
33.Em Hauppage Wincast TV and WinTV/PCI
34.Em STB TV PCI Television Tuner
35.Em Miro PC TV
36.Em Intel Smart Video Recorder III
37.Em AverMedia cards
38.Em Video Highway XTreme
39.Em VideoLogic Captivator PCI
40.Ed
41.Pp
42The driver currently supports the following features:
43.Bd -unfilled -offset indent
44PCI to PCI dma transfer
45clipping
46yuv
47rgb16
48rgb24
49rgb32
50.Ed
51.Pp
52On these cards, tuners and other components are interconnected with an I2C bus.
53The Brooktree848 chips act as a master device on the bus to control them.
54Therefore,
55.Xr iicbus 4 ,
56.Xr iicbb 4
57and
58.Xr smbus 4
59controller declarations are mandatory to activate bktr support.
60.Pp
61The following kernel parameters may be used to further configure the driver:
62.Pp
63.Em options "BROOKTREE_ALLOC_PAGES=xxx"
64specifies the number of contiguous pages to allocate when successfully
65probed. The default number of pages allocated by the kernel is 216.
66This means that there are (216*4096) bytes available for use.
67.Bd -unfilled
68.Em options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
69.Em options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
70.Ed
71One of these options can be used to set the default video format for the driver.
72This fixed random hangs and lockups with the VideoLogic Captivator PCI card.
73.Pp
74The following sysctls may be used to further configure the driver:
75.Pp
76.Em sysctl hw.bt848.card=nnnn
77This can be used to override the card make which was detected at boot time.
78.Ql nnnn
79is set to an integer from 1 to 13 taken from the following table:
80.Pp
81.Bl -tag -compact -width 22n
82.It MIRO
831
84.It HAUPPAUGE
852
86.It STB
873
88.It INTEL
894
90.It IMS_TURBO
915
92.It AVER_MEDIA
936
94.It OSPREY
957
96.It NEC_PK
978
98.It IO_GV
999
100.It FLYVIDEO
10110
102.It ZOLTRIX
10311
104.It KISS
10512
106.It VIDEO_HIGHWAY_XTREME
10713
108.El
109.Pp
110.Em sysctl hw.bt848.tuner=nnnn
111This can be used to override the tuner make which was detected at boot time.
112.Ql nnnn
113is set to an integer from 1 to 13 taken from the following table:
114.Pp
115.Bl -tag -compact -width 22n
116.It NO_TUNER
1170
118.It TEMIC_NTSC
1191
120.It TEMIC_PAL
1212
122.It TEMIC_SECAM
1233
124.It PHILIPS_NTSC
1254
126.It PHILIPS_PAL
1275
128.It PHILIPS_SECAM
1296
130.It TEMIC_PALI
1317
132.It PHILIPS_PALI
1338
134.It PHILIPS_FR1236_NTSC
1359 /* These have FM Radio support */
136.It PHILIPS_FR1216_PAL
13710 /* These have FM Radio support */
138.It PHILIPS_FR1236_SECAM
13911 /* These have FM Radio support */
140.It ALPS_TSCH5
14112
142.It ALPS_TSBH1
14313
| 3.\"
4.Dd January 28, 1998
5.Dt BKTR 4 i386
6.Os FreeBSD
7.Sh NAME
8.Nm brooktree
9.Nd video capture driver
10.Sh SYNOPSIS
11.Cd device bktr
12.Pp
13.Cd device iicbus
14.Cd device iicbb
15.Cd device smbus
16.Sh DESCRIPTION
17The
18.Nm bktr
19driver provides support for PCI
20.Em video
21capture and
22.Em VBI
23capture on low cost, high performance boards. The driver based on
24the Matrox Meteor driver and uses the same API. The bktr driver should support most video cards
25based on the
26.Em Brooktree Bt848/849/878/879 Video Capture Chip.
27The driver also supports
28.Em FM Radio
29if the Tuner supports it.
30.Pp
31Specifically, the following cards are known to work:
32.Bd -unfilled -offset indent
33.Em Hauppage Wincast TV and WinTV/PCI
34.Em STB TV PCI Television Tuner
35.Em Miro PC TV
36.Em Intel Smart Video Recorder III
37.Em AverMedia cards
38.Em Video Highway XTreme
39.Em VideoLogic Captivator PCI
40.Ed
41.Pp
42The driver currently supports the following features:
43.Bd -unfilled -offset indent
44PCI to PCI dma transfer
45clipping
46yuv
47rgb16
48rgb24
49rgb32
50.Ed
51.Pp
52On these cards, tuners and other components are interconnected with an I2C bus.
53The Brooktree848 chips act as a master device on the bus to control them.
54Therefore,
55.Xr iicbus 4 ,
56.Xr iicbb 4
57and
58.Xr smbus 4
59controller declarations are mandatory to activate bktr support.
60.Pp
61The following kernel parameters may be used to further configure the driver:
62.Pp
63.Em options "BROOKTREE_ALLOC_PAGES=xxx"
64specifies the number of contiguous pages to allocate when successfully
65probed. The default number of pages allocated by the kernel is 216.
66This means that there are (216*4096) bytes available for use.
67.Bd -unfilled
68.Em options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
69.Em options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
70.Ed
71One of these options can be used to set the default video format for the driver.
72This fixed random hangs and lockups with the VideoLogic Captivator PCI card.
73.Pp
74The following sysctls may be used to further configure the driver:
75.Pp
76.Em sysctl hw.bt848.card=nnnn
77This can be used to override the card make which was detected at boot time.
78.Ql nnnn
79is set to an integer from 1 to 13 taken from the following table:
80.Pp
81.Bl -tag -compact -width 22n
82.It MIRO
831
84.It HAUPPAUGE
852
86.It STB
873
88.It INTEL
894
90.It IMS_TURBO
915
92.It AVER_MEDIA
936
94.It OSPREY
957
96.It NEC_PK
978
98.It IO_GV
999
100.It FLYVIDEO
10110
102.It ZOLTRIX
10311
104.It KISS
10512
106.It VIDEO_HIGHWAY_XTREME
10713
108.El
109.Pp
110.Em sysctl hw.bt848.tuner=nnnn
111This can be used to override the tuner make which was detected at boot time.
112.Ql nnnn
113is set to an integer from 1 to 13 taken from the following table:
114.Pp
115.Bl -tag -compact -width 22n
116.It NO_TUNER
1170
118.It TEMIC_NTSC
1191
120.It TEMIC_PAL
1212
122.It TEMIC_SECAM
1233
124.It PHILIPS_NTSC
1254
126.It PHILIPS_PAL
1275
128.It PHILIPS_SECAM
1296
130.It TEMIC_PALI
1317
132.It PHILIPS_PALI
1338
134.It PHILIPS_FR1236_NTSC
1359 /* These have FM Radio support */
136.It PHILIPS_FR1216_PAL
13710 /* These have FM Radio support */
138.It PHILIPS_FR1236_SECAM
13911 /* These have FM Radio support */
140.It ALPS_TSCH5
14112
142.It ALPS_TSBH1
14313
|
145.Sh AUTHORS
146.An -nosplit
147This driver is based on the work of
148.An Jim Lowe Aq james@miller.cs.uwm.edu ,
149.An Mark Tinguely Aq tinguely@plains.nodak.edu ,
150.An Amancio Hasty Aq hasty@star\-gate.com ,
151.An Roger Hardiman Aq roger@FreeBSD.org
152and a bunch of other people.
153.Sh FILES
154.Bl -tag -width /usr/share/examples/meteor -compact
155.It Pa /usr/share/examples/meteor
156Examples of what you can do with the (similarly designed) Meteor driver.
157.It Pa /usr/ports/graphics/fxtv
158A TV and Camera display program utilizing the bktr driver - requires that
159.Em The X Window System
160and
161.Em The Ports Collection
162also be installed.
163.It Pa /usr/ports/misc/alevt
164A program to capture and display Teletext (VideoText) pages - requires that
165.Em The X Window System
166and
167.Em The Ports Collection
168also be installed.
169.It Pa /usr/ports/audio/xmradio
170An FM Radio Tuner for cards which have an FM Radio tuner fitted. - requires that
171.Em The X Window System
172and
173.Em The Ports Collection
174also be installed.
175It also requires
176.Em Motif
177or the
178.Em lesstif
179port.
180.El
181.Sh SEE ALSO
182.Xr meteor 4
183.Sh HISTORY
184The
185.Nm
186driver first appeared in
187.Fx 2.2 .
| 145.Sh AUTHORS
146.An -nosplit
147This driver is based on the work of
148.An Jim Lowe Aq james@miller.cs.uwm.edu ,
149.An Mark Tinguely Aq tinguely@plains.nodak.edu ,
150.An Amancio Hasty Aq hasty@star\-gate.com ,
151.An Roger Hardiman Aq roger@FreeBSD.org
152and a bunch of other people.
153.Sh FILES
154.Bl -tag -width /usr/share/examples/meteor -compact
155.It Pa /usr/share/examples/meteor
156Examples of what you can do with the (similarly designed) Meteor driver.
157.It Pa /usr/ports/graphics/fxtv
158A TV and Camera display program utilizing the bktr driver - requires that
159.Em The X Window System
160and
161.Em The Ports Collection
162also be installed.
163.It Pa /usr/ports/misc/alevt
164A program to capture and display Teletext (VideoText) pages - requires that
165.Em The X Window System
166and
167.Em The Ports Collection
168also be installed.
169.It Pa /usr/ports/audio/xmradio
170An FM Radio Tuner for cards which have an FM Radio tuner fitted. - requires that
171.Em The X Window System
172and
173.Em The Ports Collection
174also be installed.
175It also requires
176.Em Motif
177or the
178.Em lesstif
179port.
180.El
181.Sh SEE ALSO
182.Xr meteor 4
183.Sh HISTORY
184The
185.Nm
186driver first appeared in
187.Fx 2.2 .
|