PCI(4) - Device Drivers Manual

PCI(4) - Device Drivers Manual #

PCI(4) - Device Drivers Manual

NAME #

pci - introduction to PCI bus support

SYNOPSIS #

# alpha pci* at apecs? pci* at cia? pci* at irongate? pci* at lca? pci* at tsp? pci* at mcpcia?

# amd64, i386 pci* at mainbus0

# arm64 pci* at acpipci? pci* at bcmpcie? pci* at dwpcie? pci* at mvkpcie? pci* at pciecam? pci* at rkpcie?

# armv7 pci* at mvpcie? pci* at pciecam?

# hppa pci* at dino? pci* at elroy?

# landisk pci* at shpcic?

# loongson pci* at bonito? pci* at htb?

# macppc pci* at mpcpcibr? pci* at ht? pci* at hpb?

# octeon pci* at octpcie?

# riscv64 pci* at dwpcie? pci* at pciecam?

# sparc64 pci* at psycho? pci* at schizo? pci* at pyro? pci* at vpci?

# all architectures pci* at pchb? pci* at ppb?

DESCRIPTION #

The system includes a machine-independent PCI bus subsystem and several machine-independent PCI device drivers.

Note that interrupt mappings on the i386 may require that you configure your BIOS to reserve sufficient interrupts as “PCI/ISAPnP” so that there are sufficient interrupts remaining to configure the discovered PCI devices. For more information, see pcibios(4).

OpenBSD provides support for the following devices. Note that not all architectures support all devices.

SCSI host adapters #

adv(4), adw(4)

AdvanSys PCI SCSI interface

ahc(4)

Adaptec VL/EISA/PCI SCSI interface

ahd(4)

Adaptec PCI/PCI-X AIC79xx-based Ultra320 SCSI interface

iha(4)

Initio INIC-940/950 based PCI SCSI interface

mpi(4)

LSI Logic Fusion-MPT Message Passing Interface

mpii(4)

LSI Logic Fusion-MPT Message Passing Interface II

nvme(4)

Non-Volatile Memory Host Controller Interface

pcscp(4)

Advanced Micro Devices Am53c974 PCscsi-PCI SCSI interface

qla(4)

QLogic ISP2100/2200/2300 Fibre Channel controller

qle(4)

QLogic ISP2400/2500 Fibre Channel controller

qlw(4)

QLogic ISP1000/1020/1x40/1x80/1x160 SCSI controller

siop(4)

LSI/Symbios Logic/NCR 53c8xx SCSI interface

trm(4)

TRM-S1040 based PCI SCSI interface

vmwpvs(4)

VMware Paravirtual SCSI

IDE disk controllers #

ahci(4)

Advanced Host Controller Interface for Serial ATA

jmb(4)

JMicron JMB36x SATA II and PATA Host Controller

kauaiata(4)

ATA100 HD controller on PCI bus

pciide(4)

PCI IDE controller driver

sili(4)

Silicon Image 3124/3132/3531 SATA controller

RAID and cache controllers #

aac(4)

Adaptec SAS/SATA/SCSI RAID controller

ami(4)

American Megatrends Inc. MegaRAID PATA/SATA/SCSI RAID controller

arc(4)

Areca Technology Corporation SAS/SATA RAID controller

cac(4)

Compaq Smart Array 2/3/4 SCSI RAID controller

ciss(4)

Compaq Smart Array SAS/SATA/SCSI RAID controller

gdt(4)

ICP-Vortex and Intel GDT SATA/SCSI RAID controller

ips(4)

IBM SATA/SCSI ServeRAID controller

mfi(4)

LSI Logic & Dell MegaRAID SAS RAID controller

mfii(4)

LSI Logic MegaRAID SAS Fusion RAID controller

twe(4)

3ware 5000/6000/7000/8000 series PATA/SATA RAID controller

Wired network interfaces #

age(4)

Attansic L1 10/100/1Gb Ethernet device

alc(4)

Atheros AR813x/AR815x/AR816x/AR817x 10/100/1Gb Ethernet device

ale(4)

Atheros AR8121/AR8113/AR8114 10/100/1Gb Ethernet device

aq(4)

Aquantia AQC1xx 1Gb/2.5Gb/5Gb/10Gb PCIe Ethernet device

bce(4)

Broadcom BCM4401 10/100 Ethernet device

bge(4)

Broadcom BCM57xx/BCM590x 10/100/1Gb Ethernet device

bnx(4)

Broadcom NetXtreme II 10/100/1Gb Ethernet device

