AM263x MCU+ SDK  08.05.00

Introduction

This module contains the APIs to program and use the CCM module.

Files

file  sdl_ip_ccm.h
 Header file contains enumerations, structure definitions and function declarations for SDL CCM interface.
 

Data Structures

struct  SDL_CCM_staticRegs
 CCM Static Register. More...
 
struct  SDL_CCM_ErrorStatus_t
 Structure for CCM error status. More...
 

Functions

int32_t SDL_CCM_init (SDL_CCM_Inst instance)
 Initialization API for CCM module. More...
 
int32_t SDL_CCM_verifyConfig (SDL_CCM_Inst instance)
 Verifies the configuration done as part of SDL_CCM_init is as expected. More...
 
int32_t SDL_CCM_selfTest (SDL_CCM_Inst instance, SDL_CCM_MonitorType monitorType, SDL_CCM_SelfTestType testType, uint32_t polarityInversionMask, uint32_t timeoutCnt)
 Executes a self-test of the CCM module. The types of self-tests supported are described in detail in SDL_CCM_SelfTestType. More...
 
int32_t SDL_CCM_injectError (SDL_CCM_Inst instance, SDL_CCM_MonitorType monitorType)
 Forces an error to be generated for the selected monitor type. After injecting the error, an ESM error event is generated and the application will receive notification via ESM application callback. More...
 
int32_t SDL_CCM_getStaticRegisters (SDL_CCM_Inst instance, SDL_CCM_staticRegs *pStaticRegs)
 Retrieves the static register configuration. The values returned in staticRegs can be saved by the application and periodically checked for changes. Note: This API should not be called while running any self-test or during error injection, as this will change the values of the static registers temporarily. It should be called only when in normal operating mode. More...
 
int32_t SDL_CCM_getErrorType (SDL_CCM_Inst instance, uint32_t intSrc, SDL_CCM_MonitorType *monitorType)
 Gets the monitor type for which the CCM error was generated. Takes the ESM interrupt source as input. More...
 
int32_t SDL_CCM_clearError (SDL_CCM_Inst instance, SDL_CCM_MonitorType monitorType)
 Clears the compare error for the selected monitor type. More...
 

Enumerations

enum  SDL_CCM_MonitorType {
  SDL_CCM_MONITOR_TYPE_NONE = 0, SDL_CCM_MONITOR_TYPE_OUTPUT_COMPARE_BLOCK = 1, SDL_CCM_MONITOR_TYPE_VIM = 2, SDL_CCM_MONITOR_TYPE_INACTIVITY_MONITOR = 3,
  SDL_CCM_MONITOR_TYPE_INVALID = 4
}
 This enumerator defines the type of CCM Monitor type. More...
 
enum  SDL_CCM_SelfTestType { SDL_CCM_SELFTEST_TYPE_NORMAL = 1, SDL_CCM_SELFTEST_TYPE_ERROR_FORCING = 2, SDL_CCM_SELFTEST_POLARITY_INVERSION = 3, SDL_CCM_SELFTEST_TYPE_INVALID = 4 }
 This enumerator defines the type of CCM Self-test type. More...
 

Enumeration Type Documentation

◆ SDL_CCM_MonitorType

This enumerator defines the type of CCM Monitor type.

Enumerator
SDL_CCM_MONITOR_TYPE_NONE 

CCM Monitor None

SDL_CCM_MONITOR_TYPE_OUTPUT_COMPARE_BLOCK 

CCM output compare block monitor type

SDL_CCM_MONITOR_TYPE_VIM 

CCM VIM block monitor type

SDL_CCM_MONITOR_TYPE_INACTIVITY_MONITOR 

CCM inacitivty monitor type

SDL_CCM_MONITOR_TYPE_INVALID 

CCM invalid type

◆ SDL_CCM_SelfTestType

This enumerator defines the type of CCM Self-test type.

Enumerator
SDL_CCM_SELFTEST_TYPE_NORMAL 

Self-test for a particular monitor type

SDL_CCM_SELFTEST_TYPE_ERROR_FORCING 

Error-forcing self-test for a particular monitor type

SDL_CCM_SELFTEST_POLARITY_INVERSION 

