Expand description
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§
- 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)
- 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
- storage_
subclass - PCI subclasses for mass storage controllers
- vendor
- PCI Vendor IDs
Structs§
- PciAddress
- A PCI device location
- PciDevice
- PCI device information
- PciLine
Quirk 🔒 - PciScanner
- Iterator for scanning PCI bus
- Probe
Criteria - Full PCI probe criteria.
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§
- 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.
- 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_
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_
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).
- valid_
header_ 🔒type - with_
cache 🔒 - Populate the cache if empty, then run
fon the device slice.