Module pci

PCI bus enumeration and device discovery.

This module provides utilities for scanning the PCI bus to find VirtIO and other network devices. Supports both:

• ECAM (Enhanced Configuration Access Mechanism) - Modern PCIe
• Legacy I/O ports - Older PCI (0xCF8/0xCFC)

Usage

use morpheus_network::device::pci::{PciScanner, EcamAccess};

// For QEMU with PCIe ECAM at 0xB000_0000
let ecam = unsafe { EcamAccess::new(0xB000_0000 as *mut u8) };
let scanner = PciScanner::new(ecam);

for device in scanner.scan_bus(0) {
    if device.is_virtio_net() {
        // Found VirtIO network device!
    }
}

Modules

• diagnostics
  Diagnostic utilities for PCI debugging.
• ecam_bases
  Common ECAM base addresses for different platforms.

Structs

• DeviceFunction
  PCI device/function identifier.
• EcamAccess
  ECAM (PCIe Enhanced Configuration Access Mechanism) implementation.
• LegacyIoAccess
  Legacy I/O port PCI configuration access (0xCF8/0xCFC).
• PciDeviceInfo
  PCI device information from configuration space.
• PciScanner
  PCI bus scanner.

Constants

• PCIE_CONFIG_SIZE
  PCIe extended configuration space size.
• PCI_CONFIG_SIZE
  PCI configuration space size for a single function.
• VIRTIO_DEVICE_ID_BASE
  VirtIO device ID range for transitional devices.
• VIRTIO_NET_DEVICE_ID
  VirtIO device ID for modern network device.
• VIRTIO_VENDOR_ID
  PCI vendor ID for VirtIO devices.

Traits

• ConfigAccess
  Trait for PCI configuration space access.

Functions

• pci_config_read32 🔒 ^⚠
  Read 32-bit value from PCI configuration space. Args: bus, device, function, offset (must be 4-byte aligned)
• pci_config_write32 🔒 ^⚠
  Write 32-bit value to PCI configuration space. Args: bus, device, function, offset, value
• pci_io_test^⚠
  Test if PCI I/O ports are accessible. Returns the value read back from 0xCF8 (should have bit 31 set).
• read_tsc^⚠
  Read CPU timestamp counter. Returns 64-bit TSC value.
• tsc_delay_us
  Delay for approximately the given number of microseconds using TSC. Assumes ~2.5 GHz CPU (adjust TSC_MHZ for your platform).