The timer module provides an event interface to the hardware timers.
More...
Detailed Description
The timer module provides an event interface to the hardware timers.
The module uses the 16-bit timer 1 of the ATmega32. The timer is dynamically configured as needed by the registered alarms and should always be clocked as slow as possible to keep the interrupt load low. When no alarms are registered, the timer clock is disabled.
- Note:
- The timer module uses dynamic memory management (malloc/free) for the allocation of the ALARM types.
-
Interrupts must be enabled for the timer to work.
Typedef Documentation
ALARM type This is type of a struct containing information about an alarm.
Type for alarm callback functions.
Alarm callback functions are invoked on the interrupt level whenever the associated alarm expires. The programming model for callback functions is similar to that of interrupt service routines.
Function Documentation
int8_t sb_timer_cancelAlarm |
( |
ALARM * |
alrm |
) |
|
Cancel an alarm.
- Parameters:
-
| alrm | identifier of the alarm that should be canceled |
- Return values:
-
| 0 | success |
| -1 | an error occurred |
- See also:
- sb_timer_setAlarm
int8_t sb_timer_delay |
( |
uint16_t |
waittime |
) |
|
waits for a specific number of ms
This function must not be invoked with interrupts disabled, i.e. from an interrupt handler (or generally, from the ISR level) or a critical section of the application.
The CPU is set in sleep mode while waiting.
- Parameters:
-
- Return values:
-
| 0 | success |
| -1 | alarm could not be activated |
| -2 | sb_timer_delay invoked while interrupts disabled |
- See also:
- sb_timer_delay_abort
void sb_timer_delay_abort |
( |
|
) |
|
Aborts an active sb_timer_delay.
This function must be invoked on the ISR level.
- See also:
- sb_timer_delay
Create a new alarm.
This function can be used to set single shot, as well as repeating timers.
- Single shot: Set cycle to 0. This alarm must not be canceled after being fired.
- Repetitive: The first shot can be adjusted be setting alarmtime > 0. Otherwise cycle is used.
- Parameters:
-
| callback | callback function that will be invoked whenever the alarm expires |
| alarmtime | time in ms relative to the current time when the alarm shall expire the first time. If set to 0 cycle time will be used. |
| cycle | time in ms for alarms that periodically expire after the first regular expiry. Set to 0 for single shot timers. |
- Returns:
- the identifier of the alarm, or NULL if creating the alarm failed.
- Warning:
- Cancelling a timer twice or cancelling a single shot timer after its expiry may cause unexpected results.
- See also:
- sb_timer_cancelAlarm