README.md

E1000 Driver

E1000 driver in Rust for the Intel 82540EP/EM and 82574L Gigabit Ethernet.

Support features

• e1000 and e1000e driver for RISCV and x86_64 on Qemu is supported
• Initialize simple PCI-Express for e1000 device
• Implement the e1000 driver as a linux driver module

• Todo: networking protocol support: IP, ARP, UDP

Quick start on bare metal OS

Initialize PCI and E1000 driver

pub struct Kernfn;
impl e1000_driver::e1000::KernelFunc for Kernfn { ... }

e1000_driver::pci::pci_init();

let mut e1000_device = e1000_driver::e1000::E1000Device::<Kernfn>::new(e1000_driver::pci::E1000_REGS as usize).unwrap();

Sending network packets

e1000_device.e1000_transmit(&frame);

Receiving network packets

let rx_buf = e1000_device.e1000_recv();

Rust e1000 driver for Linux kernel module

cd src/linux
make ARCH=<cpu arch> KDIR=<path to linux>
# e.g. make ARCH=x86_64 KDIR=/home/rust/linux/build

Reference

• Linux source code
• xv6: Implementation of net
• MIT 6.828/2019/networking
• Intel Gigabit Ethernet 82540EP/EM
• OSDev: Intel 8254x
• Rust for Linux
• Kernel threads: Rust e1000 driver (Intel Ethernet adapter)