1.\" 2.\" $FreeBSD: src/share/man/man4/bktr.4,v 1.31 2006/01/21 14:58:25 netchild Exp $ 3.\" 4.Dd February 24, 2011 5.Dt BKTR 4 6.Os 7.Sh NAME 8.Nm bktr 9.Nd Brooktree Bt848/849/878/879 and Pinnacle PCTV 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 19driver provides support for PCI 20.Em video 21capture and 22.Em VBI 23capture on low cost, high performance boards. 24The driver is based on the Matrox Meteor driver and uses the same API. 25The Meteor driver has since been removed. 26The 27.Nm 28driver should support most video cards based on the 29.Em "Brooktree Bt848/849/878/879 Video Capture Chip" . 30Also supported are most 31.Em "Pinnacle PCTV" 32video cards. 33Furthermore, the driver supports 34.Em FM Radio 35if the tuner supports it. 36.Pp 37The driver currently supports the following features: 38.Bd -unfilled -offset indent 39PCI to PCI dma transfer 40clipping 41yuv 42rgb16 43rgb24 44rgb32 45.Ed 46.Pp 47On the supported cards, tuners and other components are interconnected 48with an I2C bus. 49The Brooktree848 chips act as a master device on the bus to control them. 50Therefore, 51.Xr iicbus 4 , 52.Xr iicbb 4 53and 54.Xr smbus 4 55controller declarations are mandatory to activate 56.Nm 57support. 58.Pp 59The following kernel parameters may be used to further configure the driver: 60.Pp 61.Cd options "BROOKTREE_ALLOC_PAGES=xxx" 62specifies the number of contiguous pages to allocate when successfully 63probed. 64The default number of pages allocated by the kernel is 216. 65This means that there are (216*4096) bytes available for use. 66.Bd -unfilled 67.Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL 68.Cd options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC 69.Ed 70One of these options can be used to set the default video format for the driver. 71This fixed random hangs and lockups with the VideoLogic Captivator PCI card. 72.Pp 73The following sysctls may be used to further configure the driver: 74.Pp 75.Em sysctl hw.bt848.card=nnnn 76This can be used to override the card make which was detected at boot time. 77.Ql nnnn 78is set to an integer from 1 to 23 taken from the following table: 79.Pp 80.Bl -tag -compact -width 30n 81.It MIRO 821 83.It HAUPPAUGE 842 85.It STB 863 87.It INTEL 884 89.It IMS_TURBO 905 91.It AVER_MEDIA 926 93.It OSPREY 947 95.It NEC_PK 968 97.It IO_GV 989 99.It FLYVIDEO 10010 101.It ZOLTRIX 10211 103.It KISS 10412 105.It VIDEO_HIGHWAY_XTREME 10613 107.It ASKEY_DYNALINK_MAGIC_TVIEW 10814 109.It LEADTEK 11015 111.It TERRATVPLUS 11216 113.It IO_BCTV3 11417 115.It AOPEN_VA1000 11618 117.It PINNACLE_PCTV_RAVE 11819 119.It PIXELVIEW_PLAYTV_PAK 12020 121.It TERRATVALUE 12221 123.It PIXELVIEW_PLAYTV_PRO_REV_4C 12422 125.It Bt848_MAX 12623 127.El 128.Pp 129.Em sysctl hw.bt848.tuner=nnnn 130This can be used to override the tuner make which was detected at boot time. 131.Ql nnnn 132is set to an integer from 1 to 16 taken from the following table: 133.Pp 134.Bl -tag -compact -width 22n 135.It NO_TUNER 1360 137.It TEMIC_NTSC 1381 139.It TEMIC_PAL 1402 141.It TEMIC_SECAM 1423 143.It PHILIPS_NTSC 1444 145.It PHILIPS_PAL 1465 147.It PHILIPS_SECAM 1486 149.It TEMIC_PALI 1507 151.It PHILIPS_PALI 1528 153.It PHILIPS_FR1236_NTSC 1549 /* These have FM Radio support */ 155.It PHILIPS_FR1216_PAL 15610 /* These have FM Radio support */ 157.It PHILIPS_FR1236_SECAM 15811 /* These have FM Radio support */ 159.It ALPS_TSCH5 16012 161.It ALPS_TSBH1 16213 163.It MT2032 16414 165.It LG_TPI8PSB12P_PAL 16615 167.It Bt848_MAX 16816 169.El 170.Sh HARDWARE 171The 172.Nm 173driver supports video capture cards based on the 174Brooktree Bt848/849/878/879 chips, as well as 175Pinnacle PCTV cards, including: 176.Pp 177.Bl -bullet -compact 178.It 179AOpen VA1000 180.It 181AVerMedia AVerTV Studio 182.It 183AVerMedia TF/FM-98 184.It 185ATI TV Wonder VE 186.It 187Hauppauge WinCast/TV 188.It 189Hauppauge WinTV-Go-FM 190.It 191Hauppauge WinTV-pci 192.It 193Hauppauge WinTV-radio 194.It 195Intel Smart Video Recorder III 196.It 197KWORLD PCI TV Tuner 198.It 199Miro PC TV 200.It 201Pinnacle PCTV Pro 202.It 203Pinnacle PCTV Rave 204.It 205PixelView PlayTV PAK 206.It 207PixelView PlayTV Pro (rev 4C, 9D) 208.It 209SIGMA TV II 210.It 211STB TV PCI Television Tuner 212.It 213Super TV Tuner 214.It 215TerraTec TValue 216.It 217V-Stream XPERT TV-PVR 878 218.It 219Video Highway XTreme 220.It 221VideoLogic Captivator PCI 222.El 223.Sh FILES 224.Bl -tag -width /usr/share/examples/meteor -compact 225.It Pa /usr/share/examples/meteor 226Examples of what you could do with the (similarly designed) Meteor driver. 227.It Pa multimedia/fxtv 228A TV and Camera display program utilizing the bktr driver. 229.It Pa misc/alevt 230A program to capture and display Teletext (VideoText) pages. 231.It Pa audio/xmradio 232An FM Radio Tuner for cards which have an FM Radio tuner fitted. 233.El 234.Sh SEE ALSO 235.Xr cxm 4 236.Sh HISTORY 237The 238.Nm 239driver first appeared in 240.Fx 2.2 . 241.Sh AUTHORS 242.An -nosplit 243This driver is based on the work of 244.An Jim Lowe Aq Mt james@miller.cs.uwm.edu , 245.An Mark Tinguely Aq Mt tinguely@plains.nodak.edu , 246.An Amancio Hasty Aq Mt hasty@star-gate.com , 247.An Roger Hardiman Aq Mt roger@FreeBSD.org 248and a bunch of other people. 249Support for Pinnacle PCTV Rave cards was added by 250.An Branko Lankester Aq Mt branko@euro.net . 251