| layout | title |
|---|---|
documentation |
MT2759 - ZWave |
{% include base.html %}
This describes the Z-Wave device MT2759, manufactured by Devolo with the thing type UID of devolo_mt2759_00_000.
The device is in the category of Wall Switch, defining Any device attached to the wall that controls a binary status of something, for ex. a light switch.
The MT2759 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data between other devices in the mesh network.
This Z-Wave module is used for switching on or off the electrical device (e.g. light or fan). The module operates on 868,4 MHz. The module can be controlled either through Z-wave network or through the wall switch. The module is designed to be mounted inside a “flush mounting box”, hidden behind a traditional wall switch. Module measures power consumption of electrical device and supports connection of digital temperature sensor. It is designed to act as repeater in order to improve range and stability of Z-wave network.
Module supports mono stable switches (push button) and bi stable switches. The module is factory set to operate with bi stable switches.
- Connect module to power supply (with temperature sensor connected if purchased*),
- enable add/remove mode on main controller
- auto inclusion (works for about 2 minutes after connected to power supply) or
- press push button I1 three times within 5 s (3 times change switch state within 5 seconds) or
- press service button S (only applicable for 24 V SELVsupply voltage) for more than 2 second
NOTE 1: For auto inclusion procedure, first set main controller into inclusion mode and then connect module to power supply.
NOTE 2: When connecting temperature sensor to module that has already been included, you have to exclude module first. Switch off power supply, connect the sensor and re include the module.
Module Exclusion/Reset (Removing from Z-Wave network)
- Connect module to power supply
- bring module within maximum 1 meter (3 feet) of the main controller,
- enable add/remove mode on main controller
- press push button I1 five times within 5 s (5 times change switch state within 5 seconds) in the first 60 seconds after the module is connected to the power supply or
- press service button S (only applicable for 24 V SELV supply voltage) for more than 6 seconds.
By this function all parameters of the module are set to default values and own ID is deleted.
Please use this procedure only when the network primary controller is missing or otherwise inoperable.
If push button I1 is pressed three times within 5 s (or service button S is pressed more than 2 and less than 6 seconds) module is excluded, but configuration parameters are not set to default values.
NOTE: If the module is included with parameters 100 or 101 with values different to default and module reset is done, wait at least 30s before next inclusion.
The following table summarises the channels available for the MT2759 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Switch | switch_binary | switch_binary | Switch | Switch |
| Binary Sensor | sensor_binary | sensor_binary | Switch | |
| Electric meter (watts) | meter_watts | meter_watts | Energy | Number |
| Electric meter (kWh) | meter_kwh | meter_kwh | Energy | Number |
| Alarm (power) | alarm_power | alarm_power | Energy | Switch |
| Switch 1 | switch_binary1 | switch_binary | Switch | Switch |
| Electric meter (watts) 1 | meter_watts1 | meter_watts | Energy | Number |
| Electric meter (kWh) 1 | meter_kwh1 | meter_kwh | Energy | Number |
| Alarm (power) 1 | alarm_power1 | alarm_power | Energy | Switch |
| Binary Sensor 2 | sensor_binary2 | sensor_binary | Switch | |
| Alarm (burglar) 2 | alarm_burglar2 | alarm_burglar | Door | Switch |
| Binary Sensor 3 | sensor_binary3 | sensor_binary | Switch | |
| Alarm (burglar) 3 | alarm_burglar3 | alarm_burglar | Door | Switch |
Switch the power on and off.
The switch_binary channel is of type switch_binary and supports the Switch item and is in the Switch category.
Indicates if a sensor has triggered.
The sensor_binary channel is of type sensor_binary and supports the Switch item. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| ON | Triggered |
| OFF | Untriggered |
Indicates the instantaneous power consumption.
The meter_watts channel is of type meter_watts and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates the energy consumption (kWh).
The meter_kwh channel is of type meter_kwh and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates if a power alarm is triggered.
The alarm_power channel is of type alarm_power and supports the Switch item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| OFF | OK |
| ON | Alarm |
Switch the power on and off.
The switch_binary1 channel is of type switch_binary and supports the Switch item and is in the Switch category.
Indicates the instantaneous power consumption.
The meter_watts1 channel is of type meter_watts and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates the energy consumption (kWh).
The meter_kwh1 channel is of type meter_kwh and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
Indicates if a power alarm is triggered.
The alarm_power1 channel is of type alarm_power and supports the Switch item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| OFF | OK |
| ON | Alarm |
Indicates if a sensor has triggered.
The sensor_binary2 channel is of type sensor_binary and supports the Switch item. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| ON | Triggered |
| OFF | Untriggered |
Indicates if the burglar alarm is triggered.
The alarm_burglar2 channel is of type alarm_burglar and supports the Switch item and is in the Door category. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| OFF | OK |
| ON | Alarm |
Indicates if a sensor has triggered.
The sensor_binary3 channel is of type sensor_binary and supports the Switch item. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| ON | Triggered |
| OFF | Untriggered |
Indicates if the burglar alarm is triggered.
The alarm_burglar3 channel is of type alarm_burglar and supports the Switch item and is in the Door category. This is a read only channel so will only be updated following state changes from the device.
The following state translation is provided for this channel to the Switch item type -:
| Value | Label |
|---|---|
| OFF | OK |
| ON | Alarm |
The following table provides a summary of the 15 configuration parameters available in the MT2759. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | (I1) Input 1 switch type | (I1) Input 1 switch type |
| 2 | (I2) Input 2 contact type | (I2) Input 2 contact type |
| 3 | (I3) Input 3 contact type | (I3) Input 3 contact type |
| 10 | ALL ON/ALL OFF | Activate / deactivate functions ALL ON/ALL OFF |
| 11 | Automatic turning off | Automatic turning off output after set time |
| 12 | Automatic turning on | Automatic turning on output after set time |
| 15 | Auto off / on, s or ms selection | Automatic turning off / on seconds or milliseconds selection |
| 30 | Saving the state | Saving the state of the relay after a power failure |
| 40 | Power reporting (W) on power change | Power reporting in Watts on power change |
| 42 | Power reporting (W) by time interval | Power reporting in Watts by time interval |
| 63 | Output Switch selection | Output Switch selection |
| 100 | Enable / Disable Endpoint I2 | Enable / Disable Endpoint I2 or select Notification Type and Event |
| 101 | Enable / Disable Endpoint I3 | Enable / Disable Endpoint I3 or select Notification Type and Event |
| 110 | Temperature sensor offset settings | Temperature sensor offset settings |
| 120 | Temperature sensor reporting | Temperature sensor reporting |
| Switch All Mode | Set the mode for the switch when receiving SWITCH ALL commands |
(I1) Input 1 switch type
<td>
Description
</td>
<td>
mono stable switch type (push button)
</td>
<td>
bi stable switch type (default)
</td>
| Values |
| 1 |
| Value | Description |
|---|---|
| 0 | mono stable switch type (push button) |
| 1 | bi-stable switch type (default) |
The manufacturer defined default value is 1 (bi-stable switch type (default)).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
(I2) Input 2 contact type
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | NO (normally open) input type (default) |
| 1 | NC (normally close) input type |
The manufacturer defined default value is 0 (NO (normally open) input type (default)).
This parameter has the configuration ID config_2_1 and is of type INTEGER.
(I3) Input 3 contact type
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | NO (normally open) input type (default) |
| 1 | NC (normally close) input type |
The manufacturer defined default value is 0 (NO (normally open) input type (default)).
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Activate / deactivate functions ALL ON/ALL OFF HC Switch relay module responds to commands ALL ON / ALL OFF that may be sent by the main controller or by other controller belonging to the system. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | NONE |
| 1 | ALL OFF |
| 2 | ALL ON |
| 255 | ALL ON / ALL OFF (Default) |
The manufacturer defined default value is 255 (ALL ON / ALL OFF (Default)).
This parameter has the configuration ID config_10_1 and is of type INTEGER.
Automatic turning off output after set time When relay is ON it goes automatically OFF after time defined by this parameter. Timer is reset to zero each time the module receive ON command regardless from where it comes (push button, associated module, controller,..).
- default value 0
- 0 = Auto OFF disabled
- 1 - 32535 = 1 second (0,01s) - 32535 seconds (325,35s)
Auto OFF enabled with define time, step is 1s or 10ms according to parameter nr. 15. The following option values may be configured, in addition to values in the range 0 to 32535 -:
| Value | Description |
|---|---|
| 0 | AUTO OFF disabled |
The manufacturer defined default value is 0 (AUTO OFF disabled).
This parameter has the configuration ID config_11_2 and is of type INTEGER.
Automatic turning on output after set time When relay is OFF it goes automatically ON after time defined by this parameter. Timer is reset to zero each time the module receive OFF command regardless from where it come s (push button, associated module, controller,..).
Available configuration parameters (data type is 2 Byte DEC):
- default value 0
- 0 Auto ON disabled
- 1 32535 = 1second (0,01s) 32536 seconds (325,35s)
Auto ON enabled with define time, step is 1s or 10m s according to parameter nr. 15. The following option values may be configured, in addition to values in the range 0 to 32535 -:
| Value | Description |
|---|---|
| 0 | AUTO ON disabled |
The manufacturer defined default value is 0 (AUTO ON disabled).
This parameter has the configuration ID config_12_2 and is of type INTEGER.
Automatic turning off / on seconds or milliseconds selection NOTE: Parameter is the same for turning OFF or ON. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | seconds selected (default) |
| 1 | milliseconds selected |
The manufacturer defined default value is 0 (seconds selected (default)).
This parameter has the configuration ID config_15_1 and is of type INTEGER.
Saving the state of the relay after a power failure
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | HC Switch relay module saves its state |
| 1 | HC Switch relay module returns to "off" position |
The manufacturer defined default value is 0 (HC Switch relay module saves its state ).
This parameter has the configuration ID config_30_1 and is of type INTEGER.
Power reporting in Watts on power change Set value means percentage, set value from 0 - 100 = 0% - 100%. Available configuration parameters (data type is 1 Byte DEC):
- default value 10 = 10%
- 0 = reporting disabled
- 1-100 = 1% - 100% reporting enabled
Power report is send (push) only when actual power in Watts in real time changes for more than set percentage comparing to previous actual power in Watts , step is When using low power loads, It is recommended to set parameter no. 40 to a higher value (e.g. 50%).
NOTE: if power changed is less than 1W, the report is not send (pushed), independent of percentage set. The following option values may be configured, in addition to values in the range 0 to 100 -:
| Value | Description |
|---|---|
| 0 | Reporting disabled |
The manufacturer defined default value is 10.
This parameter has the configuration ID config_40_1 and is of type INTEGER.
Power reporting in Watts by time interval Set value means time interval (0 - 32535) in seconds, when power report is send. Available configuration parameters (data type is 2 Byte DEC):
- default value 300 = 300s
- 0 reporting disabled
- 30-32535 = 30 seconds - 32535 seconds. Reporting enabled.
Power report is send with time interval set by entered value. The following option values may be configured, in addition to values in the range 0 to 32535 -:
| Value | Description |
|---|---|
| 0 | Reporting disabled |
The manufacturer defined default value is 300.
This parameter has the configuration ID config_42_2 and is of type INTEGER.
Output Switch selection Set value means the type of the device that is connected to the output. The device type can be normally open (NO) or normally close (NC). The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | (NC) output is 0V (default) |
| 1 | (NO) output is 230V / 24V |
The manufacturer defined default value is 0 ((NC) output is 0V (default)).
This parameter has the configuration ID config_63_1 and is of type INTEGER.
Enable / Disable Endpoint I2 or select Notification Type and Event
Enabling I2 means that Endpoint (I2) will be present on UI. Disabling it will result in hiding the endpoint according to the parameter set value. Additionally, a Notification Type and Event can be selected for the endpoint. Available configuration parameters (data type is 1 Byte DEC):
notification sensor (1-6):
GENERIC_TYPE_SENSOR_NOTIFICATION, SPECIFIC_TYPE_NOTIFICATION_SENSOR
<td>
Description
</td>
<td>
Home Security: Motion Detection, unknown loc. (Default)
</td>
<td>
Carbon Monoxide; Carbon Monoxide detected, unknown location.
</td>
<td>
Carbon Dioxide; Carbon Dioxide detected, unknown location.
</td>
<td>
Water Alarm; Water Leak detected, unknown loc.
</td>
<td>
Heat Alarm; Overheat detected, unknown loc.
</td>
<td>
Smoke Alarm; Smoke detected, unknown loc.
</td>
<td>
Endpoint I2 disabled
</td>
| Values |
| 1 |
| 2 |
| 3 |
| 4 |
| 5 |
| 6 |
binary sensor (9):
GENERIC_TYPE_SENSOR_BINARY, SPECIFIC_TYPE_NOT_USED
NOTE 1 : After parameter change, first exclude module (without setting parameters to default value) then wait at least 30s and then re include the module!
NOTE 2: If parameter is set to value 9, the messages will be sent to Home Security! The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Endpoint I2 disabled |
| 1 | Home Security: Motion Detection |
| 2 | Carbon Monoxide |
| 3 | Carbon Dioxide |
| 4 | Water Alarm |
| 5 | Heat Alarm |
| 6 | Smoke Alarm |
The manufacturer defined default value is 1 (Home Security: Motion Detection).
This parameter has the configuration ID config_100_1 and is of type INTEGER.
Enable / Disable Endpoint I3 or select Notification Type and Event
Enabling I3 means that Endpoint (I3) will be present on UI. Disabling it will result in hiding the endpoint according to the parameter set value. Additionally, a Notification Type and Event can be selected for the endpoint. Available configuration parameters (data type is 1 Byte DEC):
notification sensor (1-6):
GENERIC_TYPE_SENSOR_NOTIFICATION, SPECIFIC_TYPE_NOTIFICATION_SENSOR
<td>
Description
</td>
<td>
Home Security: Motion Detection, unknown loc. (Default)
</td>
<td>
Carbon Monoxide; Carbon Monoxide detected, unknown location.
</td>
<td>
Carbon Dioxide; Carbon Dioxide detected, unknown location.
</td>
<td>
Water Alarm; Water Leak detected, unknown loc.
</td>
<td>
Heat Alarm; Overheat detected, unknown loc.
</td>
<td>
Smoke Alarm; Smoke detected, unknown loc.
</td>
<td>
Endpoint I3 disabled
</td>
| Values |
| 1 |
| 2 |
| 3 |
| 4 |
| 5 |
| 6 |
binary sensor (9):
GENERIC_TYPE_SENSOR_BINARY, SPECIFIC_TYPE_NOT_USED
NOTE 1 : After parameter change, first exclude module (without setting parameters to default value) then wait at least 30s and then re include the module!
NOTE 2: If parameter is set to value 9, the messages will be sent to Home Security! The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Endpoint I3 disabled |
| 1 | Home Security: Motion Detection (Default) |
| 2 | Carbon Monoxide |
| 3 | Carbon Dioxide |
| 4 | Water Alarm |
| 5 | Heat Alarm |
| 6 | Smoke Alarm |
The manufacturer defined default value is 1 (Home Security: Motion Detection (Default)).
This parameter has the configuration ID config_101_1 and is of type INTEGER.
Temperature sensor offset settings Set value is added or subtracted to actual measured value by sensor. Available configuration parameters (data type is 2 Byte DEC):
<td>
Description
</td>
<td>
is 0.0C (Default)
</td>
<td>
From 1 to 100 value from 0.1°C to 10.0°C is added to actual measured temperature.
</td>
<td>
From 1001 to 1100 value from 0.1 °C to 10.0 °C is subtracted to actual measured temperature.
</td>
| Values |
| 32536 |
| 1 –100 |
| 1001 –1100 |
The manufacturer defined default value is 32536.
This parameter has the configuration ID config_110_2 and is of type INTEGER.
Temperature sensor reporting If digital temperature sensor is connected, module reports measured temperature on temperature change defined by this parameter. Available configuration parameters (data type is 1 Byte DEC):
<td>
Description
</td>
<td>
0,5°C (default)
</td>
<td>
Reporting disabled
</td>
<td>
0,1°C - 12,7°C, step is 0,1°C
</td>
| Values |
| 5 |
| 1 –127 |
The manufacturer defined default value is 5.
This parameter has the configuration ID config_120_1 and is of type INTEGER.
Set the mode for the switch when receiving SWITCH ALL commands.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Exclude from All On and All Off groups |
| 1 | Include in All On group |
| 2 | Include in All Off group |
| 255 | Include in All On and All Off groups |
This parameter has the configuration ID switchall_mode and is of type INTEGER.
Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.
The MT2759 supports 9 association groups.
The Lifeline association group reports device status to a hub and is not designed to control other devices directly. When using the Lineline group with a hub, in most cases, only the lifeline group will need to be configured and normally the hub will perform this automatically during the device initialisation. Lifeline group (reserved for communication with the main controller), 1 node allowed.
Association group 1 supports 1 node.
basic on/off (triggered at change of the output Q state and reflecting its state) up to 16 nodes.
Association group 2 supports 16 nodes.
basic on/off (triggered at change of the input I2 state and reflecting its state) up to 16 nodes.
Association group 3 supports 16 nodes.
Notification report (triggered at change of the input I2 state and reflecting its state) up to 16 nodes.
Association group 4 supports 16 nodes.
Binary sensor (triggered at change of the input I2 state and reflecting its state) up to 16 nodes.
Association group 5 supports 16 nodes.
basic on/off (triggered at change of the input I3 state an d reflecting its state) up to 16 nodes.
Association group 6 supports 16 nodes.
notification report (triggered at change of the input I3 state and reflecting its state) up to 16 nodes.
Association group 7 supports 16 nodes.
binary sensor report (triggered at change of the input I3 state and reflecting its state) up to 16 nodes.
Association group 8 supports 16 nodes.
multilevel sensor report (triggered at change of temperature sensor) up to 16 nodes.
Association group 9 supports 16 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_SWITCH_ALL_V1 | |
| COMMAND_CLASS_SENSOR_BINARY_V1 | |
| COMMAND_CLASS_METER_V3 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_MULTI_CHANNEL_V2 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_ALARM_V5 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_VERSION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 | |
| COMMAND_CLASS_SECURITY_V1 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_SWITCH_ALL_V1 | |
| COMMAND_CLASS_METER_V3 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_ALARM_V5 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SENSOR_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_ALARM_V5 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SENSOR_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_ALARM_V5 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.