Struct VirtioPciTransport 

pub struct VirtioPciTransport { /* private fields */ }

Virtio PCI transport handle.

Wraps the BAR0 I/O port base address for a legacy virtio PCI device and provides typed accessors for the common virtio register set.

Implementations

impl VirtioPciTransport

pub fn new(io_base: u16) -> Self

Create a new transport from the BAR0 I/O base address.

pub fn io_base(&self) -> u16

Get the I/O base address.

pub fn read_device_features(&self) -> u32

Read the device-offered feature bits (32-bit).

pub fn write_guest_features(&self, features: u32)

Write the driver-accepted feature bits (32-bit).

pub fn read_queue_size(&self) -> u16

Read the queue size for the currently selected queue.

pub fn select_queue(&self, index: u16)

Select a virtqueue by index.

pub fn write_queue_address(&self, pfn: u32)

Set the physical page frame number (PFN) of the selected virtqueue.

The device uses this to locate the virtqueue descriptor table, available ring, and used ring in guest physical memory. The address is pfn * 4096.

pub fn notify_queue(&self, queue_index: u16)

Notify (kick) the device that new buffers are available in the given queue.

pub fn read_status(&self) -> u8

Read the device status register.

pub fn write_status(&self, status: u8)

Write the device status register.

pub fn read_isr(&self) -> u8

Read the ISR status register (clears interrupt flag on read).

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

Read a byte from device-specific configuration space.

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

Read a 32-bit word from device-specific configuration space.

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

Read a 64-bit value from device-specific configuration space (two 32-bit reads).

pub fn reset(&self)

Reset the device by writing zero to the status register.

pub fn begin_init(&self)

Perform the standard legacy device initialization sequence.

1. Reset device
2. Set ACKNOWLEDGE
3. Set DRIVER

After calling this, the driver should read device features, negotiate, then call set_features_ok() and set_driver_ok().

pub fn set_features_ok(&self) -> bool

Signal that feature negotiation is complete.

Returns true if the device accepted FEATURES_OK; false means the device does not support the selected feature subset and initialization should be aborted.

pub fn set_driver_ok(&self)

Signal that the driver is fully initialized and ready.

pub fn set_failed(&self)

Mark the device as failed.

Trait Implementations

impl Clone for VirtioPciTransport

fn clone(&self) -> VirtioPciTransport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtioPciTransport

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Copy for VirtioPciTransport