1.38.20.21 RTC_TIMER32_CALLBACK Typedef

C

typedef void (*RTC_TIMER32_CALLBACK)( RTC_TIMER32_INT_MASK interruptCause, uintptr_t context );

Summary

Defines the data type and function signature of the RTC 32-bit Timer Counter callback function.

Description

This data type defines the function signature of the RTC 32-bit Timer Counter Callback function. The RTC peripheral will call back the client's function with this signature every time when the 32-bit Time Counter related event has occurred. Refer to the description of the RTC_TIMER32_INT_MASK enumeration for possible events. Hardware event flags are cleared when the callback function exits.

The application should register a callback function whose signature (input arguments and return type) must match the signature of this function. The callback function should be registered by calling the RTC_Timer32CallbackRegister() function. The callback function should be registered before starting the timer.

Precondition

The RTC_Initialize() function should have been called to initialize the RTC peripheral. The RTC_Timer32CallbackRegister() function should have been called to register the callback function. The RTC peripheral should have been configured for 32-bit Timer Counter mode in MHC. The RTC peripheral should have been configured for Interrupt mode operation in MHC.

Parameters

Param Description
event The 32-bit Timer Counter event that caused the callback function to be called. Multiple events can be active. The application should check for all events in the callback function
context Allows the caller to provide a context value (usually a pointer to the callers context for multi-instance clients)

Returns

None.

Remarks

This callback if only available when the RTC peripheral is configured for 32-bit Timer Counter operation. The callback function will be execute in an interrupt context. Avoid calling blocking , computationally intensive or interrupt un-safe function from the callback function.