XSem_CmdGetConfig - XSem_CmdGetConfig - 2025.2 English - UG643

Standalone Library Documentation: BSP and Libraries Document Collection (UG643)
Document ID
UG643
Release Date
2025-11-20
Version
2025.2 English

This function is used to read CRAM & NPI configuration. Primarily this function sends an IPI request to PLM to invoke SEM Get configuration command, waits for PLM to process the request and reads the response message. In case of EL1 Non-Secure mode, this function generates an SMC call to TF-A. The SMC request goes to the PLM through the TF-A. This function reads the response of the SMC call and returns the status.

Prototype

XStatus XSem_CmdGetConfig(XIpiPsu *IpiInst, XSemIpiResp *Resp);

Parameters

The following table lists the XSem_CmdGetConfig function arguments.

Table 1. XSem_CmdGetConfig Arguments
Type Member Description
XIpiPsu * IpiInst Pointer to IPI driver instance
XSemIpiResp * Resp Structure Pointer of IPI response

Resp->RespMsg1: Acknowledgment ID of Get Configuration(0x30309)

Resp->RespMsg2: CRAM Attribute register details

  • Bit [31:16]: Not Implemented
  • Bit [15:9]: Reserved
  • Bit [8]: Reserved
  • Bit [7]: Reserved
  • Bit [6:5]: Indicates when to start CRAM scan
    • 00: Do not automatically start scan
    • 01: Enable scan automatically after device configuration.
    • 10: Reserved
    • 11: Reserved
XSemIpiResp * Resp
  • Bit [4]: Reserved
  • Bit [3]: Indicates HwECC/SwECC
    • 0: Uses hardware calculated ECC.
    • 1: Uses software calculated ECC that comes from tools and part of CDO
  • Bit [2]: Indicates Correctable error is to be corrected/not
    • 0: Disables error correction capability
    • 1: Enables error correction capability
  • Bit [1:0]: Define the mode of the scan (Enable/Disable scan)
    • 00: Disable Configuration RAM scan
    • 01: RESERVED
    • 10: Enable Configuration RAM scan
    • 11: RESERVED

Resp->RespMsg3: NPI Attribute register details

  • Bit [31:24]: Not implemented
  • Bit [23:18]: Reserved
  • Bit [17:8]: The scheduled time in milliseconds that the NPI scan is periodically performed. Default Setting: 0x064 = 100ms
  • Bit [7:6]: Reserved
  • Bit [5:4]: Indicates when to start NPI scan
    • 00: Do not automatically start scan
    • 01: Enable scan automatically after device configuration.
    • 10: Reserved
    • 11: Reserved
  • Bit [3]: Reserved
  • Bit [2]: Indicates HwSHA/SwSHA 0: Use hardware calculated SHA. 1: Use software calculated SHA.
  • Bit [1:0]: Reserved

Resp->RespMsg4: Status of Get Configuration command

Returns

This API returns the success or failure.
  • XST_FAILURE: On Get Configuration failure
  • XST_SUCCESS: On Get Configuration success