On 2015年01月23日 00:45, Al Stone wrote:
On 01/21/2015 09:21 PM, Hanjun Guo wrote:
Hi Al,
some comments below.
On 2015年01月22日 08:18, al.stone@linaro.org wrote:
From: Al Stone al.stone@linaro.org
While Hanjun cleaned up most of the commentary on the arm-acpi.txt file, this patch goes several steps further. The biggest change to the existing documentation was to add a section describing why ACPI is wanted, and to do a lot of editing for continuity, and hopefully clarity.
Two documentation files are also being added: (1) A verbatim copy of the "Why ACPI on ARM?" blog posting by Grant Likely, which is also summarized in arm-acpi.txt, and
(2) A section by section review of the ACPI spec (acpi_object_usage.txt) to note recommendations and prohibitions on the use of the numerous ACPI tables and objects. This sets out the current expectations of the firmware by Linux very explicitly (or as explicitly as I can, for now).
Signed-off-by: Al Stone al.stone@linaro.org
Documentation/arm64/acpi_object_usage.txt | 557 ++++++++++++++++++++++++++++++ Documentation/arm64/arm-acpi.txt | 323 +++++++++++++---- Documentation/arm64/why_use_acpi.txt | 228 ++++++++++++ 3 files changed, 1044 insertions(+), 64 deletions(-) create mode 100644 Documentation/arm64/acpi_object_usage.txt create mode 100644 Documentation/arm64/why_use_acpi.txt
diff --git a/Documentation/arm64/acpi_object_usage.txt b/Documentation/arm64/acpi_object_usage.txt new file mode 100644 index 0000000..3fbc25d --- /dev/null +++ b/Documentation/arm64/acpi_object_usage.txt @@ -0,0 +1,557 @@ +ACPI Tables +----------- +The expectations of individual ACPI tables are discussed in the list that +follows.
+If a section number is used, it refers to a section number in the ACPI +specification where the object is defined. If "Signature Reserved" is used, +the table signature (the first four bytes of the table) is the only portion +of the table recognized by the specification, and the actual table is defined +outside of the UEFI Forum (see Section 5.2.6 of the specification).
+Table Usage for ARMv8 Linux
Can we put them in classification like below?
Required for ACPI on ARM64:
- FADT...
- MADT...
Optional
- SLIT
- SRAT
Not required
- ...
I thought about that, but then decided the alphabetical approach would make it easier to find a specific table.
How about a second list? That is, keep the alphabetical list, but then just add a short table like above?
pretty fine to me :)
Thanks Hanjun