1.\" $NetBSD: bktr.4,v 1.10 2002/09/26 01:05:04 wiz Exp $ 2.\" 3.\" Copyright (c) 2000 Thomas Klausner 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. The name of the author may not be used to endorse or promote products 12.\" derived from this software without specific prior written permission. 13.\" 14.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 15.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 16.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 17.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 18.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 19.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 20.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 22.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 23.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" POSSIBILITY OF SUCH DAMAGE. 25.\" 26.Dd May 7, 2000 27.Dt BKTR 4 28.Os 29.Sh NAME 30.Nm bktr 31.Nd Brooktree 848 compatible TV card driver 32.Sh SYNOPSIS 33.Cd bktr* at pci? dev ? function ? 34.Cd radio* at bktr? 35.Pp 36.Cd options BKTR_OVERRIDE_CARD=n 37.Cd options BKTR_OVERRIDE_TUNER=n 38.Cd options BKTR_OVERRIDE_DBX=n 39.Cd options BKTR_OVERRIDE_MSP=n 40.Cd options BKTR_SYSTEM_DEFAULT=n 41.Cd options BKTR_USE_PLL 42.Cd options BKTR_GPIO_ACCESS 43.Cd options BKTR_NO_MSP_RESET 44.\" The following options have no effect: 45.\" .Cd options BKTR_430_FX_MODE 46.\" .Cd options BKTR_SIS_VIA_MODE 47.Sh DESCRIPTION 48This driver supports video capture (frame grabber) and TV tuner cards 49based on the 50.Tn Brooktree 51.Tn Bt848 , 52.Tn Bt848A , 53.Tn Bt849A , 54.Tn Bt878 55and 56.Tn Bt879 57chips. 58.Pp 59Supported cards include most cards by 60.Tn AVerMedia , 61.Tn Hauppauge , 62.Tn Leadtek , 63.Tn Miro , 64.Tn Pinnacle , 65.Tn Pixelview , 66.Tn Terratec , 67and some other companies, especially all cards based on the 68.Tn Brooktree 69.Tn Bt848 , 70.Tn Bt848A , 71.Tn Bt849A , 72.Tn Bt878 , 73or 74.Tn Bt879 75chips. 76A notable exception are the 77.Tn ATI 78.Tn All-in-Wonder 79cards. 80.Pp 81The following kernel configuration options are available: 82.Bl -ohang 83.It Cd options BKTR_OVERRIDE_CARD=n 84If the card is not recognized correctly by the auto-detection routine, 85it can be overridden by setting this option to the appropriate 86value. 87The following values are allowed: 88.Bl -tag -width 2n -compact 89.It 1 90Pinnacle (Miro) TV, 91.It 2 92Hauppauge WinCast/TV, 93.It 3 94STB TV/PCI, 95.It 4 96Intel Smart Video III and Videologic Captivator PCI, 97.It 5 98IMS TV Turbo, 99.It 6 100AVer Media TV/FM, 101.It 7 102MMAC Osprey, 103.It 8 104NEC PK-UG-X017, 105.It 9 106I/O DATA GV-BCTV2/PCI, 107.It 10 108FlyVideo, 109.It 11 110Zoltrix, 111.It 12 112KISS TV/FM PCI, 113.It 13 114Video Highway Xtreme, 115.It 14 116Askey/Dynalink Magic TView, 117.It 15 118Leadtek WinFast TV 2000/VC100, 119and 120.It 16 121TerraTVplus. 122.El 123.It Cd options BKTR_OVERRIDE_TUNER=n 124If the TV tuner is not recognized correctly by the auto-detection 125routine, it can be overridden by setting this option to the 126appropriate value. 127Known values are: 128.Bl -tag -width 2n -compact 129.It 1 130Temic NTSC, 131.It 2 132Temic PAL, 133.It 3 134Temic SECAM, 135.It 4 136Philips NTSC, 137.It 5 138Philips PAL, 139.It 6 140Philips SECAM, 141.It 7 142Temic PAL I, 143.It 8 144Philips PAL I, 145.It 9 146Philips FR1236 NTSC FM, 147.It 10 148Philips FR1216 PAL FM, 149.It 11 150Philips FR1236 SECAM FM, 151.It 12 152ALPS TSCH5 NTSC FM, 153and 154.It 13 155ALPS TSBH1 NTSC. 156.El 157.It Cd options BKTR_OVERRIDE_DBX=n 158To override detection of the BTSC (dbx) chip, set this to 159.Em 1 160if you have one, or 161.Em 0 162if not. 163.It Cd options BKTR_OVERRIDE_MSP=n 164To override detection of the MSP 34xx chip, set this to 165.Em 1 166if you have one, or 167.Em 0 168if not. 169.It Cd options BKTR_SYSTEM_DEFAULT=n 170If this option is set to 171.Em BROOKTREE_PAL 172default to PAL, else to NTSC. 173.It Cd options BKTR_USE_PLL 174Default to PLL instead of XTAL. 175.It Cd options BKTR_GPIO_ACCESS 176Use 177.Fn ioctl Ns s 178for direct GPIO access. 179.It Cd options BKTR_NO_MSP_RESET 180Skip the MSP reset. 181This option is handy if you initialize the MSP audio in another 182operating system first and then do a soft reboot. 183.\" The following options have no effect: 184.\" .It Cd options BKTR_430_FX_MODE 185.\" .It Cd options BKTR_SIS_VIA_MODE 186.El 187.Sh FILES 188.Bl -tag -width /dev/tuner* -compact 189.It Pa /dev/bktr* 190.Nm 191driver interface device 192.It Pa /dev/tuner* 193.Nm 194tuner interface device 195.It Pa /dev/vbi* 196teletext interface device 197.El 198.Sh SEE ALSO 199.Xr options 4 , 200.Xr pci 4 , 201.Xr radio 4 , 202.Pa pkgsrc/audio/xmradio , 203.Pa pkgsrc/graphics/fxtv 204.Sh HISTORY 205The 206.Nm 207driver appeared in 208.Fx 2.2 209and 210.Nx 1.5 . 211.Sh AUTHORS 212The 213.Nm 214driver was originally written by Amancio Hasty for 215.Fx 216and is now maintained by Roger Hardiman. 217.Nx 218porting was done by Bernd Ernesti, Berndt Josef Wulf, Matthias 219Scheler, and Thomas Klausner. 220