ref/timer_8h_source.html

#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


void timer_init(void);


void timer_close(void);


long long timer_ticks(void);


timer_link_t *new_timer(int ticks, int flags, timer_callback1_t callback);


timer_link_t *new_timer_context(int ticks, int flags, timer_callback2_t callback, void *ctx);


void start_timer(timer_link_t *timer, int ticks, int flags, timer_callback1_t callback);


void start_timer_context(timer_link_t *timer, int ticks, int flags, timer_callback2_t callback, void *ctx);


void restart_timer(timer_link_t *timer);


void stop_timer(timer_link_t *timer);


void delete_timer(timer_link_t *timer);


#ifdef __cplusplus

}

#endif


#endif

timer_link_t::flags
int flags
Timer flags. See TF_ONE_SHOT, TF_CONTINUOUS, and TF_DISABLED.
Definition timer.h:58

timer_link_t::ovfl
int ovfl
To correct for drift.
Definition timer.h:56

timer_link_t::left
uint32_t left
Absolute ticks value at which the timer expires.
Definition timer.h:52

timer_link_t::set
uint32_t set
Ticks to set if continuous.
Definition timer.h:54

timer_link_t::ctx
void * ctx
Callback context parameter.
Definition timer.h:65

timer_link_t::next
struct timer_link * next
Link to next timer.
Definition timer.h:67

timer_callback1_t
void(* timer_callback1_t)(int ovfl)
Timer callback function without context.
Definition timer.h:42

timer_callback2_t
void(* timer_callback2_t)(int ovfl, void *ctx)
Timer callback function with context.
Definition timer.h:44

timer_link_t
Timer structure.
Definition timer.h:50

n64sys.h
N64 System Interface.

start_timer
void start_timer(timer_link_t *timer, int ticks, int flags, timer_callback1_t callback)
Start a timer (not currently in the list)
Definition timer.c:242

timer_close
void timer_close(void)
Free and close the timer subsystem.
Definition timer.c:355

new_timer
timer_link_t * new_timer(int ticks, int flags, timer_callback1_t callback)
Create a new timer and add to list.
Definition timer.c:186

new_timer_context
timer_link_t * new_timer_context(int ticks, int flags, timer_callback2_t callback, void *ctx)
Create a new timer with context and add to list.
Definition timer.c:214

timer_init
void timer_init(void)
Initialize the timer subsystem.
Definition timer.c:172

stop_timer
void stop_timer(timer_link_t *timer)
Stop a timer and remove it from the list.
Definition timer.c:313

delete_timer
void delete_timer(timer_link_t *timer)
Remove a timer from the list and delete it.
Definition timer.c:345

start_timer_context
void start_timer_context(timer_link_t *timer, int ticks, int flags, timer_callback2_t callback, void *ctx)
Start a timer (not currently in the list) with context.
Definition timer.c:268

timer_ticks
long long timer_ticks(void)
Return total ticks since timer was initialized, as a 64-bit counter.
Definition timer.c:390

restart_timer
void restart_timer(timer_link_t *timer)
Reset a timer and add to list.
Definition timer.c:294