Home Explore Help
Sign In
phreedom2600net
/
linux-libre
Watch 2
Star 0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Branch: master
Branches Tags
linux-libre
/
Documentation
/
devicetree
/
bindings
/
arm
/
xen.txt

xen.txt 2.8 KB
Permalink History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061 
  1. * Xen hypervisor device tree bindings
    2. 

  2. 

  3. Xen ARM virtual platforms shall have a top-level "hypervisor" node with
    4. 

  4. the following properties:
    5. 

  5. 

  6. - compatible:
    7. 

  7. 	compatible = "xen,xen-<version>", "xen,xen";
    8. 

  8.   where <version> is the version of the Xen ABI of the platform.
    9. 

  9. 

  10. - reg: specifies the base physical address and size of a region in
    11. 

  11.   memory where the grant table should be mapped to, using an
    12. 

  12.   HYPERVISOR_memory_op hypercall. The memory region is large enough to map
    13. 

  13.   the whole grant table (it is larger or equal to gnttab_max_grant_frames()).
    14. 

  14.   This property is unnecessary when booting Dom0 using ACPI.
    15. 

  15. 

  16. - interrupts: the interrupt used by Xen to inject event notifications.
    17. 

  17.   A GIC node is also required.
    18. 

  18.   This property is unnecessary when booting Dom0 using ACPI.
    19. 

  19. 

  20. To support UEFI on Xen ARM virtual platforms, Xen populates the FDT "uefi" node
    21. 

  21. under /hypervisor with following parameters:
    22. 

  22. 

  23. ________________________________________________________________________________
    24. 

  24. Name                      | Size   | Description
    25. 

  25. ================================================================================
    26. 

  26. xen,uefi-system-table     | 64-bit | Guest physical address of the UEFI System
    27. 

  27. 			  |	   | Table.
    28. 

  28. --------------------------------------------------------------------------------
    29. 

  29. xen,uefi-mmap-start       | 64-bit | Guest physical address of the UEFI memory
    30. 

  30. 			  |	   | map.
    31. 

  31. --------------------------------------------------------------------------------
    32. 

  32. xen,uefi-mmap-size        | 32-bit | Size in bytes of the UEFI memory map
    33. 

  33.                           |        | pointed to in previous entry.
    34. 

  34. --------------------------------------------------------------------------------
    35. 

  35. xen,uefi-mmap-desc-size   | 32-bit | Size in bytes of each entry in the UEFI
    36. 

  36.                           |        | memory map.
    37. 

  37. --------------------------------------------------------------------------------
    38. 

  38. xen,uefi-mmap-desc-ver    | 32-bit | Version of the mmap descriptor format.
    39. 

  39. --------------------------------------------------------------------------------
    40. 

  40. 

  41. Example (assuming #address-cells = <2> and #size-cells = <2>):
    42. 

  42. 

  43. hypervisor {
    44. 

  44. 	compatible = "xen,xen-4.3", "xen,xen";
    45. 

  45. 	reg = <0 0xb0000000 0 0x20000>;
    46. 

  46. 	interrupts = <1 15 0xf08>;
    47. 

  47. 	uefi {
    48. 

  48. 		xen,uefi-system-table = <0xXXXXXXXX>;
    49. 

  49. 		xen,uefi-mmap-start = <0xXXXXXXXX>;
    50. 

  50. 		xen,uefi-mmap-size = <0xXXXXXXXX>;
    51. 

  51. 		xen,uefi-mmap-desc-size = <0xXXXXXXXX>;
    52. 

  52. 		xen,uefi-mmap-desc-ver = <0xXXXXXXXX>;
    53. 

  53.         };
    54. 

  54. };
    55. 

  55. 

  56. The format and meaning of the "xen,uefi-*" parameters are similar to those in
    57. 

  57. Documentation/arm/uefi.txt, which are provided by the regular UEFI stub. However
    58. 

  58. they differ because they are provided by the Xen hypervisor, together with a set
    59. 

  59. of UEFI runtime services implemented via hypercalls, see
    60. 

  60. http://xenbits.xen.org/docs/unstable/hypercall/x86_64/include,public,platform.h.html.
    61. 

  61.