Struct VirtIONet

pub struct VirtIONet<H: Hal, T: Transport, const QUEUE_SIZE: usize> { /* private fields */ }

Driver for a VirtIO network device.

Unlike VirtIONetRaw, it uses RxBuffers for transmission and reception rather than the raw slices. On initialization, it pre-allocates all receive buffers and puts them all in the receive queue.

The virtio network device is a virtual ethernet card.

It has enhanced rapidly and demonstrates clearly how support for new features are added to an existing device. Empty buffers are placed in one virtqueue for receiving packets, and outgoing packets are enqueued into another for transmission in that order. A third command queue is used to control advanced filtering features.

Implementations

impl<H: Hal, T: Transport, const QUEUE_SIZE: usize> VirtIONet<H, T, QUEUE_SIZE>

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

Create a new VirtIO-Net driver.

pub fn ack_interrupt(&mut self) -> bool

Acknowledge interrupt.

pub fn disable_interrupts(&mut self)

Disable interrupts.

pub fn enable_interrupts(&mut self)

Enable interrupts.

pub fn mac_address(&self) -> [u8; 6]

Get MAC address.

pub fn can_send(&self) -> bool

Whether can send packet.

pub fn can_recv(&self) -> bool

Whether can receive packet.

pub fn receive(&mut self) -> Result<RxBuffer>

Receives a RxBuffer from network. If currently no data, returns an error with type Error::NotReady.

It will try to pop a buffer that completed data reception in the NIC queue.

pub fn recycle_rx_buffer(&mut self, rx_buf: RxBuffer) -> Result

Gives back the ownership of rx_buf, and recycles it for next use.

It will add the buffer back to the NIC queue.

pub fn new_tx_buffer(&self, buf_len: usize) -> TxBuffer

Allocate a new buffer for transmitting.

pub fn send(&mut self, tx_buf: TxBuffer) -> Result

Sends a TxBuffer to the network, and blocks until the request completed.