Struct VirtIOConsole 

pub struct VirtIOConsole<H: Hal, T: Transport> { /* private fields */ }

Driver for a VirtIO console device.

Only a single port is supported.

Example

use virtio_drivers::device::console::VirtIOConsole;
let mut console = VirtIOConsole::<HalImpl, _>::new(transport)?;

let size = console.size().unwrap().unwrap();
println!("VirtIO console {}x{}", size.rows, size.columns);

for &c in b"Hello console!\n" {
  console.send(c)?;
}

let c = console.recv(true)?;
println!("Read {:?} from console.", c);

Implementations

impl<H: Hal, T: Transport> VirtIOConsole<H, T>

pub fn new(transport: T) -> Result<Self>

Creates a new VirtIO console driver.

pub fn size(&self) -> Result<Option<Size>>

Returns the size of the console, if the device supports reporting this.

pub fn ack_interrupt(&mut self) -> Result<bool>

Acknowledges a pending interrupt, if any, and completes the outstanding finished read request if there is one.

Returns true if new data has been received.

pub fn recv(&mut self, pop: bool) -> Result<Option<u8>>

Returns the next available character from the console, if any.

If no data has been received this will not block but immediately return Ok<None>.

pub fn send(&mut self, chr: u8) -> Result<()>

Sends a character to the console.

pub fn send_bytes(&mut self, buffer: &[u8]) -> Result

Sends one or more bytes to the console.

pub fn emergency_write(&mut self, chr: u8) -> Result<()>

Sends a character to the console using the emergency write feature.

Returns an error if the device doesn’t support emergency write.

Trait Implementations

impl<H: Hal, T: Transport> Drop for VirtIOConsole<H, T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<H: Hal, T: Transport + Send> Send for VirtIOConsole<H, T>

where VirtQueue<H, QUEUE_SIZE>: Send,

impl<H: Hal, T: Transport + Sync> Sync for VirtIOConsole<H, T>

where VirtQueue<H, QUEUE_SIZE>: Sync,

impl<H: Hal, T: Transport> Write for VirtIOConsole<H, T>

fn write_str(&mut self, s: &str) -> Result

Writes a string slice into this writer, returning whether the write succeeded.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a [char] into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the [write!] macro with implementors of this trait.