1.\" $OpenBSD: pci.4,v 1.90 2004/05/03 15:18:19 drahn Exp $ 2.\" $NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $ 3.\" 4.\" Copyright (c) 2000 Theo de Raadt. All rights reserved. 5.\" Copyright (c) 1997 Jason R. Thorpe. All rights reserved. 6.\" Copyright (c) 1997 Jonathan Stone 7.\" All rights reserved. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 3. All advertising materials mentioning features or use of this software 18.\" must display the following acknowledgements: 19.\" This product includes software developed by Jonathan Stone 20.\" 4. The name of the author may not be used to endorse or promote products 21.\" derived from this software without specific prior written permission 22.\" 23.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 24.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 25.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 26.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 27.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 28.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 29.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 30.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 31.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 32.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 33.\" 34.Dd April 3, 2000 35.Dt PCI 4 36.Os 37.Sh NAME 38.Nm pci 39.Nd introduction to PCI bus support 40.Sh SYNOPSIS 41.Cd "# alpha" 42.Cd "pci* at apecs?" 43.Cd "pci* at cia?" 44.Cd "pci* at irongate?" 45.Cd "pci* at lca?" 46.Cd "pci* at tsp?" 47.Pp 48.Cd "# amd64, i386" 49.Cd "pci* at mainbus0 bus ?" 50.Pp 51.Cd "# cats" 52.Cd "pci0 at footbridge?" 53.Pp 54.Cd "# hppa" 55.Cd "pci* at dino?" 56.Pp 57.Cd "# macppc" 58.Cd "pci* at mpcpcibr?" 59.Pp 60.Cd "# sparc64" 61.Cd "pci* at psycho?" 62.Cd "pci* at schizo?" 63.Pp 64.Cd "# all architectures" 65.Cd "pci* at pchb? bus ?" 66.Cd "pci* at ppb? bus ?" 67.Sh DESCRIPTION 68The system includes a machine-independent 69.Tn PCI 70bus subsystem and 71several machine-independent 72.Tn PCI 73device drivers. 74.Pp 75Your system may support additional 76.Tn PCI 77devices. 78Drivers for 79.Tn PCI 80devices not listed here are machine-dependent. 81Consult your system's 82.Xr intro 4 83for additional information. 84.Ss Details specific to the i386 85Note that interrupt mappings on the i386 may require that you configure 86your BIOS to reserve sufficient interrupts as "PCI/ISAPnP" so that there 87are sufficient interrupts remaining to configure the discovered PCI 88devices. 89For more information, see 90.Xr pcibios 4 . 91.Sh SUPPORTED DEVICES 92The system includes machine-independent 93.Tn PCI 94drivers, sorted by device type and driver name: 95.Ss SCSI host adapters 96.Bl -tag -width 10n -offset ind -compact 97.It Xr adv 4 , Xr adw 4 98AdvanSys PCI 99.Tn SCSI 100interfaces. 101.It Xr ahc 4 102Adaptec 27xx, 29xx, 39xx, 29160, and other AIC-7xxx-based 103.Tn SCSI 104interfaces. 105.It Xr bha 4 106Buslogic BT-9xx 107.Tn SCSI 108interfaces. 109.It Xr iha 4 110Initio INIC-940 and INIC-950 based 111.Tn SCSI 112interfaces. 113.It Xr isp 4 114QLogic ISP-1020, ISP-1040, and ISP-2100 115.Tn SCSI 116and 117.Tn FibreChannel 118interfaces. 119.It Xr mpt 4 120LSI Fusion-MPT 121.Tn SCSI/Fibre Channel 122interfaces. 123.It Xr ncr 4 , Xr siop 4 124LSI/Symbios Logic/NCR 53c8xx and 53c1010-family 125.Tn SCSI 126interfaces. 127.It Xr pcscp 4 128AMD Am53c974 PCscsi-PCI 129.Tn SCSI 130interfaces. 131.It Xr trm 4 132Tekram DC-3x5U (TRM-S1040 based) 133.Tn SCSI 134interfaces. 135.El 136.Ss IDE disk controllers 137.Bl -tag -width 10n -offset ind -compact 138.It Xr pciide 4 139PCI IDE controller driver. 140.El 141.Ss RAID and cache controllers 142.Bl -tag -width 10n -offset ind -compact 143.It Xr aac 4 144Adaptec "FSA" family (Adaptec AAC, Dell PERC, HP NetRaid) 145.Tn RAID 146controllers. 147.It Xr ami 4 148American Megatrends Inc. 149MegaRAID family 150.Tn RAID 151controllers. 152.It Xr cac 4 153Compaq Smart ARRAY 154.Tn RAID 155controllers. 156.It Xr dpt 4 157DPT SmartCache/SmartRAID III and IV 158.Tn SCSI 159controllers. 160.It Xr gdt 4 161ICP-Vortex GDT 162.Tn RAID 163controllers. 164.It Xr iop 4 165Generic 166.Tn I2O 167specification 168.Tn RAID 169controllers. 170.It Xr twe 4 1713ware Escalade 172.Tn RAID 173controllers. 174.El 175.Ss Network interfaces 176.Bl -tag -width 10n -offset ind -compact 177.It Xr an 4 178Aironet Communications 4500/4800 IEEE 802.11DS wireless network adapter. 179.It Xr bce 4 180Broadcom BCM4401 Ethernet. 181.It Xr bge 4 182Broadcom BCM570x PCI gigabit ethernet. 183.It Xr dc 4 184Various Tulip-like Ethernet 185interfaces such as the DEC/Intel 21143; 186Macronix 98713, 98713A, 98715, 98715A, 98725, 98727, and 98732; 187Davicom DM9100, DM9102, and DM9102A; 188ASIX Electronics AX88140A and AX88141; 189ADMtek AL981 Comet and AN983 Centaur-P; 190Lite-On 82c168 and 82c169 PNIC; 191and 192Lite-On/Macronix 82c115 PNIC II. 193.It Xr de 4 194.Tn DEC 195DC21x4x (Tulip) based Ethernet 196interfaces, including the DE435, DE450, DE500; 197Znyx ZX3xx; 198SMC 8432, 9332, 9334; 199Cogent/Adaptec EM100FX and EM440TX; 200and Asante single- and multi-port 201Ethernet interfaces. 202Multi-port interfaces are typically configured as 203.Tn PCI Ns \- Ns Tn PCI 204bridges with multiple 205.Xr de 4 206instances on the 207.Tn PCI 208bus on the other side of the bridge. 209.It Xr em 4 210Intel Gigabit Ethernet interfaces. 211(i82542, i82543, i82544) 212.It Xr en 4 213Midway-based Efficient Networks Inc. 214and Adaptec ATM interfaces. 215.It Xr ep 4 2163Com 3c590 and 3c595 Ethernet interfaces. 217.It Xr fpa 4 218.Tn DEC 219DEFPA 220.Tn FDDI 221interfaces. 222.It Xr fxp 4 223Intel EtherExpress PRO 10+/100B Ethernet interfaces. 224.It Xr gem 4 225Sun GEM and Apple GMAC Gigabit Ethernet interfaces. 226.It Xr le 4 227PCNet-PCI Ethernet interfaces. 228.It Xr lge 4 229Level 1 LXT1001 NetCellerator PCI Gigabit Ethernet. 230.It Xr lmc 4 231Lan Media Corporation 232.Tn SSI/DS1/HSSI/DS3 233interfaces. 234.It Xr mtd 4 235Myson Technologies 236.Tn MTD803 2373-in-1 Fast Ethernet interfaces. 238.It Xr ne 4 239NE2000-compatible Ethernet interfaces. 240.It Xr nge 4 241National Semiconductor DP83820 and DP83821 based Gigabit Ethernet. 242.It Xr rl 4 243Realtek 8129/8139 Ethernet interfaces. 244.It Xr sf 4 245Adaptec AIC-6915 "Starfire" Ethernet interfaces. 246.It Xr sis 4 247SiS 900, SiS 7016, and NS DP83815 Ethernet interfaces. 248.It Xr sk 4 249SysKonnect SK-984x Gigabit Ethernet interfaces. 250.It Xr ste 4 251Sundance Technologies ST201 Ethernet interfaces. 252.It Xr stge 4 253Sundance/Tamarack TC9021 Gigabit Ethernet driver. 254.It Xr ti 4 255Alteon Networks Tigon I and Tigon II Gigabit Ethernet interfaces. 256.It Xr tl 4 257Texas Instruments ThunderLAN-based Ethernet interfaces. 258.It Xr tx 4 259SMC 9432 10/100 Mbps Ethernet interfaces. 260.It Xr txp 4 2613Com 3XP Typhoon/Sidewinder (3C990) 10/100 Mbps Ethernet interfaces. 262.It Xr vr 4 263VIA Technologies VT3043 and VT86C100A Ethernet interfaces. 264.It Xr wb 4 265Winbond W89C840F Ethernet interfaces. 266.It Xr wi 4 267WaveLAN/IEEE and PRISM-II 802.11DS wireless network interfaces behind 268a PLX 905x-based dumb PCMCIA->PCI bridge. 269.It Xr xl 4 2703Com 3c555, 3c556, 3c900, 3c905, 3c980, and 3cSOHO Ethernet interfaces. 271.El 272.Ss Cryptography accelerators 273.Bl -tag -width 10n -offset ind -compact 274.It Xr hifn 4 275Hifn 7751, 7811, and 7951. 276Symmetric Encryption Accelerator. 277.It Xr ises 4 278Pijnenburg PCC-ISES hardware crypto accelerator. 279.It Xr lofn 4 280Hifn 6500 crypto accelerator. 281.It Xr noct 4 282NetOctave NSP2000 crypto accelerator. 283.It Xr nofn 4 284Hifn 7814, 7851 and 7854 crypto processor. 285.It Xr safe 4 286Safenet SafeXcel 1141/1741 crypto accelerator. 287.It Xr ubsec 4 288Broadcom Bluesteelnet uBsec 5501, 5601, 5805, 5820, and 5821. 289.El 290.Ss Serial interfaces 291.Bl -tag -width 10n -offset ind -compact 292.It Xr cy 4 293Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications devices. 294.It Xr cz 4 295Cyclades-Z series multi-port serial adapter device driver. 296.El 297.Ss Display adapters 298.Bl -tag -width 10n -offset ind -compact 299.It Xr vga 4 300VGA graphics cards. 301.El 302.Ss Audio devices 303.Bl -tag -width 10n -offset ind -compact 304.It Xr auich 4 305Integrated Intel 82801AA/AB/BA/CA and 440MX sound devices. 306.It Xr autri 4 307Trident 4DWAVE-DX/NX, SiS 7018, ALi M5451 audio devices. 308.It Xr auvia 4 309Integrated AC97 audio controller of the 310.Tn VIA Technologies VT82C686A , 311.Tn VT8233 , 312VT8235, VT8237 Southbridges. 313.It Xr clcs 4 314Cirrus Logic CrystalClear CS4280 sound devices. 315.It Xr clct 4 316Cirrus Logic CrystalClear CS4281 sound devices. 317.It Xr cmpci 4 318C-Media CMI8x38 sound devices. 319.It Xr eap 4 320Ensoniq AudioPCI sound devices. 321.It Xr emu 4 322Creative Labs SBLive! and PCI 512 audio device driver. 323.It Xr esa 4 324ESS Alegro 1 and Maestro 3 sound devices. 325.It Xr eso 4 326ESS Solo-1 PCI AudioDrive sound devices. 327.It Xr fms 4 328Forte Media FM801 sound devices. 329.It Xr maestro 4 330ESS Maestro 1, 2 and 2E sound devices. 331.It Xr neo 4 332NeoMagic 256AV/ZX sound devices. 333.It Xr sv 4 334S3 SonicVibes sound devices. 335.It Xr yds 4 336Yamaha DS-XG sound devices. 337.El 338.Ss Radio receiver devices 339.Bl -tag -width 10n -offset ind -compact 340.It Xr fms 4 341SoundForte RadioLink SF64-PCR, SoundForte Quad X-treme SF256-PCP-R and 342SoundForte Theatre X-treme 5.1 SF256-PCS-R FM radio devices driver. 343.It Xr gtp 4 344Gemtek PCI FM radio device driver. 345.El 346.Ss Miscellaneous devices 347.Bl -tag -width 10n -offset ind -compact 348.It Xr amdpm 4 349AMD768 Power Management controller. 350.It Xr bktr 4 351Brooktree Bt848 352.Tn PCI 353TV tuners and video capture boards. 354.It Xr cbb 4 355.Tn PCI 356Yenta compatible 357.Tn CardBus 358bridges. 359.It Xr ohci 4 360USB OHCI host controller. 361.It Xr pcic 4 362.Tn PCI 363.Tn PCMCIA 364controllers, including the Cirrus Logic GD6729. 365.It Xr ppb 4 366Generic 367.Tn PCI Ns \- Ns Tn PCI 368bridges, including 369.Tn PCI 370expansion backplanes. 371.It Xr puc 4 372PCI 373.Dq universal 374communications cards, containing 375.Xr com 4 376and 377.Xr lpt 4 378communications ports. 379.It Xr uhci 4 380USB UHCI host controller. 381.It Xr wdt 4 382ICS PCI-WDT500/501 watchdog timer devices. 383.El 384.Sh IOCTLS 385If the kernel is compiled with the 386.Va USER_PCICONF 387kernel option, the following 388.Xr ioctl 2 389calls are supported by the 390.Nm 391driver. 392They are defined in the header file 393.Aq Pa sys/pciio.h . 394.Bl -tag -width 012345678901234 395.Pp 396.It PCIOCREAD 397This 398.Xr ioctl 2 399reads the 400.Tn PCI 401configuration registers specified by the passed-in 402.Va pci_io 403structure. 404The 405.Va pci_io 406structure consists of the following fields: 407.Bl -tag -width pi_width 408.It pi_sel 409A 410.Va pcisel 411structure which specifies the bus, slot and function the user would like to 412query. 413.It pi_reg 414The 415.Tn PCI 416configuration register the user would like to access. 417.It pi_width 418The width, in bytes, of the data the user would like to read. 419This value can be only 4. 420.It pi_data 421The data returned by the kernel. 422.El 423.It PCIOCWRITE 424This 425.Xr ioctl 2 426allows users to write to the 427.Tn PCI 428specified in the passed-in 429.Va pci_io 430structure. 431The 432.Va pci_io 433structure is described above. 434The limitations on data width described for 435reading registers, above, also apply to writing 436.Tn PCI 437configuration registers. 438.El 439.Sh FILES 440.Bl -tag -width /dev/pci -compact 441.It Pa /dev/pci 442Character device for the 443.Nm 444driver. 445.El 446.Sh SEE ALSO 447.Xr aac 4 , 448.Xr adv 4 , 449.Xr adw 4 , 450.Xr ahc 4 , 451.Xr ami 4 , 452.Xr an 4 , 453.Xr apecs 4 , 454.Xr auich 4 , 455.Xr autri 4 , 456.Xr auvia 4 , 457.Xr bce 4 , 458.Xr bge 4 , 459.Xr bha 4 , 460.Xr bktr 4 , 461.Xr cac 4 , 462.Xr cardbus 4 , 463.Xr cia 4 , 464.Xr clcs 4 , 465.Xr clct 4 , 466.Xr cmpci 4 , 467.Xr cy 4 , 468.Xr cz 4 , 469.Xr dc 4 , 470.Xr de 4 , 471.Xr dino 4 , 472.Xr dpt 4 , 473.Xr eap 4 , 474.Xr em 4 , 475.Xr emu 4 , 476.\" no manpage .Xr en 4 , 477.Xr ep 4 , 478.Xr esa 4 , 479.Xr eso 4 , 480.Xr fms 4 , 481.Xr footbridge 4 , 482.Xr fpa 4 , 483.Xr fxp 4 , 484.Xr gdt 4 , 485.Xr gtp 4 , 486.Xr hifn 4 , 487.Xr iha 4 , 488.Xr intro 4 , 489.Xr iop 4 , 490.Xr irongate 4 , 491.Xr isa 4 , 492.Xr isapnp 4 , 493.Xr ises 4 , 494.Xr isp 4 , 495.Xr lca 4 , 496.Xr le 4 , 497.Xr lge 4 , 498.Xr lmc 4 , 499.Xr lofn 4 , 500.Xr maestro 4 , 501.\" no manpage .Xr mpcpcibr 4 502.Xr mpt 4 , 503.Xr ncr 4 , 504.Xr ne 4 , 505.Xr neo 4 , 506.Xr nge 4 , 507.Xr noct 4 , 508.Xr nofn 4 , 509.Xr ohci 4 , 510.Xr options 4 , 511.Xr pchb 4 , 512.Xr pcib 4 , 513.Xr pcic 4 , 514.Xr pcmcia 4 , 515.Xr pcscp 4 , 516.Xr ppb 4 , 517.Xr psycho 4 , 518.Xr puc 4 , 519.Xr rl 4 , 520.Xr safe 4 , 521.Xr schizo 4 , 522.Xr sf 4 , 523.Xr siop 4 , 524.Xr sis 4 , 525.Xr sk 4 , 526.Xr ste 4 , 527.Xr stge 4 , 528.Xr sv 4 , 529.Xr ti 4 , 530.Xr tl 4 , 531.Xr trm 4 , 532.Xr tsp 4 , 533.Xr twe 4 , 534.Xr tx 4 , 535.Xr txp 4 , 536.Xr ubsec 4 , 537.Xr uhci 4 , 538.Xr usb 4 , 539.Xr vga 4 , 540.Xr vr 4 , 541.Xr wb 4 , 542.Xr wdt 4 , 543.Xr wi 4 , 544.Xr xl 4 , 545.Xr yds 4 546.Sh HISTORY 547The machine-independent 548.Tn PCI 549subsystem appeared in 550.Ox 2.0 . 551Support for device listing and matching was re-implemented by 552Kenneth Merry, and first appeared in 553.Fx 3.0 . 554