xsem_npi_example.c File Reference

Overview

This file has XilSEM NPI SHA error injection example.

MODIFICATION HISTORY:

Ver   Who   Date        Changes



0.1   rb    03/16/2021  Initial Creation
0.2   hb    07/20/2021  Added event notification and restructured code
0.3   hb    09/20/2021  Added description on error injection &
                        correction
0.4   hb    01/06/2022  Added feature to print golden SHA values
0.5   hb    01/27/2022  Added event for NPI scan self diagnosis
0.6   hb    07/28/2022  Updated example with descriptor attribute
                        interpretation
0.7   gayu  05/19/2023  Added Test print summary and updated copyright
                        information
0.8   anv   10/18/2023  Added macro protection to Enable Error Injection
                        Feature usage and Updated to get
                        XilSEM NPI status prints
0.9   gayu  01/18/2024  Removed false else condition in main function
                        for XSem_CmdNpiGetStatus API as this is not a
                        valid case for deferred start-up.

Functions
int	main (void)
	The purpose of this function is to illustrate the usage of client APIs for NPI scan over IPI. More...

Function Documentation

int main

(

void

)

The purpose of this function is to illustrate the usage of client APIs for NPI scan over IPI.

Returns

• XST_SUCCESS - on successful execution of injection and detection of error
• XST_FAILURE - on failure

Note

Npi example always injects error in the golden SHA of the first descriptor. The injected SHA error can be corrected by executing the error injection sequence again. Real SHA errors are uncorrectable.

References CMD_ACK_NPI_ERRINJECT, CMD_ACK_NPI_GET_GLDN_SHA, CMD_ACK_NPI_STARTSCAN, CMD_ACK_NPI_STOPSCAN, XSem_DescriptorData::DescriptorCount, XSemNpiStatus::ErrInfo, XSemNpiStatus::HbCnt, MAX_NPI_ERR_INFO_CNT, MAX_NPI_SLV_SKIP_CNT, XSemIpiResp::RespMsg1, XSemIpiResp::RespMsg2, XSemNpiStatus::ScanCnt, XSemNpiStatus::SlvSkipCnt, XSemNpiStatus::Status, XSem_ApiCheckScanCount(), XSem_CmdNpiGetGldnSha(), XSem_CmdNpiGetStatus(), XSem_CmdNpiInjectError(), XSem_CmdNpiStartScan(), XSem_CmdNpiStopScan(), and XSem_NpiEventRegisterNotifier().