.\"	$NetBSD: pci.4,v 1.103 2021/02/27 11:05:38 nia Exp $
.\"
.\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
.\" Copyright (c) 1997 Jonathan Stone
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgements:
.\"      This product includes software developed by Jonathan Stone
.\" 4. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd February 27, 2021
.Dt PCI 4
.Os
.Sh NAME
.Nm pci
.Nd introduction to machine-independent PCI bus support and drivers
.Sh SYNOPSIS
.Cd "pci* at mainbus? bus ?"
.Cd "pci* at pchb? bus ?"
.Cd "pci* at ppb? bus ?"
.Pp
.Cd options PCIVERBOSE
.Cd options PCI_CONFIG_DUMP
.Cd options PCI_ADDR_FIXUP
.Cd options PCI_BUS_FIXUP
.Cd options PCI_INTR_FIXUP
.Sh DESCRIPTION
Other
.Nm
attachments are machine-dependent and depend on the bus topology and
.Tn PCI
bus interface of your system.
See
.Xr intro 4
for your system for details.
.Pp
.Nx
includes a machine-independent
.Tn PCI
bus subsystem and
several machine-independent
.Tn PCI
device drivers.
.Pp
Your system may support additional
.Tn PCI
devices.
Drivers for
.Tn PCI
devices not listed here are machine-dependent.
Consult your system's
.Xr intro 4
for additional information.
.Sh OPTIONS
.Bl -tag -width PCI_ADDR_FIXUP -offset 3n
.It Dv PCI_ADDR_FIXUP
Fixup PCI I/O and memory addresses.
.Pp
Some i386 and amd64 BIOS implementations don't allocate I/O space and
memory space for some PCI devices \(em primarily BIOS in PnP mode, or laptops
that expect devices to be configured via ACPI.
Since necessary space isn't allocated, those devices
will not work without special handling.
.Pp
This option allocates I/O space and memory space
instead of relying upon the BIOS to do so.
.Pp
If necessary space is already correctly assigned to the devices,
this option leaves the space as is.
.It Dv PCI_BUS_FIXUP
Fixup PCI bus numbering; needed for many
.Xr cardbus 4
bridges.
.Pp
Each PCI bus and CardBus should have a unique bus number.
But some BIOS implementations don't assign a bus number
for subordinate PCI buses.
And many BIOS implementations
don't assign a bus number for CardBuses.
.Pp
A typical symptom of this is the following boot message:
.D1 Sy cardbus0 at cardslot0: bus 0 device 0...
Please note that this cardbus0 has a bus number
.Sq 0 ,
but normally the bus number 0 is used by the machine's
primary PCI bus.
Thus, this bus number for cardbus is incorrect
.Pq not assigned .
In this situation, a device located in cardbus0 doesn't
show correct device ID,
because its bus number 0 incorrectly refers to the primary
PCI bus, and a device ID in the primary PCI bus is shown
in the boot message instead of the device's ID in the cardbus0.
.Pp
This option assigns bus numbers for all subordinate
PCI buses and CardBuses.
.Pp
Since this option renumbers all PCI buses and CardBuses,
all bus numbers of subordinate buses become different
when this option is enabled.
.It Dv PCI_INTR_FIXUP
Fixup PCI interrupt routing via PCIBIOS or ACPI.
.Pp
Some i386 and amd64 BIOS implementations don't assign an interrupt for
some devices.
.Pp
This option assigns an interrupt for such devices instead
of relying upon the BIOS to do so.
.Pp
If a valid interrupt has already been assigned to a device, this
option leaves the interrupt as is.
.El
.Sh HARDWARE
.Nx
includes machine-independent
.Tn PCI
drivers, sorted by device type and driver name:
.Ss SCSI interfaces
.Bl -tag -width pcdisplay -offset indent
.It ahc
Adaptec 29xx, 39xx, and other AIC-7xxx-based
.Tn SCSI
interfaces.
.It adv
Advansys
.Tn SCSI
interfaces.
.It adw
Advansys Ultra Wide
.Tn SCSI
interfaces.
.It bha
Buslogic BT-9xx
.Tn SCSI
interfaces.
.It dpt
DPT SmartCache/SmartRAID III and IV
.Tn SCSI
interfaces.
.It iha
Initio INIC-940/950
.Tn SCSI
interfaces.
.It isp
QLogic ISP-1020, ISP-1040, and ISP-2100
.Tn SCSI
and
.Tn FibreChannel
interfaces.
.It mfi
LSI Logic & Dell MegaRAID SAS RAID controllers.
.It mly
Mylex AcceleRAID and eXtremeRAID controllers with v6 firmware.
.It nca
Domex 536
.Tn SCSI
interfaces.
.It pcscp
Advanced Micro Devices Am53c974 PCscsi-PCI
.Tn SCSI
interfaces.
.It siop
Symbios Logic/NCR 53c8xx-family
.Tn SCSI
interfaces.
.It trm
Tekram TRM-S1040 ASIC based
.Tn SCSI
interfaces.
.El
.Ss Disk and tape controllers
.Bl -tag -width pcdisplay -offset indent
.It aac
The Adaptec AAC family of RAID controllers.
.It ahcisata
AHCI 1.0 and 1.1 compliant SATA controllers.
.It amr
The AMI and LSI Logic MegaRAID family of RAID controllers.
.It cac
Compaq array controllers.
.It icp
ICP Vortex GDT and Intel Storage RAID controllers.
.It mlx
Mylex DAC960 and DEC SWXCR RAID controllers.
.It pciide
IDE disk controllers.
.It twe
3Ware Escalade RAID controllers.
.El
.Ss Network interfaces
.Bl -tag -width pcdisplay -offset indent
.It an
.Tn Aironet
4500/4800 and
.Tn Cisco
340 series 802.11 interfaces.
.It aq
Aquantia AQC multigigabit Ethernet interfaces.
.It bnx
Broadcom NetXtreme II 10/100/1000 Ethernet interfaces.
.It de
.Tn DEC
DC21x4x (Tulip) based
.Tn Ethernet
interfaces, including the DE435,
DE450, and DE500, and Znyx, SMC, Cogent/Adaptec, and Asante single- and
multi-port
.Tn Ethernet
interfaces.
.It ep
3Com 3c590, 3c595, 3c900, and 3c905
.Tn Ethernet
interfaces.
.It epic
SMC83C170 (EPIC/100)
.Tn Ethernet
interfaces.
.It ex
3Com 3c900, 3c905, and 3c980
.Tn Ethernet
interfaces.
.It fxp
Intel EtherExpress PRO 10+/100B
.Tn Ethernet
interfaces.
.It gsip
National Semiconductor DP83820 based Gigabit
.Tn Ethernet
interfaces.
.It hme
Sun Microelectronics STP2002-STQ
.Tn Ethernet
interfaces.
.It ixl 
Intel 700 series
.Tn Ethernet
interfaces.
.It le
PCNet-PCI
.Tn Ethernet
interfaces.
Note, the
.Xr pcn 4
driver supersedes this driver.
.It mcx
Mellanox 5th generation Ethernet devices.
.It msk
Marvell Yukon 2 based Gigabit
.Tn Ethernet
interfaces.
.It ne
NE2000-compatible
.Tn Ethernet
interfaces.
.It nfe
NVIDIA nForce
.Tn Ethernet
interfaces.
.It ntwoc
SDL Communications N2pci and WAN/ic 400 synchronous serial interfaces.
.It pcn
AMD PCnet-PCI family of
.Tn Ethernet
interfaces.
.It ral
Ralink Technology RT2500/RT2600-based 802.11a/b/g wireless network interfaces.
.It re
Realtek 10/100/1000 Ethernet adapters.
.It rtk
Realtek 8129/8139 based
.Tn Ethernet
interfaces.
.It rtwn
Realtek RTL8188CE/RTL8192CE 802.11b/g/n wireless network interfaces.
.It sf
Adaptec AIC-6915 10/100
.Tn Ethernet
interfaces.
.It sip
Silicon Integrated Systems SiS 900, SiS 7016, and National Semiconductor
DP83815 based
.Tn Ethernet
interfaces.
.It sk
SysKonnect SK-98xx based Gigabit
.Tn Ethernet
interfaces.
.It ste
Sundance ST-201 10/100 based
.Tn Ethernet
interfaces.
.It stge
Sundance/Tamarack TC9021 based Gigabit
.Tn Ethernet
interfaces.
.It ti
Alteon Networks Tigon I and Tigon II Gigabit Ethernet driver.
.It tl
Texas Instruments ThunderLAN-based
.Tn Ethernet
interfaces.
.It tlp
DECchip 21x4x and clone
.Tn Ethernet
interfaces.
.It vge
VIA Networking Technologies VT6122 PCI Gigabit Ethernet adapter driver.
.It vr
VIA VT3043 (Rhine) and VT86C100A (Rhine-II)
.Tn Ethernet
interfaces.
.It wi
WaveLAN/IEEE and PRISM-II 802.11 wireless interfaces.
.It wm
Intel i8254x Gigabit
.Tn Ethernet
driver.
.El
.Ss Serial interfaces
.Bl -tag -width pcdisplay -offset indent
.It cy
Cyclades Cyclom-4Y, -8Y, and -16Y multi-port serial interfaces.
.It cz
Cyclades-Z series multi-port serial interfaces.
.El
.Ss Audio devices
.Bl -tag -width pcdisplay -offset indent
.It auacer
Acer Labs M5455 I/O Controller Hub integrated AC'97 audio device.
.It auich
Intel I/O Controller Hub integrated AC'97 audio device.
.It auvia
VIA VT82C686A integrated AC'97 audio device.
.It autri
Trident 4DWAVE-DX/NX, SiS 7018, ALi M5451 AC'97 audio device.
.It clcs
Cirrus Logic CS4280 audio device.
.It clct
Cirrus Logic CS4281 audio device.
.It cmpci
C-Media CMI8x38 audio device.
.It eap
Ensoniq AudioPCI audio device.
.It emuxki
Creative Labs SBLive! and PCI 512 audio device.
.It esa
ESS Technology Allegro-1 / Maestro-3 audio device.
.It esm
ESS Maestro-1/2/2e PCI AC'97 Audio Accelerator audio device.
.It eso
ESS Solo-1 PCI AudioDrive audio device.
.It fms
Forte Media FM801 audio device.
.It hdaudio
High Definition Audio Specification 1.0 device.
.It neo
NeoMagic MagicMedia 256 audio device.
.It sv
S3 SonicVibes audio device.
.It yds
Yamaha YMF724/740/744/754-based audio device.
.El
.Ss Bridges
.Bl -tag -width pcdisplay -offset indent
.It cbb
.Tn PCI
Yenta compatible
.Tn CardBus
bridges.
.It ppb
Generic
.Tn PCI Ns \- Ns Tn PCI
bridges, including
.Tn PCI
expansion backplanes.
.El
.Ss Miscellaneous devices
.Bl -tag -width pcdisplay -offset indent
.It bktr
Brooktree 848 compatible TV cards.
.It ehci
USB EHCI host controllers.
.It iop
I2O I/O processors.
.It mr
Guillemot Maxi Radio FM 2000 FM radio device.
.It nvme
Non-Volatile Memory Host controllers.
.It oboe
Toshiba OBOE IrDA SIR/FIR controller.
.It ohci
USB OHCI host controllers.
.It pcic
.Tn PCI
.Tn PCMCIA
controllers, including the Cirrus Logic GD6729.
.It puc
PCI
.Dq universal
communications cards, containing
.Xr com 4
and
.Xr lpt 4
communications ports.
.It uhci
USB UHCI host controllers.
.It viapm
VIA VT82C686A hardware monitors.
.It vga
VGA graphics boards.
.It xhci
USB XHCI host controllers.
.El
.Sh SEE ALSO
.Xr aac 4 ,
.Xr adv 4 ,
.Xr adw 4 ,
.Xr agp 4 ,
.Xr ahc 4 ,
.Xr ahcisata 4 ,
.Xr amr 4 ,
.Xr an 4 ,
.Xr aq 4 ,
.Xr auich 4 ,
.Xr autri 4 ,
.Xr auvia 4 ,
.Xr bha 4 ,
.Xr bktr 4 ,
.Xr bnx 4 ,
.Xr cac 4 ,
.Xr cbb 4 ,
.Xr clcs 4 ,
.Xr cmpci 4 ,
.Xr cy 4 ,
.Xr cz 4 ,
.Xr dpt 4 ,
.Xr eap 4 ,
.Xr ehci 4 ,
.Xr emuxki 4 ,
.Xr ep 4 ,
.Xr epic 4 ,
.Xr esa 4 ,
.Xr esm 4 ,
.Xr eso 4 ,
.Xr ex 4 ,
.Xr fms 4 ,
.Xr fxp 4 ,
.Xr gsip 4 ,
.Xr hme 4 ,
.Xr icp 4 ,
.Xr iha 4 ,
.Xr intro 4 ,
.Xr iop 4 ,
.Xr isp 4 ,
.Xr le 4 ,
.Xr mcx 4 ,
.Xr mfi 4 ,
.Xr mlx 4 ,
.Xr mly 4 ,
.Xr mpt 4 ,
.Xr msk 4 ,
.Xr nca 4 ,
.Xr ne 4 ,
.Xr neo 4 ,
.Xr nfe 4 ,
.Xr ntwoc 4 ,
.Xr nvme 4 ,
.Xr oboe 4 ,
.Xr ohci 4 ,
.Xr pcic 4 ,
.Xr pciide 4 ,
.Xr pcn 4 ,
.Xr pcscp 4 ,
.Xr ppb 4 ,
.Xr puc 4 ,
.Xr ral 4 ,
.Xr re 4 ,
.Xr rtk 4 ,
.Xr rtwn 4 ,
.Xr sf 4 ,
.Xr siisata 4 ,
.Xr siop 4 ,
.Xr sip 4 ,
.Xr sk 4 ,
.Xr ste 4 ,
.Xr stge 4 ,
.Xr sv 4 ,
.Xr ti 4 ,
.Xr tl 4 ,
.Xr tlp 4 ,
.Xr trm 4 ,
.Xr twe 4 ,
.Xr uhci 4 ,
.Xr vax/en 4 ,
.Xr vga 4 ,
.Xr vge 4 ,
.\" .Xr viapm 4 ,
.Xr vr 4 ,
.Xr wi 4 ,
.Xr wm 4 ,
.Xr wscons 4 ,
.Xr xhci 4 ,
.Xr yds 4
.Sh HISTORY
The machine-independent
.Tn PCI
subsystem appeared in
.Nx 1.2 .