Merge PRD rework from stable

2 files changed, 40 insertions, 0 deletions

diff --git a/doc/device-tree/ibm,opal/diagnostics.txt b/doc/device-tree/ibm,opal/diagnostics.txt
new file mode 100644
index 0000000..14da91c
--- /dev/null
+++ b/doc/device-tree/ibm,opal/diagnostics.txt
@@ -0,0 +1,10 @@
+
+ibm,opal/diagnostics device tree entries
+----------------------------------
+
+The diagnostics node under ibm,opal describes a userspace-to-firmware
+interface, supporting the runtime processor recovery diagnostics functions.
+
+The properties of a prd node are:
+
+ compatible = "ibm,opal-prd"
diff --git a/doc/device-tree/reserved-memory.txt b/doc/device-tree/reserved-memory.txt
new file mode 100644
index 0000000..ff0d6a4
--- /dev/null
+++ b/doc/device-tree/reserved-memory.txt
@@ -0,0 +1,30 @@
+reserved-memory device tree nodes
+
+OPAL exposes reserved memory through a top-level reserved-memory node,
+containing subnodes that represent each reserved memory region.
+
+This follows the Linux specification for the /reserved-memory node,
+described in the kernel source tree, in:
+
+  Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt
+
+The top-level /reserved-memory node contains:
+
+  #size-cells = <2>
+  #address-cells = <2>
+   - addresses and sizes are all 64-bits
+
+  ranges;
+   - the empty ranges node indicates no translation of physical
+     addresses in the subnodes.
+
+The sub-nodes under the /reserved-memory node contain:
+
+ reg = <address size>
+  - the address and size of the reserved memory region. The address
+    and size values are two cells each, as signified by the top-level
+    #{address,size}-cells
+
+ ibm,prd-label = "string"
+  - a string token for use by the prd system. Specific ranges may be
+    used by prd - those will be referenced by this label.