xref: /rk3399_ARM-atf/docs/plat/xilinx-versal.rst (revision 0b25f4045a19aca9ce5837c8d2703b0bc1dc4e8c)
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*0b25f404SVenkatesh Yadav AbbarapuTo build TF-A for JTAG DCC console
23*0b25f404SVenkatesh Yadav Abbarapu```bash
24*0b25f404SVenkatesh Yadav Abbarapumake RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal bl31 VERSAL_CONSOLE=dcc
25*0b25f404SVenkatesh Yadav Abbarapu```
26*0b25f404SVenkatesh Yadav Abbarapu
2724dba2b3SPaul BeesleyXilinx Versal platform specific build options
2824dba2b3SPaul Beesley---------------------------------------------
2924dba2b3SPaul Beesley
3024dba2b3SPaul Beesley*   `VERSAL_ATF_MEM_BASE`: Specifies the base address of the bl31 binary.
3124dba2b3SPaul Beesley*   `VERSAL_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary.
3224dba2b3SPaul Beesley*   `VERSAL_BL32_MEM_BASE`: Specifies the base address of the bl32 binary.
3324dba2b3SPaul Beesley*   `VERSAL_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary.
3424dba2b3SPaul Beesley
3524dba2b3SPaul Beesley*   `VERSAL_CONSOLE`: Select the console driver. Options:
3624dba2b3SPaul Beesley    -   `pl011`, `pl011_0`: ARM pl011 UART 0
3724dba2b3SPaul Beesley    -   `pl011_1`         : ARM pl011 UART 1
3824dba2b3SPaul Beesley
3924dba2b3SPaul Beesley*   `VERSAL_PLATFORM`: Select the platform. Options:
4024dba2b3SPaul Beesley    -   `versal_virt`	: Versal Virtual platform
4131ce893eSVenkatesh Yadav Abbarapu
4231ce893eSVenkatesh Yadav Abbarapu# PLM->TF-A Parameter Passing
4331ce893eSVenkatesh Yadav Abbarapu------------------------------
4431ce893eSVenkatesh Yadav AbbarapuThe PLM populates a data structure with image information for the TF-A. The TF-A
4531ce893eSVenkatesh Yadav Abbarapuuses that data to hand off to the loaded images. The address of the handoff
4631ce893eSVenkatesh Yadav Abbarapudata structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register.
4731ce893eSVenkatesh Yadav AbbarapuThe register is free to be used by other software once the TF-A is bringing up
4831ce893eSVenkatesh Yadav Abbarapufurther firmware images.
49