Struct FakePci 

pub struct FakePci { /* private fields */ }

A fake implementation of the fpci::Device protocol for testing PCI drivers.

Implementations

impl FakePci

pub fn new() -> Self

Creates a new empty FakePci instance.

pub fn set_device_info(&self, info: DeviceInfo)

Sets the [fpci::DeviceInfo] for the fake PCI device and populates header fields.

pub fn device_info(&self) -> DeviceInfo

Returns the current [fpci::DeviceInfo].

pub fn bus_master_enabled(&self) -> Option<bool>

Returns whether bus mastering has been enabled, or None if not set.

pub fn reset_count(&self) -> u32

Returns the number of times the device has been reset.

pub fn add_vmo_bar(&self, bar_id: u32, size: u64, vmo: Vmo)

Configures a VMO BAR with the given ID and size using an existing zx::Vmo.

Panics

Panics if bar_id is invalid (>= fpci::MAX_BAR_COUNT), or if a BAR has already been set for bar_id.

pub fn create_vmo_bar(&self, bar_id: u32, size: u64)

Creates and configures a new VMO BAR with the given ID and size.

Panics

Panics if VMO creation fails, or under the same conditions as Self::add_vmo_bar.

pub fn vmo_bar(&self, bar_id: u32) -> Option<Vmo>

Returns a duplicated handle to the zx::Vmo associated with bar_id, if present.

pub fn add_bti(&self, index: u32, bti: Bti)

Registers a zx::Bti handle at the given index.

Panics

Panics if a BTI is already registered at index.

pub fn add_capability(&self, id: CapabilityId, position: u8, size: u8)

Adds a PCI capability at the specified offset in configuration space.

Panics

Panics if:

• id is an unknown capability ordinal.
• position is in the configuration header or the capability exceeds configuration space bounds.
• The capability overlaps with a previously added capability.

pub fn add_vendor_capability(&self, position: u8, size: u8)

Adds a vendor-specific PCI capability at the specified offset.

Panics

Panics if size <= 2, or under the same conditions as Self::add_capability.

pub fn add_pci_express_capability(&self, position: u8)

Adds a PCI Express capability at the specified offset.

Panics

Panics under the same conditions as Self::add_capability.

pub fn add_legacy_interrupt(&self) -> Arc<VirtualInterrupt>

Adds a legacy virtual interrupt and returns its zx::VirtualInterrupt.

Panics

Panics if creation of the virtual interrupt fails, or if a legacy interrupt has already been added.

pub fn add_msi_interrupt(&self) -> Arc<VirtualInterrupt>

Adds an MSI virtual interrupt and returns its zx::VirtualInterrupt.

Subsequent calls populate interrupts at incrementing indices.

Panics

Panics if creation of the virtual interrupt fails, or if the number of MSI interrupts exceeds the protocol maximum.

pub fn add_msix_interrupt(&self) -> Arc<VirtualInterrupt>

Adds an MSI-X virtual interrupt and returns its zx::VirtualInterrupt.

Subsequent calls populate interrupts at incrementing indices.

Panics

Panics if creation of the virtual interrupt fails, or if the number of MSI-X interrupts exceeds the protocol maximum.

pub fn interrupt_mode(&self) -> InterruptMode

Returns the currently configured [fpci::InterruptMode].

pub fn requested_irq_count(&self) -> u32

Returns the number of requested interrupt vectors.

pub fn read_config8(&self, offset: u16) -> u8

Reads an 8-bit value from configuration space at offset.

Panics

Panics if the read exceeds configuration space bounds.

pub fn read_config16(&self, offset: u16) -> u16

Reads a 16-bit value from configuration space at offset.

Panics

Panics if the read exceeds configuration space bounds.

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

Reads a 32-bit value from configuration space at offset.

Panics

Panics if the read exceeds configuration space bounds.

pub fn write_config8(&self, offset: u16, value: u8)

Writes an 8-bit value to configuration space at offset.

Panics

Panics if offset is in the configuration header or the write exceeds configuration space bounds.

pub fn write_config16(&self, offset: u16, value: u16)

Writes a 16-bit value to configuration space at offset.

Panics

Panics if offset is in the configuration header or the write exceeds configuration space bounds.

pub fn write_config32(&self, offset: u16, value: u32)

Writes a 32-bit value to configuration space at offset.

Panics

Panics if offset is in the configuration header or the write exceeds configuration space bounds.

pub fn serve<O: ServiceObjTrait>( &self, service_fs: &mut ServiceFs<O>, scope: ScopeHandle, instance_name: &str, ) -> Offer

Offers the fpci::Service to service_fs and returns the [fdf::Offer].

Trait Implementations

impl Clone for FakePci

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for FakePci

fn default() -> Self

Returns the “default value” for a type.