Crate morpheus_network

MorpheusX Network Stack

ASM-first bare-metal HTTP client for bootloader environments. Designed for post-ExitBootServices execution with no firmware dependencies.

Architecture (ASM-First)

┌─────────────────────────────────────────────────────────────┐
│                    HTTP Client                              │
│            NativeHttpClient (bare metal TCP/IP)             │
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────┐
│              NetInterface (smoltcp TCP/IP stack)            │
│  DHCP | TCP sockets | IP routing | ARP                      │
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────┐
│              NetworkDevice trait                            │
│  Abstraction over hardware: transmit, receive, mac_address │
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────┐
│              VirtioNetDriver (ASM-backed)                   │
│  Uses hand-written assembly for all hardware access         │
│  - MMIO with explicit barriers                              │
│  - Virtqueue descriptor ring management                     │
│  - Fire-and-forget TX, poll-based RX                        │
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────┐
│              ASM Layer (network/asm/)                       │
│  Core: TSC, barriers, MMIO, PIO, cache                      │
│  VirtIO: init, queue, TX, RX, notify                        │
└─────────────────────────────────────────────────────────────┘

Usage (Post-ExitBootServices)

use morpheus_network::{VirtioNetDriver, VirtioConfig, NetworkDriver};
use morpheus_network::boot::BootHandoff;
use morpheus_network::mainloop::bare_metal_main;

// After ExitBootServices, with BootHandoff from pre-EBS setup:
let result = unsafe { bare_metal_main(handoff, config) };

Re-exports

• pub use device::NetworkDevice;
• pub use error::NetworkError;
• pub use error::Result;
• pub use types::HttpMethod;
• pub use types::ProgressCallback;
• pub use client::HttpClient;
• pub use client::NativeHttpClient;
• pub use stack::debug_log;
• pub use stack::debug_log_available;
• pub use stack::debug_log_clear;
• pub use stack::debug_log_pop;
• pub use stack::DebugLogEntry;
• pub use stack::debug_stage;
• pub use stack::set_debug_stage;
• pub use stack::ecam_bases;
• pub use stack::DeviceAdapter;
• pub use stack::NetConfig;
• pub use stack::NetInterface;
• pub use stack::NetState;
• pub use driver::NetworkDriver as AsmNetworkDriver;
• pub use driver::VirtioConfig;
• pub use driver::VirtioNetDriver;
• pub use device::pci::pci_io_test;
• pub use device::pci::read_tsc;
• pub use device::pci::tsc_delay_us;

Modules

• alloc_heap
  Post-EBS Global Allocator
• asm
  ASM bindings module - Thin wrappers over standalone assembly functions.
• boot
  Boot integration module.
• client
  HTTP client implementation.
• device
  Network device abstraction for smoltcp integration.
• dma
  DMA buffer management module.
• driver
  Driver abstraction module.
• error
  Network error types
• http
  HTTP message handling
• mainloop
  Main loop module.
• pci
  PCI enumeration and capability access module.
• stack
  smoltcp integration layer.
• state
  State machine module.
• time
  Time and timing module.
• transfer
  Data transfer handling.
• types
  Shared data types module.
• url
  URL parsing and manipulation

Functions

• serial_byte
  Write a single byte to COM1 serial port (non-blocking with bounded wait)
• serial_stage
  Log debug stage to serial - format: [NET:XX] message
• serial_str
  Write a string to COM1 serial port
• serial_u32
  Write a u32 as decimal to serial