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.