diff options
author | Felix Held <felix-coreboot@felixheld.de> | 2023-08-21 19:02:52 +0200 |
---|---|---|
committer | Felix Held <felix-coreboot@felixheld.de> | 2023-08-22 18:19:07 +0000 |
commit | 048c2f2ac0d7712b74928cbdbba16f51c69f8c6d (patch) | |
tree | 1090f8f159e7f0a31cd4f6097a37e3e71429960e /Documentation | |
parent | eb08ae4ce13b6e6290fdfb31fbb87db440940a84 (diff) |
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')
-rw-r--r-- | Documentation/acpi/index.md | 3 | ||||
-rw-r--r-- | Documentation/acpi/windows.md | 9 |
2 files changed, 12 insertions, 0 deletions
diff --git a/Documentation/acpi/index.md b/Documentation/acpi/index.md index 0009837fcb..f9ae425760 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 0000000000..5745df8e8a --- /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. |