XSemStatus - XSemStatus - 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

XSemStatus - SEM (CRAM & NPI) Status structure to store the data read from PMC RAM registers of any SLR 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
  • CRAM scan state information
  • The low address of last 7 corrected error details if correction is enabled in design
  • The high address of last 7 corrected error details if correction is enabled in design
  • CRAM corrected error bits count value

Declaration

typedef struct
{
  u32 NpiStatus,
  u32 SlvSkipCnt[MAX_NPI_SLV_SKIP_CNT],
  u32 ScanCnt,
  u32 HbCnt,
  u32 ErrInfo[MAX_NPI_ERR_INFO_CNT],
  u32 CramStatus,
  u32 ErrAddrLowHigh[MAX_ADDRLOC],
  u32 ErrCorCnt
} XSemStatus;
Table 1. Structure XSemStatus member description
Member Description
NpiStatus

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)

CramStatus

CRAM Status

ErrAddrLowHigh

Error Low & High register L0,H0, L1,H1...L6,H6

ErrCorCnt

Count of correctable errors