From d8dc1cfa6f339696f6c1e1cac6e1fac0e52cf30f Mon Sep 17 00:00:00 2001 From: Prasad Kummari Date: Thu, 8 Feb 2024 17:29:57 +0530 Subject: [PATCH] docs(versal): update SMC convention Updated documentation for SMC SiP calling conventions for IPI, PM, and SiP Service queries. Signed-off-by: Prasad Kummari Change-Id: Ic232551bb09152124da5226673c88e1a34a384c4 --- docs/plat/xilinx-versal.rst | 43 +++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/docs/plat/xilinx-versal.rst b/docs/plat/xilinx-versal.rst index aa094f757..072329a5b 100644 --- a/docs/plat/xilinx-versal.rst +++ b/docs/plat/xilinx-versal.rst @@ -76,3 +76,46 @@ uses that data to hand off to the loaded images. The address of the handoff data structure is passed in the ```PMC_GLOBAL_GLOB_GEN_STORAGE4``` register. The register is free to be used by other software once the TF-A is bringing up further firmware images. + +Reference DEN0028E SMC calling convention +------------------------------------------ + +Allocated subranges of Function Identifier to SIP services +---------------------------------------------------------- + ++-----------------------+-------------------------------------------------------+ +| SMC Function | Identifier Service type | ++-----------------------+-------------------------------------------------------+ +| 0xC2000000-0xC200FFFF | Fast SMC64 SiP Service Calls as per SMCCC Section 6.1 | ++-----------------------+-------------------------------------------------------+ + +IPI SMC call ranges +------------------- + ++---------------------------+-----------------------------------------------------------+ +| SMC Function Identifier | Service type | ++---------------------------+-----------------------------------------------------------+ +| 0xc2001000-0xc2001FFF | Fast SMC64 SiP Service call range used for AMD-Xilinx IPI | ++---------------------------+-----------------------------------------------------------+ + +PM SMC call ranges +------------------ + ++---------------------------+---------------------------------------------------------------------------+ +| SMC Function Identifier | Service type | ++---------------------------+---------------------------------------------------------------------------+ +| 0xc2000000-0xc2000FFF | Fast SMC64 SiP Service call range used for AMD-Xilinx Platform Management | ++---------------------------+---------------------------------------------------------------------------+ + +SMC function IDs for SiP Service queries +---------------------------------------- + ++--------------+--------------+--------------+ +| Service | Call UID | Revision | ++--------------+--------------+--------------+ +| SiP Service | 0x8200_FF01 | 0x8200_FF03 | ++--------------+--------------+--------------+ + +Call UID Query – Returns a unique identifier of the service provider. + +Revision Query – Returns revision details of the service implementor.