xilinx-versal-net.rst 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  1. Xilinx Versal NET
  2. =================
  3. Trusted Firmware-A implements the EL3 firmware layer for Xilinx Versal NET.
  4. The platform only uses the runtime part of TF-A as Xilinx Versal NET 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=versal_net bl31
  12. ```
  13. To build bl32 TSP you have to rebuild bl31 too
  14. ```bash
  15. make CROSS_COMPILE=aarch64-none-elf- PLAT=versal_net SPD=tspd RESET_TO_BL31=1 bl31 bl32
  16. ```
  17. To build TF-A for JTAG DCC console:
  18. ```bash
  19. make RESET_TO_BL31=1 CROSS_COMPILE=aarch64-none-elf- PLAT=versal_net VERSAL_NET_CONSOLE=dcc bl31
  20. ```
  21. Xilinx Versal NET platform specific build options
  22. -------------------------------------------------
  23. * `VERSAL_NET_ATF_MEM_BASE`: Specifies the base address of the bl31 binary.
  24. * `VERSAL_NET_ATF_MEM_SIZE`: Specifies the size of the memory region of the bl31 binary.
  25. * `VERSAL_NET_BL32_MEM_BASE`: Specifies the base address of the bl32 binary.
  26. * `VERSAL_NET_BL32_MEM_SIZE`: Specifies the size of the memory region of the bl32 binary.
  27. * `VERSAL_NET_CONSOLE`: Select the console driver. Options:
  28. - `pl011`, `pl011_0`: ARM pl011 UART 0 (default)
  29. - `pl011_1` : ARM pl011 UART 1
  30. - `dcc` : JTAG Debug Communication Channel(DCC)
  31. * `TFA_NO_PM` : Platform Management support.
  32. - 0 : Enable Platform Management (Default)
  33. - 1 : Disable Platform Management
  34. * `CPU_PWRDWN_SGI`: Select the SGI for triggering CPU power down request to
  35. secondary cores on receiving power down callback from
  36. firmware. Options:
  37. - `0` : SGI 0
  38. - `1` : SGI 1
  39. - `2` : SGI 2
  40. - `3` : SGI 3
  41. - `4` : SGI 4
  42. - `5` : SGI 5
  43. - `6` : SGI 6 (Default)
  44. - `7` : SGI 7
  45. Reference DEN0028E SMC calling convention
  46. ------------------------------------------
  47. Allocated subranges of Function Identifier to SIP services
  48. -----------------------------------------------------------
  49. +-----------------------+-------------------------------------------------------+
  50. | SMC Function | Identifier Service type |
  51. +-----------------------+------------------------------+------------------------+
  52. | 0xC2000000-0xC200FFFF | Fast SMC64 SiP Service Calls as per SMCCC Section 6.1 |
  53. +-----------------------+-------------------------------------------------------+
  54. IPI SMC call ranges
  55. -------------------------------------------------------------
  56. +---------------------------+-----------------------------------------------------------+
  57. | SMC Function Identifier | Service type |
  58. +---------------------------+-----------------------------------------------------------+
  59. | 0xc2001000-0xc2001FFF | Fast SMC64 SiP Service call range used for AMD-Xilinx IPI |
  60. +---------------------------+-----------------------------------------------------------+
  61. PM SMC call ranges for SiP SVC version 0.1
  62. --------------------------------------------------------
  63. +---------------------------+---------------------------------------------------------------------------+
  64. | SMC Function Identifier | Service type |
  65. +---------------------------+---------------------------------------------------------------------------+
  66. | 0xc2000000-0xc2000FFF | Fast SMC64 SiP Service call range used for AMD-Xilinx Platform Management |
  67. +---------------------------+---------------------------------------------------------------------------+
  68. PM SMC call ranges for SiP SVC version 0.2
  69. --------------------------------------------------------
  70. +---------------------------+---------------------------------------------------------------------------+
  71. | SMC Function Identifier | Service type |
  72. +---------------------------+---------------------------------------------------------------------------+
  73. | 0xc2000FFF | Fast SMC64 SiP Service call used for pass-through of AMD-Xilinx Platform |
  74. | | Management APIs to firmware |
  75. +---------------------------+---------------------------------------------------------------------------+
  76. | 0xc2000A00-0xc2000AFF | Fast SMC64 SiP Service call range used for AMD-Xilinx Platform Management |
  77. | | specific TF-A APIs |
  78. +---------------------------+---------------------------------------------------------------------------+
  79. SMC function IDs for SiP Service queries
  80. ----------------------------------------------
  81. +--------------+--------------+--------------+
  82. | Service | Call UID | Revision |
  83. +--------------+--------------+--------------+
  84. | SiP Service | 0x8200_FF01 | 0x8200_FF03 |
  85. +--------------+--------------+--------------+
  86. Call UID Query – Returns a unique identifier of the service provider.
  87. Revision Query – Returns revision details of the service implementor.