| Paul Beesley | f3653a6 | 2019-05-22 11:22:44 +0100 | [diff] [blame] | 1 | Xilinx Versal |
| 2 | ============= |
| Siva Durga Prasad Paladugu | fe4af66 | 2018-09-25 18:44:58 +0530 | [diff] [blame] | 3 | |
| 4 | Trusted Firmware-A implements the EL3 firmware layer for Xilinx Versal. |
| 5 | The platform only uses the runtime part of TF-A as Xilinx Versal already has a |
| 6 | BootROM (BL1) and PMC FW (BL2). |
| 7 | |
| 8 | BL31 is TF-A. |
| 9 | BL32 is an optional Secure Payload. |
| 10 | BL33 is the non-secure world software (U-Boot, Linux etc). |
| 11 | |
| 12 | To build: |
| 13 | ```bash |
| 14 | make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 |
| 15 | ``` |
| 16 | |
| Siva Durga Prasad Paladugu | cbc9005 | 2019-07-10 16:15:19 +0530 | [diff] [blame] | 17 | To build ATF for different platform (supported are "silicon"(default) and "versal_virt") |
| Siva Durga Prasad Paladugu | fe4af66 | 2018-09-25 18:44:58 +0530 | [diff] [blame] | 18 | ```bash |
| 19 | make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal VERSAL_PLATFORM=versal_virt bl31 |
| 20 | ``` |
| 21 | |
| Venkatesh Yadav Abbarapu | 17a12ce | 2020-11-27 08:42:14 -0700 | [diff] [blame] | 22 | To build TF-A for JTAG DCC console |
| 23 | ```bash |
| 24 | make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 VERSAL_CONSOLE=dcc |
| 25 | ``` |
| 26 | |
| Venkatesh Yadav Abbarapu | 82252a4 | 2021-07-20 22:27:32 -0600 | [diff] [blame] | 27 | To build TF-A with Straight-Line Speculation(SLS) |
| 28 | ```bash |
| 29 | make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 HARDEN_SLS_ALL=1 |
| 30 | ``` |
| 31 | |
| Paul Beesley | f3653a6 | 2019-05-22 11:22:44 +0100 | [diff] [blame] | 32 | Xilinx Versal platform specific build options |
| 33 | --------------------------------------------- |
| 34 | |
| Siva Durga Prasad Paladugu | fe4af66 | 2018-09-25 18:44:58 +0530 | [diff] [blame] | 35 | * `VERSAL_ATF_MEM_BASE`: Specifies the base address of the bl31 binary. |
| 36 | * `VERSAL_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary. |
| 37 | * `VERSAL_BL32_MEM_BASE`: Specifies the base address of the bl32 binary. |
| 38 | * `VERSAL_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary. |
| 39 | |
| 40 | * `VERSAL_CONSOLE`: Select the console driver. Options: |
| 41 | - `pl011`, `pl011_0`: ARM pl011 UART 0 |
| 42 | - `pl011_1` : ARM pl011 UART 1 |
| 43 | |
| 44 | * `VERSAL_PLATFORM`: Select the platform. Options: |
| 45 | - `versal_virt` : Versal Virtual platform |
| Venkatesh Yadav Abbarapu | 9c3b77b | 2022-04-13 09:04:53 +0530 | [diff] [blame] | 46 | - `spp_itr6` : SPP ITR6 |
| Venkatesh Yadav Abbarapu | 1d6d9dd | 2022-05-11 13:46:28 +0530 | [diff] [blame] | 47 | - `emu_itr6` : EMU ITR6 |
| Venkatesh Yadav Abbarapu | 9156ffd | 2020-01-22 21:23:20 -0700 | [diff] [blame] | 48 | |
| 49 | # PLM->TF-A Parameter Passing |
| 50 | ------------------------------ |
| 51 | The PLM populates a data structure with image information for the TF-A. The TF-A |
| 52 | uses that data to hand off to the loaded images. The address of the handoff |
| 53 | data structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register. |
| 54 | The register is free to be used by other software once the TF-A is bringing up |
| 55 | further firmware images. |