bnxt(4)

Broadcom NetXtreme-C/E 10Gb/25Gb/40Gb/50Gb Ethernet device

cas(4)

Sun Cassini 10/100/1Gb Ethernet device

dc(4)

DEC/Intel 21140/21142/21143/21145 and clones 10/100 Ethernet device

de(4)

DEC DC21x4x (Tulip) 10/100 Ethernet device

dwqe(4)

Synopsys DesignWare Ethernet Quality-of-Service Controller

em(4)

Intel PRO/1000 10/100/1Gb Ethernet device

ep(4)

3Com EtherLink III and Fast EtherLink III 10/100 Ethernet device

epic(4)

SMC 83C170 (EPIC/100) 10/100 Ethernet device

et(4)

Agere/LSI ET1310 10/100/1Gb Ethernet device

fxp(4)

Intel EtherExpress PRO/100 10/100 Ethernet device

gem(4)

GEM 10/100/1Gb Ethernet device

hme(4)

Sun Happy Meal 10/100 Ethernet device

iavf(4)

Intel Ethernet Adaptive Virtual Function device

igc(4)

Intel I225/I226 1Gb/2.5Gb Ethernet device

ix(4)

Intel 82598/82599/X540/X550 PCI Express 100/1Gb/10Gb Ethernet device

ixgb(4)

Intel PRO/10GbE 10Gb Ethernet device

ixl(4)

Intel Ethernet 700 series Ethernet device

jme(4)

JMicron JMC25x/JMC26x 10/100/1Gb Ethernet device

lge(4)

Level 1 LXT1001 NetCellerator PCI 1Gb Ethernet device

lii(4)

Attansic L2 10/100 Ethernet device

mcx(4)

Mellanox 5th generation Ethernet device

msk(4)

Marvell Yukon-2 10/100/1Gb Ethernet device

mtd(4)

Myson Technology MTD800/MTD803/MTD891 10/100/1Gb Ethernet device

myx(4)

Myricom Myri-10G PCI Express 10Gb Ethernet device

ne(4)

NE2000 and compatible 10/100 Ethernet device

nep(4)

Sun Neptune 10Gb Ethernet device

nfe(4)

NVIDIA nForce MCP 10/100/1Gb Ethernet device

ngbe(4)

WangXun WX1860 PCI Express 10/100/1Gb Ethernet device

nge(4)

National Semiconductor PCI 10/100/1Gb Ethernet device

oce(4)

Emulex OneConnect 10Gb Ethernet device

pcn(4)

AMD PCnet-PCI 10/100 Ethernet device

re(4)

Realtek 8139C+/8169/816xS/811xS/8168/810xE 10/100/1Gb Ethernet device

rge(4)

Realtek 8125/8125B PCI Express 10/100/1Gb/2.5Gb Ethernet device

rl(4)

Realtek 8129/8139 10/100 Ethernet device

se(4)

SiS 190/191 10/100/1Gb Ethernet device

sf(4)

Adaptec AIC-6915 “Starfire” PCI 10/100 Ethernet device

sis(4)

SiS 900, SiS 7016, and NS DP83815/6 10/100 Ethernet device

sk(4)

SysKonnect XMAC II and Marvell Yukon 10/100/1Gb Ethernet device

ste(4)

Sundance Technologies ST201 10/100 Ethernet device

stge(4)

Sundance/Tamarack TC9021 1Gb Ethernet device

tht(4)

Tehuti Networks 10Gb Ethernet device

ti(4)

Alteon Networks Tigon I and II 1Gb Ethernet device

tl(4)

Texas Instruments ThunderLAN 10/100 Ethernet device

txp(4)

3Com 3XP Typhoon/Sidewinder (3CR990) 10/100 Ethernet device

vge(4)

VIA Velocity 10/100/1Gb Ethernet device

vic(4)

VMware VMXnet Virtual Interface Controller device

vmx(4)

VMware VMXNET3 Virtual Interface Controller device

vr(4)

VIA Rhine I/II/III 10/100 Ethernet device

vte(4)

RDC R6040 10/100 Ethernet device

wb(4)

Winbond W89C840F 10/100 Ethernet device

xge(4)

Neterion Xframe/Xframe II 10Gb Ethernet device

xl(4)

3Com EtherLink XL and Fast EtherLink XL 10/100 Ethernet device

Wireless network interfaces #

acx(4)

TI ACX100/ACX111 IEEE 802.11a/b/g wireless network device

an(4)

