PCI configuration space

PCI configuration space is the underlying way that the Conventional PCI, PCI-X and PCI Express perform auto configuration of the cards inserted into their bus.

This library implements access to PCI configuration space and PCI Express extended configuration space.

Design

The library is divided into three parts: - PCI 3.0 Compatible Configuration Space Header - PCI Configuration Space Capabilities - Extended Configuration Space Capabilities

Usage

```rust use pcics::{ DDROFFSET, ECSOFFSET, Header, Capabilities, ExtendedCapabilities, capabilities::{ CapabilityKind, bridgesubsystemvendorid::BridgeSubsystemVendorId }, extendedcapabilities::{ ExtendedCapabilityKind, vendorspecificextended_capability::VendorSpecificExtendedCapability }, };

let confspace = includebytes!(concat!( env!("CARGOMANIFESTDIR"), "/tests/data/device/8086:2030/config" ));

let headerdata = &confspace[..DDROFFSET]; let header = Header::tryfrom(headerdata).unwrap(); asserteq!((0x8086, 0x2030), (header.vendorid, header.deviceid));

let devicedependedregiondata = &confspace[DDROFFSET..ECSOFFSET]; let mut caps = Capabilities::new(devicedependedregiondata, header.capabilitiespointer); let BridgeSubsystemVendorId { subsystemvendorid, .. } = caps.findmap(|c| { if let CapabilityKind::BridgeSubsystemVendorId(ssvid) = c.kind { Some(ssvid) } else { None } }) .unwrap(); asserteq!(0x8086, subsystemvendorid);

let ecsdata = &confspace[ECSOFFSET..]; let mut ecaps = ExtendedCapabilities::new(ecsdata); let VendorSpecificExtendedCapability { header, .. } = ecaps .findmap(|c| { if let ExtendedCapabilityKind::VendorSpecificExtendedCapability(vsec) = c.kind { Some(vsec) } else { None } }) .unwrap(); asserteq!(0x0c, header.vsec_length); ``` More detailed usage in modules descriptions