hardware 0.0.9

A no_std bare-metal hardware abstraction layer — all port I/O, memory and swap allocations are guarded at runtime. Do not consider this dependency stable before x.1.x
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# Net Module

The `net` module provides basic network protocol structures for Ethernet, IPv4, and TCP.

## Submodules

| File | Description |
|------|-------------|
| `ethernet.rs` | Ethernet frame parsing and `EtherType` enum |
| `ipv4.rs` | IPv4 packet structures |
| `tcp.rs` | TCP segment structures |

## EtherType

```rust
pub enum EtherType {
    Ipv4    = 0x0800,
    Arp     = 0x0806,
    Ipv6    = 0x86DD,
    Vlan    = 0x8100,
    Unknown = 0xFFFF,
}
```

`EtherType::from_u16(v)` converts a raw 16-bit value to the enum.

## EthernetFrame

```
EthernetFrame {
    dst: [u8; 6]            — destination MAC address
    src: [u8; 6]            — source MAC address
    ether_type: EtherType   — protocol type
    payload_len: usize      — payload length in bytes
}
```

`EthernetFrame::parse(data: &[u8]) -> Option<Self>`

Parses a raw byte slice into an Ethernet frame. Returns `None` if the data is too short (< 14 bytes).

## Scope

The net module provides protocol data structures only. It does not implement:
- Network interface drivers (handled by device drivers)
- IP routing or ARP resolution
- Socket API
- Full TCP state machine

These structures are used for packet inspection and basic protocol handling in conjunction with NIC device drivers.