1*54fd6939SJiyong ParkXilinx Versal 2*54fd6939SJiyong Park============= 3*54fd6939SJiyong Park 4*54fd6939SJiyong ParkTrusted Firmware-A implements the EL3 firmware layer for Xilinx Versal. 5*54fd6939SJiyong ParkThe platform only uses the runtime part of TF-A as Xilinx Versal already has a 6*54fd6939SJiyong ParkBootROM (BL1) and PMC FW (BL2). 7*54fd6939SJiyong Park 8*54fd6939SJiyong ParkBL31 is TF-A. 9*54fd6939SJiyong ParkBL32 is an optional Secure Payload. 10*54fd6939SJiyong ParkBL33 is the non-secure world software (U-Boot, Linux etc). 11*54fd6939SJiyong Park 12*54fd6939SJiyong ParkTo build: 13*54fd6939SJiyong Park```bash 14*54fd6939SJiyong Parkmake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 15*54fd6939SJiyong Park``` 16*54fd6939SJiyong Park 17*54fd6939SJiyong ParkTo build ATF for different platform (supported are "silicon"(default) and "versal_virt") 18*54fd6939SJiyong Park```bash 19*54fd6939SJiyong Parkmake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal VERSAL_PLATFORM=versal_virt bl31 20*54fd6939SJiyong Park``` 21*54fd6939SJiyong Park 22*54fd6939SJiyong ParkTo build TF-A for JTAG DCC console 23*54fd6939SJiyong Park```bash 24*54fd6939SJiyong Parkmake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 VERSAL_CONSOLE=dcc 25*54fd6939SJiyong Park``` 26*54fd6939SJiyong Park 27*54fd6939SJiyong ParkTo build TF-A with Straight-Line Speculation(SLS) 28*54fd6939SJiyong Park```bash 29*54fd6939SJiyong Parkmake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 HARDEN_SLS_ALL=1 30*54fd6939SJiyong Park``` 31*54fd6939SJiyong Park 32*54fd6939SJiyong ParkXilinx Versal platform specific build options 33*54fd6939SJiyong Park--------------------------------------------- 34*54fd6939SJiyong Park 35*54fd6939SJiyong Park* `VERSAL_ATF_MEM_BASE`: Specifies the base address of the bl31 binary. 36*54fd6939SJiyong Park* `VERSAL_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary. 37*54fd6939SJiyong Park* `VERSAL_BL32_MEM_BASE`: Specifies the base address of the bl32 binary. 38*54fd6939SJiyong Park* `VERSAL_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary. 39*54fd6939SJiyong Park 40*54fd6939SJiyong Park* `VERSAL_CONSOLE`: Select the console driver. Options: 41*54fd6939SJiyong Park - `pl011`, `pl011_0`: ARM pl011 UART 0 42*54fd6939SJiyong Park - `pl011_1` : ARM pl011 UART 1 43*54fd6939SJiyong Park 44*54fd6939SJiyong Park* `VERSAL_PLATFORM`: Select the platform. Options: 45*54fd6939SJiyong Park - `versal_virt` : Versal Virtual platform 46*54fd6939SJiyong Park 47*54fd6939SJiyong Park# PLM->TF-A Parameter Passing 48*54fd6939SJiyong Park------------------------------ 49*54fd6939SJiyong ParkThe PLM populates a data structure with image information for the TF-A. The TF-A 50*54fd6939SJiyong Parkuses that data to hand off to the loaded images. The address of the handoff 51*54fd6939SJiyong Parkdata structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register. 52*54fd6939SJiyong ParkThe register is free to be used by other software once the TF-A is bringing up 53*54fd6939SJiyong Parkfurther firmware images. 54