The timer management provides functions to start and stop asynchronous timers, determine the CPU speed and let a thread give up the CPU for a specified time period.
Functions | |
void | NutTimerInit (void) |
Initialize system timer. | |
void | NutTimerInsert (NUTTIMERINFO *tn) |
Insert a new timer in the global timer list. | |
void | NutTimerProcessElapsed (void) |
NUTTIMERINFO * | NutTimerCreate (u_long ticks, void(*callback)(HANDLE, void *), void *arg, u_char flags) |
Create a new timer. | |
HANDLE | NutTimerStartTicks (u_long ticks, void(*callback)(HANDLE, void *), void *arg, u_char flags) |
HANDLE | NutTimerStart (u_long ms, void(*callback)(HANDLE, void *), void *arg, u_char flags) |
Create an asynchronous timer. | |
void | NutSleep (u_long ms) |
Temporarily suspends the current thread. | |
void | NutTimerStopAsync (HANDLE handle) |
Asynchronously stop a specified timer. | |
void | NutTimerStop (HANDLE handle) |
Stop a specified timer. | |
u_long | NutGetTickCount (void) |
Return the number of timer ticks. | |
u_long | NutGetSeconds (void) |
Return the seconds counter value. | |
u_long | NutGetMillis (void) |
Return the milliseconds counter value. | |
Variables | |
NUTTIMERINFO *volatile | nutTimerList |
Linked list of all system timers. | |
u_char volatile | nutTimerStopped |
Flag to indicate that a timer was stopped. | |
volatile u_long | nut_ticks |
Pointer to the timer, which is currently processed by the timer interrupt handler. System tick counter. |
|
Initialize system timer. This function is automatically called by Nut/OS during system initialization. It calls the hardware dependent layer to initialze the timer hardware and register a timer interrupt handler. |
|
Create an asynchronous timer. The function returns immediately, while the timer runs asynchronously in the background. The timer counts for a specified number of milliseconds, then calls the callback routine with a given argument. The callback function is executed in interrupt context at a very high priority. It can call only a limited set of functions and must return as soon as possible.
|
|
Temporarily suspends the current thread. Causes the current thread to wait for a specified interval or, if the specified interval is zero, to give up the CPU for another thread with higher or same priority. This function may switch to another application thread, that got the same or a higher priority and is ready to run.
|
|
Asynchronously stop a specified timer. Stops one-shot and periodic timers.
|
|
Stop a specified timer. Only periodic timers need to be stopped. One-shot timers are automatically stopped by the timer management after ther first timer interval. Anyway, long running one-shot timers may be stopped to release the occupied memory.
|
|
Return the number of timer ticks. This function returns the TickCount since the system was started. It is limited to the resolution of the system timer.
|
|
Return the seconds counter value. This function returns the value of a counter, which is incremented every second. During system start, the counter is cleared to zero.
|
|
Return the milliseconds counter value. This function returns the value of a counter, which is incremented every system timer tick. During system start, the counter is cleared to zero and will overflow with the 64 bit tick counter (4294967296). With the default 1024 ticks/s this will happen after 7.9 years. The resolution is also given by the system ticks.
|