wire / wire-format / hpet
The HPET is a hardware timer with multiple comparators (3-32). Each comparator can generate interrupts. Registers: general capabilities (period, number of comparators, 64-bit counter), general configuration (enable, legacy replacement), main counter (64-bit, incrementing at a fixed frequency), timer N configuration (enable, periodic, level/edge, interrupt route, FSB delivery), timer N comparator (value to compare against main counter).
aka: HPET (High Precision Event Timer)
spec: HPET specification (Intel)
The HPET is a hardware timer with multiple comparators (3-32). Each comparator can generate interrupts. Registers: general capabilities (period, number of comparators, 64-bit counter), general configuration (enable, legacy replacement), main counter (64-bit, incrementing at a fixed frequency), timer N configuration (enable, periodic, level/edge, interrupt route, FSB delivery), timer N comparator (value to compare against main counter).
| field | size | meaning |
|---|---|---|
| General capabilities | 8 bytes | Period (femtoseconds per tick), number of comparators, 64-bit counter support, legacy replacement support. |
| General configuration | 8 bytes | Bit 0: enable (counter running). Bit 1: legacy replacement (route timer 0/1 to IRQ0/8). |
| Main counter | 8 bytes | 64-bit counter, increments by period each tick. Read-only (or writable for sync). |
| Timer N config | 8 bytes | Bit 0: enable. Bit 1: periodic mode. Bit 2: level/edge trigger. Bit 3: interrupt route (IRQ number). Bit 4: FSB delivery (MSI). Bits 8-13: size (32/64-bit). Bit 14: value set (for periodic). Bit 15: force 32-bit mode. |
| Timer N comparator | 8 bytes | Value to compare against main counter. On match, generates interrupt. For periodic: auto-reloads (adds period). |
| Timer N FSB route | 8 bytes | MSI address and data for FSB delivery (if enabled). |
example:
00 00 00 00 00 00 00 00
HPET (placeholder)
agent: curl -H 'accept: application/json' wire.phall.io/wire-format/hpet
or /wire-format/hpet.json