Contiki 2.6
|
Event timers provides a way to generate timed events. More...
Data Structures | |
struct | etimer |
A timer. More... | |
Files | |
file | etimer.c |
Event timer library implementation. | |
file | etimer.h |
Event timer header file. | |
Functions called from application programs | |
void | etimer_set (struct etimer *et, clock_time_t interval) |
Set an event timer. | |
void | etimer_reset (struct etimer *et) |
Reset an event timer with the same interval as was previously set. | |
void | etimer_restart (struct etimer *et) |
Restart an event timer from the current point in time. | |
void | etimer_adjust (struct etimer *et, int td) |
Adjust the expiration time for an event timer. | |
int | etimer_expired (struct etimer *et) |
Check if an event timer has expired. | |
clock_time_t | etimer_expiration_time (struct etimer *et) |
Get the expiration time for the event timer. | |
clock_time_t | etimer_start_time (struct etimer *et) |
Get the start time for the event timer. | |
void | etimer_stop (struct etimer *et) |
Stop a pending event timer. | |
Functions called from timer interrupts, by the system | |
void | etimer_request_poll (void) |
Make the event timer aware that the clock has changed. | |
int | etimer_pending (void) |
Check if there are any non-expired event timers. | |
clock_time_t | etimer_next_expiration_time (void) |
Get next event timer expiration time. |
Event timers provides a way to generate timed events.
An event timer will post an event to the process that set the timer when the event timer expires.
An event timer is declared as a struct
etimer
and all access to the event timer is made by a pointer to the declared event timer.
void etimer_adjust | ( | struct etimer * | et, |
int | td | ||
) |
Adjust the expiration time for an event timer.
et | A pointer to the event timer. |
td | The time difference to adjust the expiration time with. |
This function is used to adjust the time the event timer will expire. It can be used to synchronize periodic timers without the need to restart the timer or change the timer interval.
clock_time_t etimer_expiration_time | ( | struct etimer * | et | ) |
CCIF int etimer_expired | ( | struct etimer * | et | ) |
Check if an event timer has expired.
et | A pointer to the event timer |
This function tests if an event timer has expired and returns true or false depending on its status.
Definition at line 206 of file etimer.c.
Referenced by ctimer_expired(), and PROCESS_THREAD().
clock_time_t etimer_next_expiration_time | ( | void | ) |
Get next event timer expiration time.
This functions returns next expiration time of all pending event timers.
Definition at line 230 of file etimer.c.
References etimer_pending().
Referenced by Java_se_sics_cooja_corecomm_CLASSNAME_tick(), and main().
int etimer_pending | ( | void | ) |
Check if there are any non-expired event timers.
This function checks if there are any active event timers that have not expired.
Definition at line 224 of file etimer.c.
References NULL.
Referenced by etimer_next_expiration_time(), Java_se_sics_cooja_corecomm_CLASSNAME_tick(), and main().
void etimer_request_poll | ( | void | ) |
Make the event timer aware that the clock has changed.
This function is used to inform the event timer module that the system clock has been updated. Typically, this function would be called from the timer interrupt handler when the clock has ticked.
Definition at line 146 of file etimer.c.
References process_poll().
Referenced by Java_se_sics_cooja_corecomm_CLASSNAME_tick(), and main().
CCIF void etimer_reset | ( | struct etimer * | et | ) |
Reset an event timer with the same interval as was previously set.
et | A pointer to the event timer. |
This function resets the event timer with the same interval that was given to the event timer with the etimer_set() function. The start point of the interval is the exact time that the event timer last expired. Therefore, this function will cause the timer to be stable over time, unlike the etimer_restart() function.
Definition at line 185 of file etimer.c.
References timer_reset().
Referenced by ctimer_reset(), and uip_ds6_periodic().
void etimer_restart | ( | struct etimer * | et | ) |
Restart an event timer from the current point in time.
et | A pointer to the event timer. |
This function restarts the event timer with the same interval that was given to the etimer_set() function. The event timer will start at the current time.
Definition at line 192 of file etimer.c.
References timer_restart().
Referenced by ctimer_restart().
CCIF void etimer_set | ( | struct etimer * | et, |
clock_time_t | interval | ||
) |
Set an event timer.
et | A pointer to the event timer |
interval | The interval before the timer expires. |
This function is used to set an event timer for a time sometime in the future. When the event timer expires, the event PROCESS_EVENT_TIMER will be posted to the process that called the etimer_set() function.
Definition at line 178 of file etimer.c.
References timer_set().
Referenced by ctimer_set(), PROCESS_THREAD(), uip_ds6_init(), and uip_ds6_send_rs().
clock_time_t etimer_start_time | ( | struct etimer * | et | ) |
void etimer_stop | ( | struct etimer * | et | ) |
Stop a pending event timer.
et | A pointer to the pending event timer. |
This function stops an event timer that has previously been set with etimer_set() or etimer_reset(). After this function has been called, the event timer will not emit any event when it expires.
Definition at line 236 of file etimer.c.
References NULL.
Referenced by ctimer_stop(), and uip_ds6_send_rs().