Difference between revisions of "Contatto"

From HSYCO
Jump to navigation Jump to search
Line 2,640: Line 2,640:
 
!Description
 
!Description
 
|-
 
|-
 +
 +
|o<address>.<channel>
 +
|refresh
 +
|RW
 +
|update the state of the DALI devices
 +
|-
 +
 +
|rowspan="2"|o<address>.<channel><br/>o<address>.<channel>.all<br/>o<address>.<channel>.0
 +
|off
 +
|RW
 +
|switch off all available DALI devices
 +
|-
 +
|<level>
 +
|RW
 +
|set a level for all available devices
 +
|-
 +
 +
|rowspan="2"|o<address>.<channel>.group.<DALI group>
 +
|off
 +
|RW
 +
|switch off all DALI devices on that group
 +
|-
 +
|<level>
 +
|RW
 +
|set a level for all DALI devices in that group
 +
|-
 +
 +
|rowspan="3"|o<address>.<channel>.<DALI address>
 +
|off
 +
|RW
 +
|switch off a single DALI device
 +
|-
 +
|<level>
 +
|RW
 +
|set a level for a single DALI device
 +
|-
 +
|>100
 +
|RW
 +
|special functions: possible values are described in the MODDALI Programming Handbook
 +
|-
 +
 +
|rowspan="2"|i<address>.<channel>.polling
 +
|off
 +
|RW
 +
|polling disabled
 +
|-
 +
|on
 +
|RW
 +
|polling enabled
 +
|-
 +
 +
|rowspan="2"|i<address>.<channel>.test
 +
|0
 +
|RW
 +
|test button not pressed
 +
|-
 +
|1
 +
|RW
 +
|test button pressed
 +
|-
 +
 +
|rowspan="4"|i<address>.<channel>.dali
 +
|nopower
 +
|RW
 +
|lamp failure
 +
|-
 +
|open
 +
|RW
 +
|DALI line broken
 +
|-
 +
|short
 +
|RW
 +
|DALI line short circuit
 +
|-
 +
|on
 +
|RW
 +
|on DALI line
 +
|-
 +
 +
|rowspan="2"|i<address>.<channel>.1
 +
|fault
 +
|RW
 +
|ballast 1 lamp failure
 +
|-
 +
|unknown
 +
|RW
 +
|ballast 1 lamp unknown state
 +
|-
 +
 +
|}
 +
 +
The channel 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 “x/y”, where 0 <= x <= y
 +
values in the range 101÷255. Values and commands are described in the MODDALI Programming Handbook.
 +
 +
=== CLIMA2 ===
 +
 +
Module for the regulation of the ambient temperature.
 +
It takes 1 input and 1 output address that are equal each one to the other, so only a base address is needed.
 +
 +
{| class="wikitable"
 +
!ID
 +
!Value
 +
!R/W
 +
!Description
 +
|-
 +
 +
|rowspan="2"|i<address>
 +
|on<br/>1
 +
|R
 +
|zone on
 +
|-
 +
|off<br/>0
 +
|R
 +
|zone off
 +
|-
 +
 +
|rowspan="2"|i<address>.mode
 +
|summer
 +
|R
 +
|summer mode
 +
|-
 +
|winter
 +
|R
 +
|winter mode
 +
|-
 +
 +
|rowspan="3"|i<address>.status
 +
|off<br/>0
 +
|R
 +
|off status
 +
|-
 +
|heating
 +
|R
 +
|heating request
 +
|-
 +
|cooling
 +
|R
 +
|cooling request
 +
|-
 +
 +
|rowspan="4"|i<address>.fan
 +
|off<br/>0
 +
|R
 +
|fan off
 +
|-
 +
|min
 +
|R
 +
|min speed
 +
|-
 +
|med
 +
|R
 +
|med speed
 +
|-
 +
|max
 +
|R
 +
|max speed
 +
|-
 +
 +
|rowspan="2"|i<address>.temp
 +
|fault
 +
|R
 +
|NTC probe fault
 +
|-
 +
|<temp>
 +
|R
 +
|ambient temperature value, in C/10
 +
|-
 +
 +
|i<address>.setpoint.temp
 +
|<temp>
 +
|R
 +
|real setpoint value, in C/10
 +
|-
 +
 +
|i<address>.knob
 +
|0...1000
 +
|R
 +
|position of rotary knob
 +
|-
 +
 +
|rowspan="2"|o<address>.mode
 +
|summer
 +
|RW
 +
|set summer
 +
|-
 +
|winter
 +
|RW
 +
|set winter
 +
|-
 +
 +
|rowspan="2"|o<address>
 +
|on<br/>1
 +
|RW
 +
|zone on
 +
|-
 +
|off<br/>0
 +
|RW
 +
|zone off
 +
|-
 +
 +
|o<address>.setpoint.temp
 +
|0...400
 +
|RW
 +
|set and read the value of central setpoint (temp in C/10)
 +
|-
 +
 +
|o<address>.setpoint.delta.neg
 +
|<temp>
 +
|RW
 +
|set and read the MAX negative delta
 +
|-
 +
 +
|o<address>.setpoint.delta.pos
 +
|<temp>
 +
|RW
 +
|set and read the MAX positive delta
 +
|-
 +
 +
|rowspan="4"|o<address>.led.1
 +
|red<br/>r
 +
|RW
 +
|LED 1 red
 +
|-
 +
|green<br/>g
 +
|RW
 +
|LED 1 green
 +
|-
 +
|yellow<br/>y
 +
|RW
 +
|LED 1 yellow
 +
|-
 +
|off<br/>0
 +
|RW
 +
|set off
 +
|-
 +
 +
|rowspan="4"|o<address>.led.2
 +
|red<br/>r
 +
|RW
 +
|LED 2 red
 +
|-
 +
|green<br/>g
 +
|RW
 +
|LED 2 green
 +
|-
 +
|yellow<br/>y
 +
|RW
 +
|LED 2 yellow
 +
|-
 +
|off<br/>0
 +
|RW
 +
|set off
 +
|-
 +
 +
|rowspan="4"|o<address>.led.3
 +
|red<br/>r
 +
|RW
 +
|LED 3 red
 +
|-
 +
|green<br/>g
 +
|RW
 +
|LED 3 green
 +
|-
 +
|yellow<br/>y
 +
|RW
 +
|LED 3 yellow
 +
|-
 +
|off<br/>0
 +
|RW
 +
|set off
 +
|-
 +
 +
|rowspan="4"|o<address>.led.4
 +
|red<br/>r
 +
|RW
 +
|LED 4 red
 +
|-
 +
|green<br/>g
 +
|RW
 +
|LED 4 green
 +
|-
 +
|yellow<br/>y
 +
|RW
 +
|LED 4 yellow
 +
|-
 +
|off<br/>0
 +
|RW
 +
|set off
 +
|-
 +
 +
|}
 +
 +
=== MODANA ===
 +
 +
Network analyzer module for Contatto bus.
 +
It uses, in dynamic mode, up to a maximum of 5 consecutive input addresses and, if enabled, 1 output address equal to the base address.
 +
The module must be configured with the same base address for input and output. For example: (I7, O7).
 +
 +
{| class="wikitable"
 +
!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
 +
|-
 +
 +
|i<address>.q1
 +
|[W]
 +
|R
 +
|reactive power phase 1
 +
|-
 +
 +
|i<address>.q1k
 +
|[kW]
 +
|R
 +
|reactive power phase 1
 +
|-
 +
 +
|i<address>.q2
 +
|[W]
 +
|R
 +
|reactive power phase 2
 +
|-
 +
 +
|i<address>.q2k
 +
|[kW]
 +
|R
 +
|reactive power phase 2
 +
|-
 +
 +
|i<address>.q3
 +
|[W]
 +
|R
 +
|reactive power phase 3
 +
|-
 +
 +
|i<address>.q3k
 +
|[kW]
 +
|R
 +
|reactive power phase 3
 +
|-
 +
 +
|i<address>.pf1
 +
|[pf]
 +
|R
 +
|power factor phase 1
 +
|-
 +
 +
|i<address>.pf2
 +
|[pf]
 +
|R
 +
|power factor phase 2
 +
|-
 +
 +
|i<address>.pf3
 +
|[pf]
 +
|R
 +
|power factor phase 3
 +
|-
 +
 +
|i<address>.s1
 +
|[VA]
 +
|R
 +
|apparent power phase 1
 +
|-
 +
 +
|i<address>.s1k
 +
|[kVA]
 +
|R
 +
|apparent power phase 1
 +
|-
 +
 +
|i<address>.s2
 +
|[VA]
 +
|R
 +
|apparent power phase 2
 +
|-
 +
 +
|i<address>.s2k
 +
|[kVA]
 +
|R
 +
|apparent power phase 2
 +
|-
 +
 +
|i<address>.s3
 +
|[VA]
 +
|R
 +
|apparent power phase 3
 +
|-
 +
 +
|i<address>.s3k
 +
|[kVA]
 +
|R
 +
|apparent power phase 3
 +
|-
 +
 +
|i<address>.stot
 +
|[VA]
 +
|R
 +
|total apparent power
 +
|-
 +
 +
|i<address>.hours
 +
|[hours]
 +
|R
 +
|hour-meter
 +
|-
 +
 +
|i<address>.temperature
 +
|[°C]
 +
|R
 +
|cabinet temperature
 +
|-
 +
 +
|i<address>.energy.active
 +
|[Wh]
 +
|R
 +
|positive active energy
 +
|-
 +
 +
|i<address>.energy.activeneg
 +
|[Wh]
 +
|R
 +
|negative active energy
 +
|-
 +
 +
|i<address>.energy.reactive
 +
|[VARh]
 +
|R
 +
|positive reactive energy
 +
|-
 +
 +
|i<address>.energy.reactiveneg
 +
|[VARh]
 +
|R
 +
|negative reactive energy
 +
|-
 +
 +
|i<address>.pm
 +
|[W]
 +
|R
 +
|average positive active power
 +
|-
 +
 +
|i<address>.qm
 +
|[VAR]
 +
|R
 +
|average positive reactive power
 +
|-
 +
 +
|rowspan="2"|i<address>.reset.energy
 +
|1
 +
|RW
 +
|reset energies
 +
|-
 +
|0
 +
|RW
 +
|
 +
|-
 +
 +
|rowspan="2"|i<address>.reset.hours
 +
|1
 +
|RW
 +
|reset hour-meter
 +
|-
 +
|0
 +
|RW
 +
|
 +
|-
 +
 +
|}

Revision as of 18:06, 10 February 2014

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.

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 addresses
detected.output.<n>. model name an output device of the type passed as value has been detected at address <n>, using addresses

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

MOD8I/A

8 digital input module for NO contacts in modular housing. It uses one input 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
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

MOD32I/A

32 digital input module for NO contacts in modular housing. It uses four addresses of the Contatto bus, one for each group of 8 inputs.

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+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
i<address+1>.5 0 R input pin 5 off
1 R input pin 5 on
i<address+1>.6 0 R input pin 6 off
1 R input pin 6 on
i<address+1>.7 0 R input pin 7 off
1 R input pin 7 on
i<address+1>.8 0 R input pin 8 off
1 R input pin 8 on
i<address+2>.1 0 R input pin 1 off
1 R input pin 1 on
i<address+2>.2 0 R input pin 2 off
1 R input pin 2 on
i<address+2>.3 0 R input pin 3 off
1 R input pin 3 on
i<address+2>.4 0 R input pin 4 off
1 R input pin 4 on
i<address+2>.5 0 R input pin 5 off
1 R input pin 5 on
i<address+2>.6 0 R input pin 6 off
1 R input pin 6 on
i<address+2>.7 0 R input pin 7 off
1 R input pin 7 on
i<address+2>.8 0 R input pin 8 off
1 R input pin 8 on
i<address+3>.1 0 R input pin 1 off
1 R input pin 1 on
i<address+3>.2 0 R input pin 2 off
1 R input pin 2 on
i<address+3>.3 0 R input pin 3 off
1 R input pin 3 on
i<address+3>.4 0 R input pin 4 off
1 R input pin 4 on
i<address+3>.5 0 R input pin 5 off
1 R input pin 5 on
i<address+3>.6 0 R input pin 6 off
1 R input pin 6 on
i<address+3>.7 0 R input pin 7 off
1 R input pin 7 on
i<address+3>.8 0 R input pin 8 off
1 R input pin 8 on

MOD8INP2/A

8 digital input module for NO contacts. It uses one input address of 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
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

MOD8INP2/C

8 digital input module for NC contacts. It uses one input address of 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
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

MOAN/I

0÷10V analog input module. It uses one input address in the range 1 to 127 of the Contatto bus.

ID Value R/W Description
i<address>.1 0...255 R voltage value divided in 255 steps

MOAN/I4

Quad 0÷10V analog input module. It uses four consecutive addresses of the Contatto bus, one for each input.

ID Value R/W Description
i<address>.1 0...255 R voltage value divided in 255 steps
i<address+1>.1 0...255 R voltage value divided in 255 steps
i<address+2>.1 0...255 R voltage value divided in 255 steps
i<address+3>.1 0...255 R voltage value divided in 255 steps

MI420

4÷20mA analog input module. It uses one input address in the range 1 to 127 of the Contatto bus.

ID Value R/W Description
i<address>.1 0...255 R current value divided in 255 steps

MI420-X4

Quad 4÷20mA analog input module. It uses four consecutive addresses of the Contatto bus, one for each input.

ID Value R/W Description
i<address>.1 0...255 R current value divided in 255 steps
i<address+1>.1 0...255 R current value divided in 255 steps
i<address+2>.1 0...255 R current value divided in 255 steps
i<address+3>.1 0...255 R current value divided in 255 steps

MOD4AM12/V/I

4-channel 0÷10V or 4÷20mA (0÷21mA) analog input module. It uses one input address of the Contatto bus.

ID Value R/W Description
i<address>.1 0...4095 R measurement range divided in 4095 steps
i<address>.2 0...4095 R measurement range divided in 4095 steps
i<address>.3 0...4095 R measurement range divided in 4095 steps
i<address>.4 0...4095 R measurement range divided in 4095 steps

MOD2PT

Input module for two PT100 temperature probes. It uses one or two addresses according to how the dip-switch is set. If both channels are enabled (IN1 and IN2), setting the n “base” address through the FXPRO programmer, the input address and address+1 (consecutive) will be automatically assigned to the module.

ID Value R/W Description
i<address>.1 0...255 R range –40 ÷ +87.5°C: code 0 corresponds to –40°C and code 255 corresponds to +87.5°C
i<address+1>.1 0...255 R range –40 ÷ +87.5°C: code 0 corresponds to –40°C and code 255 corresponds to +87.5°C

MODCNT

4-channel counter module in modular housing. It uses one input address of the Contatto bus.

ID Value R/W Description
i<address>.1 0...65535 R number of pulses
i<address>.2 0...65535 R number of pulses
i<address>.3 0...65535 R number of pulses
i<address>.4 0...65535 R number of pulses

MODNTC

Input module for ambient temperature sensors and potentiometers. It uses one input address of the Contatto bus. The temperature values measured by MODNTC module are reported as Kelvin degrees multiplied by 10; in other words, 0°C will be reported as 2730, 0.1°C will be reported as 2731 and so on. Concerning the potentiometer channels, the values read from the module will be 0 with the potentiometer at its minimum position and it will be 1000 with the potentiometer at its maximum position.

ID Value R/W Description
i<address>.1 0...4095 R temperature value
i<address>.2 0...4095 R temperature value
i<address>.3 0...4095 R temperature value
i<address>.4 0...4095 R temperature value

MOD4I/A

4-digital input module for NO contacts in modular housing. It uses one input address in the range 1 to 127 of the Contatto bus.

ID Value R/W Description
i<address> 0 R input pin 1 off
1 R input pin 1 on
i<address+1> 0 R input pin 1 off
1 R input pin 1 on
i<address+2> 0 R input pin 1 off
1 R input pin 1 on
i<address+3> 0 R input pin 1 off
1 R input pin 1 on

MOD4I/S

4-digital input module for NO contacts in 2M modular housing. It uses one address of the Contatto bus.

ID Value R/W Description
i<address> 0 R input pin 1 off
1 R input pin 1 on
i<address+1> 0 R input pin 1 off
1 R input pin 1 on
i<address+2> 0 R input pin 1 off
1 R input pin 1 on
i<address+3> 0 R input pin 1 off
1 R input pin 1 on

MODLUX

Ambient light measurement module with sensor for ceiling mounting. It uses one address of the Contatto bus.

ID Value R/W Description
i<address>.1 0...1023 R ambient brightness value

MODMETEO

Meteorological data detection module for Contatto bus. It uses one input address and, if enabled by the configuration panel of MCP IDE, one output address with the same value.

ID Value R/W Description
i<address>.temp <temp> R temperature value (in C/10)
i<address>.lux <lux*10> R daylight value in tens of LUX
i<address>.wind 1 m/s / 10 R wind speed value
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 temperature < threshold
1 R measured temperature > threshold
i<address>.lux.limit 0 R measured daylight < threshold
1 R measured daylight > threshold
i<address>.wind.limit 0 R measured wind speed < threshold
1 R measured wind speed > threshold
i<address>.light.south 0 R light not from South
1 R light from South
i<address>.light.west 0 R light not from West
1 R light from West
i<address>.light.east 0 R light not from East
1 R light from East
i<address>.fault 0 R sensor works correctly
1 R lsensor failure
o<address>.temp <temp> RW temperature threshold (in C/10)
off RW temperature threshold off
o<address>.lux <lux*10> RW daylight threshold
off RW daylight threshold off
o<address>.wind 1 m/s / 10 RW wind speed threshold
off RW wind speed threshold off

MOD8R

8 power relay output module. It uses one output address of the Contatto 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
o<address>.5 0
off 		RW output pin 5 off
1
on 		RW output pin 5 on
o<address>.6 0
off 		RW output pin 6 off
1
on 		RW output pin 6 on
o<address>.7 0
off 		RW output pin 7 off
1
on 		RW output pin 7 on
o<address>.8 0
off 		RW output pin 8 off
1
on 		RW output pin 8 on

MODPNP

8 positive logic (PNP) “open collector” digital output module. It uses one output address in the range 1 to 127 of the Contatto 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
o<address>.5 0
off 		RW output pin 5 off
1
on 		RW output pin 5 on
o<address>.6 0
off 		RW output pin 6 off
1
on 		RW output pin 6 on
o<address>.7 0
off 		RW output pin 7 off
1
on 		RW output pin 7 on
o<address>.8 0
off 		RW output pin 8 off
1
on 		RW output pin 8 on

MODREL

8 relay output compact module in DIN 3M housing. It uses one output address in the range 1 to 127 of the Contatto 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
o<address>.5 0
off 		RW output pin 5 off
1
on 		RW output pin 5 on
o<address>.6 0
off 		RW output pin 6 off
1
on 		RW output pin 6 on
o<address>.7 0
off 		RW output pin 7 off
1
on 		RW output pin 7 on
o<address>.8 0
off 		RW output pin 8 off
1
on 		RW output pin 8 on

MOAN/U

0÷10V analog output module. It uses one output address in the range 1 to 127 of the Contatto bus.

ID Value R/W Description
o<address> x/255 R value in fractional format, where 0 ≤ x ≤ 255
o<address> <x%> W the percentage of signal (0÷100%) applied to the output
0...255 W convert the 8 bits digital code received through the bus in the proper analog level.
x/y W fractional format, formatted as “x/y”, where 0 ≤ x ≤ y

MO420

4÷20mA analog output module. It uses one output address in the range 1 to 127 of the Contatto bus.

ID Value R/W Description
o<address> <x%> RW the percentage of signal (0÷100%) applied to the output
0...255 RW convert the 8 bits digital code received through the bus in the proper analog level
x/y RW fractional format, formatted as “x/y”, where 0 ≤ x ≤ y

MODLC

Ambient light regulator module with integrated sensor. It uses one input address and, if enabled by the configuration panel of MCP IDE, one output address with the same value.

ID Value R/W Description
i<address>.lux value equivalent to three times the brightness in lux detected by the sensor R the brightness value in lux detected by the MODLC
i<address>.level calculated value for the automatic brightness regulation R the value to be sent to the dimmer in order to execute the automatic regulation
i<address>.mode auto R automatic regulation
man R manual regulation
i<address>.in 0 R digital input OFF
1 R digital input ON
o<address>.setpoint setpoint value RW set the setpoint for the automatic brightness regulation
o<address>.mode auto RW set automatic regulation
man RW set manual regulation
o<address>.in.reset 0 RW not active
1 R force the expiring of the deactivation delay time of the digital input
o<address>.mode.reset 0 RW not active
1 R disable the automatic regulation and it reset the input channel

MOD4-4S

4 digital input and 4 power relay output multifunction module. HSYCO supports two configurations only: four independent outputs, or two shutters. When set as four independent outputs, the module must be configured with the same base address for input and output. For example: (I20, O20). The input address must be enabled. Configuration switches must be set as SW1=OFF, SW2=OFF and SW5=ON. When set as two shutters, the module must be configured with the same base address for input and output. For example: (I20, O20, O21). The input address must be enabled. Configuration switches must be set as SW1=ON, SW2=ON and SW5=ON.

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
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+1>.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>.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

MOD2-2R

2 digital input and 2 power relay output module. It uses one input address and one output address in the range 1 to 127 of the Contatto bus. The input and the output addresses may be the same or they can be different each one to the other.

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
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

MOD4-4R

4 digital input and 4 digital output module. It uses one input address and one output address in the range 1 to 127 of the Contatto bus. The input and the output addresses may be the same or they can be different each one to the other.

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
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

MOD2DM

2x300W dimmer module. It uses 2 output addresses (one for each dimmer channel) and 2 input addresses. HSYCO supports this module only when its dip-switches are set as SW1=ON, SW2=ON, SW3=ON, SW4=ON.

ID Value R/W Description
i<address> 0...100 R brightness level according to current ramp
off R dimmer off
i<address+1> 0...100 R brightness level according to current ramp
off R dimmer off
o<address> 0...100 R brightness level according to current ramp
off R dimmer off
o<address+1> 0...100 R brightness level according to current ramp
off R dimmer off

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.

MOD2DV

Dual 1-10V output for electronic ballast driving. It uses 2 output addresses (one for each dimmer channel) and 2 input addresses. HSYCO supports this module only when its dip-switches are set as SW1=ON, SW2=ON, SW3=ON, SW4=ON.

ID Value R/W Description
i<address> 0...100 R brightness level according to current ramp
off R dimmer off
i<address+1> 0...100 R brightness level according to current ramp
off R dimmer off
o<address> 0...100 R brightness level according to current ramp
off R dimmer off
o<address+1> 0...100 R brightness level according to current ramp
off R dimmer off

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.

MOD8IL

8 digital input – 8 LED output module for wall box. It uses 1 input address and 1 output address.

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>.5 0
off 		R input pin 5 off
1
on 		R input pin 5 on
i<address>.6 0
off 		R input pin 6 off
1
on 		R input pin 6 on
i<address>.7 0
off 		R input pin 7 off
1
on 		R input pin 7 on
i<address>.8 0
off 		R input pin 8 off
1
on 		R input pin 8 on
o<address>.1 0
off 		R output pin 1 off
1
on 		R output pin 1 on
o<address>.2 0
off 		R output pin 2 off
1
on 		R output pin 2 on
o<address>.3 0
off 		R output pin 3 off
1
on 		R output pin 3 on
o<address>.4 0
off 		R output pin 4 off
1
on 		R output pin 4 on
o<address>.5 0
off 		R output pin 5 off
1
on 		R output pin 5 on
o<address>.6 0
off 		R output pin 6 off
1
on 		R output pin 6 on
o<address>.7 0
off 		R output pin 7 off
1
on 		R output pin 7 on
o<address>.8 0
off 		R output pin 8 off
1
on 		R output pin 8 on

MOD4DV

Quad 0-10V output module for generic applications or for external dimmers control. It uses 4 consecutive output addresses (one for each dimmer channel) and 4 input addresses. HSYCO supports this module only when its dip-switches are set as SW1=ON, SW2=ON, SW3=ON, SW4=ON, SW5=OFF.

ID Value R/W Description
i<address> 0...100 R brightness level according to current ramp
off R dimmer off
i<address+1> 0...100 R brightness level according to current ramp
off R dimmer off
i<address+2> 0...100 R brightness level according to current ramp
off R dimmer off
i<address+3> 0...100 R brightness level according to current ramp
off R dimmer off
o<address> 0...100 R brightness level according to current ramp
off R dimmer off
o<address+1> 0...100 R brightness level according to current ramp
off R dimmer off
o<address+2> 0...100 R brightness level according to current ramp
off R dimmer off
o<address+3> 0...100 R brightness level according to current ramp
off R dimmer off

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 “x/y”, where 0 <= x <= y values in the range 101÷255. Values and commands are described in the MOD4DV Programming Handbook (Operation from the bus, page 3).

MODDMX

ModDMX module allows to handle, through the Contatto bus, up to 32 DMX devices. ModDMX module makes possible the communication on the first 64 of 512 DMX channels allowed by this protocol. It uses 1 output address, 1-channel 16-bit.

ID Value R/W Description
o<address>.<DMX address> 0...100 RW Values and commands are described in the MODDMX Programming Handbook

MODDALI

ModDALI module allows the management, through the Contatto bus, of 4 DALI lines upon it's possible to connect up to 32 devices for line (or channel). In this way it's possible to control and regulate up to 128 DALI ballasts (or other similar devices). It uses 1 output address and, if enabled, 1 input address with the same value.

ID Value R/W Description
o<address>.<channel> refresh RW update the state of the DALI devices
o<address>.<channel>
o<address>.<channel>.all
o<address>.<channel>.0 		off RW switch off all available DALI devices
<level> RW set a level for all available devices
o<address>.<channel>.group.<DALI group> off RW switch off all DALI devices on that group
<level> RW set a level for all DALI devices in that group
o<address>.<channel>.<DALI address> off RW switch off a single DALI device
<level> RW set a level for a single DALI device
>100 RW special functions: possible values are described in the MODDALI Programming Handbook
i<address>.<channel>.polling off RW polling disabled
on RW polling enabled
i<address>.<channel>.test 0 RW test button not pressed
1 RW test button pressed
i<address>.<channel>.dali nopower RW lamp failure
open RW DALI line broken
short RW DALI line short circuit
on RW on DALI line
i<address>.<channel>.1 fault RW ballast 1 lamp failure
unknown RW ballast 1 lamp unknown state

The channel 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 “x/y”, where 0 <= x <= y values in the range 101÷255. Values and commands are described in the MODDALI Programming Handbook.

CLIMA2

Module for the regulation of the ambient temperature. It takes 1 input and 1 output address that are equal each one to the other, so only a base address is needed.

ID Value R/W Description
i<address> on
1 		R zone on
off
0 		R zone off
i<address>.mode summer R summer mode
winter R winter mode
i<address>.status off
0 		R off status
heating R heating request
cooling R cooling request
i<address>.fan off
0 		R fan off
min R min speed
med R med speed
max R max speed
i<address>.temp fault R NTC probe fault
<temp> R ambient temperature value, in C/10
i<address>.setpoint.temp <temp> R real setpoint value, in C/10
i<address>.knob 0...1000 R position of rotary knob
o<address>.mode summer RW set summer
winter RW set winter
o<address> on
1 		RW zone on
off
0 		RW zone off
o<address>.setpoint.temp 0...400 RW set and read the value of central setpoint (temp in C/10)
o<address>.setpoint.delta.neg <temp> RW set and read the MAX negative delta
o<address>.setpoint.delta.pos <temp> RW set and read the MAX positive delta
o<address>.led.1 red
r 		RW LED 1 red
green
g 		RW LED 1 green
yellow
y 		RW LED 1 yellow
off
0 		RW set off
o<address>.led.2 red
r 		RW LED 2 red
green
g 		RW LED 2 green
yellow
y 		RW LED 2 yellow
off
0 		RW set off
o<address>.led.3 red
r 		RW LED 3 red
green
g 		RW LED 3 green
yellow
y 		RW LED 3 yellow
off
0 		RW set off
o<address>.led.4 red
r 		RW LED 4 red
green
g 		RW LED 4 green
yellow
y 		RW LED 4 yellow
off
0 		RW set off

MODANA

Network analyzer module for Contatto bus. It uses, in dynamic mode, up to a maximum of 5 consecutive input addresses and, if enabled, 1 output address equal to the base address. The module must be configured with the same base address for input and output. For example: (I7, O7).

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
i<address>.q1 [W] R reactive power phase 1
i<address>.q1k [kW] R reactive power phase 1
i<address>.q2 [W] R reactive power phase 2
i<address>.q2k [kW] R reactive power phase 2
i<address>.q3 [W] R reactive power phase 3
i<address>.q3k [kW] R reactive power phase 3
i<address>.pf1 [pf] R power factor phase 1
i<address>.pf2 [pf] R power factor phase 2
i<address>.pf3 [pf] R power factor phase 3
i<address>.s1 [VA] R apparent power phase 1
i<address>.s1k [kVA] R apparent power phase 1
i<address>.s2 [VA] R apparent power phase 2
i<address>.s2k [kVA] R apparent power phase 2
i<address>.s3 [VA] R apparent power phase 3
i<address>.s3k [kVA] R apparent power phase 3
i<address>.stot [VA] R total apparent power
i<address>.hours [hours] R hour-meter
i<address>.temperature [°C] R cabinet temperature
i<address>.energy.active [Wh] R positive active energy
i<address>.energy.activeneg [Wh] R negative active energy
i<address>.energy.reactive [VARh] R positive reactive energy
i<address>.energy.reactiveneg [VARh] R negative reactive energy
i<address>.pm [W] R average positive active power
i<address>.qm [VAR] R average positive reactive power
i<address>.reset.energy 1 RW reset energies
0 RW
i<address>.reset.hours 1 RW reset hour-meter
0 RW
Retrieved from "https://wiki.hsyco.com/3.8/index.php?title=Contatto&oldid=1977"