Obsolete guidance doc and reset to default RISC-V template

The ACPI guidance document which was hosted here was never frozen/ratified.
Instead, the relavant contents are created in BRS TG as non-normative
document [1]. So, reset this repo to default RVI template and remove
existing content so that it doesn't cause confusion with BRS TG's spec.

[1] - https://github.com/riscv-non-isa/riscv-brs/blob/main/non-normative/acpi.adoc



Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Fix and improve RIMT

I don't think having a field referring to a number of items should
include the complexity of the so called N-1 convention.

If the goal is to enforce these fields to never be 0, then let's write
it down in the specification so that different implementations can error
out if these fields hold a value of 0.

Signed-off-by: Sebastien Boeuf <seb@rivosinc.com>

The fields of the RIMT don't need to be specified with bullet points
given they're already part of a table.

Signed-off-by: Sebastien Boeuf <seb@rivosinc.com>

The byte offset was either wrong or not specified, which is fixed by
this change.

Signed-off-by: Sebastien Boeuf <seb@rivosinc.com>

Ran a spell checker to identify grammar issues.

Signed-off-by: Sebastien Boeuf <seb@rivosinc.com>

RIMT: Editorial updates

Signed-off-by: Ved Shanbhogue <ved@rivosinc.com>

Signed-off-by: vlsunil <sunilvl@ventanamicro.com>

Add RIMT for IOMMU mapping

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Guidance document with more details

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

readme: Fix the broken contributors.adoc link

This repo does not have a 'main' branch.

Signed-off-by: Bin Meng <bmeng.cn@gmail.com>

Add GitHub workflow for building PDFs

Signed-off-by: Stephano Cetola <scetola@linuxfoundation.org>

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Update to use new documentation template.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Delete UEFI spec

Since now we have hosted UEFI spec in separate repo, removing it
from here.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Add UEFI boot protocol required on UEFI systems.

Currently added in this repo since it is reuqired for ACPI
enablement. However, it can be hosted in some other repo or
in UEFI spec itself in future.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Update the tables with latest understanding and feedback

1) Rename REDT to RHCT since there may be some information
without an extension.
2) Rename files
3) Add the extension table description in the main acpi requirement
4) Extension grouping is still being defined by tech-config. Hence,
keeping a simple table with which PoC done as version_1. Moved the
proposed one to v2 since it needs major refinement after tech-config
freezes the schema.
5)AIA related information removed from extension table as per feedback
from Jessica.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Add RISC-V Timer Description Table (RTDT).

This table is required to communicate information regarding timer devices. Currently, only time_base_frequency is added. But in future revisions of this table, more information regarding timer device and watchdog device can be added to this table.

The plan is to maintain this table within RVI organization and provide a reference to it from the ACPI spec. A separate code-first proposal may be required to add the reference in ACPI spec.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Different RISC-V platforms can support different extensions. A new ACPI table is required to communicate this information to the OS.

This table will be maintained by the RVI and a reference will be added in ACPI spec. This table will be made mandatory in the RISC-V ACPI requirements document.

Any new extension should reserve its unique ID (16 bit) if ACPI support is required for the platform implementing the extension.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Update the README with link to instructions how to build and test the PoC changes.

ECR process defined by UEFI ASWG

Fix build with correct RISCV_ACPI_SPEC file name

The asciidoc file is riscv-acpi-platform-req.adoc. Fix the build
by using the correct file name.

Signed-off-by: Aaron Durbin <adurbin@rivosinc.com>

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>

Remove IOMMU and PMU related requirements. Will add if required
when there is more clarity.

Signed-off-by: Sunil V L <sunilvl@ventanamicro.com>