SDL API Guide for J721E

Introduction

Functions

int32_t SDL_LBIST_selfTest (SDL_LBIST_inst instance, SDL_LBIST_testType testType, bool *pResult)
 LBIST self test. More...
 
int32_t SDL_LBIST_getPOSTStatus (SDL_LBIST_postResult *pResult)
 LBIST POST result status. More...
 

Function Documentation

◆ SDL_LBIST_selfTest()

int32_t SDL_LBIST_selfTest ( SDL_LBIST_inst  instance,
SDL_LBIST_testType  testType,
bool *  pResult 
)

LBIST self test.

This function executes an LBIST self test of the specified type for a specific LBIST instance. The test types supported are defined in SDL_LBIST_testType. LBIST is a feature that is used for self test of the logic circuitry in the SoC. Multiple instances may be supported. Note: The LBIST test is destructive to the cores/IP which are being tested. Therefore it should be executed from a different core than the one under test. It is important to note that execution of LBIST self-tests require preparation of the IPS under test by bringing them to a certain power and reset state before executing the test. The application must take care of this sequence before executing the self-test. The SDL examples give a reference for the necessary sequences. The LBIST instances supported are specific to the SoC, and are defined in the soc-specific header file.

Parameters
instance[IN] LBIST instance
testType[IN] LBIST test type to run.
pResult[OUT] Pointer to variable to indicate result
Returns
The SDL error code for the API. If pResult is NULL: SDL_EBADARGS If testType is invalid: SDL_EBADARGS If other error happened: SDL_EFAIL Success: SDL_PASS

◆ SDL_LBIST_getPOSTStatus()

int32_t SDL_LBIST_getPOSTStatus ( SDL_LBIST_postResult pResult)

LBIST POST result status.

This function retrieves the status of the LBIST POST test(s) for all the supported LBIST instances which have POST support on the device. LBIST is a feature that is used for self test of the logic circuitry in the SoC. Multiple instances may be supported.

If supported, HW POST may execute for one or more instances. This function will check if the test was executed, and if it was executed, what was the result of the test.

See the definition of SDL_LBIST_postResult for more information.

Parameters
pResult[OUT] Pointer to variable to indicate the result