summaryrefslogtreecommitdiffstats
path: root/Documentation/acpi
diff options
context:
space:
mode:
authorFelix Held <felix-coreboot@felixheld.de>2023-08-21 19:02:52 +0200
committerFelix Held <felix-coreboot@felixheld.de>2023-08-22 18:19:07 +0000
commit048c2f2ac0d7712b74928cbdbba16f51c69f8c6d (patch)
tree1090f8f159e7f0a31cd4f6097a37e3e71429960e /Documentation/acpi
parenteb08ae4ce13b6e6290fdfb31fbb87db440940a84 (diff)
downloadcoreboot-048c2f2ac0d7712b74928cbdbba16f51c69f8c6d.tar.gz
coreboot-048c2f2ac0d7712b74928cbdbba16f51c69f8c6d.tar.bz2
coreboot-048c2f2ac0d7712b74928cbdbba16f51c69f8c6d.zip
Documentation/acpi: add Windows-specific documentation
When using the Windows fast startup mechanism which is enabled by default, Windows will use a cached version of the ACPI tables during normal boots after a clean shutdown. Since I've run into this issue and spent quite a bit of time debugging the wrong issue due to this, better document this possibly unexpected behavior. Signed-off-by: Felix Held <felix-coreboot@felixheld.de> Change-Id: Ia9e65f6a3aff13fa54abe68c8f5fcbf9bc6efc1a Reviewed-on: https://review.coreboot.org/c/coreboot/+/77354 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Nico Huber <nico.h@gmx.de> Reviewed-by: Paul Menzel <paulepanter@mailbox.org> Reviewed-by: Matt DeVillier <matt.devillier@gmail.com>
Diffstat (limited to 'Documentation/acpi')
-rw-r--r--Documentation/acpi/index.md3
-rw-r--r--Documentation/acpi/windows.md9
2 files changed, 12 insertions, 0 deletions
diff --git a/Documentation/acpi/index.md b/Documentation/acpi/index.md
index 0009837fcbcb..f9ae42576026 100644
--- a/Documentation/acpi/index.md
+++ b/Documentation/acpi/index.md
@@ -11,6 +11,9 @@ upwards.
- [GPIO toggling in ACPI AML](gpio.md)
+## Windows-specific ACPI documentation
+
+- [Windows-specific documentation](windows.md)
## ACPI specification - Useful links
diff --git a/Documentation/acpi/windows.md b/Documentation/acpi/windows.md
new file mode 100644
index 000000000000..5745df8e8a64
--- /dev/null
+++ b/Documentation/acpi/windows.md
@@ -0,0 +1,9 @@
+# Testing ACPI changes under Windows
+
+When testing ACPI changes in coreboot against Windows 8 or newer, beware that
+during a normal boot after a clean shutdown, Windows will use the fast startup
+mechanism which results in it not evaluating the changed ACPI code but instead
+using some cached version which won't include the changes that were supposed to
+be tested. In order for Windows to actually use the new ACPI tables, either
+disable the fast startup or just tell Windows to do a reboot which will make it
+read and use the ACPI tables in memory instead of an outdated cached version.