Module pci 

PCI Configuration Space Access

Provides functions to scan the PCI bus and read/write configuration registers. Used to discover VirtIO and other PCI devices.

Reference: PCI Local Bus Specification 3.0

Modules

aer_cap

AER (Advanced Error Reporting) capability register offsets.

cap_id

PCI capability IDs

class

PCI base class codes

command

PCI command register bits

config

PCI configuration register offsets

device

PCI Device IDs (VirtIO legacy)

ext_cap_id

PCIe Extended Capability IDs (offset >= 0x100)

intel_eth

Intel Ethernet device IDs

msi_cap

Offsets within an MSI capability block (relative to capability base).

msi_ctrl

MSI control register bit definitions (16-bit at cap_base + 2).

msix_cap

Offsets within an MSI-X capability block (relative to capability base).

msix_ctrl

MSI-X control register bit definitions (16-bit at cap_base + 2).

net_subclass

PCI subclasses for network controllers

sata_progif

Programming interface codes for mass-storage SATA controllers

sriov_cap

SR-IOV capability register offsets (relative to capability base).

sriov_ctrl

SR-IOV Control register bits

sriov_status

SR-IOV Status register bits

storage_subclass

PCI subclasses for mass storage controllers

vendor

PCI Vendor IDs

Structs

AerInfo

AER (Advanced Error Reporting) capability information.

EcamRegion 🔒

A mapped ECAM region covering a range of buses.

PciAddress

A PCI device location

PciDevice

PCI device information

PciLineQuirk 🔒

PciScanner

Iterator for scanning PCI bus

ProbeCriteria

Full PCI probe criteria.

SriovInfo

SR-IOV capability information.

Enums

Bar

Base Address Register (BAR) types

Constants

CONFIG_ADDRESS 🔒

PCI Configuration Address Port

CONFIG_DATA 🔒

PCI Configuration Data Port

MSI_ADDR_BASE

x86 MSI message address (delivers to LAPIC via system bus).

MSI_ADDR_DEST_SHIFT

PCI_IRQ_LINE_ZERO_IF_FF 🔒

Statics

ECAM_REGIONS 🔒

Cached ECAM MMIO regions for extended config space access (offsets >= 0x100). Populated during scan_ecam_devices() when an MCFG table is present.

PCI_DEVICE_CACHE 🔒

Cached PCI device inventory.

PCI_IO_LOCK 🔒

Global lock for PCI configuration space I/O.

Functions

all_devices

Return a snapshot of all discovered PCI devices.

class_name 🔒

Human-readable PCI class name.

device_name 🔒

Known PCI device names for human-readable logging.

ecam_read8 🔒 ^⚠

Read a single byte from ECAM config space.

ecam_read32 🔒 ^⚠

Read a 32-bit register from an ECAM-mapped PCI config space.

ecam_write32 🔒 ^⚠

Write a 32-bit register to an ECAM-mapped PCI config space.

find_device

Helper to find a device by vendor and device ID

find_devices_by_class

Return all devices matching a PCI class/subclass pair.

find_devices_by_vendor

Return all devices for a given vendor from the cached PCI inventory.

find_ext_capability

Find the PCIe extended capability offset for a given capability ID.

find_virtio_device

Find a specific VirtIO device by device ID

find_virtio_devices

Find all VirtIO devices on the PCI bus

invalidate_cache

Invalidate PCI cache.

is_absent_vendor 🔒

is_ghost_device 🔒

probe_all

Return all devices matching criteria.

probe_device_full 🔒

Probe a PCI address using 4 batched dword reads under a single lock hold.

probe_ecam_device 🔒

Probe a single PCI device via ECAM MMIO.

probe_first

Return the first device matching criteria.

probe_from_word00 🔒

Build a PciDevice when word00 (vendor+device dword) was already read by the caller’s fast-path vendor check, avoiding a redundant I/O cycle.

quirk_zero_irq_line 🔒

raw_config_read 🔒

Single dword config read without building a PciDevice/PciAddress. Acquires PCI_IO_LOCK once.

raw_config_read_u8 🔒

Read a single byte from config space (derived from a dword read).

read_aer_info

Read AER (Advanced Error Reporting) capability information.

read_sriov_info

Read SR-IOV capability information from a PCI device.

scan_ecam_devices 🔒

Scan PCI devices via ECAM (Memory-Mapped Configuration).

valid_header_type 🔒

walk_ext_capabilities

Walk PCIe extended capabilities starting from cap_ptr (>= 0x100).

with_cache 🔒

Populate the cache if empty, then run f on the device slice.