Add submodule dependency filesHEADmaster

Change-Id: Iaf8d18082d3991dec7c0ebbea540f092188eb4ec

1 files changed, 44 insertions, 0 deletions

diff --git a/roms/skiboot/doc/device-tree/ibm,opal/firmware.rst b/roms/skiboot/doc/device-tree/ibm,opal/firmware.rst
new file mode 100644
index 000000000..5e76199ec
--- /dev/null
+++ b/roms/skiboot/doc/device-tree/ibm,opal/firmware.rst
@@ -0,0 +1,44 @@
+System Firmware
+===============
+
+The 'firmware' node under 'ibm,opal' lists system and OPAL firmware version.
+
+.. code-block:: dts
+
+  firmware {
+	symbol-map = <0x0 0x300ac650 0x0 0x1b3f5>;
+	compatible = "ibm,opal-firmware";
+	ml-version = [4d 4c 20 46 57 37 37 30 2e 32 30 20 46 57 37 37 30 2e 32 30 20 46 57 37 37 30 2e 32 30];
+	mi-version = <0x4d49205a 0x4c373730 0x5f303735 0x205a4c37 0x37305f30 0x3735205a 0x4c373730 0x5f303735>;
+	version = "skiboot-5.0-rc2";
+	phandle = <0x8e>;
+	linux,phandle = <0x8e>;
+  };
+
+``compatible``
+  property describes OPAL compatibility.
+
+``symbol-map``
+  property describes OPAL symbol start address and size.
+
+``version``
+  property describes OPAL version. It replaced a property named 'git-id' early
+  in the POWER8 lifecycle, so may not always be present. It will be absent on
+  IBM FSP based systems running firmware prior to FW840. The 'version' property
+  is present on all GA POWER8 BMC systems.
+
+  On POWER9 and above, it is always present.
+
+``mi-version``
+  property describes Microcode Image. Only on IBM FSP systems.
+  Will (likely) not be present on POWER9 systems.
+
+``ml-version``
+  property describes Microcode Level. Only on IBM FSP systems.
+  Will (likely) not be present on POWER9 systems.
+
+MI/ML format
+------------
+::
+
+   <ML/MI> <T side version> <P side version> <boot side version>