Polarity inversion self-test for a particular monitor type

SDL_CCM_SELFTEST_TYPE_INVALID 

CCM invalid type

Function Documentation

◆ SDL_CCM_init()

int32_t SDL_CCM_init ( SDL_CCM_Inst  instance)

Initialization API for CCM module.

Parameters
instance[IN] CCM Instance
Returns
The SDL error code for the API SDL_PASS : Success; SDL_EFAIL : if error happened during initialization

◆ SDL_CCM_verifyConfig()

int32_t SDL_CCM_verifyConfig ( SDL_CCM_Inst  instance)

Verifies the configuration done as part of SDL_CCM_init is as expected.

Parameters
instance[IN] CCM Instance
Returns
The SDL error code for the API SDL_PASS : Success; SDL_EFAIL : Verification failed

◆ SDL_CCM_selfTest()

int32_t SDL_CCM_selfTest ( SDL_CCM_Inst  instance,
SDL_CCM_MonitorType  monitorType,
SDL_CCM_SelfTestType  testType,
uint32_t  polarityInversionMask,
uint32_t  timeoutCnt 
)

Executes a self-test of the CCM module. The types of self-tests supported are described in detail in SDL_CCM_SelfTestType.

Parameters
instance[IN] CCM Instance
monitorType[IN] Monitor type for which to run the self-test
testType[IN] Test type to run for the selected monitor type.
polarityInversionMask[IN] Mask used to invert polarity of selected signals. For meaning of signals, refer to hardware manuals. This parameter is used only for the polarity inversion self-test type
timeoutCnt[IN] Number of times to check for self-test completion in a loop before timing out
Returns
The SDL error code for the API SDL_PASS : Self-test passed SDL_EBADARGS : Returned if input paramter is invalid SDL_EFAIL : Self-test failed

◆ SDL_CCM_injectError()

int32_t SDL_CCM_injectError ( SDL_CCM_Inst  instance,
SDL_CCM_MonitorType  monitorType 
)

Forces an error to be generated for the selected monitor type. After injecting the error, an ESM error event is generated and the application will receive notification via ESM application callback.

Parameters
instance[IN] CCM Instance
monitorType[IN] Monitor type for which to inject the error
Returns
The SDL error code for the API SDL_PASS : Error injection passed SDL_EBADARGS : Returned if input paramter is invalid SDL_EFAIL : Error injection failed

◆ SDL_CCM_getStaticRegisters()

int32_t SDL_CCM_getStaticRegisters ( SDL_CCM_Inst  instance,
SDL_CCM_staticRegs pStaticRegs 
)

Retrieves the static register configuration. The values returned in staticRegs can be saved by the application and periodically checked for changes. Note: This API should not be called while running any self-test or during error injection, as this will change the values of the static registers temporarily. It should be called only when in normal operating mode.

Parameters
instance[IN] CCM Instance
pStaticRegs[OUT] Pointer to the variable to store the static register information
Returns
The SDL error code for the API SDL_PASS : Static registers successfully read SDL_EBADARGS : Invalid pointer passed

◆ SDL_CCM_getErrorType()

int32_t SDL_CCM_getErrorType ( SDL_CCM_Inst  instance,
uint32_t  intSrc,
SDL_CCM_MonitorType monitorType 
)

Gets the monitor type for which the CCM error was generated. Takes the ESM interrupt source as input.

Parameters
instance[IN] CCM Instance
intSrc[IN] ESM interrupt source used to check for monitorType that generated the error
monitorType[OUT] Monitor type which generated the error
Returns
The SDL error code for the API SDL_PASS : Monitor type retrieved SDL_EBADARGS : Invalid parameter

◆ SDL_CCM_clearError()

int32_t SDL_CCM_clearError ( SDL_CCM_Inst  instance,
SDL_CCM_MonitorType  monitorType 
)

Clears the compare error for the selected monitor type.

Parameters
instance[IN] CCM Instance
monitorType[IN] Monitor type for which to clear the error
Returns
The SDL error code for the API SDL_PASS : Event cleared SDL_EBADARGS : Invalid parameter SDL_EFAIL : Failed to clear the error