Setup_RTC(7)
This function sets up the Real Time Clock date and time. Note that the 24 hour format must be
used to set the time.
Parameters
Hours Actual Hours in 24h format (0...23)
Minutes Actual Minutes (0...59)
Seconds Actual Seconds (0...59)
Day Actual Day of Month (1...31)
Month Actual Month (1...12)
Year Actual Year (00...99)
DayofWeek Actual Day of Week (SUNDAY...SATURDAY)
Returns
0 = Setup failed
1 = Setup correctly executed
Error Codes
PARAM_RANGE = a parameter is out of range
Examples
If (RTC_Needs_Update = 1)
{
Setup_RTC(14,35,00,6,11,7,MONDAY) ; June 11, 2007 at 2:35pm
}
Hold_RTC(0) and Release_RTC(0)
These functions stop and start the updating of the Date and Time variables. Note that the
internal clock continues to run independent of these functions, only the VCL variables are not
updated after a HOLD_RTC is called. This can be useful when writing the time out to a display
or using them to time stamp a fault into EEPROM, as the time will not tick forward unexpectedly
during the process.
Use the Release_RTC to allow the automatic update of the the correct time and date VCL
variables to continue.
Hold_RTC() will set the RTC_Disabled variable (=1) and Release_RTC() will clear it (=0)
These functions have no parameters, no errors and return nothing.
Examples
Hold_RTC()
Release_RTC()
1310 Vehicle Control System Users Manual Release Rev B Page 38 of 51