1 * Xen hypervisor device tree bindings 1 * Xen hypervisor device tree bindings
2 2
3 Xen ARM virtual platforms shall have a top-lev 3 Xen ARM virtual platforms shall have a top-level "hypervisor" node with
4 the following properties: 4 the following properties:
5 5
6 - compatible: 6 - compatible:
7 compatible = "xen,xen-<version>", "xen 7 compatible = "xen,xen-<version>", "xen,xen";
8 where <version> is the version of the Xen AB 8 where <version> is the version of the Xen ABI of the platform.
9 9
10 - reg: specifies the base physical address and !! 10 - reg: specifies the base physical address and size of a region in
11 where the special resources should be mapped !! 11 memory where the grant table should be mapped to, using an
12 hypercall. !! 12 HYPERVISOR_memory_op hypercall. The memory region is large enough to map
13 Region 0 is reserved for mapping grant table !! 13 the whole grant table (it is larger or equal to gnttab_max_grant_frames()).
14 The memory region is large enough to map the <<
15 or equal to gnttab_max_grant_frames()). <<
16 Regions 1...N are extended regions (unused a <<
17 GFNs and grants, they might be absent if the <<
18 14
19 - interrupts: the interrupt used by Xen to inj 15 - interrupts: the interrupt used by Xen to inject event notifications.
20 A GIC node is also required. 16 A GIC node is also required.
21 17
22 To support UEFI on Xen ARM virtual platforms, <<
23 under /hypervisor with following parameters: <<
24 <<
25 ______________________________________________ <<
26 Name | Size | Descripti <<
27 ============================================== <<
28 xen,uefi-system-table | 64-bit | Guest phy <<
29 | | Table. <<
30 ---------------------------------------------- <<
31 xen,uefi-mmap-start | 64-bit | Guest phy <<
32 | | map. <<
33 ---------------------------------------------- <<
34 xen,uefi-mmap-size | 32-bit | Size in b <<
35 | | pointed t <<
36 ---------------------------------------------- <<
37 xen,uefi-mmap-desc-size | 32-bit | Size in b <<
38 | | memory ma <<
39 ---------------------------------------------- <<
40 xen,uefi-mmap-desc-ver | 32-bit | Version o <<
41 ---------------------------------------------- <<
42 18
43 Example (assuming #address-cells = <2> and #si 19 Example (assuming #address-cells = <2> and #size-cells = <2>):
44 20
45 hypervisor { 21 hypervisor {
46 compatible = "xen,xen-4.3", "xen,xen"; 22 compatible = "xen,xen-4.3", "xen,xen";
47 reg = <0 0xb0000000 0 0x20000>; 23 reg = <0 0xb0000000 0 0x20000>;
48 interrupts = <1 15 0xf08>; 24 interrupts = <1 15 0xf08>;
49 uefi { <<
50 xen,uefi-system-table = <0xXXX <<
51 xen,uefi-mmap-start = <0xXXXXX <<
52 xen,uefi-mmap-size = <0xXXXXXX <<
53 xen,uefi-mmap-desc-size = <0xX <<
54 xen,uefi-mmap-desc-ver = <0xXX <<
55 }; <<
56 }; 25 };
57 <<
58 The format and meaning of the "xen,uefi-*" par <<
59 Documentation/arch/arm/uefi.rst, which are pro <<
60 they differ because they are provided by the X <<
61 of UEFI runtime services implemented via hyper <<
62 http://xenbits.xen.org/docs/unstable/hypercall <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.