doc/device-tree/ibm,opal/dump.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

.. _device-tree/ibm,opal/dump:

Dump (MPIPL) Device Tree Binding
=================================

See :ref:`mpipl` for general MPIPL information.

dump node
---------
.. code-block:: dts

	dump {
                /*
                 * Memory used by OPAL to load kernel/initrd from PNOR
                 * (KERNEL_LOAD_BASE & INITRAMFS_LOAD_BASE). This is the
                 * temporary memory used by OPAL during boot. Later Linux
                 * kernel is free to use this memory. During MPIPL boot
                 * also OPAL will overwrite this memory.
                 *
                 * OPAL will advertise these memory details to kernel.
                 * If kernel is using these memory and needs these memory
                 * content for proper dump creation, then it has to reserve
                 * destination memory to preserve these memory ranges.
                 * Also kernel should pass this detail during registration.
                 * During MPIPL firmware will take care of preserving memory
                 * and post MPIPL kernel can create proper dump.
                 */
		fw-load-area = <0x0 0x20000000 0x0 0x8000000 0x0 0x28000000 0x0 0x8000000>;
                /* Compatible property */
		compatible = "ibm,opal-dump";
		phandle = <0x98>;
                /*
                 * This property indicates that its MPIPL boot. Kernel will use OPAL API
                 * to retrieve metadata tags and use metadata to create dump.
                 */
                mpipl-boot
	};