Module stack

smoltcp integration layer.

This module provides the bridge between MorpheusX network device drivers and the smoltcp TCP/IP stack.

Components

• DeviceAdapter - Adapts NetworkDevice to smoltcp’s Device trait
• NetInterface - Full IP stack with TCP sockets and DHCP

Usage

use morpheus_network::stack::{NetInterface, NetConfig};
use morpheus_network::device::virtio::VirtioNetDevice;
use morpheus_network::device::hal::StaticHal;
use dma_pool::DmaPool;

// Initialize DMA pool from caves in our PE image
unsafe { DmaPool::init_from_caves(image_base, image_end) };

// Initialize HAL
StaticHal::init();

// Create device
let device = VirtioNetDevice::<StaticHal, _>::new(transport)?;

// Create interface with DHCP
let mut iface = NetInterface::new(device, NetConfig::dhcp());

// Poll until IP configured
while !iface.has_ip() {
    iface.poll(get_time_ms());
}

Re-exports

• pub use crate::device::pci::ecam_bases;

Modules

• interface 🔒
  Full smoltcp network interface with TCP/IP stack.

Structs

• AdapterRxToken
• AdapterTxToken
• DebugLogEntry
  A single debug log entry
• DebugRing 🔒
  Ring buffer for debug logs
• DeviceAdapter
  Thin adapter that exposes a NetworkDevice to smoltcp.
• NetInterface
  Full network interface with IP stack.
• PacketCounterRing 🔒
  Ring buffer for packet statistics - tracks recent activity without overflow

Enums

• NetConfig
  Network interface configuration.
• NetState
  Network interface state.

Constants

• DEBUG_MSG_LEN 🔒
  Maximum length of a single debug message
• DEBUG_RING_SIZE 🔒
  Number of messages in the ring buffer
• MAX_TCP_SOCKETS
  Maximum number of concurrent TCP sockets.
• MTU 🔒
• PACKET_COUNTER_SIZE 🔒
  Ring buffer size for packet counters (must be power of 2 for efficient masking)

Statics

• DEBUG_INIT_STAGE 🔒
• DEBUG_RING 🔒
• DEBUG_RING_LOCK 🔒
• DHCP_DISCOVER_COUNTER 🔒
• RX_PACKET_COUNTER 🔒
• TX_ERROR_COUNTER 🔒
• TX_PACKET_COUNTER 🔒

Functions

• debug_log
  Push a debug message to the ring buffer (AND write to serial)
• debug_log_available
  Check if there are pending debug messages
• debug_log_clear
  Clear all debug messages
• debug_log_pop
  Pop the next debug message from the ring buffer (FIFO order) Returns None if buffer is empty
• debug_stage
  Get current debug init stage.
• dhcp_discover_count
  Get the number of DHCP discover packets sent.
• rx_packet_count
  Get the number of packets received.
• set_debug_stage
  Set debug init stage and log it
• tx_error_count
  Get the number of TX errors that have occurred.
• tx_packet_count
  Get the number of packets transmitted.