XSem_CmdNpiStartScan - XSem_CmdNpiStartScan - 2026.1 English - UG643

Standalone Library Documentation: BSP and Libraries Document Collection (UG643)

Document ID
UG643
Release Date
2026-06-23
Version
2026.1 English

This function is used to start NPI scan from user application. Primarily this function sends an IPI request to PLM to invoke SEM NPI StartScan, 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_CmdNpiStartScan(XIpiPsu *IpiInst, XSemIpiResp *Resp);

Parameters

The following table lists the XSem_CmdNpiStartScan function arguments.

Table 1. XSem_CmdNpiStartScan Arguments
Type Member Description
XIpiPsu * IpiInst Pointer to IPI driver instance
XSemIpiResp * Resp Structure Pointer of IPI response
  • Resp->RespMsg1: Acknowledgment ID of NPI start scan(0x10305)
  • Resp->RespMsg2: Status of NPI start scan (0: Success, 1: Failure)

Returns

This API returns the success or failure.
  • XST_FAILURE: On NPI start scan failure
  • XST_SUCCESS: On NPI start scan success