Timer

group group_abstraction_rtos_timer

APIs for creating and working with Timers.

Unnamed Group

cy_rslt_t cy_rtos_init_timer(cy_timer_t *timer, cy_timer_trigger_type_t type, cy_timer_callback_t fun, cy_timer_callback_arg_t arg)

Create a new timer.

This function initializes a timer object.

note

The timer is not active until start is called.

note

The callback may be (likely will be) called from a different thread.

Parameters

  • timer – [out] Pointer to the timer handle to initialize

  • type – [in] Type of timer (periodic or once)

  • fun – [in] The function

  • arg – [in] Argument to pass along to the callback function

Returns

The status of the creation request. [CY_RSLT_SUCCESS, CY_RTOS_GENERAL_ERROR]

cy_rslt_t cy_rtos_start_timer(cy_timer_t *timer, cy_time_t num_ms)

Start a timer.

Parameters

  • timer – [in] Pointer to the timer handle

  • num_ms – [in] The number of milliseconds to wait before the timer fires

Returns

The status of the creation request. [CY_RSLT_SUCCESS, CY_RTOS_GENERAL_ERROR]

cy_rslt_t cy_rtos_stop_timer(cy_timer_t *timer)

Stop a timer.

Parameters

timer – [in] Pointer to the timer handle

Returns

The status of the creation request. [CY_RSLT_SUCCESS, CY_RTOS_GENERAL_ERROR]

cy_rslt_t cy_rtos_is_running_timer(cy_timer_t *timer, bool *state)

Returns state of a timer.

Parameters

  • timer – [in] Pointer to the timer handle

  • state – [out] Return value for state, true if running, false otherwise

Returns

The status of the creation request. [CY_RSLT_SUCCESS, CY_RTOS_GENERAL_ERROR]

cy_rslt_t cy_rtos_deinit_timer(cy_timer_t *timer)

Deinit the timer.

This function deinitializes the timer and frees all consumed resources.

Parameters

timer – [in] Pointer to the timer handle

Returns

The status of the creation request. [CY_RSLT_SUCCESS, CY_RTOS_GENERAL_ERROR]

Typedefs

typedef void (*cy_timer_callback_t)(cy_timer_callback_arg_t arg)

The callback function to be called by a timer.

Enums

enum cy_timer_trigger_type_t

cy_timer_trigger_type_t: The type of timer.

Values:

enumerator CY_TIMER_TYPE_PERIODIC

called periodically until stopped

enumerator CY_TIMER_TYPE_ONCE

called once only

enumerator cy_timer_type_periodic

Deprecated:

replaced by CY_TIMER_TYPE_PERIODIC

enumerator cy_timer_type_once

Deprecated:

replaced by CY_TIMER_TYPE_ONCE