xref: /rk3399_ARM-atf/docs/plat/xilinx-versal.rst (revision 31ce893ec29197c51e3814648ad0dd2acf4a31a7)
124dba2b3SPaul BeesleyXilinx Versal
224dba2b3SPaul Beesley=============
324dba2b3SPaul Beesley
424dba2b3SPaul BeesleyTrusted Firmware-A implements the EL3 firmware layer for Xilinx Versal.
524dba2b3SPaul BeesleyThe platform only uses the runtime part of TF-A as Xilinx Versal already has a
624dba2b3SPaul BeesleyBootROM (BL1) and PMC FW (BL2).
724dba2b3SPaul Beesley
824dba2b3SPaul BeesleyBL31 is TF-A.
924dba2b3SPaul BeesleyBL32 is an optional Secure Payload.
1024dba2b3SPaul BeesleyBL33 is the non-secure world software (U-Boot, Linux etc).
1124dba2b3SPaul Beesley
1224dba2b3SPaul BeesleyTo build:
1324dba2b3SPaul Beesley```bash
1424dba2b3SPaul Beesleymake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31
1524dba2b3SPaul Beesley```
1624dba2b3SPaul Beesley
177b9f0cfdSSiva Durga Prasad PaladuguTo build ATF for different platform (supported are "silicon"(default) and "versal_virt")
1824dba2b3SPaul Beesley```bash
1924dba2b3SPaul Beesleymake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal VERSAL_PLATFORM=versal_virt bl31
2024dba2b3SPaul Beesley```
2124dba2b3SPaul Beesley
2224dba2b3SPaul BeesleyXilinx Versal platform specific build options
2324dba2b3SPaul Beesley---------------------------------------------
2424dba2b3SPaul Beesley
2524dba2b3SPaul Beesley*   `VERSAL_ATF_MEM_BASE`: Specifies the base address of the bl31 binary.
2624dba2b3SPaul Beesley*   `VERSAL_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary.
2724dba2b3SPaul Beesley*   `VERSAL_BL32_MEM_BASE`: Specifies the base address of the bl32 binary.
2824dba2b3SPaul Beesley*   `VERSAL_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary.
2924dba2b3SPaul Beesley
3024dba2b3SPaul Beesley*   `VERSAL_CONSOLE`: Select the console driver. Options:
3124dba2b3SPaul Beesley    -   `pl011`, `pl011_0`: ARM pl011 UART 0
3224dba2b3SPaul Beesley    -   `pl011_1`         : ARM pl011 UART 1
3324dba2b3SPaul Beesley
3424dba2b3SPaul Beesley*   `VERSAL_PLATFORM`: Select the platform. Options:
3524dba2b3SPaul Beesley    -   `versal_virt`	: Versal Virtual platform
36*31ce893eSVenkatesh Yadav Abbarapu
37*31ce893eSVenkatesh Yadav Abbarapu# PLM->TF-A Parameter Passing
38*31ce893eSVenkatesh Yadav Abbarapu------------------------------
39*31ce893eSVenkatesh Yadav AbbarapuThe PLM populates a data structure with image information for the TF-A. The TF-A
40*31ce893eSVenkatesh Yadav Abbarapuuses that data to hand off to the loaded images. The address of the handoff
41*31ce893eSVenkatesh Yadav Abbarapudata structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register.
42*31ce893eSVenkatesh Yadav AbbarapuThe register is free to be used by other software once the TF-A is bringing up
43*31ce893eSVenkatesh Yadav Abbarapufurther firmware images.
44