Struct Serial16550

pub struct Serial16550 { /* private fields */ }

A 16550 serial port emulator.

Implementations

impl Serial16550

pub fn new( debug_name: String, base: MmioOrIoPort, register_width: u8, interrupt: LineInterrupt, io: Box<dyn SerialIo>, wait_for_rts: bool, ) -> Result<Self, ConfigurationError>

Returns a new emulator instance.

debug_name is used to improve tracing statements. base is the base IO port and will be used for an IO region spanning 8 bytes.

Trait Implementations

impl ChangeDeviceState for Serial16550

fn start(&mut self)

Starts a device, allowing it to interact with the guest asynchronously.

async fn stop(&mut self)

Stops a device’s asynchronous work.

async fn reset(&mut self)

Resets the device state to its initial state, for a fresh boot.

impl ChipsetDevice for Serial16550

fn supports_pio(&mut self) -> Option<&mut dyn PortIoIntercept>

Optionally returns a trait object to send IO port intercepts to.

fn supports_mmio(&mut self) -> Option<&mut dyn MmioIntercept>

Optionally returns a trait object to send MMIO port intercepts to.

fn supports_poll_device(&mut self) -> Option<&mut dyn PollDevice>

Optionally returns a trait object to send poll requests to.

fn supports_pci(&mut self) -> Option<&mut (dyn PciConfigSpace + 'static)>

Optionally returns a trait object to send PCI config space accesses to.

fn supports_line_interrupt_target( &mut self, ) -> Option<&mut dyn LineInterruptTarget>

Optionally returns a trait object to send interrupt line changes to.

fn supports_handle_eoi(&mut self) -> Option<&mut dyn HandleEoi>

Optionally returns a trait object to send EOI requests to.

fn supports_acknowledge_pic_interrupt( &mut self, ) -> Option<&mut dyn AcknowledgePicInterrupt>

Optionally returns a trait object with which to acknowledge PIC interrupts.

impl InspectMut for Serial16550

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

Inspects the object.

impl MmioIntercept for Serial16550

fn mmio_read(&mut self, addr: u64, data: &mut [u8]) -> IoResult

Dispatch an MMIO read to the device with the given address.

fn mmio_write(&mut self, addr: u64, data: &[u8]) -> IoResult

Dispatch an MMIO write to the device with the given address.

fn get_static_regions(&mut self) -> &[(&str, RangeInclusive<u64>)]

Report a set of static static mmio regions (region_name, gpa_range) that cannot be remapped at runtime and are always registered.

impl PollDevice for Serial16550

fn poll_device(&mut self, cx: &mut Context<'_>)

Poll the device for asynchronous work.

impl PortIoIntercept for Serial16550

fn io_read(&mut self, io_port: u16, data: &mut [u8]) -> IoResult

Dispatch an IO port read to the device with the given address.

fn io_write(&mut self, io_port: u16, data: &[u8]) -> IoResult

Dispatch an IO port write to the device with the given address.

fn get_static_regions(&mut self) -> &[(&str, RangeInclusive<u16>)]

Report a set of static io port regions (region_name, port_range) that cannot be remapped at runtime and are always registered.

impl SaveRestore for Serial16550

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, state: Self::SavedState) -> Result<(), RestoreError>

Restores the object’s state.