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 220b25f404SVenkatesh Yadav AbbarapuTo build TF-A for JTAG DCC console 230b25f404SVenkatesh Yadav Abbarapu```bash 240b25f404SVenkatesh Yadav Abbarapumake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 VERSAL_CONSOLE=dcc 250b25f404SVenkatesh Yadav Abbarapu``` 260b25f404SVenkatesh Yadav Abbarapu 27302b4dfbSVenkatesh Yadav AbbarapuTo build TF-A with Straight-Line Speculation(SLS) 28302b4dfbSVenkatesh Yadav Abbarapu```bash 29302b4dfbSVenkatesh Yadav Abbarapumake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 HARDEN_SLS_ALL=1 30302b4dfbSVenkatesh Yadav Abbarapu``` 31302b4dfbSVenkatesh Yadav Abbarapu 3224dba2b3SPaul BeesleyXilinx Versal platform specific build options 3324dba2b3SPaul Beesley--------------------------------------------- 3424dba2b3SPaul Beesley 3524dba2b3SPaul Beesley* `VERSAL_ATF_MEM_BASE`: Specifies the base address of the bl31 binary. 3624dba2b3SPaul Beesley* `VERSAL_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary. 3724dba2b3SPaul Beesley* `VERSAL_BL32_MEM_BASE`: Specifies the base address of the bl32 binary. 3824dba2b3SPaul Beesley* `VERSAL_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary. 3924dba2b3SPaul Beesley 4024dba2b3SPaul Beesley* `VERSAL_CONSOLE`: Select the console driver. Options: 4124dba2b3SPaul Beesley - `pl011`, `pl011_0`: ARM pl011 UART 0 4224dba2b3SPaul Beesley - `pl011_1` : ARM pl011 UART 1 4324dba2b3SPaul Beesley 4424dba2b3SPaul Beesley* `VERSAL_PLATFORM`: Select the platform. Options: 4524dba2b3SPaul Beesley - `versal_virt` : Versal Virtual platform 46*be73459aSVenkatesh Yadav Abbarapu - `spp_itr6` : SPP ITR6 47*be73459aSVenkatesh Yadav Abbarapu - `emu_it6` : EMU ITR6 4831ce893eSVenkatesh Yadav Abbarapu 4931ce893eSVenkatesh Yadav Abbarapu# PLM->TF-A Parameter Passing 5031ce893eSVenkatesh Yadav Abbarapu------------------------------ 5131ce893eSVenkatesh Yadav AbbarapuThe PLM populates a data structure with image information for the TF-A. The TF-A 5231ce893eSVenkatesh Yadav Abbarapuuses that data to hand off to the loaded images. The address of the handoff 5331ce893eSVenkatesh Yadav Abbarapudata structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register. 5431ce893eSVenkatesh Yadav AbbarapuThe register is free to be used by other software once the TF-A is bringing up 5531ce893eSVenkatesh Yadav Abbarapufurther firmware images. 56