Colony

/*

time.h

*/

#ifndef _TIME_H_

#define _TIME_H_

/*        Predefined times for prescale_opt in time.c.

        To make you own, know that a pulse is 1/16th of a second. You cannot get less than this. To get more, you need

        to know how many 16ths of a second are in the time you want. (Time_desired * 16 = prescaler_opt)

*/

#define SIXTEENTH_SECOND 1

#define EIGTH_SECOND 2

#define QUARTER_SECOND 4

#define HALF_SECOND        8

#define SECOND 16

#define TWO_SECOND 32

#define FOUR_SECOND 64

/*

delay_ms(int ms)

pause_ms(int ms)

sleep_ms(int ms)

pause(int ms)

sleep(int ms)

all have the same behavior

pauses the calling process for the specified

amount of time in milliseconds

*/

void delay_ms(int ms) ;

void pause_ms(int ms);

void pause(int ms);

void sleep_ms(int ms);

void sleep(int ms);

/*

void rtc_init(void)

call this function to initialize the real time clock

real time clock requires global interrupts to be enabled

*/

void rtc_init(int prescale_opt, void (*rtc_func)(void));

/*

void rtc_reset(void)

use this to reset the real time value

rtc_init() should be called beforehand

*/

void rtc_reset(void);

/*

int rtc(void)

returns the current value of the real time clock (in seconds)

rtc_init() should be called beforehand

the returned amount is the number of seconds that have past since the

last call to rtc_init() or rtc_reset()

*/

int rtc(void);

#endif