chapter2: recommend psci node under firmware

Add a recommendation to locate the /psci node of the Devicetree under the /firmware node. Add a note (to OSes' intention) that legacy systems did not do so, but rather located it under the root node /. Reported-by: Jon Humphreys <[email protected]> Suggested-by: Rob Herring <[email protected]> Signed-off-by: Vincent Stehlé <[email protected]>
ARM-software · Oct 21, 2024 · a6b6f57 · a6b6f57
1 parent 035a2f2
commit a6b6f57
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst
@@ -383,6 +383,12 @@ take precedence. [#DTSchNote]_
      - This Property is required. It is necessary for console output.
        ([DTSPEC]_ § 3.6)
 
+When a ``/psci`` node is provided, it is recommended that it is located under
+the ``/firmware`` node. [#PSCINote]_
+
+.. [#PSCINote] Legacy systems also commonly located the ``/psci`` node under the
+   root node ``/``.
+
 The DTB must be contained in memory of type `EfiACPIReclaimMemory`.
 [#ACPIMemNote]_