Aironet Communications 4500/4800 IEEE 802.11FH/b wireless network device

ath(4)

Atheros IEEE 802.11a/b/g wireless network device with GPIO

athn(4)

Atheros IEEE 802.11a/b/g/n wireless network device

atw(4)

ADMtek ADM8211 IEEE 802.11b wireless network device

bwfm(4)

Broadcom and Cypress IEEE 802.11a/ac/ax/b/g/n wireless network device

bwi(4)

Broadcom AirForce IEEE 802.11b/g wireless network device

ipw(4)

Intel PRO/Wireless 2100 IEEE 802.11b wireless network device

iwi(4)

Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network device

iwn(4)

Intel WiFi Link and Centrino IEEE 802.11a/b/g/n wireless network device

iwm(4)

Intel 7000/8000/9000 IEEE 802.11a/ac/b/g/n wireless network device

iwx(4)

Intel AX200/AX201/AX210/AX211 IEEE 802.11a/ac/ax/b/g/n wireless network device

malo(4)

Marvell Libertas IEEE 802.11b/g wireless network device

pgt(4)

Conexant/Intersil Prism GT Full-MAC IEEE 802.11a/b/g wireless network device

qwx(4)

Qualcomm IEEE 802.11a/ac/ax/b/g/n wireless network device

ral(4)

Ralink Technology/MediaTek IEEE 802.11a/b/g/n wireless network device

rtw(4)

Realtek RTL8180L IEEE 802.11b wireless network device

rtwn(4)

Realtek RTL8188CE/RTL8188EE/RTL8192CE/RTL8723AE PCIe IEEE 802.11b/g/n wireless network device

wi(4)

WaveLAN/IEEE, PRISM 2-3, and Spectrum24 IEEE 802.11b wireless network device

wpi(4)

Intel PRO/Wireless 3945ABG IEEE 802.11a/b/g wireless network device

Cryptography accelerators #

ccp(4)

AMD cryptographic co-processor

glxsb(4)

Geode LX Security Block crypto accelerator

Serial interfaces #

cy(4)

Cyclades Cyclom-4Y, -8Y, and -16Y asynchronous serial communications devices

cz(4)

Cyclades-Z series multi-port serial adapter device

puc(4)

PCI “universal” communications card driver

Display adapters #

astfb(4)

Aspeed BMC frame buffer

gfxp(4)

accelerated color frame buffer

ifb(4)

inextricable frame buffer

machfb(4)

accelerated color frame buffer

radeonfb 4

accelerated color frame buffer

raptor(4)

accelerated color frame buffer

sisfb(4)

SiS 315 Pro frame buffer

smfb(4)

Silicon Motion frame buffer

sti(4)

HP Standard Text Interface

tga(4)

DECchip 21030 (TGA) graphics driver

vga(4)

VGA graphics cards

vgafb(4)

VGA frame buffer

Audio devices #

auacer(4)

Acer Labs I/O Controller Hub integrated AC'97 audio device

auglx(4)

AMD Geode LX CS5536 integrated AC'97 audio device

auich(4)

Intel ICH integrated AC'97 audio device

auixp(4)

ATI SB200/SB300/SB400/SB600 integrated AC'97 audio device

autri(4)

Trident 4DWAVE-DX/NX, SiS 7018, ALi M5451 audio device

auvia(4)

VIA VT82C686A/VT8233/VT8235/VT8237 integrated AC'97 audio device

azalia(4)

generic High Definition Audio device

clcs(4)

Cirrus Logic CS4280/CS4610/CS4615 audio device

clct(4)

Cirrus Logic CS4281 audio device

cmpci(4)

C-Media CMI8338/CMI8738/CMI8768 PCI audio device

eap(4)

Ensoniq AudioPCI audio device

emu(4)

Creative Labs SBLive!, PCI 512, and Audigy audio device

envy(4)

VIA Envy24 audio device

esa(4)

ESS Technology Allegro-1/Maestro-3 family audio device

eso(4)

ESS Technology Solo-1 PCI AudioDrive audio device

fms(4)

Forte Media FM801 audio device

maestro(4)

ESS Maestro 1 and 2 audio device

neo(4)

NeoMagic 256AV/ZX audio device

sv(4)

S3 SonicVibes audio device

yds(4)

Yamaha DS-XG audio device

Time receiver devices #

mbg(4)

Meinberg Funkuhren timedelta sensor

Radio receiver devices #

fms(4)

Forte Media FM801 audio device

Hardware Sensors #

berkwdt(4)

