mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-05-16 12:19:42 +00:00
5fd6021dee
This patch adds more comment to describe functions that are interfaces to the other modules in the hypervisor. The comments are in doxygen-style for document generation. Tracked-On: #1595 Signed-off-by: Li, Fei1 <fei1.li@intel.com>
51 lines
1.3 KiB
ReStructuredText
51 lines
1.3 KiB
ReStructuredText
.. _timer-hld:
|
|
|
|
Timer
|
|
#####
|
|
|
|
Because ACRN is a flexible, lightweight reference hypervisor, we provide
|
|
limited timer management services:
|
|
|
|
- Only lapic tsc-deadline timer is supported as the clock source.
|
|
|
|
- A timer can only be added on the logical CPU for a process or thread. Timer
|
|
scheduling or timer migrating are not supported.
|
|
|
|
How it works
|
|
************
|
|
|
|
When the system boots, we check that the hardware supports lapic
|
|
tsc-deadline timer by checking CPUID.01H:ECX.TSC_Deadline[bit 24]. If
|
|
support is missing, we output an error message and panic the hypervisor.
|
|
If supported, we register the timer interrupt callback that raises a
|
|
timer softirq on each logical CPU and set the lapic timer mode to
|
|
tsc-deadline timer mode by writing the local APIC LVT register.
|
|
|
|
Data Structures and APIs
|
|
************************
|
|
|
|
Interfaces Design
|
|
=================
|
|
|
|
.. doxygenfunction:: initialize_timer
|
|
:project: Project ACRN
|
|
|
|
.. doxygenfunction:: timer_expired
|
|
:project: Project ACRN
|
|
|
|
.. doxygenfunction:: add_timer
|
|
:project: Project ACRN
|
|
|
|
.. doxygenfunction:: del_timer
|
|
:project: Project ACRN
|
|
|
|
.. doxygenfunction:: timer_init
|
|
:project: Project ACRN
|
|
|
|
.. doxygenfunction:: check_tsc
|
|
:project: Project ACRN
|
|
|
|
.. doxygenfunction:: calibrate_tsc
|
|
:project: Project ACRN
|
|
|