xilsem
Vitis Drivers API Documentation
XSemNpiStatus Struct Reference

XSemNpiStatus - NPI Status structure to store the data read from PMC RAM registers. More...

Data Fields

u32 Status
 NPI scan status. More...
 
u32 SlvSkipCnt [MAX_NPI_SLV_SKIP_CNT]
 
                 Slave Skip Count: Contains the

number of times NPI scan failed to get arbitration for GT/DDRMC descriptor More...

 
u32 ScanCnt
 
              NPI Scan Count: Increments each time  NPI scan

successfully completes a full scan (Including the first scan) More...

 
u32 HbCnt
 
            Heart Beat Count: Increments for each slave group scanned

in the descriptor and each time SHA is calculated More...

 
u32 ErrInfo [MAX_NPI_ERR_INFO_CNT]
 
              Error Information: Is updated with

error details in case of SHA mismatch failure. More...

 

Detailed Description

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

Field Documentation

u32 XSemNpiStatus::ErrInfo[MAX_NPI_ERR_INFO_CNT]

              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)

Referenced by main(), and XSem_CmdNpiGetStatus().

u32 XSemNpiStatus::HbCnt

            Heart Beat Count: Increments for each slave group scanned

in the descriptor and each time SHA is calculated

Referenced by main(), XSem_ApiCheckHbtCount(), and XSem_CmdNpiGetStatus().

u32 XSemNpiStatus::ScanCnt

              NPI Scan Count: Increments each time  NPI scan

successfully completes a full scan (Including the first scan)

Referenced by main(), XSem_ApiCheckScanCount(), and XSem_CmdNpiGetStatus().

u32 XSemNpiStatus::SlvSkipCnt[MAX_NPI_SLV_SKIP_CNT]

                 Slave Skip Count: Contains the

number of times NPI scan failed to get arbitration for GT/DDRMC descriptor

Referenced by main(), and XSem_CmdNpiGetStatus().

u32 XSemNpiStatus::Status

NPI scan status.

Referenced by main(), and XSem_CmdNpiGetStatus().