mirror of
https://github.com/xen-project/xen.git
synced 2026-10-29 10:40:03 +01:00
Shannon Zhao
48f4bf6bde
Create a DT for Dom0 for ACPI-case only. DT contains minimal required information such as Dom0 bootargs, initrd, efi description table and address of uefi memory table. Also document this device tree bindings of "hypervisor" and "hypervisor/uefi" node. Signed-off-by: Naresh Bhat <naresh.bhat@linaro.org> Signed-off-by: Parth Dixit <parth.dixit@linaro.org> Signed-off-by: Shannon Zhao <shannon.zhao@linaro.org> Reviewed-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Acked-by: Julien Grall <julien.grall@arm.com>
61 lines
2.8 KiB
Plaintext
61 lines
2.8 KiB
Plaintext
* Xen hypervisor device tree bindings
|
|
|
|
Xen ARM virtual platforms shall have a top-level "hypervisor" node with
|
|
the following properties:
|
|
|
|
- compatible:
|
|
compatible = "xen,xen-<version>", "xen,xen";
|
|
where <version> is the version of the Xen ABI of the platform.
|
|
|
|
- reg: specifies the base physical address and size of a region in
|
|
memory where the grant table should be mapped to, using an
|
|
HYPERVISOR_memory_op hypercall. The memory region is large enough to map
|
|
the whole grant table (it is larger or equal to gnttab_max_grant_frames()).
|
|
This property is unnecessary when booting Dom0 using ACPI.
|
|
|
|
- interrupts: the interrupt used by Xen to inject event notifications.
|
|
A GIC node is also required.
|
|
This property is unnecessary when booting Dom0 using ACPI.
|
|
|
|
To support UEFI on Xen ARM virtual platforms, Xen populates the FDT "uefi" node
|
|
under /hypervisor with following parameters:
|
|
|
|
________________________________________________________________________________
|
|
Name | Size | Description
|
|
================================================================================
|
|
xen,uefi-system-table | 64-bit | Guest physical address of the UEFI System
|
|
| | Table.
|
|
--------------------------------------------------------------------------------
|
|
xen,uefi-mmap-start | 64-bit | Guest physical address of the UEFI memory
|
|
| | map.
|
|
--------------------------------------------------------------------------------
|
|
xen,uefi-mmap-size | 32-bit | Size in bytes of the UEFI memory map
|
|
| | pointed to in previous entry.
|
|
--------------------------------------------------------------------------------
|
|
xen,uefi-mmap-desc-size | 32-bit | Size in bytes of each entry in the UEFI
|
|
| | memory map.
|
|
--------------------------------------------------------------------------------
|
|
xen,uefi-mmap-desc-ver | 32-bit | Version of the mmap descriptor format.
|
|
--------------------------------------------------------------------------------
|
|
|
|
Example (assuming #address-cells = <2> and #size-cells = <2>):
|
|
|
|
hypervisor {
|
|
compatible = "xen,xen-4.3", "xen,xen";
|
|
reg = <0 0xb0000000 0 0x20000>;
|
|
interrupts = <1 15 0xf08>;
|
|
uefi {
|
|
xen,uefi-system-table = <0xXXXXXXXX>;
|
|
xen,uefi-mmap-start = <0xXXXXXXXX>;
|
|
xen,uefi-mmap-size = <0xXXXXXXXX>;
|
|
xen,uefi-mmap-desc-size = <0xXXXXXXXX>;
|
|
xen,uefi-mmap-desc-ver = <0xXXXXXXXX>;
|
|
};
|
|
};
|
|
|
|
The format and meaning of the "xen,uefi-*" parameters are similar to those in
|
|
Documentation/arm/uefi.txt in Linux, which are provided by the regular Linux
|
|
UEFI stub. However they differ because they are provided by the Xen hypervisor,
|
|
together with a set of UEFI runtime services implemented via hypercalls, see
|
|
xen/include/public/platform.h.
|