diff --git a/boards/arm64/rpi_5/doc/index.rst b/boards/arm64/rpi_5/doc/index.rst index c22c695a405d663..a9d5800557101b8 100644 --- a/boards/arm64/rpi_5/doc/index.rst +++ b/boards/arm64/rpi_5/doc/index.rst @@ -159,3 +159,35 @@ When you power on the Raspberry Pi 5, you will see the following output in the s .. _Raspberry Pi Debug Probe: https://www.raspberrypi.com/products/debug-probe/ + +XEN Dom0 +======== + +The Raspberry Pi 5 platform can be used to run as Xen Zephyr Dom0. For such purposes the `xen_dom0` +can be used. + +Run below command as an example of RPI 5 Zephyr build as Dom0: + +.. code-block:: bash + + west build -b rpi_5 -p always -S xen_dom0 samples/hello_world + +It is expected to be used with special application performing Xen0 functions. + +.. note:: + + The "hypervisor@x" and "memory@x" DT nodes may need to be updated depending on the Xen boot, + because normaly Xan will update DT for the target Kernel, but this is not possible in case + of Zephyr. See comments in `rpi_5_xen_dom0.dts`. + +XEN DomU with HW passthrough +============================ + +The Raspberry Pi 5 platform can be used to run as Xen Zephyr DomU with RPI 5 HW support. +For such purposes the `rpi_5_xen_domd` can be used. + +Run below command as an example of RPI 5 Zephyr build as Dom0: + +.. code-block:: bash + + west build -b xenvm -S rpi_5_xen_domd samples/basic/blinky