XSemNpiStatus - 2023.2 English

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

Document ID
UG643
Release Date
2023-12-13
Version
2023.2 English

XSemNpiStatus - NPI Status structure to store the data read from PMC RAM registers. This structure provides:

  • NPI scan status information (Refer XSem_CmdNpiGetStatus API)
  • NPI descriptor slave skip counter value if arbitration fails
  • NPI scan counter value
  • NPI heartbeat counter value
  • NPI scan error information if SHA mismatch is detected

Declaration

typedef struct
{
  u32 Status,
  u32 SlvSkipCnt[MAX_NPI_SLV_SKIP_CNT],
  u32 ScanCnt,
  u32 HbCnt,
  u32 ErrInfo[MAX_NPI_ERR_INFO_CNT]
} XSemNpiStatus;
Table 1. Structure XSemNpiStatus member description
Member Description
Status

NPI scan status

SlvSkipCnt

Slave Skip Count: Contains the number of times NPI scan failed to get arbitration for GT/DDRMC descriptor

ScanCnt

NPI Scan Count: Increments each time NPI scan successfully completes a full scan (Including the first scan)

HbCnt

Heart Beat Count: Increments for each slave group scanned in the descriptor and each time SHA is calculated

ErrInfo

Error Information: Is updated with error details in case of SHA mismatch failure. -ErrInfo[0]: Calculated SHA value of the descriptor for which mismatch is observed. -ErrInfo[1]: Bit[31:16] Reserved. Bit[15:8] The descriptor index number for which the SHA failure is observed. Bit[7:0] The skip count index of the descriptor where SHA failure is observed (This value is zero if arbitration is not applicable for the descriptor)