WSCH – Week scheduler

Block SymbolLicensing group: STANDARD

Function Description
The WSCH function block is a weekly scheduler for e.g. heating (day, night, eco), ventilation (high, low, off), lighting, irrigation etc. Its outputs can be used for switching individual appliances on/off or adjusting the intensity or power of the connected devices.

During regular weekly schedule the outputs iy and y reflect the values from the wst table. This table contains triplets day-hour-value. E.g. the notation [2 6.5 21.5] states that on Tuesday, at 6:30 in the morning (24-hour format), the output y will be set to 21.5. The output iy will be set to 22 (rounding to nearest integer). The individual triplets are separated by semicolons.

The days in a week are numbered from 1 (Monday) to 7 (Sunday). Higher values can be used for special daily schedules, which can be forced using the fsch input or the specdays table. The active daily program is indicated by the isch output.

Alternatively it is possible to temporarily force a specific output value using the val input and a rising edge at the SET input (off $\to$ on). When a rising edge occurs at the SET input, the val input is copied to the y output and the isch output is set to 0. The forced value remains set until:

the next interval as defined by the wst table, or
another rising edge occurs at the SET input, or
a different daily schedule is forced using the fsch input.

The list of special days (specdays) can be used for forcing a special daily schedule at given dates. E.g. you can force a Sunday daily schedule on holidays, Christmas, New Year, etc. The date is entered in the YYYYMMDD format. The notation [20160328 7] thus means that on March 28th, 2016, the Sunday daily schedule should be used. Individual pairs are separated by semicolons.

The trem and ynext outputs can be used for triggering specific actions in advance, before the y and iy are changed.

The iy output is meant for direct connection to function blocks with Boolean inputs (the conversion from type long to type bool is done automatically).

The nmax parameter defines memory allocation for the wst and specdays arrays. For $nmax = 100$ the wst list can contain up to 100 triplets day-hour-value. In typical applications there is no need to modify the nmax parameter.

This block does not propagate the signal quality. More information can be found in the 1.4 section.

Input

SET	Trigger for setting output	Bool
val	Value to set the output to	Double (F64)
fsch	Forced schedule (0=normal operation)	Long (I32)
	0 .... Standard weekly shedule 1 .... Monday 2 .... Tuesday 3 .... Wednesday 4 .... Thursday 5 .... Friday 6 .... Saturday 7 .... Sunday 8 and above Additional daily program as defined by the wst table

Parameter

tz	Timezone $⊙$ 1	Long (I32)
	1 .... Local time 2 .... UTC
nmax	Allocated size of arrays $↓$ 10 $↑$ 1000000 $⊙$ 100	Long (I32)
imode	Reserved for internal use	Long (I32)
user	Reserved for special editor	String
wst	Weekly schedule table (day-hour-value) $⊙$ [1 0.01 18.0; 2 6.0 22.0; 2 18.0 18.0; 3 6.0 22.0; 3 18.0 18.0; 4 6.0 22.0; 4 18.0 18.0; 5 6.0 22.0; 5 18.0 18.0; 6 6.0 22.0; 6 18.0 18.0; 1 0.01 18.0]	Double (F64)
specdays	List of special days (date-daily program) $⊙$ [20150406 1; 20151224 1; 20151225 1; 20151226 1; 20160101 1; 20160328 1; 20170417 1; 20180402 1; 20190422 1; 20200413 1]	Long (I32)

Output

iy	Integer output value	Long (I32)
y	Output value	Double (F64)
isch	Daily schedule identifier	Long (I32)
trem	Time remaining in the current section [s]	Double (F64)
ynext	Output in the next section	Double (F64)

[Previous] [Back to top] [Up]