Struct PciExpressCapability 

pub struct PciExpressCapability { /* private fields */ }

Configurable PCI Express capability.

Implementations

impl PciExpressCapability

pub fn new( typ: DevicePortType, flr_handler: Option<Arc<dyn FlrHandler>>, ) -> Self

Creates a new PCI Express capability with FLR support.

Arguments

• typ - The spec-defined device or port type.
• flr_handler - Optional handler to be called when FLR is initiated. This emulator will report that FLR is supported if flr_handler = Some(_)

pub fn with_hotplug_support(self, slot_number: u32) -> Self

Enable hotplug support for this PCIe capability. This configures the appropriate registers to support hotpluggable devices. Panics if called on device types other than RootPort or DownstreamSwitchPort.

Arguments

• slot_number - The physical slot number to assign to this hotplug-capable port

pub fn set_presence_detect_state(&self, present: bool)

Set the presence detect state for the slot. This method only has effect if the slot is implemented (slot_implemented = true). If slot is not implemented, the call is silently ignored, as the spec says “If this register is implemented but the Slot Implemented bit is Clear, the field behavior of this entire register with the exception of the DLLSC bit is undefined.”

Arguments

• present - true if a device is present in the slot, false if the slot is empty

pub fn set_hotplug_changed_bits(&self)

Set the RW1C changed bits in Slot Status to signal a hotplug event. Call this only for runtime hotplug events, not build-time device attachment.

pub fn set_hotplug_state(&self, present: bool)

Atomically update presence detect state, link active state, and changed bits for a hotplug event.

pub fn hot_plug_interrupt_enabled(&self) -> bool

Returns whether the hot plug interrupt is enabled in Slot Control.

pub fn slot_capabilities(&self) -> &SlotCapabilities

Returns a reference to the slot capabilities register.

Trait Implementations

impl Inspect for PciExpressCapability

fn inspect(&self, req: Request<'_>)

Inspects the object.

impl PciCapability for PciExpressCapability

fn label(&self) -> &str

A descriptive label for use in Save/Restore + Inspect output

fn capability_id(&self) -> CapabilityId

Returns the PCI capability ID for this capability

fn len(&self) -> usize

Length of the capability structure

fn read_u32(&self, offset: u16) -> u32

Read a u32 at the given offset

fn write_u32(&mut self, offset: u16, val: u32)

Write a u32 at the given offset

fn reset(&mut self)

Reset the capability

fn as_pci_express(&self) -> Option<&PciExpressCapability>

Downcast to PCI Express capability

fn as_pci_express_mut(&mut self) -> Option<&mut PciExpressCapability>

Downcast to PCI Express capability (mutable)

fn as_msi_cap(&self) -> Option<&MsiCapability>

Downcast to MSI capability

fn as_msi_cap_mut(&mut self) -> Option<&mut MsiCapability>

Downcast to MSI capability (mutable)

impl SaveRestore for PciExpressCapability

type SavedState = SavedState

The concrete saved state type.

fn save(&mut self) -> Result<Self::SavedState, SaveError>

Saves the object’s state.

fn restore(&mut self, _: Self::SavedState) -> Result<(), RestoreError>

Restores the object’s state.