Unitary | Pre-APOGEE | APOGEE | BACnet | PXC.A |
|---|---|---|---|---|
| ● | ● | ● | ● |
Syntax
TOD(mode,recomd,time1,time2,pt1,...,pt12)
mode | Mode number. - Valid entries are any combination of 1, 2, 4, 8, or 16 as defined in the following table. - Mode numbers can be added together to create customized schedules for the TOD program. See the TODMOD command for more information. |
recomd | Determines if the points defined will be commanded after a return from a power failure (fail-safe position). Recomd (re-command) is sometimes necessary for automation station warmstarts. - Valid values are 0 and 1. 0 = Does not re-command pt1 through pt12 on return from power failure. 1 = Re-commands pt1 through pt12 on return from power failure. |
time1 | Time at which an ON command is executed. - This parameter can be a military time (7:30 p.m. = 19:30), a decimal time (7:30 p.m. = 19.50), a logical point name, or a local variable. |
time2 | Time at which an OFF command is executed. - This parameter can be a military time (7:30 p.m. = 19:30), a decimal time (7:30 p.m. = 19.50), a logical point name, or a local variable. |
pt1 through pt12 | Point names of digital output points that are commanded ON or OFF. |
Valid TOD Mode Values. | |
|---|---|
Mode | Schedule |
1 | Normal schedule |
2 | Extended schedule |
4 | Shortened schedule |
8 | Weekend schedule |
16* | Holiday schedule |
* | Mode number 16 (Holiday) should only be used with the HOLIDA command. |
Use
This command changes digital output point ON and OFF based on the day of the week and the time of day. If the mode number in the TOD command matches the mode number in the TODMOD command, then TOD commands the particular output points ON and OFF at the specified times.
Example
10 TOD(1,1,17:00,07:00,OLITE1,OLITE2)
The command time can also be a relative time point that is assigned a value of time. When you calculate a value of time to be used in a TOD command and assign it to the relative time point, make sure that the calculated time is greater later than or equal to the current time. The TOD command will not execute properly if the relative time point is commanded to a time that precedes or is equal to the current time.