wire / wire-format / hpet

HPET (High Precision Event Timer)

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).

wire-format kind wire-format status standard verification verified tier B wire-format@1

aka: HPET (High Precision Event Timer)

wire format

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).

fieldsizemeaning
General capabilities8 bytesPeriod (femtoseconds per tick), number of comparators, 64-bit counter support, legacy replacement support.
General configuration8 bytesBit 0: enable (counter running). Bit 1: legacy replacement (route timer 0/1 to IRQ0/8).
Main counter8 bytes64-bit counter, increments by period each tick. Read-only (or writable for sync).
Timer N config8 bytesBit 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 comparator8 bytesValue to compare against main counter. On match, generates interrupt. For periodic: auto-reloads (adds period).
Timer N FSB route8 bytesMSI address and data for FSB delivery (if enabled).

example:

00 00 00 00 00 00 00 00

HPET (placeholder)


provenance

agent: curl -H 'accept: application/json' wire.phall.io/wire-format/hpet or /wire-format/hpet.json