Block Contact monitoring

This block collects all window and door contacts of the building in one place and answers the questions that come up in everyday use: Is anything still open? Which window is open? Is a roof window open while it is raining? Has a window been open longer than intended?

As with all block function blocks, the absence comes from the block "Block Presence"; input AB works in addition to it.

The contacts are not wired individually but assigned through a contact list in the parameter "Contacts". For each contact the group address, a name, the room and the type (window, door, roof window) are entered. Addresses can be dragged from the variable window into the list; a multiple selection fills several rows at once.

A contact is always evaluated through an address. If a signal is only available as a drawn connection, create an internal address for it and enter that address here.

When the controller starts, the block takes the initial state from the addresses of the project; every further change reaches it through the telegrams. It does not request a read on its own. If the state of a bus address is not known at start, set "read at start" at the address or use the block "KNX read trigger".

A contact without a valid address counts as unknown: it counts neither as open nor as closed and does not trigger a warning.

The outputs change only on a real change. Even with a large number of contacts this causes no permanent load on the addresses.

The matching control element is Block Contact monitoring. It shows the list of open contacts with room and duration and has to be linked to this function block.

Inputs
AB	Absent	1 = nobody at home. If a contact is open, the warning is set after the configured delay. The input works in addition to the central presence: like every other block function block, the contact monitoring evaluates the state of the block "Block Presence" on its own. "Absent" and "Holiday" both count as absent there. The input therefore only has to be linked if the absence comes from another source.
RE	Rain	1 = it is raining. Depending on the setting, either only the roof windows or all contacts trigger a warning.
FR	Outside temperature	Current outside temperature in °C. If it is below the configured value and a contact is open, the warning is set. If the input is not linked, the frost warning is omitted.
QU	Acknowledge	A rising edge acknowledges the message. Output ME falls back and is only set again once the cause has disappeared in the meantime and occurs again.
Outputs
OF	Anything open	1 if at least one contact is open.
GE	Anything tilted	1 if at least one contact is tilted.
AN	Number open	Number of open contacts.
AG	Number tilted	Number of tilted contacts.
WA	Warning	1 if one of the three warnings is active: open while absent, open while raining or open during frost.
LA	Open for a long time	1 if at least one contact has been open longer than configured for its type. The calculation uses the time of the last change; a restart of the controller does not reset the duration.
ME	Message	Triggers a message. The output is usually connected to a message block. When it switches is defined by the parameter "Trigger message".
ST	Status	Status number for the visualisation. The value is the sum of the applicable states: 1 = something open, 2 = something tilted, 4 = warning absent, 8 = warning rain, 16 = warning frost, 32 = open for a long time, 64 = a contact is unknown, 128 = message is pending.
Parameters
	Contacts	Opens the dialog with the contact list. There you define which contacts the block monitors. The structure of the dialog is described below under "Contact list".
	Debounce time	A new state is only accepted once it has been stable for this time. Without debouncing, short state changes would make text and message flicker.
	Open for a long time window	Time after which an open window counts as open for too long. 0 = monitoring for this type off.
	Open for a long time door	The same time for doors. It is usually considerably shorter than for windows.
	Open for a long time roof window	The same time for roof windows.
	Warning when absent	Enables the warning "open while absent".
	Delay absent	Waiting time before the warning is set while absent. It is required so that the warning does not already respond while locking the front door.
	Warning when raining	"Roof windows only" or "All contacts". In both cases the warning only applies to contacts where "In warning" is set.
	Warning on frost below	Outside temperature in °C below which an open contact triggers a warning.
	Trigger message	Defines when output ME switches: on a warning, only on "open for a long time" or on both.
	Push notification	Switched on, the controller sends a notification to all registered uni-PRO APPs as soon as output ME goes active. The subject is the comment of the block, the text names the open contacts. A new message replaces the previous one, so they do not pile up. This setting is the default: as soon as the user switches the notification on or off in the control element, their decision applies.

Contact list
The dialog is opened through the parameter "Contacts". It stays open and usable while you work with it – this is what allows addresses to be dragged in from the variable window. Creating a contact: Drag a group address from the variable window into the list. Each dragged address creates one row and the comment of the address is used as the name. If you drop onto an existing row, the address replaces the previous entry – the column you drop on decides between "address open" and "address tilted". Clicking an address jumps to that position in the variable window. The button "Add" does not create a row but shows the variable window: a contact is always created through its address. Select block: If the contact already exists in the project as a block function block, this button takes it over directly. It shows the existing blocks Block Switch, Block Dimmer and Block Blind – one submenu per program page plus a search across all pages, exactly like linking a control element. After the selection a row is created with the comment of the block as the name and its status address: for the switch and the dimmer the status address of the switching state, for the blind the status of the height. If no status address is linked, the switching address is used. If the block has no variables at all yet, a message appears – create the variables there first. For the blind the height is a percentage. If the fully opened blind is to count as "open", set "Invert" in that row. "Up" and "Down" change the order. It defines in which order contacts of the same room appear in the text.
Columns of the contact list
	Address open	The group address of the contact, data type "EIS 1: switch bit". 1 means open, 0 means closed. It is the mandatory entry per row: without a valid address the contact stays unknown permanently and is not evaluated.
	Address tilted	Second, optional address for tilt-and-turn windows that report "tilted" separately (for example a handle sensor with three positions or two reed contacts). If this address reports 1, the window counts as tilted and not as open – "tilted" therefore takes precedence, because many sensors report both signals while the window is tilted. If the field stays empty, the contact only knows the two states open and closed; outputs GE and AG then always stay 0 for it.
	Comment	The comment of the address from the variable window. For orientation only, it is not stored.
	Name	Designation of the contact, for example "window". This name appears in the control element and in the push notification. When dragging an address in, the comment of the address is used as a default.
	Room	Room the contact is located in, for example "bathroom". The room is put in front of the name (giving "bathroom window") and is at the same time the sort key in the control element.
	Type	Window, door or roof window. The type decides which of the three "open for a long time" times applies to this contact and whether it triggers a warning while raining when "Warning when raining" is set to "Roof windows only".
	Invert	Reverses the meaning of the contact. Required for sensors that report 1 while closed (normally closed instead of normally open).
	In warning	Defines whether this contact triggers a warning when absent, raining or during frost. Switched off, the contact still counts towards OF, GE, AN, AG and the text but never triggers WA. Useful for an interior door or a window that is deliberately left tilted.

Block Contact monitoring

Inputs

Outputs

Parameters

Contact list

Columns of the contact list