summaryrefslogtreecommitdiff
path: root/docs/plat
diff options
context:
space:
mode:
authorSoren Brinkmann <soren.brinkmann@xilinx.com>2016-03-06 20:16:27 -0800
committerSoren Brinkmann <soren.brinkmann@xilinx.com>2016-04-06 10:44:27 -0700
commitc8284409e13ea72d08a9d858f8bcbddfb2f4df42 (patch)
tree782fb94f2b6bbc49740979daa7c87fa71baf1343 /docs/plat
parent21aa752dd8ece3aeb0264ebf385db2989e436972 (diff)
Add support for Xilinx Zynq UltraScale+ MPSOC
The Xilinx Zynq UltraScale+ MPSOC containes a quad A53 cluster. This patch adds the platform port for that SoC. Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
Diffstat (limited to 'docs/plat')
-rw-r--r--docs/plat/xilinx-zynqmp.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/plat/xilinx-zynqmp.md b/docs/plat/xilinx-zynqmp.md
new file mode 100644
index 00000000..997d9a9a
--- /dev/null
+++ b/docs/plat/xilinx-zynqmp.md
@@ -0,0 +1,49 @@
+ARM Trusted Firmware for Xilinx Zynq UltraScale+ MPSoC
+================================
+
+ARM Trusted Firmware implements the EL3 firmware layer for Xilinx Zynq
+UltraScale + MPSoC.
+The platform only uses the runtime part of ATF as ZynqMP already has a
+BootROM (BL1) and FSBL (BL2).
+
+BL31 is ATF.
+BL32 is an optional Secure Payload.
+BL33 is the non-secure world software (U-Boot, Linux etc).
+
+To build:
+```bash
+make ERROR_DEPRECATED=1 RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=zynqmp bl31
+```
+
+To build bl32 TSP you have to rebuild bl31 too:
+```bash
+make ERROR_DEPRECATED=1 RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=zynqmp SPD=tspd bl31 bl32
+```
+
+# ZynqMP platform specific build options
+* `ZYNQMP_ATF_LOCATION`: Specifies the location of the bl31 binary. Options:
+ - `tsram` : bl31 will be located in OCM (default)
+ - `tdram` : bl31 will be located in DRAM (address: 0x30000000)
+
+* `ZYNQMP_TSP_RAM_LOCATION`: Specifies the location of the bl32 binary and
+ secure payload dispatcher. Options:
+ - `tsram` : bl32/spd will be located in OCM (default)
+ - `tdram` : bl32/spd will be located in DRAM (address: 0x30000000)
+
+# Power Domain Tree
+The following power domain tree represents the power domain model used by the
+ATF for ZynqMP:
+```
+ +-+
+ |0|
+ +-+
+ +-------+---+---+-------+
+ | | | |
+ | | | |
+ v v v v
+ +-+ +-+ +-+ +-+
+ |0| |1| |2| |3|
+ +-+ +-+ +-+ +-+
+```
+The 4 leaf power domains represent the individual A53 cores, while resources
+common to the cluster are grouped in the power domain on the top.