Time Interface Guide

The Time platform service interface is provided by the MRtcAdaptation class. The class is defined in the os/devicesrv/sysstatemgmt/systemstatemgr/inc/ssmadaptation.h header file.

+ Interface classes + + + +Class +Description + + + + +MRtcAdaptation +Provides the interface between the Real Time Clock (RTC) and +the upper layers of the operating system. + + +ASIC +Provides an interface to the Application Specific Integrated +Circuit (ASIC) that is being used. + + + +

Time +adaptation functions

The following functions should be implemented +to provide the Time platform service functionality.

+ + + +API +Description + + + + +MRtcAdaptation::ValidateRtc(TDesc8& aValidityPckg, +TRequestStatus aStatus) +Check the real time clock implementation is valid. + + +MRtcAdaptation::SetWakeupAlarm(TDesC8& aAlarmTimePckg, +TRequestStatus& aStat) +Set a device wakeup alarm time in UTC. + + +MRtcAdaptation::UnsetWakeupAlarm(TRequestStatus& +aStatus) +Delete the device wakeup alarm. + + +MRtcAdaptation::Cancel() +Cancel any outstanding request to the real time clock. + + +MRtcAdaptation::Release() +Deletes and release the allocated memory. + + + +

The above function calls will return KErrNotSuported +in an emulator.

ASIC +functions

The functions related to the Time platform service +in the ASIC class.

+ + + +API +Description + + + + +ASIC::SetSystemTimeCalibration() +Set the real time clock by specifying the time calibration +in parts per million. + + +ASIC::SystemTimeInSecondsFrom2000(TInt) +Get the system time in seconds from the year 2000. + + +ASIC::SetSystemTimeInSecondsFrom2000(TInt) +Set the system time to 0 from the start the year 2000. + + + +

The header file for the Time platform service can be found here.