| layout | title |
|---|---|
documentation |
DS100 - ZWave |
{% include base.html %}
This describes the Z-Wave device DS100, manufactured by Vemmio with the thing type UID of vemmio_ds100_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 DS100 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.
Vemmio Double Switch is a dual relay in-wall module. The product works as a transceiver and is a Z-Wave Plus enabled device. Mini size design lets the module be easily hidden into the wall box to do not interfere with house decoration. One of many uses of the Double Switch is to turn on or off the connected fittings and monitor power consumption in real time. The new smart relay calibration technology can work perfectly with many kinds of lights like: incandescent, fluorescent and LED lights.
Pressing Z-Wave button three times within 2 seconds will enter inclusion mode.
Pressing Z-Wave button three times within 2 seconds will enter exclusion mode.
The following table summarises the channels available for the DS100 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Switch | switch_binary | switch_binary | Switch | Switch |
| Scene Number | scene_number | scene_number | Number | |
| Electric meter (power factor) | meter_powerfactor | meter_powerfactor | Energy | Number |
| Electric meter (volts) | meter_voltage | meter_voltage | Energy | Number |
| Electric meter (amps) | meter_current | meter_current | Energy | Number |
| Electric meter (watts) | meter_watts | meter_watts | Energy | Number |
| Electric meter (kWh) | meter_kwh | meter_kwh | Energy | Number |
| Alarm | alarm_general | alarm_general | Alarm | Switch |
| Switch 1 | switch_binary1 | switch_binary | Switch | Switch |
| Electric meter (power factor) 1 | meter_powerfactor1 | meter_powerfactor | Energy | Number |
| Electric meter (volts) 1 | meter_voltage1 | meter_voltage | Energy | Number |
| Electric meter (amps) 1 | meter_current1 | meter_current | Energy | Number |
| Electric meter (watts) 1 | meter_watts1 | meter_watts | Energy | Number |
| Electric meter (kWh) 1 | meter_kwh1 | meter_kwh | Energy | Number |
| Switch 2 | switch_binary2 | switch_binary | Switch | Switch |
| Electric meter (power factor) 2 | meter_powerfactor2 | meter_powerfactor | Energy | Number |
| Electric meter (volts) 2 | meter_voltage2 | meter_voltage | Energy | Number |
| Electric meter (amps) 2 | meter_current2 | meter_current | Energy | Number |
| Electric meter (watts) 2 | meter_watts2 | meter_watts | Energy | Number |
| Electric meter (kWh) 2 | meter_kwh2 | meter_kwh | Energy | Number |
| Switch 3 | switch_binary3 | switch_binary | Switch | Switch |
| Electric meter (power factor) 3 | meter_powerfactor3 | meter_powerfactor | Energy | Number |
| Electric meter (volts) 3 | meter_voltage3 | meter_voltage | Energy | Number |
| Electric meter (amps) 3 | meter_current3 | meter_current | Energy | Number |
| Electric meter (watts) 3 | meter_watts3 | meter_watts | Energy | Number |
| Electric meter (kWh) 3 | meter_kwh3 | meter_kwh | Energy | Number |
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.
Triggers when a scene button is pressed.
The scene_number channel is of type scene_number and supports the Number item.
Indicates the instantaneous power factor.
The meter_powerfactor channel is of type meter_powerfactor 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 instantaneous voltage.
The meter_voltage channel is of type meter_voltage 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 instantaneous current consumption.
The meter_current channel is of type meter_current 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 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 an alarm is triggered.
The alarm_general channel is of type alarm_general and supports the Switch item and is in the Alarm 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 factor.
The meter_powerfactor1 channel is of type meter_powerfactor 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 instantaneous voltage.
The meter_voltage1 channel is of type meter_voltage 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 instantaneous current consumption.
The meter_current1 channel is of type meter_current 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 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.
Switch the power on and off.
The switch_binary2 channel is of type switch_binary and supports the Switch item and is in the Switch category.
Indicates the instantaneous power factor.
The meter_powerfactor2 channel is of type meter_powerfactor 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 instantaneous voltage.
The meter_voltage2 channel is of type meter_voltage 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 instantaneous current consumption.
The meter_current2 channel is of type meter_current 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 instantaneous power consumption.
The meter_watts2 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_kwh2 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.
Switch the power on and off.
The switch_binary3 channel is of type switch_binary and supports the Switch item and is in the Switch category.
Indicates the instantaneous power factor.
The meter_powerfactor3 channel is of type meter_powerfactor 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 instantaneous voltage.
The meter_voltage3 channel is of type meter_voltage 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 instantaneous current consumption.
The meter_current3 channel is of type meter_current 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 instantaneous power consumption.
The meter_watts3 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_kwh3 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.
The following table provides a summary of the 10 configuration parameters available in the DS100. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 0 | Watt Meter Report Period | 720*5s=3600s=1hour |
| 2 | KWH Meter Report Period | 6*10 min = 1 hour |
| 3 | Selected Relay | 1: Relay 1, 2: Relay 2, 3: Relay 1 & Relay 2 |
| 4 | Edge or Pulse mode or Edge-Toggle mode | 1: Edge mode, 2: Pulse mode, 3: Edge-Toggle mode |
| 5 | Threshold of current for load caution | 750*0.01A=7.5A |
| 6 | Threshold of KWH for load caution | |
| 7 | Restore switch state mode | 0: Switch off, 1: Last switch, 2: Switch on |
| 8 | Auto off timer | 0: Disable auto off function, 1: 0x0-0x7FFF 1s-32767s |
| 9 | RF off command mode | 0: Switch off, 1: Ignore, 2: Switch toggle, 3: Switch on |
| 10 | Existence of endpoint 3 | 1: endpoint 3 exists, 2: No endpoint 3 |
| Switch All Mode | Set the mode for the switch when receiving SWITCH ALL commands |
720*5s=3600s=1hour
Values in the range 1 to 32767 may be set.
The manufacturer defined default value is 720.
This parameter has the configuration ID config_0_2 and is of type INTEGER.
6*10 min = 1 hour
Values in the range 1 to 32767 may be set.
The manufacturer defined default value is 6.
This parameter has the configuration ID config_2_2 and is of type INTEGER.
1: Relay 1, 2: Relay 2, 3: Relay 1 & Relay 2
Values in the range 1 to 3 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_3_1 and is of type INTEGER.
1: Edge mode, 2: Pulse mode, 3: Edge-Toggle mode
Values in the range 1 to 3 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_4_1 and is of type INTEGER.
750*0.01A=7.5A
Values in the range 10 to 750 may be set.
The manufacturer defined default value is 750.
This parameter has the configuration ID config_5_2 and is of type INTEGER.
Values in the range 1 to 10000 may be set.
The manufacturer defined default value is 10000.
This parameter has the configuration ID config_6_2 and is of type INTEGER.
0: Switch off, 1: Last switch, 2: Switch on
Values in the range 0 to 2 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_7_1 and is of type INTEGER.
0: Disable auto off function, 1: 0x0-0x7FFF 1s-32767s
Values in the range 0 to 32767 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_8_2 and is of type INTEGER.
0: Switch off, 1: Ignore, 2: Switch toggle, 3: Switch on
Values in the range 0 to 3 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_9_1 and is of type INTEGER.
1: endpoint 3 exists, 2: No endpoint 3
Values in the range 1 to 2 may be set.
The manufacturer defined default value is 1.
This parameter has the configuration ID config_10_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 DS100 supports 3 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.
Association group 1 supports 1 node.
For group 2, the Switch will report
- ON/OFF status of Relay1
- Instant Power Consumption (Watt) of Relay1
- Accumulated Power Consumption (KWh) of Relay1 to Z-Wave Controller.
Association group 2 supports 1 node.
For group 3, the Switch will report
- ON/OFF status of Relay2
- Instant Power Consumption (Watt) of Relay2
- Accumulated Power Consumption (KWh) of Relay2 to Z-Wave Controller.
Association group 3 supports 1 node.
| 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_SCENE_ACTIVATION_V1 | |
| COMMAND_CLASS_SCENE_ACTUATOR_CONF_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_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| COMMAND_CLASS_PROTECTION_V2 | |
| COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_VERSION_V2 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_METER_V3 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_METER_V3 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_METER_V3 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.