User manual AMX I!-SCHEDULE

[. . . ] S o l u t i o n s Software Limited Agreement LIMITED WARRANTY LIMITED WARRANTY. AMX Corporation warrants that the SOFTWARE will perform substantially in accordance with the accompanying written materials for a period of ninety (90) days from the date of receipt. Any implied warranties on the SOFTWARE and hardware are limited to ninety (90) days and one (1) year, respectively. Some states/countries do not allow limitations on duration of an implied warranty, so the above limitation may not apply to you. [. . . ] 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. 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). [. . . ] If this file is not present, an internal list of NIST time servers are used and an appropriate server is selected from the list. 16 i!-Schedule Programming i!-Schedule i!-ScheduleMod Module To assist you in your programming the i!-ScheduleMod 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. DEFINE_MODULE 'i!-ScheduleMod' mdlSch(vdvSchEvents, nvTmTimeSync, nvTP, nchSchEventList, nchSchEventListCtrl, nchSchEventEdit, nchSchEngineList, nchSchEngineListCtrl, nchSchEngineListMode, nchSchEngineEdit, nchSchTimeSelect, nchSchDateSelect, nchSchSaveOpt, nchSchDateOpt, nchSchDetailSelect, nvtSchEventList, nvtSchEventInfo, nvtSchEngineList, nvtSchEngineInfo, nvtSchEngineStats, nvtSchEngineListSel, nvtSchTimeSelect, nvtSchDateSelect, nvtSchDetailSelect, strTmTzName, strTmTzDesc, dTmTzGmtOffset, strTmTzDstRules, strTmLocName, dTmLocLong, dTmLocLat, nTmTsProtocol, nTmTsCheck_Time, strTmTsServer) Where: mdlSch is a unique module name. i!-ScheduleMod Module Parameters Parameter vdvSchEvents nvTmTimeSync nvTP nchSchEventList Description A virtual device number for programming NetLinx events. An INTEGER array with the following buttons: Main Event List Items 1-8 nchSchEventListCtrl An INTEGER array with the following buttons: · Page Up · Page Down · Top of List · End of List · Slider Channel Code Continued i!-Schedule 17 Programming i!-Schedule i!-ScheduleMod Module Parameters (Cont. ) nchSchEventEdit An INTEGER array with the following buttons: · Edit Event · Run Event · Cancel Event nchSchEngineList An INTEGER array with the following buttons: Today's Event List Items 1 - 6 nchSchEngineListCtrl An INTEGER array with the following buttons: · Page Up · Page Down · Top of List nchSchEngineListMode An INTEGER array with the following buttons: · Past Events · Current Events · Future Events nchSchEngineEdit An INTEGER array with the following buttons: · Run Event · Cancel Event nchSchTimeSelect An INTEGER array with the following buttons: · Start time - Fixed · Start Time - Sunrise · Start time - Sunset · Start Time - Before Sunrise · 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 nchSchDateSelect An INTEGER array with the following buttons: · Date - Fixed · Date - Daily · Date - Weekly nchSchSaveOpt An INTEGER array with the following buttons: · Save Edit · Cancel Edit · Parameters · Clear Event nchSchDateOpt An INTEGER array with the following buttons: Pool of Channel codes for Date editing options (9 channel codes, see touch panel pages) nchSchDetailSelect An INTEGER array with the following buttons: Pool of Channel codes for editing Date and Time parameters (37 channel codes, see touch panel pages) · Date - Monthly · Date - Yearly · End time - Sunrise · End time - Sunset · End time - Before Sunrise · End time - Before Sunset · End time - After Sunrise · End time - After Sunset · End time - Hour · End time - Minute · End time - AM/PM · End time - Sunrise · Hours Done/Minutes Done · End of List · Slider Channel Code Continued 18 i!-Schedule Programming i!-Schedule i!-ScheduleMod Module Parameters (Cont. ) nvtSchEventList An INTEGER array with the following variable text channels: · Main Event List Total Items · Main Event List Slider Level Code · Main Event List Items 1 - 8 nvtSchEventInfo An INTEGER array with the following variable text channels: · Scheduled For Date · Scheduled For time · Runs Next at nvtSchEngineList An INTEGER array with the following variable text channels: · Today's Event List Total Items · Today's Event List Slider Level Code · Today's Event List Items 1 - 6 nvtSchEngineInfo An INTEGER array with the following variable text channels: · Scheduled For Date · Scheduled For time · Runs Next at nvtSchEngineStats An INTEGER array with the following variable text channels: · Date · Time nvtSchEngineListSel · Number of Past Events · Number of Current Events · Number of Future Events nvtSchTimeSelect An INTEGER array with the following variable text channels: · Start time - Hours · Start Time - Minutes · Start Time - AM/PM · Start Time - Label · End Time - Hours nvtSchDateSelect An INTEGER array with the following variable text channels: · Daily Repeat · Weekly Repeat · Monthly Repeat · Monthly/Yearly Date of Month · Monthly/Yearly Day Occurrence · Monthly/Yearly Day of Month · Yearly Month · Fixed Date - Month · Fixed Date - Day nvtSchDetailSelect An INTEGER array with the following variable text channels: Pool of variable text channels codes for editing Date and Time parameters (37 channel codes, see touch panel pages) strTmTzName · Sunrise Time · Sunset Time An INTEGER array with the following variable text channels: · End Time - Minutes · End Time - AM/PM · End time- Label · Adjustable Minutes · Fixed Date - Year · Year 0 · Year 1 · Year 2 · Year 3 · Year 4 · Description Schedule For Date · Description Schedule For time A string containing the Time zone Name. [. . . ]