Skip to content

Commit 383d53b

Browse files
fyin1wenlingz
authored andcommitted
doc: Update hv power management doc
Signed-off-by: Yin Fengwei <fengwei.yin@intel.com>
1 parent 4586acd commit 383d53b

File tree

2 files changed

+21
-21
lines changed

2 files changed

+21
-21
lines changed

doc/developer-guides/hld/hv-pm.rst

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -8,42 +8,42 @@ System PM module
88

99
The PM module in the hypervisor does three things:
1010

11-
- When all UOSes enter low power state, VM management will notify the SOS
12-
lifecycle service and trigger the SOS to enter a low-power state.
13-
SOS follows its own standard low-power state entry process and
14-
writes the ACPI control register to put SOS into low-power state.
15-
Hypervisor traps the ACPI control register writing and
16-
emulates SOS low-power state entry.
17-
18-
- Once SOS low-power emulation is done, Hypervisor handles its
11+
- Monitor all guests power state transition. And emulate low power
12+
state for the guests which are launched by HV directly.
13+
14+
- Once all guests enter low power state, Hypervisor handles its
1915
own low-power state transition
2016

2117
- Once system resumes from low-power mode, the hypervisor handles its
22-
own resume and emulates SOS resume too.
18+
own resume and emulates Service VM resume too.
2319

24-
It is assumed that SOS does not trigger any power state transition until
25-
the VM manager of ACRN notifies it that all UOSes are inactive and SOS
26-
offlines all its virtual APs.
20+
It is assumed that Service VM does not trigger any power state transition
21+
until the VM manager of ACRN notifies it that all User VMs are inactive
22+
and Service VM offlines all its virtual APs. And it is assumed that HV
23+
does not trigger its own power state transition until all guests are in
24+
low power state.
2725

28-
:numref:`pm-low-power-transition` shows the SOS/Hypervisor low-power
29-
state transition process. SOS triggers power state transition by
26+
:numref:`pm-low-power-transition` shows the Hypervisor entering S3
27+
state process. Service VM triggers power state transition by
3028
writing ACPI control register on its virtual BSP (which is pinned to the
3129
physical BSP). The hypervisor then does the following in sequence before
3230
it writes to the physical ACPI control register to trigger physical
3331
power state transition:
3432

35-
- Pauses SOS.
33+
- Pauses Service VM.
34+
- Wait all other guests enter low power state.
3635
- Offlines all physical APs.
37-
- Save the context of console, ioapic of SOS, I/O MMU, lapic of SOS,
38-
virtual BSP.
36+
- Save the context of console, ioapic of Service VM, I/O MMU, lapic of
37+
Service VM, virtual BSP.
3938
- Save the context of physical BSP.
4039

41-
When exiting from low-power mode, the hypervisor does similar steps in
42-
reverse order to restore contexts, start APs and resume SOS. SOS is
43-
responsible for starting its own virtual APs as well as UOSes.
40+
When exiting from S3 state, the hypervisor does similar steps in
41+
reverse order to restore contexts, start APs and resume all guests launched
42+
by hypervisor directly. Service VM is responsible for starting its own
43+
virtual APs as well as User VMs.
4444

4545
.. figure:: images/pm-image24-105.png
4646
:align: center
4747
:name: pm-low-power-transition
4848

49-
SOS/Hypervisor low power state transition process
49+
Service VM/Hypervisor S3 transition process
644 Bytes
Loading

0 commit comments

Comments
 (0)