From b7343268b9a814f1f0d5325728cf0f159f850576 Mon Sep 17 00:00:00 2001 From: Andrei Warkentin Date: Mon, 8 Apr 2024 22:22:43 -0500 Subject: [PATCH] Resolve https://github.com/riscv-non-isa/riscv-brs/issues/35 Remove all usages of "platform", replacing with "system". Signed-off-by: Andrei Warkentin --- intro.adoc | 2 +- non-normative/acpi.adoc | 6 +++--- uefi.adoc | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/intro.adoc b/intro.adoc index d84ede6..e6cd204 100644 --- a/intro.adoc +++ b/intro.adoc @@ -63,6 +63,6 @@ Most terminology has the standard RISC-V meaning. This table captures other term | SBI | RISC-V Supervisor Binary Interface Specification cite:[SBI]. | SMBIOS | System Management BIOS cite:[SMBIOS]. | SoC | System on a chip, a combination of processor and supporting chipset logic in single package. -| System | A system is the entirety of a computing entity, including all elements in a platform (hardware, firmware) and software (hypervisor, operating system, user applications, user data). A system can be thought of both as a logical construct (e.g. a software stack) or physical construct (e.g. a notebook, a desktop, a server, a network switch, etc). +| System | A system is the entirety of a computing entity, including all hardware, firmware and software (hypervisor, operating system, user applications, user data). A system can be thought of both as a logical construct (e.g. a software stack) or physical construct (e.g. a notebook, a desktop, a server, a network switch, etc). | UEFI | Unified Extensible Firmware Interface Specification cite:[UEFI]. |=== diff --git a/non-normative/acpi.adoc b/non-normative/acpi.adoc index 7e7cc92..bf44aa7 100644 --- a/non-normative/acpi.adoc +++ b/non-normative/acpi.adoc @@ -58,9 +58,9 @@ information about certain capabilities like ISA string, cache and MMU info. |Memory-mapped Configuration space (MCFG) |cite:[PCIFW] |See <> and <> |Secondary System Description Table (SSDT) |5.2.11.2 |See <> and <>. |Serial Port Console Redirection (SPCR) |cite:[SPCR] |See <> and <> -|ACPI Table for TPM 2.0 (TPM2) |cite:[TcgAcpi]|If the platform supports TPM 2.0 -|System Resource Affinity Table (SRAT) |5.2.16 |If the platform supports NUMA -|System Locality Information Table (SLIT) |5.2.17 |If the platform supports NUMA +|ACPI Table for TPM 2.0 (TPM2) |cite:[TcgAcpi]|If the system supports TPM 2.0 +|System Resource Affinity Table (SRAT) |5.2.16 |If the system supports NUMA +|System Locality Information Table (SLIT) |5.2.17 |If the system supports NUMA |Boot Error Record Table (BERT) |18.3.1 |If APEI is supported |Error Injection Table (EINJ) |18.6.1 |If APEI is supported |Error Record Serialization Table (ERST) |18.5 |If APEI is supported diff --git a/uefi.adoc b/uefi.adoc index 3d8749d..5fbda80 100644 --- a/uefi.adoc +++ b/uefi.adoc @@ -80,9 +80,9 @@ See additional <>. !EfiResetShutdown ! 0x00000000 (Shutdown) !EfiResetCold ! 0x00000001 (Cold reboot) !EfiResetWarm ! 0x00000002 (Warm reboot) -!EfiResetPlatformSpecific ! 0xF0000000 - 0xFFFFFFFF (Vendor or platform specific reset type) +!EfiResetPlatformSpecific ! 0xF0000000 - 0xFFFFFFFF (Vendor or system-specific reset type) !=== -2+| _The OS MUST call the ResetSystem() runtime service call to reset or shutdown the system, preferring this to SBI SRST, ACPI or other platform-specific mechanisms. This allows for systems to perform any required platform tasks on the way out (e.g. servicing UpdateCapsule() or persisting non-volatile variables in some systems)._ +2+| _The OS MUST call the ResetSystem() runtime service call to reset or shutdown the system, preferring this to SBI SRST, ACPI or other system-specific mechanisms. This allows for systems to perform any required system tasks on the way out (e.g. servicing UpdateCapsule() or persisting non-volatile variables in some systems)._ | URT_040 | Non-volatile UEFI variables MUST persist across calls to the Reset System() runtime service call. | URT_050 | UEFI Runtime Services MUST be able to update the variables directly without the aid of an OS. | URT_060 a| The following requirements MUST be met for systems with UEFI Secure Boot: