11 real time clock, 1 overview of the real time clock xml file, Real-time clock -1 – Echelon i.LON SmartServer 2.0 User Manual
Page 167: Overview of the real-time clock xml file -1, 11 real-time clock, Overview of the real-time clock xml file
i.LON SmartServer 2.0 Programmer’s Reference
11-1
11
Real-Time Clock
You can use the real-time clock on the SmartServer to schedule events to start or stop based on the
calculated sundown or sunrise, or a configured amount of time before or after the sundown or sunrise.
The real-time clock includes an astronomical position sensor that calculates the position of the sun
based on the time-of-day stored on the SmartServer and the location (geographic coordinates) of the
SmartServer, which you specify. Based on the calculated position of the sun, the real-time clock can
determine the sunrise and sundown times and pass this information to the Schedulers on the
SmartServer.
11.1
Overview of the Real-Time Clock XML File
The #8000010128000000[4].UFPTrealTimeClock.xml file stores the configuration of the real-time
clock on the SmartServer. You can create multiple real-time clocks; however, the SmartServer
supports only 1 active real-time clock at a time. The following represents a sample
#8000010128000000[4].UFPTrealTimeClock.xml file for a SmartServer:
<Item xsi:type="UFPTrealTimeClock_Cfg" >
<UCPTname>Net/LON/iLON App/Real Time Clock</UCPTname>
<UCPTannotation>#8000010128000000[4].UFPTrealTimeClock;xsi:type=“LON_Fb_Cfg”</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-03-07T14:21:09.390-08:00</UCPTlastUpdate>
<UCPTuri>#8000010128000000[4].UFPTrealTimeClock_Cfg.htm</UCPTuri>
<DataPoint dpType="nvoTimeDate" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoRtTimeDate</UCPTname>
</DataPoint>
<DataPoint dpType="nviTimeSet" discrim="dir_in" >
<UCPTname>Net/LON/iLON
App/Node
Object/nviTimeSet</UCPTname>
</DataPoint>
<DataPoint dpType="nciMasterSlave" discrim="dir_in" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nciRtMasterSlave</UCPTname>
</DataPoint>
<DataPoint dpType="nciUpdateRate" discrim="dir_in" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nciRtUpdateRate</UCPTname>
</DataPoint>
<DataPoint dpType="nvoSummerTime" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoRtSummerTime</UCPTname>
</DataPoint>
<DataPoint dpType="nvoWinterTime" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoRtWinterTime</UCPTname>
</DataPoint>
<DataPoint dpType="nviTimeZone" discrim="dir_in" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nviRtTimeZone</UCPTname>
</DataPoint>
<DataPoint dpType="Elevation" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoElevation</UCPTname>
</DataPoint>
<DataPoint dpType="Azimuth" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoAzimuth</UCPTname>
</DataPoint>
<DataPoint dpType="Sunrise" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoSunrise</UCPTname>
</DataPoint>
<DataPoint dpType="Sunset" discrim="dir_out" >
<UCPTname>Net/LON/iLON App/Real Time Clock/nvoSunset</UCPTname>
</DataPoint>
<UCPTdegLongitude>-121.913</UCPTdegLongitude>
<UCPTdegLatitude>37.3182</UCPTdegLatitude>
</Item>
11.2
Creating and Modifying the Real-Time Clock XML File
You can create and manage the #8000010128000000[4].UFPTrealTimeClock.xml file with the Set
SOAP function. The following section, Real-Time Clock SOAP Interface, describes how to use Set
and the other SOAP functions provided for the real-time clock application.