background image

Using i!-Schedule

8

 i!-Schedule

Time Protocols

i!-Schedule supports four time protocols to synchronize the NetLinx Master’s clock with and 

Internet timeserver:

 

DayTime (13/udp, 13/tcp)

 

Time (37/udp, 37/tcp) 

 

SNTP (123/udp) 

 

SNTP Broadcast (123/udp). 

Only one of the protocols can be active at a time. 

The DayTime protocol is based on RFC 867 and can provide Day and Time information. While the 

Daytime protocol can provide accurate day and time formation, RFC867 does not specify the actual 

format for the message. This limits the usefulness of the DayTime protocol with one exception: The 

National Institute of Standards and Technology operate a series of Time Servers, known as the 

NIST Internet Time Servers, that provide a DayTime message of fixed format than can be reliably 

parsed and can be used to accurately set the Day and Time of any clock. While these Time Servers 

reside in the US, the Day and Time of the servers is supplied in Universal time Coordinates or 

UTC. The Time Management portion of i!-Schedule is capable of connecting to any of the NIST 

Time servers and calculating the correct time and date for any location in the world. The Time 

Manager also supports the standard NIST server list, a file called nist-srv.lst, and will attempt to 

read this file from doc:\user\time. You may get a copy of this file from the /pub directory on any 

NIST timeserver. If this file cannot be found on the NetLinx file system, a default list of NIST 

servers will be used instead. See the NIST home page at 

http://www.boulder.nist.gov/timefreq/

index.html

 for more information on NIST Time service or Servers.

Additionally, the Time Manager in i!-Schedule has also been written to use a "popular" DayTime 

format which is used by the Linux implementation of DayTime and Tardis, a popular time synching 

software. Although not specified, the Date and Time of this format does not specify the time zone 

and is assumed to be local. If you select DayTime protocol and select a server that is running 

DayTime and the format, specifically "DayOfWeek Month Day HH:MM:SS Year", can be found, 

no time offset will be added. If you have chosen this combination and find that the time does not 

synchronize to the correct time, choose another protocol or server.

The Time protocol, based on RFC868, is a very simple straightforward time protocol providing the 

number of seconds that have transpired since January 1, 1900 UTC. The current Date and time can 

easily be calculated form this value. However, the number of seconds in this protocol is provides as 

a 32 bit unsigned number, which can represent a maximum value of 4294967295 (2 ^ 32). 

4294967295 seconds from January 1st, 1900 occurs on Feb 7, 2036 at 6h 28m 16s. Therefore, this 

protocol can only accurately represent time before this date. Many of the NIST servers, as well and 

many Unix, Linux and Windows programs, can provide this time protocol, and it can be reliably 

used up until Feb 7, 2036.

The last two Time protocols share the same message format but differ in their connection scheme. 

SNTP stands for Simple Network Time Protocol, a subset of NTP or Network Time Protocol, is 

based on RFC2030. It is a highly accurate measure of time and date and also measures Date and 

Time as the number of seconds from January 1st 1900. However, the number of seconds is provided 

in two parts: the number of whole seconds, with a range of 4294967295 (2^32) and fractions of a 

second also with a range of 4294967295 (2^32). The Netlinx master is not able to take advantage of 

Summary of Contents for I!-SCHEDULE

Page 1: ...instruction manual integration Solutions i Schedule...

Page 2: ...any accompanying hardware This limited warranty gives you specific legal rights You may have others which vary from state country to state country NO LIABILITY FOR CONSEQUENTIAL DAMAGES In no event sh...

Page 3: ...ing Systems 1 Minimum PC Requirements 1 Installing i Schedule 2 Using i Schedule 3 Dynamic Events 4 Schedule Persistence 7 Time Protocols 8 Programming i Schedule 11 Channels 11 Levels 11 Send_Command...

Page 4: ...ii i Schedule Table of Contents...

Page 5: ...ace where the user can edit the scheduling of events Use this module if you want a user interface for scheduling You do not need to include the i ScheduleEngineMod if you use this module Supported Ope...

Page 6: ...xt to proceed 4 In the i Schedule Select Components dialog select which example programs you would like to install 5 In the Select i Schedule Install Location dialog use the Browse button to navigate...

