[PATCH] Move ACPI requirements to separate document and provide the link to it from the main platform spec.


Sunil V L
 

Signed-off-by: Sunil V L <sunilvl@...>
---
riscv-platform-spec.adoc | 76 +++-------------------------------------
1 file changed, 5 insertions(+), 71 deletions(-)

diff --git a/riscv-platform-spec.adoc b/riscv-platform-spec.adoc
index a24281f..514c913 100644
--- a/riscv-platform-spec.adoc
+++ b/riscv-platform-spec.adoc
@@ -103,6 +103,7 @@ The M platform has the following extensions:
|link:https://uefi.org/sites/default/files/resources/ACPI_Spec_6_4_Jan22.pdf[ACPI Specification] | v6.4
|link:https://uefi.org/specs/ACPI/6.4/18_ACPI_Platform_Error_Interfaces/ACPI_PLatform_Error_Interfaces.html[APEI Specification] | v6.4
|link:https://www.dmtf.org/sites/default/files/standards/documents/DSP0134_3.4.0.pdf[SMBIOS Specification] | v3.4.0
+|link:https://github.com/riscv/riscv-acpi/blob/master/riscv-acpi-platform-req.adoc[RISC-V ACPI Platform Requirements Specification] | v0.1
|link:[Platform Policy] | TBD
|===

@@ -500,7 +501,7 @@ protocols as specified in Chapter 14 of UEFI specification version 2.9.
====== UEFI configuration tables
The platforms are required to provide following tables.

-* *EFI_ACPI_20_TABLE_GUID* ACPI configuration table which is at version 6.4+ or
+* *EFI_ACPI_20_TABLE_GUID* ACPI configuration table which is at version 6.4 or
newer with HW-Reduced ACPI model.
* *SMBIOS3_TABLE_GUID* SMBIOS table which conforms to version 3.4 or later.

@@ -519,76 +520,9 @@ the base spec requirements.
===== Hardware Discovery Mechanisms

====== ACPI
-
-For RV64I server platforms, ACPI tables are required to be passed via UEFI
-to the operating system for the purpose of discovery and the configuration of
-the hardware. This section defines the required ACPI tables and objects. All
-other ACPI tables for RISC-V can be implemented as needed adhering to the ACPI
-spec version 6.4+(RISC-V support when added).
-
-In ACPI namespace, processors are required to be defined under the System Bus
-*(\_SB)* name space.
-
-The required ACPI System Description Tables, Device Objects and Methods are
-listed below.
-
-.Required ACPI System Description Tables
-[cols="3,2,2", width=95%, align="center", options="header"]
-|===
-|ACPI Table |ACPI Section|Note
-|Root System Description Pointer (RSDP) |5.2.5 |
-|Extended System Description Table (XSDT) |5.2.8 |
-|Fixed ACPI Description Table (FADT) |5.2.9 |
-|Differentiated System Description Table (DSDT)|5.2.11.1 |
-|Multiple APIC Description Table (MADT) |5.2.12 |
-|RISC-V Timer Description Table | |timebase-frequency
-|Processor Properties Topology Table (PPTT) |5.2.29 |CPU and Cache
- topology
- information
-|Memory-mapped Configuration space (MCFG) |See Links to ACPI-Related
- Documents (http://uefi.org/acpi)
- under the heading
- "PCI Sig” |Required for PCIe
- support
-|Debug Port Table 2 (DBG2) |See Links to ACPI-Related
- Documents (http://uefi.org/acpi)
- under the heading
- “Debug Port Table 2” |
-|Serial Port Console Redirection (SPCR) |See Links to ACPI-Related
- Documents (http://uefi.org/acpi)
- under the heading
- “Serial Port Console
- Redirection Table” |
-|System Resource Affinity Table (SRAT) |5.2.16 |Required if the
- platform supports
- NUMA
-|System Locality Information Table (SLIT) |5.2.17 |Required if the
- platform supports
- NUMA
-|IOMMU Information Table | |IOMMU table
- (like IVRS)
-|Software Delegated Exception Interface (SDEI) |See Links to ACPI-Related
- Documents (http://uefi.org/acpi)
- under the heading
- "Software Delegated Exceptions
- Interface” |
-|PMU event mapping table | |
-|===
-
-
-.Required Device Objects and Methods
-[cols="1,2,3", width=95%, align="center", options="header"]
-|===
-|Object/Method | ACPI Section | Note
-|_AEI | 5.6.5.2 | Required for GPIO-signalled events
-|_EVT | 5.6.5.3 | Required for interrupt-signalled events
-|_ADR | 6.1.1 | Required for PCI
-|_HID | 6.1.5 |
-|_UID | 6.1.12 |
-|_CRS | 6.2.2 |
-|_CCA | 6.2.17 | Required for DMA capable devices
-|_STA | 6.3.7/7.2.4 | Device status
-|===
+ACPI is the required mechanism for the hardware discovery and configuration.
+Server platforms are required to adhere to the
+*RISC-V ACPI Platform Requirements Specification*.

====== SMBIOS

--
2.32.0