X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Fdrv%2Ftimer.h;h=5696823a3e156ce7ef1ceebff01bbecbf2c0b44e;hb=702bedb30a235a64f61f1d06653f8b22e39b5c5f;hp=aaa35dc6732fca49ccce295ead3b98b264f5bf56;hpb=46cacdd7cf98dd977225deceb6ec3f08ef11a81f;p=bertos.git diff --git a/bertos/drv/timer.h b/bertos/drv/timer.h index aaa35dc6..5696823a 100644 --- a/bertos/drv/timer.h +++ b/bertos/drv/timer.h @@ -27,16 +27,19 @@ * the GNU General Public License. * * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/) - * Copyright 2000 Bernie Innocenti - * + * Copyright 2000, 2008 Bernie Innocenti * --> * * \brief Hardware independent timer driver (interface) * * \version $Id$ - * * \author Bernie Innocenti * + * $WIZARD_MODULE = { + * "name" : "timer", + * "depends" : [], + * "configuration" : "bertos/cfg/cfg_timer.h" + * } */ #ifndef DRV_TIMER_H @@ -54,7 +57,8 @@ * Try the CPU specific one for bare-metal environments. */ #if OS_HOSTED - #include OS_HEADER(timer) + //#include OS_HEADER(timer) + #include #else #include CPU_HEADER(timer) #endif @@ -92,12 +96,18 @@ extern volatile ticks_t _clock; * The following code is safe: * * \code + * drop_teabag(); * ticks_t tea_start_time = timer_clock(); * - * boil_water(); - * - * if (timer_clock() - tea_start_time > TEAPOT_DELAY) - * printf("Your tea, Sir.\n"); + * for (;;) + * { + * if (timer_clock() - tea_start_time > TEAPOT_DELAY) + * { + * printf("Your tea, Sir.\n"); + * break; + * } + * patience(); + * } * \endcode * * \note This function must disable interrupts on 8/16bit CPUs because the @@ -229,8 +239,8 @@ INLINE void timer_udelay(utime_t delay) typedef struct Timer { Node link; /**< Link into timers queue */ - ticks_t _delay; /**< Timer delay in ms */ - ticks_t tick; /**< Timer will expire at this tick */ + ticks_t _delay; /**< [ticks] Timer delay */ + ticks_t tick; /**< [ticks] When this timer will expire */ Event expire; /**< Event to execute when the timer expires */ DB(uint16_t magic;) } Timer; @@ -243,14 +253,11 @@ void timer_add(Timer *timer); Timer *timer_abort(Timer *timer); /** Set the timer so that it calls an user hook when it expires */ -INLINE void timer_setSoftInt(Timer *timer, Hook func, iptr_t user_data) +INLINE void timer_setSoftint(Timer *timer, Hook func, iptr_t user_data) { - event_initSoftInt(&timer->expire, func, user_data); + event_initSoftint(&timer->expire, func, user_data); } -// OBSOLETE -#define timer_set_event_softint timer_setSoftInt - /** Set the timer delay (the time before the event will be triggered) */ INLINE void timer_setDelay(Timer *timer, ticks_t delay) { @@ -262,12 +269,13 @@ INLINE void timer_setDelay(Timer *timer, ticks_t delay) #if defined(CONFIG_KERN_SIGNALS) && CONFIG_KERN_SIGNALS /** Set the timer so that it sends a signal when it expires */ -INLINE void timer_set_event_signal(Timer *timer, struct Process *proc, sigmask_t sigs) +INLINE void timer_setSignal(Timer *timer, struct Process *proc, sigmask_t sigs) { event_initSignal(&timer->expire, proc, sigs); } -#endif /* CONFIG_KERN_SIGNALS */ +#define timer_set_event_signal timer_setSignal +#endif /* CONFIG_KERN_SIGNALS */ #endif /* DRV_TIMER_H */