HPET: Difference between revisions

← Older edit

HPET (view source)

Revision as of 05:23, 9 June 2024

91 bytes added , 29 days ago

m

Bot: Replace deprecated source tag with syntaxhighlight

[unchecked revision]

VisualWikitext

Xtex

Interface administrators, Administrators

972

edits

Revision as of 13:31, 24 November 2013 (view source) osdev>Griwes (finished (I hope)) ← Older edit		Latest revision as of 05:23, 9 June 2024 (view source) Xtex (talk \| contribs) m (Bot: Replace deprecated source tag with syntaxhighlight)
(14 intermediate revisions by 8 users not shown)
Line 1: ~~{{In Progress}}~~ :''This page is not meant as a full description of HPET, only as a lightweight introduction. If you need any information not covered by this article, consult the [http://www.intel.com/content/dam/www/public/us/en/documents/technical-specifications/software-developers-hpet-spec-1-0a.pdf HPET specification].'' '''HPET''', or High Precision Event Timer, is a piece of hardware designed by Intel and Microsoft to replace older [[PIT]] and [[RTC]]. It consists of (usually 64-bit) main counter (which counts up), as well as from 3 to 32 32-bit or 64 -bit wide comparators. HPET is programmed using memory mapped IO, and the base address of HPET can be found using [[ACPI]].▼ ~~==Preface==~~ ▲HPET, or High Precision Event Timer, is a piece of hardware designed by Intel and Microsoft to replace older [[PIT]] and [[RTC]]. It consists of (usually 64-bit) main counter (which counts up), as well as from 3 to 32 32 or 64 bit wide comparators. HPET is programmed using memory mapped IO, and the base address of HPET can be found using [[ACPI]]. ==Detecting HPET using ACPI== The [http://www.intel.com/content/dam/www/public/us/en/documents/technical-specifications/software-developers-hpet-spec-1-0a.pdf HPET specification] defines an ACPI 2.0 table that is to be used to detect presence, address and capabilities of HPET present in the system. If this table doesn't exist, you should assume there is no HPET and you should fall back to [[PIT]] or the [[APIC timer]]. <~~source~~syntaxhighlight lang="cpp"> struct address_structure { { uint8_t address_space_id; // 0 - system memory, 1 - system I/O uint8_t register_bit_width; uint8_t register_bit_offset; uint8_t reserved; uint64_t address; } __attribute__((packed)); struct description_table_header { { char signature[4]; // 'HPET' in case of HPET table uint32_t length; uint8_t revision; uint8_t checksum; char oemid[6]; uint64_t oem_tableid; uint32_t oem_revision; uint32_t creator_id; uint32_t creator_revision; } __attribute__((packed)); struct hpet : public description_table_header { { uint8_t hardware_rev_id; uint8_t comparator_count:5; uint8_t counter_size:1; uint8_t reserved:1; uint8_t legacy_replacement:1; ~~pci_vendor_t~~uint16_t pci_vendor_id; address_structure address; uint8_t hpet_number; uint16_t minimum_tick; uint8_t page_protection; } __attribute__((packed)); </syntaxhighlight> ~~</source>~~ ==HPET - timer vs comparators== Line 103 ⟶ 99: ===FSB mapping=== This mapping is almost identical to PCI's Message Signaled Interrupts. The "Timer N FSB Interrupt Route Register" which defines how FSB interrupts are configured can be found in the specification. FSB interrupts are enabled using "Tn_FSB_EN_CNF" field in timer's configuration register. This mapping mode will not be further discussed in this article. ==HPET registers== Line 114 ⟶ 110: !Type \|- \|0x000 - ~~000x7~~0x007 \|General Capabilities and ID Register \|Read only Line 152 ⟶ 148: \|63:32 \|COUNTER_CLK_PERIOD \|Main counter tick period in ~~femptoseconds~~femtoseconds (10^-15 seconds). Must not be zero, must be less or equal to 0x05F5E100, or 100 nanoseconds. \|- \|31-16 Line 301 ⟶ 297: General initialization: 1. Find HPET base address in 'HPET' ACPI table. 2. Calculate HPET frequency (f = 10^15 / period). 3. Save minimal tick (either from ACPI table or configuration register). 4. Initialize comparators. 5. Set ENABLE_CNF bit. Timer N initialization: 1. Determine if timer N is periodic capable, save that information to avoid re-reading it every time. 2. Determine allowed interrupt routing for current timer and allocate an interrupt for it. Line 321 ⟶ 324: To enable one-shot mode: <~~source~~syntaxhighlight lang="cpp"> // "time" is time in ~~femptoseconds~~femtoseconds from now to interrupt if (time < COUNTER_CLK_PERIOD) { Line 330 ⟶ 333: write_register_64(timer_configuration(n), (ioapic_input << 9) \| (1 << 2)); write_register_64(timer_comparator(n), read_register(main_counter) + time); </syntaxhighlight> ~~</source>~~ I hope the above code is obvious. If it's not, please analyze the meaning of specific fields in registers used above. Line 338 ⟶ 341: To enable periodic mode: <~~source~~syntaxhighlight lang="cpp"> // "time" is time in ~~femptoseconds~~femtoseconds from now to interrupt if (time < COUNTER_CLK_PERIOD) { Line 348 ⟶ 351: write_register_64(timer_comparator(n), read_register(main_counter) + time); write_register_64(timer_comparator(n), time); </syntaxhighlight> ~~</source>~~ This snippet requires some more comments. Line 362 ⟶ 365: ==See also== * [[IOAPIC]] * [[APIC]] * [[APIC timer]] * [[PIT]] * [[RTC]] ==External links== * [http://en.wikipedia.org/wiki/High_Precision_Event_Timer HPET article on Wikipedia] * [http://www.intel.com/content/dam/www/public/us/en/documents/technical-specifications/software-developers-hpet-spec-1-0a.pdf Intel's HPET Specification v1.0a] [[Category:Common Devices]] [[Category:Interrupts]] [[Category:Timers]]