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

# CPU Topology

Detects the physical layout of the CPU: sockets, cores, threads, and their relationships.

## Structures

```rust
pub struct Topology {
    pub physical_cores: u8,
    pub logical_cores: u8,
    pub sockets: u8,
    pub threads_per_core: u8,
}
```

## Detection

```rust
pub fn detect() -> Topology
```

On x86_64, uses CPUID leaves:
- Leaf 1: basic feature flags, hyperthreading bit
- Leaf 4: deterministic cache parameters (core count per package)
- Leaf 0x0B: extended topology enumeration (sub-leaf 0 = SMT, sub-leaf 1 = core)
- Leaf 0x1F: v2 topology (if leaf 0x0B unavailable)

On aarch64, topology is typically provided by the DeviceTree or ACPI MADT table.

## Multi-socket detection

The crate detects multi-socket systems by examining:
1. APIC ID ranges (x86_64)
2. ACPI MADT processor entries

## Relationship to cpu::cores

`cpu::topology::detect()` provides the aggregate view (counts), while `cpu::cores::detect_cores()` provides per-core detail (frequency, temperature).