timer.h

Go to the documentation of this file.

 
#ifndef __LIBDRAGON_TIMER_H
#define __LIBDRAGON_TIMER_H
 
#include <stdint.h>
#include "n64sys.h"
 
typedef void (*timer_callback1_t)(int ovfl);
typedef void (*timer_callback2_t)(int ovfl, void *ctx);
 
typedef struct timer_link
{
    uint32_t left;
    uint32_t set;
    int ovfl;
    int flags;
    union {
        timer_callback1_t callback;
        timer_callback2_t callback_with_context;
    };
    void *ctx;
    struct timer_link *next;
} timer_link_t;
 
#define TF_ONE_SHOT   0
#define TF_CONTINUOUS 1
#define TF_DISABLED 2
 
#define TIMER_TICKS(us) ((int)TIMER_TICKS_LL(us))
#define TIMER_MICROS(tk) ((int)TIMER_MICROS_LL(tk))
 
#define TIMER_TICKS_LL(us) ((long long)(us) * TICKS_PER_SECOND / 1000000)
#define TIMER_MICROS_LL(tk) ((long long)(tk) * 1000000 / TICKS_PER_SECOND)
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* initialize timer subsystem */
void timer_init(void);
/* delete all timers in list */
void timer_close(void);
/* return total ticks since timer was initialized */
long long timer_ticks(void);
 
/* create a new timer and add to list */
timer_link_t *new_timer(int ticks, int flags, timer_callback1_t callback);
/* create a new timer and add to list */
timer_link_t *new_timer_context(int ticks, int flags, timer_callback2_t callback, void *ctx);
 
/* start a timer not currently in the list */
void start_timer(timer_link_t *timer, int ticks, int flags, timer_callback1_t callback);
/* start a timer not currently in the list */
void start_timer_context(timer_link_t *timer, int ticks, int flags, timer_callback2_t callback, void *ctx);
 
/* reset a timer and add to list */
void restart_timer(timer_link_t *timer);
/* remove a timer from the list */
void stop_timer(timer_link_t *timer);
/* remove a timer from the list and delete it */
void delete_timer(timer_link_t *timer);
 
#ifdef __cplusplus
}
#endif
 
#endif