Berkshire Products watchdog timer device

geodesc(4)

Geode SC1100/SCx200 IAOC watchdog timer device

ichwdt(4)

Intel 6300ESB ICH watchdog timer device

itherm(4)

Intel 3400 temperature sensor

kate(4)

AMD K8 temperature sensor

km(4)

AMD K10 temperature sensor

ksmn(4)

AMD K17 temperature sensor over SMN

pchtemp(4)

Intel PCH temperature sensor

pwdog(4)

Quancom PWDOG1 watchdog timer device

viapm(4)

VIA SMBus controller and VIA VT82C686A/VT8231 hardware monitor

wdt(4)

ICS PCI-WDT500/501 watchdog timer device

Miscellaneous devices #

alipm(4)

Acer Labs M7101 SMBus controller

amas(4)

AMD memory address map

amdiic(4)

AMD-8111 SMBus controller

amdpcib(4)

AMD-8111 series LPC bridge and timecounter

amdpm(4)

AMD-756/766/768/8111 Power Management and SMBus controller

bktr(4)

Brooktree Bt848/849/878/879 PCI TV tuners and video capture boards

cbb(4)

PCI Yenta compatible CardBus bridges

drm(4)

Direct Rendering Manager device

dwiic(4)

Synopsys DesignWare I2C controller

ehci(4)

USB Enhanced Host Controller Interface

gcu(4)

Intel EP80579 Global Configuration Unit

glxpcib(4)

CS5536 PCI-ISA Bridge with timecounter, watchdog timer, and GPIO

gscpcib(4)

National Semiconductor Geode SC1100 PCI-ISA bridge with GPIO

gscpm(4)

National Semiconductor Geode SC1100 SMI/ACPI module

hpb(4)

HyperTransport-PCI bridge

ichiic(4)

Intel ICH SMBus controller

ichpcib(4)

Intel ICHx/ICHx-M LPC bridges

iosf(4)

Intel OnChip System Fabric device

nviic(4)

NVIDIA nForce2/3/4 SMBus controller

ohci(4)

USB Open Host Controller Interface

pcib(4)

PCI-ISA bridge

pcic(4)

PCI PCMCIA controllers, including the Cirrus Logic GD6729

piixpm(4)

Intel PIIX SMBus controller

ppb(4)

PCI-PCI bridge

rtsx(4)

Realtek SD card reader

sbbc(4)

PCI BootBus Controller

sdhc(4)

SD Host Controller

ssio(4)

National Semiconductor PC87560 Legacy IO

tcpcib(4)

Intel Atom E600 series LPC bridge and watchdog timer

uhci(4)

USB Universal Host Controller Interface

viapm(4)

VIA SMBus controller

virtio(4)

VirtIO support driver

voyager(4)

Silicon Motion Mobile Multimedia Companion Chip

xspd(4)

XenSource Platform Device driver

IOCTLS #

If the kernel is compiled with the USER_PCICONF kernel option, the following ioctl(2) calls are supported by the pci driver. They are defined in the header file <sys/pciio.h>.

PCIOCREAD struct pci_io *‌

This ioctl(2) reads the PCI configuration registers specified by the passed-in pci_io structure. The pci_io structure consists of the following fields:

pi_sel

A pcisel structure which specifies the bus, slot and function the user would like to query.

pi_reg

The PCI configuration register the user would like to access.

pi_width

The width, in bytes, of the data the user would like to read. This value can be only 4.

pi_data

The data returned by the kernel.

PCIOCWRITE struct pci_io *‌

This ioctl(2) allows users to write to the PCI device specified in the passed-in pci_io structure. The pci_io structure is described above. The limitations on data width described for reading registers, above, also apply to writing PCI configuration registers.

PCIOCGETROM struct pci_rom *‌

This ioctl(2) allows users to read the contents of the PCI ROM specified in the passed-in pci_rom structure. The pci_rom structure consists of the following fields:

pr_sel

A pcisel structure which specifies the bus, slot and function the user would like to query.

pr_romlen

Size of the buffer to store the contents of the ROM. Upon return, this field will contain the size of the ROM

pr_rom

The address of the buffer to store the contents of the ROM.

If the ROM is larger than the specified buffer size, ENOMEM will be returned.

FILES #

/dev/pci*‌

Character device for the pci driver.

SEE ALSO #

intro(4), pcidump(8)

HISTORY #

The machine-independent PCI subsystem appeared in OpenBSD 1.2.

OpenBSD 7.5 - February 15, 2024