XSemStatus - 2023.2 English

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

Document ID
UG643
Release Date
2023-12-13
Version
2023.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 ErrAddrL[MAX_CRAMERR_REGISTER_CNT],
  u32 ErrAddrH[MAX_CRAMERR_REGISTER_CNT],
  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

ErrAddrL

Error Low register L0...L6

ErrAddrH

Error High register H0...H6

ErrCorCnt

Count of correctable errors