Page 7: ...uld write code that responds to the pushes turning the lights on and then off Let s use relays for lighting control to simplify the example BUTTON_EVENT TP 1 Outdoor Lights On PUSH ON RELAY 1 BUTTON_E...

Page 8: ...ddition to specifying the name of an event you can also program the date and time when the event should occur The scheduled virtual device supports a variety of commands to set and query the values of...

Page 9: ...ecord RELEASE Switch nVCRNumber Case 1 dvVCRDev dvVCR1 Case 2 dvVCRDev dvVCR2 Case 3 dvVCRDev dvVCR3 Case 4 dvVCRDev dvVCR4 Case 5 dvVCRDev dvVCR5 Send_Command dvVCRDev SP 2 Stop Easy right If we have...

Page 10: ...ll probably have an OK and Cancel button The Cancel would simply return them to the scheduling edit page while the OK button would return them to the scheduling edit page and update the parameters You...

Page 11: ...doc user schedule directory All event information is stored in this file and recalled during power up Any event scheduled by the user is stored during a power cycle and will not be lost This file is...

Page 12: ...ule has also been written to use a popular DayTime format which is used by the Linux implementation of DayTime and Tardis a popular time synching software Although not specified the Date and Time of t...

Page 13: ...your Network administrator It is probable that your network already provides some form of Date and Time information and that information is probably obtained from a highly accurate source Most instal...

Page 14: ...Using i Schedule 10 i Schedule...

Page 15: ...annel Status 241 Sunrise occurred Push only 242 Sunset occurred Push only 243 Daylight savings status Push when active and release when not active with Channel Status 244 Time changed by time sever up...

Page 16: ...ts the string parameter for event number If no string is supplied parameter is deleted GET SPARAM Event Number Param Number Gets the string parameters for event number If the parameter number is 0 all...

Page 17: ...Weekly SMTWTFS or xMultiplier Monthly Day 1 31 xMultiplier Monthly First Second Third Fourth Last Sun Mon Tue Wed Thu Fri Sat xMultiplier Yearly Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec Day 1...

Page 18: ...Sch is a unique module name i Schedule Strings String Description ETIME Event Number Time String End Time String for event number DATE Event Number Date String Date String for event number PARAM Param...

Page 19: ...ST rules So to handle the case you specify E sT Eastern time zone C sT Central time zone M sT Mountain time zone P sT Pacific time zone For description in DTS time rules you use Standard Description S...

Page 20: ...FF Mar LastSun 03 00 00 00 00 00 X Here is the example configuration for London England which uses GMT and observes Daylight savings starting on the last Sunday in March at 1 00 AM jump ahead 1 hour a...

Page 21: ...nvtSchEventList nvtSchEventInfo nvtSchEngineList nvtSchEngineInfo nvtSchEngineStats nvtSchEngineListSel nvtSchTimeSelect nvtSchDateSelect nvtSchDetailSelect strTmTzName strTmTzDesc dTmTzGmtOffset strT...

Page 22: ...unrise Start time Before Sunset Start Time After Sunrise Start time After Sunset Start Time Hour Start time Minute Start Time AM PM End time None End time Fixed End time Sunrise End time Sunset End ti...

Page 23: ...tSel An INTEGER array with the following variable text channels Number of Past Events Number of Current Events Number of Future Events nvtSchTimeSelect An INTEGER array with the following variable tex...

Page 24: ...rules So to handle the case you specify E sT Eastern time zone C sT Central time zone M sT Mountain time zone P sT Pacific time zone For description in DTS time rules you use Standard Description S Da...

Page 25: ...tSun 03 00 00 00 00 00 X Here is the example configuration for London England which uses GMT and observes Daylight savings starting on the last Sunday in March at 1 00 AM jump ahead 1 hour and the Las...

Page 26: ...ve richardson TX 75082 USA 469 624 8000 800 222 0193 fax 469 624 7153 technical support 800 932 6993 033 004 2598 2 05 2005 AMX Corporation All rights reserved AMX the AMX logo the building icon the h...

Reviews: