Contatto
The CONTATTO system is DUEMMEGI’s proprietary bus architecture for building automation. HSYCO fully integrates with this system through the MCP control and gateway module, and its FXP-XT serial communication protocol. A serial connection between the MCP and the HSYCO SERVER is required for the integration, either directly through the server’s RS-232 port or via the RS-232 port of a supported serial to IP gateway, including the WEBS module.
Contents
- 1 Communication
- 2 HSYCO Configuration
- 3 Initialization and Connection Events
- 4 The Device Configuration Database
- 5 MCP Virtual Data Points and Registers
- 6 MCP Internal Clock
- 7 CONTATTO Modules Events and Control
- 7.1 DF4I
- 7.2 DFCK3
- 7.3 DF8I
- 7.4 DF2R
- 7.5 DF4R, DF4RP
- 7.6 DF4RP/I
- 7.7 DFDM, DFDI, DFDI2, DFDI2B, DFDT
- 7.8 DFDMX
- 7.9 DFDALI
- 7.10 DFDV
- 7.11 DFTP
- 7.12 DFTP/I
- 7.13 DFTR
- 7.14 DF4IL
- 7.15 DF8IL
- 7.16 DFIGLASS
- 7.17 DF4I/V
- 7.18 DFAI
- 7.19 DFLUX, DFSUN
- 7.20 DFCT
- 7.21 DFTZ
- 7.22 DFRHT
- 7.23 DFMETEO
- 7.24 DFCC
- 7.25 DFANA
- 8 User Interface
Communication
Employ a DE-9 (often called DB-9) male-female RS-232 straight cable to connect the RS-232 MCP port to the serial port on HSYCO SERVER or serial gateway. The communication baud rate can be set to 9600, 38400, 57600 or 115200 bps, according to the MCP serial port settings. The protocol requires 8bit data, no parity, one stop bit, no flow control. A speed of 115200 bps is recommended to achieve good performance, particularly when the number of devices connected to the bus is large.
HSYCO Configuration
Options
| ID | Default | Values | Description |
|---|---|---|---|
| startupevents | false | true | generate IO events also during the driver’s start-up phase |
| false | start generating events only after HSYCO is aligned with the current status of the system | ||
| inputdiscovery | false | true | auto-detects CONTATTO’s input devices as configured in the MCP, and automatically creates the list of all detected devices and individual data points in the systemtopo.txt file. Should be enabled to allow the automatic update of (button) objects’ states |
| false | auto-detect for input devices is disabled | ||
| outputdiscovery | true | true | auto-detects CONTATTO’s output devices as configured in the MCP, and automatically creates the list of all detected devices and individual data points in the systemtopo.txt file. Should be enabled to allow the automatic update of (button) objects’ states |
| false | auto-detect for output devices is disabled | ||
| virtualdiscovery | false | true | auto-detects CONTATTO’s virtual points for input and output devices as configured in the MCP, and automatically creates the list of all detected virtual data points in the systemtopo.txt file. Should be enabled to allow the automatic update of (button) objects’ states |
| false | auto-detect for devices’ virtual data points is disabled | ||
| virtualpoints | false | 1...2033 | enables polling for the first n virtual points of the MCP. Enable this option only if you need to generate I/O events based on these virtual points |
| true | enables polling for all the 2032 virtual points of the MCP | ||
| false | polling of the MCP virtual data points is disabled | ||
| registers | false | 1...1024 | enables polling for registers R0-Rn of the MCP. Enable this option only if you need to generate I/O events based on these registers |
| true | enables polling for registers R0-R127 of the MCP | ||
| false | polling of the MCP registers is disabled | ||
| powerdisplay | false | ≥ 0 (MODANA address) | enables the automatic display in the GUI of the total real power measured by a DFANA module connected to this MCP. Note that, if you have more than one MCP gateway, you should enable this option for one gateway only |
| false | power display disabled for this MCP | ||
| powersensivity | 50 | ≥ 0 | measured power changes are reported only if the difference from last reading is equal or greater than the power sensivity option, in Watts |
| detectevents | false | true | generate forced events when a device is detected at start-up |
| false | do not generate events when a device is detected at start-up | ||
| toolspassword | string | set this option with a long string (only letters and numbers) password to allow the remote connection of MCP-IDE and other configuration tools to the MCP gateways that are connected to HSYCO. For additional security, it is recommended to set this option only when required | |
| language | english | en it fr | language for all messages from the CONTATTO system: English, Italian or French |
Initialization and Connection Events
| Event name | Value | Description |
|---|---|---|
| connection | online | connection established to the MCP module |
| offline | HSYCO can’t connect to the MCP module | |
| detected.input.<n>. |
model name | an input device of the type passed as value has been detected at address <n>, using |
| detected.output.<n>. |
model name | an output device of the type passed as value has been detected at address <n>, using |
The Device Configuration Database
The systemtopo.txt file contains the list of all devices and their individual input, output and virtual data points that could be directly associated to graphic object in the Web-based user interface. This file can be filled manually or automatically by HSYCO at start-up. To enable automatic discovery and automatic generation of devices’ information in the systemtopo file, use the inputdiscovery, outputdiscovery and virtualdiscovery options in the hsyco.ini configuration file. The default behavior is to only discover devices with output data points.
This is an example of an automatically generated systemtopo.txt file:
(devices) contatto.o10.1 : LIGHT ; LIGHT contatto.o6.1 : LIGHT ; DIMMER contatto.o7.2 : LIGHT ; LIGHT contatto.o7.1 : LIGHT ; DIMMER contatto.o9.2 : AUTOM ; VSHUT contatto.o5.4 : LIGHT ; LIGHT contatto.o9.1 : AUTOM ; VSHUT contatto.o5.3 : LIGHT ; LIGHT contatto.o5.2 : LIGHT ; LIGHT contatto.o5.1 : LIGHT ; LIGHT
You should then manually add comments and other optional parameters:
(devices) contatto.o10.1 : LIGHT ; LIGHT; main entrance light contatto.o6.1 : LIGHT ; DIMMER; lobby dimmer contatto.o7.2 : LIGHT ; LIGHT; kitchen workbench contatto.o7.1 : LIGHT ; DIMMER; kitchen main dimmer
MCP Virtual Data Points and Registers
The MCP implements 2032 virtual points for binary (on/off) data and 1024 registers for positive scalar values (0-65535). All the virtual points and the registers can optionally generate I/O events. You can also write to the virtual data points and registers using the IO action in EVENTS or ioSet() method in Java. You cannot directly control the MCP virtual data points and registers using GUI objects. To enable polling of the current state of the MCP’s virtual data points, enable the virtualpoints options in hsyco.ini. To enable polling of the current state of the MCP’s registers, enable the registers options in hsyco.ini. If you only have to write to virtual points or registers, enabling polling is not strictly required.
| ID | Value | R/W | Description |
|---|---|---|---|
| v0.<n> | 0 | RW | virtual data point <n> off (<n>: 1-2032) |
| 1 | RW | virtual data point <n> on (<n>: 1-2032) | |
| r0.<n> | <x> | RW | register <n> off (<n>: 0-1023) set to value <x> (<x>: 0-65535) |
MCP Internal Clock
The MCP module has an integrated real-time clock. You can use the clock datapoint to read the MCP date and time, and set the MCP clock to HSYCO’s current time.
| ID | Value | R/W | Description |
|---|---|---|---|
| clock | yyyy-mm-dd hh:mm:ss | R | the MCP clock current time |
| read | W | read the MCP clock, and the delta with HSYCO’s time | |
| sync | W | set the MCP clock to HSYCO’s current time | |
| clock.delta | integer number | R | the delta time in seconds between the MCP and HSYCO clocks. A positive number means that the MCP clock is ahead of HSYCO |
CONTATTO Modules Events and Control
| Module Code | Description |
|---|---|
| MOD8I/A 8 | digital input module for NO contacts in modular housing |
| MOD32I/A | 32 digital input module for NO contacts in modular housing |
| MOD8INP2/A | 8 digital input module for NO contacts |
| MOD8INP2/C | 8 digital input module for NC contacts |
| MOAN/I | 0÷10V analog input module |
| MOAN/I4 | quad 0÷10V analog input module |
| MI420 | 4÷20mA analog input module |
| MI420-X4 | quad 4÷20mA analog input module |
| MOD4AM12/V/I | 4-channel 0÷10V or 4÷20mA (0÷21mA) analog input module |
| MOD2PT | input module for two PT100 temperature probes |
| MODCNT | 4-channel counter module in modular housing |
| MODNTC | input module for ambient temperature sensors and potentiometers |
| MOD4I/A | 4-digital input module for NO contacts in modular housing |
| MOD4I/S | 4-digital input module for NO contacts in 2M modular housing |
| MODLUX | ambient light measurement module with sensor for ceiling mounting |
| MODMETEO | meteorological data detection module for Contatto bus |
| MOD8R | 8 power relay output module |
| MODPNP | 8 positive logic (PNP) “open collector” digital output module |
| MODREL | 8 relay output compact module in DIN 3M housing |
| MOAN/U | 0÷10V analog output module |
| MO420 | 4÷20mA analog output module |
| MODLC | ambient light regulator module with integrated sensor |
| MOD4-4S | 4 digital input and 4 power relay output multifunction module |
| MOD2-2R | 2 digital input and 2 power relay output module |
| MOD4-4 | 4 digital input and 4 digital output module |
| MOD2DM | 2x300W dimmer module |
| MOD2DV | dual 1-10V output for electronic ballast driving |
| MOD8IL | 8 digital input – 8 LED output module for wall box |
| MOD4DV | quad 0-10V output module for generic applications or for external dimmers control |
| MODDMX | DMX gateway |
| MODDALI | 4-channel DALI gateway |
| CLIMA2 | module for the regulation of the ambient temperature |
| MODANA | network analyzer module for Contatto bus |
| MODPQ5 | tags proximity reader and programmer |
| MODHT | hotel room controller |
| MODCA | access control module |
| MODKB | keypad access control module |
DF4I
The DF4I is an input module with 4 digital inputs. It uses one address in the CONTATTO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 | R | input pin 1 off |
| 1 | R | input pin 1 on | |
| i.<address>.2 | 0 | R | input pin 2 off |
| 1 | R | input pin 2 on | |
| i.<address>.3 | 0 | R | input pin 3 off |
| 1 | R | input pin 3 on | |
| i.<address>.4 | 0 | R | input pin 4 off |
| 1 | R | input pin 4 on |
DFCK3
The DFCK3 is an input module for managing up to 15 different zones with an integrated clock. It uses one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 | R | input pin 1 off |
| 1 | R | input pin 1 on | |
| i.<address>.2 | 0 | R | input pin 2 off |
| 1 | R | input pin 2 on | |
| i.<address>.3 | 0 | R | input pin 3 off |
| 1 | R | input pin 3 on | |
| i.<address>.4 | 0 | R | input pin 4 off |
| 1 | R | input pin 4 on | |
| i.<address>.5 | 0 | R | input pin 5 off |
| 1 | R | input pin 5 on | |
| i.<address>.6 | 0 | R | input pin 6 off |
| 1 | R | input pin 6 on | |
| i.<address>.7 | 0 | R | input pin 7 off |
| 1 | R | input pin 7 on | |
| i.<address>.8 | 0 | R | input pin 8 off |
| 1 | R | input pin 8 on | |
| i.<address>.9 | 0 | R | input pin 9 off |
| 1 | R | input pin 9 on | |
| i.<address>.10 | 0 | R | input pin 10 off |
| 1 | R | input pin 10 on | |
| i.<address>.11 | 0 | R | input pin 11 off |
| 1 | R | input pin 11 on | |
| i.<address>.12 | 0 | R | input pin 12 off |
| 1 | R | input pin 12 on | |
| i.<address>.13 | 0 | R | input pin 13 off |
| 1 | R | input pin 13 on | |
| i.<address>.14 | 0 | R | input pin 14 off |
| 1 | R | input pin 14 on | |
| i.<address>.15 | 0 | R | input pin 15 off |
| 1 | R | input pin 15 on |
DF8I
The DF8I is an input module with 2x4 digital inputs. It uses two consecutive addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 | R | input pin 1 off |
| 1 | R | input pin 1 on | |
| i.<address>.2 | 0 | R | input pin 2 off |
| 1 | R | input pin 2 on | |
| i.<address>.3 | 0 | R | input pin 3 off |
| 1 | R | input pin 3 on | |
| i.<address>.4 | 0 | R | input pin 4 off |
| 1 | R | input pin 4 on | |
| i.<address+1>.1 | 0 | R | input pin 1 off |
| 1 | R | input pin 1 on | |
| i.<address+1>.2 | 0 | R | input pin 2 off |
| 1 | R | input pin 2 on | |
| i.<address+1>.3 | 0 | R | input pin 3 off |
| 1 | R | input pin 3 on | |
| i.<address+1>.4 | 0 | R | input pin 4 off |
| 1 | R | input pin 4 on |
DF2R
The DF2R is an output module with 2 relay outputs. It uses one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address>.1 | 0 off |
RW | output pin 1 off |
| 1 on |
RW | output pin 1 on | |
| o.<address>.2 | 0 off |
RW | output pin 2 off |
| 1 on |
RW | output pin 2 on |
DF4R, DF4RP
The DF4R (DF4RP) is an output module with 4 relay outputs. It uses one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address>.1 | 0 off |
RW | output pin 1 off |
| 1 on |
RW | output pin 1 on | |
| o.<address>.2 | 0 off |
RW | output pin 2 off |
| 1 on |
RW | output pin 2 on | |
| o.<address>.3 | 0 off |
RW | output pin 3 off |
| 1 on |
RW | output pin 3 on | |
| o.<address>.4 | 0 off |
RW | output pin 4 off |
| 1 on |
RW | output pin 4 on |
DF4RP/I
The DF4RP/I is an output module with 4 generic inputs and 4 relay outputs. It uses one input address and one output address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 | R | input pin 1 off |
| 1 | R | input pin 1 on | |
| o.<address>.1 | 0 | RW | output pin 1 off |
| 1 | RW | output pin 1 on | |
| i.<address>.2 | 0 | R | input pin 2 off |
| 1 | R | input pin 2 on | |
| o.<address>.2 | 0 | RW | output pin 2 off |
| 1 | RW | output pin 2 on | |
| i.<address>.3 | 0 | R | input pin 3 off |
| 1 | R | input pin 3 on | |
| o.<address>.3 | 0 | RW | output pin 3 off |
| 1 | RW | output pin 3 on | |
| i.<address>.4 | 0 | R | input pin 4 off |
| 1 | R | input pin 4 on | |
| o.<address>.4 | 0 | RW | output pin 4 off |
| 1 | RW | output pin 4 on |
DFDM, DFDI, DFDI2, DFDI2B, DFDT
The DFDM, DFDI, DFDI2, DFDI2B and DFDT are output modules with 1 dimmer output. They use one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address> | program | R | program mode |
| fault | R | dimmer fault | |
| auto | R | auto mode | |
| man | R | manual mode | |
| o.<address>.1 | off | RW | dimmer off |
| 1...100% | RW | percent dimmer level | |
| on | RW | dimmer on at last level | |
| o.<address>.ramp | save | RW | saves the current ramp as default |
| 1...30 | RW | ramp value in seconds (1 sec steps up to 10 and 2 sec steps up to 30) | |
| 40, 50, 60 | RW | ramp value in seconds (10 sec steps) | |
| o.<address>.setpoint | 0...1023 | RW | setpoint level |
| o.<address>.hysteresis | 0...255 | RW | tolerance level |
| o.<address>.time | 0...255 | RW | period (seconds) |
The dimmer level can be set using additional formats besides the standard percent values: - absolute positive integer number between 0 and 100 - percent number, formatted as x% - fractional format, formatted as “n/m”, where 0 <= n <= m.
DFDMX
The DFDMX is a DMX-512 protocol output module. It uses one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address>.<command> | 0...255 | RW | commands and values according to the DFDMX programming manual |
DFDALI
The DFDALI is a DALI interface module. Using the DFDALI you can control up to 32 DALI devices. You can control individual devices, groups or broadcast commands to all devices. It uses one input (if enabled) and one output address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address> | refresh | RW | queries the DFDALI module to update the current status of all DALI devices |
| o.<address> | off | RW | broadcast off command |
| o.<address>.all
o.<address>.0 |
<level> | RW | broadcast level command |
| o.<address>.group.<DALI group> | off | RW | broadcast off command |
| <level> | RW | group level command | |
| o.<address>.<DALI address> | off | RW | turn off a single device |
| <level> | RW | set a single device to a specific level | |
| > 100 | RW | special functions, having values between 101 and 255, as defined in the DFDALI manual | |
| i.<address>.polling | off | RW | polling mode is disabled |
| on | RW | polling mode is enabled | |
| i.<address>.test | 0 | RW | test button not pressed |
| 1 | RW | test button pressed | |
| i.<address>.dali | nopower | RW | power failure on the DALI bus |
| open | RW | DALI bus is open | |
| short | RW | DALI bus is shorted | |
| on | RW | DALI bus on | |
| i.<address>.1 | fault | RW | DALI device 1 reporting a lamp failure |
| unknown | RW | DALI device 1 status unknown |
The DALI level can be set using additional formats besides the standard percent values: - absolute positive integer number between 0 and 100 - percent number, formatted as x% - fractional format, formatted as “n/m”, where 0 <= n <= m - special functions, having values between 101 and 255, as defined in the DFDALI manual.
DFDV
The DFDV is an output module with 1 output (1-10V for ballast) + 1 generic power relay output. It uses one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address>.1 | off | RW | dimmer off |
| 1...100% | RW | percent dimmer level | |
| on | RW | dimmer on at last level | |
| o.<address>.2 | 0 | RW | output pin 1 off |
| 1 | RW | output pin 1 on |
The dimmer level can be set using additional formats besides the standard percent values: - absolute positive integer number between 0 and 100 - fractional format, formatted as “n/m”, where 0 <= n <= m. You can also set the value to “on” or “off”, that is equivalent to 1 and 0.
DFTP
The DFTP is an output module for 2 shutters. It uses one output address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address>.1 | up | RW | shutter up command |
| down | RW | shutter down command | |
| stop off 0 |
RW | shutter stop command | |
| unknown | RW | unknown state | |
| offup | RW | shutter off, up position | |
| offdown | RW | shutter off, down position | |
| o.<address>.2 | up | RW | shutter up command |
| down | RW | shutter down command | |
| stop off 0 |
RW | shutter stop command | |
| unknown | RW | unknown state | |
| offup | RW | shutter off, up position | |
| offdown | RW | shutter off, down position |
DFTP/I
The DFTP is an input/output module for 2 shutters and 4 generic inputs. It uses one input and one output address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 | R | input pin 1 off |
| 1 | R | input pin 1 on | |
| o.<address>.1 | up | RW | shutter up command |
| down | RW | shutter down command | |
| stop off 0 |
RW | shutter stop command | |
| unknown | RW | unknown state | |
| offup | RW | shutter off, up position | |
| offdown | RW | shutter off, down position | |
| i.<address>.2 | 0 | R | input pin 2 off |
| 1 | R | input pin 2 on | |
| o.<address>.2 | up | RW | shutter up command |
| down | RW | shutter down command | |
| stop off 0 |
RW | shutter stop command | |
| unknown | RW | unknown state | |
| offup | RW | shutter off, up position | |
| offdown | RW | shutter off, down position | |
| i.<address>.3 | 0 | R | input pin 3 off |
| 1 | R | input pin 3 on | |
| i.<address>.4 | 0 | R | input pin 4 off |
| 1 | R | input pin 4 on |
DFTR
The DFTR is an output module with 1 shutter output and 1 relay output. It uses one address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| o.<address>.1 | up | R | shutter up |
| down | R | shutter down | |
| unknown | R | unknown state | |
| offup | R | shutter offup | |
| offdown | R | shutter offdown | |
| o.<address>.2 | 0 | R | output pin 2 off |
| 1 | R | output pin 2 on |
DF4IL
The DF4IL is an input/output module with 4 digital inputs and 4 digital open collector outputs for LEDs. It uses one input and one output address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 off |
R | input pin 1 off |
| 1 on |
R | input pin 1 on | |
| o.<address>.1 | 0 off |
RW | LED 1 off |
| 1 on |
RW | LED 1 on | |
| i.<address>.2 | 0 off |
R | input pin 2 off |
| 1 on |
R | input pin 2 on | |
| o.<address>.2 | 0 off |
RW | LED 2 off |
| 1 on |
RW | LED 2 on | |
| i.<address>.3 | 0 off |
R | input pin 3 off |
| 1 on |
R | input pin 3 on | |
| o.<address>.3 | 0 off |
RW | LED 3 off |
| 1 on |
RW | LED 3 on | |
| i.<address>.4 | 0 off |
R | input pin 4 off |
| 1 on |
R | input pin 4 on | |
| o.<address>.4 | 0 off |
RW | LED 4 off |
| 1 on |
RW | LED 4 on |
DF8IL
The DF8IL is an input/output module with 8 digital inputs and 8 digital open collector outputs for LEDs. It uses 4 input and 4 output addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 off |
R | input pin 1 off |
| 1 on |
R | input pin 1 on | |
| i.<address>.2 | 0 off |
R | input pin 2 off |
| 1 on |
R | input pin 2 on | |
| i.<address>.3 | 0 off |
R | input pin 3 off |
| 1 on |
R | input pin 3 on | |
| i.<address>.4 | 0 off |
R | input pin 4 off |
| 1 on |
R | input pin 4 on | |
| i.<address+1>.1 | 0 off |
R | input pin 5 off |
| 1 on |
R | input pin 5 on | |
| i.<address+1>.2 | 0 off |
R | input pin 6 off |
| 1 on |
R | input pin 6 on | |
| i.<address+1>.3 | 0 off |
R | input pin 7 off |
| 1 on |
R | input pin 7 on | |
| i.<address+1>.4 | 0 off |
R | input pin 8 off |
| 1 on |
R | input pin 8 on | |
| i.<address+2>.1 | 0 off |
R | LED 1 is off |
| 1 on |
R | LED 1 is on | |
| i.<address+2>.2 | 0 off |
R | LED 2 is off |
| 1 on |
R | LED 2 is on | |
| i.<address+2>.3 | 0 off |
R | LED 3 is off |
| 1 on |
R | LED 3 is on | |
| i.<address+2>.4 | 0 off |
R | LED 4 is off |
| 1 on |
R | LED 4 is on | |
| i.<address+3>.1 | 0 off |
R | LED 5 is off |
| 1 on |
R | LED 5 is on | |
| i.<address+3>.2 | 0 off |
R | LED 6 is off |
| 1 on |
R | LED 6 is on | |
| i.<address+3>.3 | 0 off |
R | LED 7 is off |
| 1 on |
R | LED 7 is on | |
| i.<address+3>.4 | 0 off |
R | LED 8 is off |
| 1 on |
R | LED 8 is on | |
| v.<address+2>.1 | 0 off |
RW | LED 1 is off |
| 1 on |
RW | LED 1 is on | |
| v.<address+2>.2 | 0 off |
RW | LED 2 is off |
| 1 on |
RW | LED 2 is on | |
| v.<address+2>.3 | 0 off |
RW | LED 3 is off |
| 1 on |
RW | LED 3 is on | |
| v.<address+2>.4 | 0 off |
RW | LED 4 is off |
| 1 on |
RW | LED 4 is on | |
| v.<address+3>.1 | 0 off |
RW | LED 5 is off |
| 1 on |
RW | LED 5 is on | |
| v.<address+3>.2 | 0 off |
RW | LED 6 is off |
| 1 on |
RW | LED 6 is on | |
| v.<address+3>.3 | 0 off |
RW | LED 7 is off |
| 1 on |
RW | LED 7 is on | |
| v.<address+3>.4 | 0 off |
RW | LED 8 is off |
| 1 on |
RW | LED 8 is on |
Note that the first two output addresses are reserved and should not be used. Use address + 2 and address + 3 to control the LEDs.
DFIGLASS
The DFIGLASS is an input/output module with 6 touch buttons with addressable LEDs and a buzzer for audio feedback. It uses 1 input and 1 output addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 off |
R | button 1 off |
| 1 on |
R | button 1 on | |
| i.<address>.2 | 0 off |
R | button 2 off |
| 1 on |
R | button 2 on | |
| i.<address>.3 | 0 off |
R | button 3 off |
| 1 on |
R | button 3 on | |
| i.<address>.4 | 0 off |
R | button 4 off |
| 1 on |
R | button 4 on | |
| i.<address>.5 | 0 off |
R | button 5 off |
| 1 on |
R | button 5 on | |
| i.<address>.6 | 0 off |
R | button 6 off |
| 1 on |
R | button 6 on | |
| i.<address>.fault | 0 off |
R | no fault |
| 1 on |
R | touch keypad fault | |
| i.<address>.led.1 | 0 off |
RW | led 1 off |
| 1 on |
RW | led 1 on | |
| i.<address>.led.2 | 0 off |
RW | led 2 off |
| 1 on |
RW | led 2 on | |
| i.<address>.led.3 | 0 off |
RW | led 3 off |
| 1 on |
RW | led 3 on | |
| i.<address>.led.4 | 0 off |
RW | led 4 off |
| 1 on |
RW | led 4 on | |
| i.<address>.led.5 | 0 off |
RW | led 5 off |
| 1 on |
RW | led 5 on | |
| i.<address>.led.6 | 0 off |
RW | led 6 off |
| 1 on |
RW | led 6 on | |
| i.<address>.backlight | 0 off |
RW | backlight off |
| 1 on |
RW | backlight on | |
| i.<address>.buzzer | 0 off |
RW | buzzer disabled |
| 1 on |
RW | buzzer enabled |
DF4I/V
The DF4I/V is an input/output module with 4 digital inputs and 12 digital virtual outputs. It uses four consecutive addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.1 | 0 off |
R | input pin 1 off |
| 1 on |
R | input pin 1 on | |
| i.<address>.2 | 0 off |
R | input pin 2 off |
| 1 on |
R | input pin 2 on | |
| i.<address>.3 | 0 off |
R | input pin 3 off |
| 1 on |
R | input pin 3 on | |
| i.<address>.4 | 0 off |
R | input pin 4 off |
| 1 on |
R | input pin 4 on | |
| v.<address+1>.1 | 0 off |
RW | virtual pin 1 off |
| 1 on |
RW | virtual pin 1 on | |
| v.<address+1>.2 | 0 off |
RW | virtual pin 2 off |
| 1 on |
RW | virtual pin 2 on | |
| v.<address+1>.3 | 0 off |
RW | virtual pin 3 off |
| 1 on |
RW | virtual pin 3 on | |
| v.<address+1>.4 | 0 off |
RW | virtual pin 4 off |
| 1 on |
RW | virtual pin 4 on | |
| v.<address+2>.1 | 0 off |
RW | virtual pin 1 off |
| 1 on |
RW | virtual pin 1 on | |
| v.<address+2>.2 | 0 off |
RW | virtual pin 2 off |
| 1 on |
RW | virtual pin 2 on | |
| v.<address+2>.3 | 0 off |
RW | virtual pin 3 off |
| 1 on |
RW | virtual pin 3 on | |
| v.<address+2>.4 | 0 off |
RW | virtual pin 4 off |
| 1 on |
RW | virtual pin 4 on | |
| v.<address+3>.1 | 0 off |
RW | virtual pin 1 off |
| 1 on |
RW | virtual pin 1 on | |
| v.<address+3>.2 | 0 off |
RW | virtual pin 2 off |
| 1 on |
RW | virtual pin 2 on | |
| v.<address+3>.3 | 0 off |
RW | virtual pin 3 off |
| 1 on |
RW | virtual pin 3 on | |
| v.<address+3>.4 | 0 off |
RW | virtual pin 4 off |
| 1 on |
RW | virtual pin 4 on |
DFAI
The DFAI is an input module (0-10V) with 2 analog inputs. It uses two consecutive input addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address> | 0...1000 | R | input voltage in Volt/100 |
| i.<address+1> | 0...1000 | R | input voltage in Volt/100 |
DFLUX, DFSUN
The DFLUX and DFSUN are input modules with 1 analog light sensor. They use one input address in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address> | 0...1023 | R | lux level (raw level, not translated to the lux range) |
DFCT
The DFCT is an input/output temperature sensor module. It uses two consecutive input addresses and five consecutive output addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.mode | winter | R | winter mode |
| summer | R | summer mode | |
| i.<address>.fan | min | R | min fan speed |
| med | R | medium fan speed | |
| max | R | max fan speed | |
| off | R | fan off | |
| i.<address>.fan.mode | man | R | manual fan mode |
| auto | R | auto fan mode | |
| i.<address>.setpoint | 1 | R | setpoint 1 |
| 2 | R | setpoint 2 | |
| 3 | R | setpoint 3 | |
| off | R | off | |
| man | R | manual setpoint | |
| i.<address>.setpoint.mode | man | R | manual setpoint mode |
| auto | R | auto setpoint mode | |
| i.<address>.temp | <temp> | R | temperature value (in C/10) |
| fault | R | temperature sensor fault | |
| i.<address>.status | off | R | off |
| cooling | R | cooling status mode | |
| heating | R | heating status mode | |
| o.<address>.mode | winter | RW | winter mode |
| summer | RW | summer mode | |
| o.<address>.fan | min | RW | min fan speed |
| med | RW | medium fan speed | |
| max | RW | max fan speed | |
| off | RW | fan off | |
| o.<address>.fan.mode | man | RW | manual fan mode |
| auto | RW | auto fan mode | |
| o.<address>.setpoint | 1 | RW | setpoint 1 |
| 2 | RW | setpoint 2 | |
| 3 | RW | setpoint 3 | |
| 0 off |
RW | setpoint off | |
| man | RW | manual setpoint | |
| o.<address>.setpoint.temp.1 | <temp> | RW | temperature setpoint 1 value (in C/10) |
| o.<address>.setpoint.temp.2 | <temp> | RW | temperature setpoint 2 value (in C/10) |
| o.<address>.setpoint.temp.3 | <temp> | RW | temperature setpoint 3 value (in C/10) |
| o.<address>.setpoint.temp.man | <temp> | RW | temperature manual setpoint 1 value (in C/10) |
| o.<address>.program.summer o.<address>.program.winter |
refresh | RW | forces to daily summer/winter program for all days of the week |
| o.<address>.program.summer.<day> o.<address>.program.winter.<day> |
refresh | RW | forces to daily summer/winter program for the reported day (mon:1, sun:7) |
| <s0>...<s47> | RW | 48 character represents the daily setpoint program divided in time slots of 30 minutes |
DFTZ
The DFTZ is an input/output temperature sensor module. It uses 3 consecutive input addresses and 4 consecutive output addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.mode | winter | R | winter mode |
| summer | R | summer mode | |
| i.<address>.setpoint | comfort | R | comfort setpoint |
| eco | R | eco setpoint | |
| off | R | off | |
| i.<address>.temp | <temp> | R | temperature value (in C/10) |
| fault | R | temperature sensor fault | |
| i.<address>.status | off | R | off |
| cooling | R | cooling status mode | |
| heating | R | heating status mode | |
| o.<address>.mode | winter | RW | winter mode |
| summer | RW | summer mode | |
| o.<address>.setpoint | comfort | RW | comfort setpoint |
| eco | RW | eco setpoint | |
| 0 off |
RW | off | |
| o.<address>.setpoint.temp.comfort | <temp> | RW | comfort setpoint value (in C/10) |
| o.<address>.setpoint.temp.eco | <temp> | RW | eco setpoint value (in C/10) |
| o.<address>.setpoint.temp.limit | <temp> | RW | summer/winter setpoint temperature limit (in C/10) |
DFRHT
The DFRHT is a temperature and humidity sensor. It uses four consecutive input addresses and two consecutive output addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.humidity | 0...100 | R | relative percent umidity |
| i.<address>.temp | <temp> | R | temperature value |
| i.<address>.dewpoint | <temp> | R | dew point value |
| i.<address>.dewpoint.limit.1 | 0 | R | dew point is lower than limit 1 |
| 1 | R | dew point is higher than limit 1 | |
| <temp> | RW | dew point limit 1 | |
| off | RW | limit 1 not set | |
| i.<address>.dewpoint.limit.2 | 0 | R | dew point is lower than limit 2 |
| 1 | R | dew point is higher than limit 2 | |
| <temp> | RW | dew point limit 2 | |
| off | RW | limit 2 not set |
DFMETEO
The DFMETEO is the weather sensor module. It uses four consecutive input addresses and three consecutive output addresses in the DOMINO bus.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.temp | <temp> | RW | temperature value (in C/10) |
| off | RW | limit not set | |
| i.<address>.lux | <lux*10> | R | lux level according to the DFLUX range |
| <lux> | RW | lux limit | |
| 0 | RW | limit not set | |
| i.<address>.wind | 1 m/s /10 | R | wind value |
| m/s | RW | wind limit | |
| 0 | RW | limit not set | |
| i.<address>.rain | 0 | R | no rain |
| 1 | R | rain | |
| i.<address>.night | 0 | R | day |
| 1 | R | night | |
| i.<address>.temp.limit | 0 | R | measured temp is less than limit |
| 1 | R | measured temp is greater than limit | |
| i.<address>.lux.limit | 0 | R | measured lux is less than limit |
| 1 | R | measured lux is greater than limit | |
| i.<address>.wind.limit | 0 | R | measured wind is less than limit |
| 1 | R | measured wind is greater than limit | |
| i.<address>.light.south | 0 | R | light is not coming from south |
| 1 | R | light is coming from south | |
| i.<address>.light.west | 0 | R | light is not coming from west |
| 1 | R | light is coming from west | |
| i.<address>.light.east | 0 | R | light is not coming from east |
| 1 | R | light is coming from east | |
| i.<address>.fault | 0 | R | sensor not fault |
| 1 | R | sensor fault |
DFCC
The DFCC is an energy meter and load manager module. In the following table, <N> is the sequential index (1 to 3) of the DFCC module.
| ID | Value | R/W | Description |
|---|---|---|---|
| energy.<n>.power.real | 0...65535 | R | real power (Watt) |
| energy.<n>.power.reactive | -32768...+32767 | R | reactive power (var) |
| energy.<n>.power.apparent | -32768...+32767 | R | apparent power (VA) |
| energy.<n>.power.realavg | 0...65535 | R | average real power (Watt) |
| energy.<n>.power.reactiveavg | -32768...+32767 | R | average reactive power (var) |
| energy.<n>.cos | -1000...+1000 | R | cos(φ) * 1000 |
| energy.<n>.load.1 | 0 | R | load 1 disabled |
| 1 | R | load 1 enabled | |
| energy.<n>.load.2 | 0 | R | load 2 disabled |
| 1 | R | load 2 enabled | |
| energy.<n>.load.3 | 0 | R | load 3 disabled |
| 1 | R | load 3 enabled | |
| energy.<n>.load.4 | 0 | R | load 4 disabled |
| 1 | R | load 4 enabled | |
| energy.<n>.load.5 | 0 | R | load 5 disabled |
| 1 | R | load 5 enabled | |
| energy.<n>.load.6 | 0 | R | load 6 disabled |
| 1 | R | load 6 enabled | |
| energy.<n>.load.7 | 0 | R | load 7 disabled |
| 1 | R | load 7 enabled | |
| energy.<n>.load.8 | 0 | R | load 8 disabled |
| 1 | R | load 8 enabled |
DFANA
Network analyzer module for Domino bus. Uses up to 20 consecutive input addresses and, if enabled, 1 output address equal to the base input address.
| ID | Value | R/W | Description |
|---|---|---|---|
| i.<address>.v12 | [V] | R | chained voltage phase 1-2 |
| i.<address>.v23 | [V] | R | chained voltage phase 2-3 |
| i.<address>.v31 | [V] | R | chained voltage phase 3-1 |
| i.<address>.vtm | [V] | R | average chained voltage |
| i.<address>.i1 | [A] | R | current phase 1 |
| i.<address>.i2 | [A] | R | current phase 2 |
| i.<address>.i3 | [A] | R | current phase 3 |
| i.<address>.itm | [A] | R | average current |
| i.<address>.ptot | [W] | R | total active power |
| i.<address>.ptotk | [kW] | R | total active power |
| i.<address>.qtot | [W] | R | total reactive power |
| i.<address>.qtotk | [kW] | R | total reactive power |
| i.<address>.pf | [pf] | R | total power factor |
| i.<address>.frequency | [Hz] | R | frequency |
| i.<address>.v1n | [V] | R | voltage phase 1 |
| i.<address>.v2n | [V] | R | voltage phase 2 |
| i.<address>.v3n | [V] | R | voltage phase 3 |
| i.<address>.p1 | [W] | R | active power phase 1 |
| i.<address>.p1k | [kW] | R | active power phase 1 |
| i.<address>.p2 | [W] | R | active power phase 2 |
| i.<address>.p2k | [kW] | R | active power phase 2 |
| i.<address>.p3 | [W] | R | active power phase 3 |
| i.<address>.p3k | [kW] | R | active power phase 3 |
User Interface
DFDMX
You can define a standard HSYCO DMX server for each DFDMX module, then use the (dmx) and (dmxrgb) objects to control channels 1-64 of the DMX bus connected to the DFDMX module. For example:
dmxServers = dmx dmxServersId.dmx = domino.o8
Note that, instead of defining the dmxServersIP parameter, the dmxServersId is used to associate the DMX server with the id of the DFDMX module.
DFCC
UISET Actions
| ID | Attribute | Set to | |
|---|---|---|---|
| energy.<n>.power | value | real power, followed by “ W” | |
DFCT
UISET Actions
| ID | Attribute | Set to | |
|---|---|---|---|
| <address>.mode | summer | summer mode (cooling) | |
| winter | winter mode (heating) | ||
| <address>.mode.label.summer | visible | the DFCT is in summer mode | |
| <address>.mode.label.winter | visible | the DFCT is in winter mode | |
| <address>.status | off | zone off | |
| on | zone on | ||
| <address>.status.label.cooling | visible | if the zone is cooling | |
| <address>.status.label.heating | visible | if the zone is heating | |
| <address>.fan | off | fan off | |
| min | minimum fan speed | ||
| med | medium fan speed | ||
| max | maximum fan speed | ||
| <address>.fan.label.min | visible | the fan speed is min | |
| <address>.fan.label.med | visible | the fan speed is med | |
| <address>.fan.label.max | visible | the fan speed is max | |
| <address>.fan.mode | man | manual fan mode | |
| auto | auto fan mode | ||
| <address>.setpoint | 1,2,3 | active setpoint | |
| man | manual setpoint | ||
| off | zone off | ||
| <address>.setpoint.label.1 | visible | setpoint 1 is active | |
| <address>.setpoint.label.2 | visible | setpoint 2 is active | |
| <address>.setpoint.label.3 | visible | setpoint 3 is active | |
| <address>.setpoint.label.man | visible | manual setpoint is active | |
| <address>.setpoint.label.off | visible | zone is off | |
| <address>.setpoint.mode | man | manual setpoint mode | |
| auto | auto setpoint mode | ||
| <address>.setpoint.temp | <value> | the active setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.1 | <value> | the active setpoint 1 temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.2 | <value> | the active setpoint 2 temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.3 | <value> | the active setpoint 3 temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.man | <value> | the manual setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.temp | <temp> | the manual setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| fault | fault/error condition | ||
USER Commands
| Name | Param | Action |
|---|---|---|
| <address> | mode | cycle through summer and winter mode |
| mode.summer | set summer mode (cooling) | |
| mode.winter | set winter mode (heating) | |
| fan | cycle through fan speeds and modes (auto, off, man/min, man/med, man/max, auto) | |
| <address>.setpoint | mode | cycle through the manual, automatic and off operation modes |
| mode.man | set manual operation mode | |
| mode.auto | set automatic operation mode | |
| mode.off | off mode | |
| temp.1.up | increase setpoint 1 temperature in 0.5C steps | |
| temp.1.down | decrease setpoint 1 temperature in 0.5C steps | |
| temp.1.<t> | setpoint 1 set to temperature t, in C/10 (0 <= t <= 355) | |
| temp.2.up | increase setpoint 2 temperature in 0.5C steps | |
| temp.2.down | decrease setpoint 2 temperature in 0.5C steps | |
| temp.2.<t> | setpoint 2 set to temperature t, in C/10 (0 <= t <= 355) | |
| temp.3.up | increase setpoint 3 temperature in 0.5C steps | |
| temp.3.down | decrease setpoint 3 temperature in 0.5C steps | |
| temp.3.<t> | setpoint 3 set to temperature t, in C/10 (0 <= t <= 355) | |
| temp.man.up | increase manual setpoint temperature in 0.5C steps | |
| temp.man.down | decrease manual setpoint temperature in 0.5C steps | |
| temp.man.<t> | manual setpoint set to temperature t, in C/10 (0 <= t <= 355) | |
| <address>.fan | mode | cycle through the manual and automatic fan speed modes |
| mode.man | set manual fan speed mode | |
| mode.auto | set automatic fan speed mode | |
| up | increase fan speed | |
| down | decrease fan speed | |
| min | set min fan speed | |
| med | set med fan speed | |
| max | set max fan speed | |
| off | fan off |
DFTZ
UISET Actions
| ID | Attribute | Set to | |
|---|---|---|---|
| <address>.mode | summer | summer mode (cooling) | |
| winter | winter mode (heating) | ||
| <address>.mode.label.summer | visible | the DFTZ is in summer mode | |
| <address>.mode.label.winter | visible | the DFTZ is in winter mode | |
| <address>.status | off | zone off | |
| on | zone on | ||
| <address>.status.label.off | visible | if the zone is not cooling or heating | |
| <address>.status.label.cooling | visible | if the zone is cooling | |
| <address>.status.label.heating | visible | if the zone is heating | |
| <address>.setpoint | com | comfort setpoint | |
| man | manual setpoint | ||
| off | zone off | ||
| <address>.setpoint.label.1 | visible | comfort setpoint is active | |
| <address>.setpoint.label.2 | visible | eco setpoint is active | |
| <address>.setpoint.label.off | visible | zone is off | |
| <address>.setpoint.temp | <value> | the active setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.1 | <value> | the comfort setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.2 | <value> | the eco setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.setpoint.temp.man | <value> | the summer or winter setpoint temperature limit, in Celsius degrees with one decimal digit, followed by " °C" | |
| <address>.temp | <temp> | the manual setpoint temperature, in Celsius degrees with one decimal digit, followed by " °C" | |
| fault | fault/error condition | ||
USER Commands
| Name | Param | Action |
|---|---|---|
| <address> | mode | cycle through summer and winter mode |
| mode.summer | set summer mode (cooling) | |
| mode.winter | set winter mode (heating) | |
| <address>.setpoint | mode | cycle through the manual, automatic and off operation modes |
| mode.comfort | set comfort operation mode | |
| mode.eco | set eco operation mode | |
| mode.off | off mode | |
| temp.up | increase the active setpoint temperature in 0.5C steps | |
| temp.down | ddecrease the active setpoint temperature in 0.5C steps | |
| temp.<t> | active setpoint set to temperature t, in C/10 (0 <= t <= 355) | |
| temp.1.up | increase comfort setpoint temperature in 0.5C steps | |
| temp.1.down | decrease comfort setpoint temperature in 0.5C steps | |
| temp.1.<t> | comfort setpoint set to temperature t, in C/10 (0 <= t <= 355) | |
| temp.2.up | increase eco setpoint temperature in 0.5C steps | |
| temp.2.down | decrease eco setpoint temperature in 0.5C steps | |
| temp.2.<t> | eco setpoint set to temperature t, in C/10 (0 <= t <= 355) | |
| temp.man.up | increase setpoint temperature limit in 0.5C steps | |
| temp.man.down | decrease setpoint temperature limit in 0.5C steps | |
| temp.man.<t> | set-point temperature limit set to temperature t, in C/10 (0 <= t <= 355) |
