1.\" $NetBSD: bktr.4,v 1.8 2002/03/23 09:47:21 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. The following values are allowed: 87.Bl -tag -width 2n -compact 88.It 1 89Pinnacle (Miro) TV, 90.It 2 91Hauppauge WinCast/TV, 92.It 3 93STB TV/PCI, 94.It 4 95Intel Smart Video III and Videologic Captivator PCI, 96.It 5 97IMS TV Turbo, 98.It 6 99AVer Media TV/FM, 100.It 7 101MMAC Osprey, 102.It 8 103NEC PK-UG-X017, 104.It 9 105I/O DATA GV-BCTV2/PCI, 106.It 10 107FlyVideo, 108.It 11 109Zoltrix, 110.It 12 111KISS TV/FM PCI, 112.It 13 113Video Highway Xtreme, 114.It 14 115Askey/Dynalink Magic TView, 116.It 15 117Leadtek WinFast TV 2000/VC100, 118and 119.It 16 120TerraTVplus. 121.El 122.It Cd options BKTR_OVERRIDE_TUNER=n 123If the TV tuner is not recognized correctly by the auto-detection 124routine, it can be overridden by setting this option to the 125appropriate value. Known values are: 126.Bl -tag -width 2n -compact 127.It 1 128Temic NTSC, 129.It 2 130Temic PAL, 131.It 3 132Temic SECAM, 133.It 4 134Philips NTSC, 135.It 5 136Philips PAL, 137.It 6 138Philips SECAM, 139.It 7 140Temic PAL I, 141.It 8 142Philips PAL I, 143.It 9 144Philips FR1236 NTSC FM, 145.It 10 146Philips FR1216 PAL FM, 147.It 11 148Philips FR1236 SECAM FM, 149.It 12 150ALPS TSCH5 NTSC FM, 151and 152.It 13 153ALPS TSBH1 NTSC. 154.El 155.It Cd options BKTR_OVERRIDE_DBX=n 156To override detection of the BTSC (dbx) chip, set this to 157.Em 1 158if you have one, or 159.Em 0 160if not. 161.It Cd options BKTR_OVERRIDE_MSP=n 162To override detection of the MSP 34xx chip, set this to 163.Em 1 164if you have one, or 165.Em 0 166if not. 167.It Cd options BKTR_SYSTEM_DEFAULT=n 168If this option is set to 169.Em BROOKTREE_PAL 170default to PAL, else to NTSC. 171.It Cd options BKTR_USE_PLL 172Default to PLL instead of XTAL. 173.It Cd options BKTR_GPIO_ACCESS 174Use ioctl's for direct GPIO access. 175.It Cd options BKTR_NO_MSP_RESET 176Skip the MSP reset. This option is handy if you initialise the 177MSP audio in another operating system first and then do a soft 178reboot. 179.\" The following options have no effect: 180.\" .It Cd options BKTR_430_FX_MODE 181.\" .It Cd options BKTR_SIS_VIA_MODE 182.El 183.Sh FILES 184.Bl -tag -width /dev/tuner* -compact 185.It Pa /dev/bktr* 186.Nm 187driver interface device 188.It Pa /dev/tuner* 189.Nm 190tuner interface device 191.It Pa /dev/vbi* 192teletext interface device 193.El 194.Sh SEE ALSO 195.Xr options 4 , 196.Xr pci 4 , 197.Xr radio 4 , 198.Pa pkgsrc/audio/xmradio , 199.Pa pkgsrc/graphics/fxtv 200.Sh HISTORY 201The 202.Nm 203driver appeared in 204.Fx 2.2 205and 206.Nx 1.5 . 207.Sh AUTHORS 208The 209.Nm 210driver was originally written by Amancio Hasty for 211.Fx 212and is now maintained by Roger Hardiman. 213.Nx 214porting was done by Bernd Ernesti, Berndt Josef Wulf, Matthias 215Scheler, and Thomas Klausner. 216