*********************************************************************************************************
* FORMAT CURRENT TIME INTO STRING
*
* Description : Formats the current time into an ASCII string.
* Arguments : mode is the format type:
* 1 will format the time as "HH:MM:SS" (24 Hour format)
* (needs at least 9 characters)
* 2 will format the time as "HH:MM:SS AM" (With AM/PM indication)
* (needs at least 13 characters)
* s is a pointer to the destination string. The destination string must be large
* enough to hold the formatted time.
* contain
* Returns : None.
* Notes : - A 'switch' statement has been used to allow you to add your own time formats.
* - This function assumes that strcpy() is reentrant.
*********************************************************************************************************
*/
void Clk_format_time (UCHAR mode, char *s)
{
UCHAR hr;
switch (mode)
{
case 1:
strcpy(s, "HH:MM:SS"); /* Create the template for the selected format */
s[0] = ClkHr / 10 + '0'; /* Convert TIME to ASCII */
s[1] = ClkHr % 10 + '0';
s[3] = ClkMin / 10 + '0';
s[4] = ClkMin % 10 + '0';
s[6] = ClkSec / 10 + '0';
s[7] = ClkSec % 10 + '0';
break;

case 2:
strcpy(s, "HH:MM:SS AM"); /* Create the template for the selected format */
s[9] = (ClkHr >= 12) ? 'P' : 'A'; /* Set AM or PM indicator */
if (ClkHr > 12)
{ /* Adjust time to be displayed */
hr = ClkHr - 12;
}
else
{
hr = ClkHr;
}
s[0] = hr / 10 + '0'; /* Convert TIME to ASCII */
s[1] = hr % 10 + '0';
s[3] = ClkMin / 10 + '0';
s[4] = ClkMin % 10 + '0';
s[6] = ClkSec / 10 + '0';
s[7] = ClkSec % 10 + '0';
break;

default:
strcpy(s, "?");
break;
}
}
/*
*********************************************************************************************************
* UPDATE THE TIME
*
* Description : This function is called to update the time (i.e. hours, minutes and seconds)
* Arguments : None.
* Returns : TRUE if we have completed one day.
* FALSE otherwise
* Notes : This function updates ClkSec, ClkMin and ClkHr.
*********************************************************************************************************
*/
static BOOL ClkUpdateTime (void)
{
BOOL newday;

newday = FALSE; /* Assume that we haven't completed one whole day yet */
if (ClkSec >= 59)
{ /* See if we have completed one minute yet */
ClkSec = 0; /* Yes, clear seconds */
if (ClkMin >= 59)
{ /* See if we have completed one hour yet */
ClkMin = 0; /* Yes, clear minutes */
if (ClkHr >= 23)
{ /* See if we have completed one day yet */
ClkHr = 0; /* Yes, clear hours ... */
newday = TRUE; /* ... change flag to indicate we have a new day */
}
else
{
ClkHr++; /* No, increment hours */
}
}
else
{
ClkMin++; /* No, increment minutes */
}
}
else
{
ClkSec++; /* No, increment seconds */
}
return (newday);
}
/*
*********************************************************************************************************
* SET TIME ONLY
*
* Description : Set the time-of-day clock
* Arguments : hr is the desired hour (0..23)
* min is the desired minutes (0..59)
* sec is the desired seconds (0..59)
* Returns : None.
* Notes : It is assumed that you are specifying a correct time (i.e. there is no range checking
* done by this function).
*********************************************************************************************************
*/
void Clk_set_time (UCHAR hr, UCHAR min, UCHAR sec)
{
ENTER_CRITICAL(); /* Gain exclusive access to time-of-day clock */
ClkHr = hr;
ClkMin = min;
ClkSec = sec;
EXIT_CRITICAL(); /* Release access to time-of-day clock */
}
/*