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 22*7b7c5350SPrasad KummariTo build bl32 TSP you have to rebuild bl31 too 23*7b7c5350SPrasad Kummari```bash 24*7b7c5350SPrasad Kummarimake CROSS_COMPILE=aarch64-none-elf- PLAT=versal SPD=tspd RESET_TO_BL31=1 bl31 bl32 25*7b7c5350SPrasad Kummari``` 26*7b7c5350SPrasad Kummari 270b25f404SVenkatesh Yadav AbbarapuTo build TF-A for JTAG DCC console 280b25f404SVenkatesh Yadav Abbarapu```bash 290b25f404SVenkatesh Yadav Abbarapumake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 VERSAL_CONSOLE=dcc 300b25f404SVenkatesh Yadav Abbarapu``` 310b25f404SVenkatesh Yadav Abbarapu 32302b4dfbSVenkatesh Yadav AbbarapuTo build TF-A with Straight-Line Speculation(SLS) 33302b4dfbSVenkatesh Yadav Abbarapu```bash 34302b4dfbSVenkatesh Yadav Abbarapumake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 HARDEN_SLS_ALL=1 35302b4dfbSVenkatesh Yadav Abbarapu``` 36302b4dfbSVenkatesh Yadav Abbarapu 3724dba2b3SPaul BeesleyXilinx Versal platform specific build options 3824dba2b3SPaul Beesley--------------------------------------------- 3924dba2b3SPaul Beesley 4024dba2b3SPaul Beesley* `VERSAL_ATF_MEM_BASE`: Specifies the base address of the bl31 binary. 4124dba2b3SPaul Beesley* `VERSAL_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary. 4224dba2b3SPaul Beesley* `VERSAL_BL32_MEM_BASE`: Specifies the base address of the bl32 binary. 4324dba2b3SPaul Beesley* `VERSAL_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary. 4424dba2b3SPaul Beesley 4524dba2b3SPaul Beesley* `VERSAL_CONSOLE`: Select the console driver. Options: 4624dba2b3SPaul Beesley - `pl011`, `pl011_0`: ARM pl011 UART 0 4724dba2b3SPaul Beesley - `pl011_1` : ARM pl011 UART 1 4824dba2b3SPaul Beesley 4924dba2b3SPaul Beesley* `VERSAL_PLATFORM`: Select the platform. Options: 5024dba2b3SPaul Beesley - `versal_virt` : Versal Virtual platform 51be73459aSVenkatesh Yadav Abbarapu - `spp_itr6` : SPP ITR6 52103bbd56SVenkatesh Yadav Abbarapu - `emu_itr6` : EMU ITR6 5331ce893eSVenkatesh Yadav Abbarapu 5431ce893eSVenkatesh Yadav Abbarapu# PLM->TF-A Parameter Passing 5531ce893eSVenkatesh Yadav Abbarapu------------------------------ 5631ce893eSVenkatesh Yadav AbbarapuThe PLM populates a data structure with image information for the TF-A. The TF-A 5731ce893eSVenkatesh Yadav Abbarapuuses that data to hand off to the loaded images. The address of the handoff 5831ce893eSVenkatesh Yadav Abbarapudata structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register. 5931ce893eSVenkatesh Yadav AbbarapuThe register is free to be used by other software once the TF-A is bringing up 6031ce893eSVenkatesh Yadav Abbarapufurther firmware images. 61