background image

Programming i!-TimeManager

9

i!-TimeManager

Channels

i!-TimeManager uses a virtual device to post channel events for certain time related activities. 

i!-TimeManager supports the following channels:

Commands

i!-TimeManager supports the following commands. 

i!-TimeManagerEngineMod Module Definitions (Cont.)

dTmLocLong and 

dTmLocLat

A double containing the longitude and latitude coordinates of the location where the 
system is installed. Longitude is in Degrees (Fraction of Degrees). West longitudes 
must be negative. Latitude is in Degrees (Fraction of Degrees). South latitudes must be 
negative.

These parameters are used for calculating sunrise and sunset times. You can find 
longitude / latitude values and descriptions at:

• http://geography.about.com/cs/latitudelongitude/

• http://www.census.gov/cgi-bin/gazetteer

• http://www.njdxa.org/landl-lookup-dx.shtml

nTmTsProtocol

A time server protocol number to allow the Netlinx system to synchronous its clock with 
an Internet time server. The available values are:

• 0  =  Disabled

• 1 = DayTime(13/udp, 13/tcp)

• 2 = Time(37/udp, 37/tcp)

• 3 = SNTP(123/udp)

• 4 = SNTP Broadcast (123/udp). 

nTmTsCheck_Time

The time in minutes between time checks to the Internet time server. You can put 0 to 
use the default value of 120 (2 hours).

strTmTsServer

The IP address or Host Name of the preferred Internet time server. If left blank (empty 
string), a default server will be picked from the nist-srv.lst file location in the doc:\time 
directory of the NetLinx Master. If this file is not present, an internal list of NIST time 
server will be used, and an appropriate server will be selected from the list.

i!-TimeManager Channels

Channel

Description

1

Sunrise Occurred

2

Sunset Occurred

3

Daylight Saving Time is active.

4

Time changed by Internet time server.

i!-TimeManager Strings

Syntax

Description

"'RESET'"

Resets the time zone and timeserver information.

"'VERSION'"

Sends version information to Master debug port (Master messaging).

Summary of Contents for I!-TIMEMANAGER

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

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: ...rted Operating Systems 1 Minimum PC Requirements 1 Installing i TimeManager 2 Time Protocols 3 DayTime Protocol 3 Time Protocol 4 SNTP Protocols 4 Choosing a Protocol 4 Programming i TimeManager 7 i T...

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

Page 5: ...ws NT 4 0 Workstation or Server service pack 6 B or greater with at least 64 MB of installed memory Windows 2000 Professional or Server running on a Pentium 266 MHZ processor minimum requirement 300 M...

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

Page 7: ...the NIST Time servers and calculating the correct time and date for any location in the world i Time Manager also supports the standard NIST server list a file called nist srv lst and will attempt to...

Page 8: ...ter Feb 7 2036 SNTP message can represent a Date and Time accurately until some time in the year 2104 Most of the NIST servers also provide Date and Time information in SNTP format The difference betw...

Page 9: ...nchronize the NetLinx Master s time with the servers at NIST It would be a good idea to setup the DNS server entries on the NetLinx Master but not required If the name lookup fails for a given server...

Page 10: ...Time Protocols 6 i TimeManager...

Page 11: ...Mod Module definition code is displayed below You can use this as a start to create custom programming or use it as is for the standard functionality Where mdlTm is a unique module name DEFINE_MODULE...

Page 12: ...stern 5 Center 6 Mountain 7 Pacific 8 Locations such as Newfoundland which runs 3 hours 30 minutes behind GMT would use a GMT offset of 3 5 This information is used for calculating sunrise and sunset...

Page 13: ...ime server protocol number to allow the Netlinx system to synchronous its clock with an Internet time server The available values are 0 Disabled 1 DayTime 13 udp 13 tcp 2 Time 37 udp 37 tcp 3 SNTP 123...

Page 14: ...r 10 i TimeManager Strings i TimeManager supports the following in bound strings device to Master i TimeManager Strings Syntax Description SUNRISE Sunrise Time Sunrise time for today SUNSET Sunset Tim...

Page 15: ...Programming i TimeManager 11 i TimeManager...

Page 16: ...ve richardson TX 75082 USA 469 624 8000 800 222 0193 fax 469 624 7153 technical support 800 932 6993 033 004 2612 4 03 2003 AMX Corporation All rights reserved AMX the AMX logo the building icon the h...

Reviews: