amd-versal2.rst 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. AMD Versal Gen 2
  2. ================
  3. Trusted Firmware-A implements the EL3 firmware layer for AMD Versal Gen 2.
  4. The platform only uses the runtime part of TF-A as AMD Versal Gen 2 already
  5. has a BootROM (BL1) and PMC FW (BL2).
  6. BL31 is TF-A.
  7. BL32 is an optional Secure Payload.
  8. BL33 is the non-secure world software (U-Boot, Linux etc).
  9. To build:
  10. ```bash
  11. make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal2 bl31
  12. ```
  13. To build TF-A for JTAG DCC console:
  14. ```bash
  15. make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal2 CONSOLE=dcc bl31
  16. ```
  17. To build TF-A with Errata management interface
  18. ```bash
  19. make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal2 bl31 ERRATA_ABI_SUPPORT=1
  20. ```
  21. To build TF-A with IPI CRC check:
  22. ```bash
  23. make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal2 bl31 IPI_CRC_CHECK=1
  24. ```
  25. AMD Versal Gen 2 platform specific build options
  26. -------------------------------------------------
  27. * `MEM_BASE`: Specifies the base address of the bl31 binary.
  28. * `MEM_SIZE`: Specifies the size of the memory region of the bl31 binary.
  29. * `BL32_MEM_BASE`: Specifies the base address of the bl32 binary.
  30. * `BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary.
  31. * `CONSOLE`: Select the console driver. Options:
  32. - `pl011`, `pl011_0`: ARM pl011 UART 0 (default)
  33. - `pl011_1` : ARM pl011 UART 1
  34. - `dcc` : JTAG Debug Communication Channel(DCC)
  35. Reference DEN0028E SMC calling convention
  36. ------------------------------------------
  37. Allocated subranges of Function Identifier to SIP services
  38. ------------------------------------------------------------
  39. +-----------------------+-------------------------------------------------------+
  40. | SMC Function | Identifier Service type |
  41. +-----------------------+-------------------------------------------------------+
  42. | 0xC2000000-0xC200FFFF | Fast SMC64 SiP Service Calls as per SMCCC Section 6.1 |
  43. +-----------------------+-------------------------------------------------------+
  44. IPI SMC call ranges
  45. -------------------
  46. +---------------------------+-----------------------------------------------------------+
  47. | SMC Function Identifier | Service type |
  48. +---------------------------+-----------------------------------------------------------+
  49. | 0xc2001000-0xc2001FFF | Fast SMC64 SiP Service call range used for AMD-Xilinx IPI |
  50. +---------------------------+-----------------------------------------------------------+
  51. PM SMC call ranges
  52. ------------------
  53. +---------------------------+---------------------------------------------------------------------------+
  54. | SMC Function Identifier | Service type |
  55. +---------------------------+---------------------------------------------------------------------------+
  56. | 0xc2000000-0xc2000FFF | Fast SMC64 SiP Service call range used for AMD-Xilinx Platform Management |
  57. +---------------------------+---------------------------------------------------------------------------+
  58. SMC function IDs for SiP Service queries
  59. ----------------------------------------
  60. +--------------+--------------+--------------+
  61. | Service | Call UID | Revision |
  62. +--------------+--------------+--------------+
  63. | SiP Service | 0x8200_FF01 | 0x8200_FF03 |
  64. +--------------+--------------+--------------+
  65. Call UID Query – Returns a unique identifier of the service provider.
  66. Revision Query – Returns revision details of the service implementor.