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

# Topology Module

The `topology` module detects and models the system's physical topology: sockets, cores, interconnects, and NUMA nodes.

## Submodules

| File | Description |
|------|-------------|
| `detection.rs` | `Topology` struct and `detect_topology()` |
| `node.rs` | NUMA/topology node representation |
| `interconnect.rs` | Inter-node interconnect modeling |
| `system.rs` | System-wide topology view |

## Topology

```
Topology {
    sockets: u8              — number of physical CPU sockets
    cores_per_socket: u8     — cores per socket
}
```

## Detection

`detect_topology() -> Topology`

On x86_64, uses CPUID:
- Leaf `0x0B` (Extended Topology) for core/thread counts
- Leaf `0x04` (Deterministic Cache) for shared cache levels
- Leaf `0x01` for legacy core count

On AArch64, reads MPIDR_EL1 for affinity levels (cluster/core/thread).

## Re-exports

```rust
pub use detection::{detect_topology, Topology};
```

## Integration

- `cpu::topology` provides lower-level per-CPU topology info
- This module provides the system-wide view
- Used by the NUMA subsystem to map cores to memory nodes
- Used by the scheduler for load balancing decisions