| layout | title |
|---|---|
documentation |
WDS2 - ZWave |
{% include base.html %}
This describes the Z-Wave device WDS2, manufactured by wiDom with the thing type UID of widom_wds2_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 WDS2 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.
WiDom Smart Double Switch is an ON/OFF control device designed to independently control two separate loads, suited for being controlled by both remote and local switches. Similarly to the other WiDom “in wall” devices, it can be fully integrated into pre-existing systems and configured to associate configurable behaviors to a specific number of clicks, in full integration with the Z-Wave home automation ecosystem. There are two versions of WiDom Double Switch: L version controlled by Line signal; N version controlled by Neutral signal
Before including the device the LED status indicator is solid RED. The procedure of inclusion is activated by clicking Add in the inclusion interface and by pressing any sequence of click on the integrated button. As soon as the inclusion procedure initiates the LED indicator starts a sequence of GREEN-BLUE blinks. The device is included in the network when the LED status is OFF and the interview is completed.
Only a controller can remove the device from the network. After activating the exclusion function by the controller, the device can be removed by setting it in Learning Mode. If you are using the WiDom Multi Sensor Room Controller, the procedure of exclusion can be activated by Removing a node from the Z-Wave network and any click sequence on the integrated button; as soon as the exclusion initiates, the LED indicator starts a sequence of RED-BLUE blinks. The device is excluded from the network when the LED status indicator is solid RED and the App_status in the interface is OK.
Control Actions :
- Holding the I1/I2 button change the status of Channel1/Channel2 and return to previous status as soon as the button is released.
- A single and/or more clicks (Parameter No.1) on the I1 button turn ON/OFF the Channel 1 load.
- A single and/or more clicks (Parameter No.2 and No. 1) on the button I2 turn ON/OFF the Channel 2 load.
The following table summarises the channels available for the WDS2 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Meter Reset | meter_reset | meter_reset | Energy | Switch |
| Switch1 | switch_binary1 | switch_binary | Switch | Switch |
| Electric meter (watts)1 | meter_watts1 | meter_watts | Energy | Number |
| Switch2 | switch_binary2 | switch_binary | Switch | Switch |
| Electric meter (watts)2 | meter_watts2 | meter_watts | Energy | Number |
Reset the meter.
The meter_reset channel is of type meter_reset and supports the Switch item and is in the Energy category.
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.
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 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.
The following table provides a summary of the 16 configuration parameters available in the WDS2. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Numbers of clicks to control Channel 1 | Define which sequences of clicks control the load connected to Channel 1/2. |
| 2 | Numbers of clicks to control Channel 2 | Define which sequences of click control the load connected to Channel 2 |
| 4 | Value used for devices belonging to Group 2 | Value used for devices belonging to Group 2 when I1 button receive 1 Click |
| 5 | Value used for devices belonging to Group 5 | Value used for devices belonging to Group 5 when I2 button receive 1 Click |
| 6 | Value used for devices belonging to Group 3 | Value used for devices belonging to Group 3 when I1 button receive 2 Clicks |
| 7 | Value used for devices belonging to Group 6 | Value used for devices belonging to Group 6 when I2 button receive 2 Clicks |
| 8 | Value used for devices belonging to Group 4 | Value used for devices belonging to Group 4 when I1 button receive 3 Clicks |
| 9 | Value used for devices belonging to Group 7 | Value used for devices belonging to Group 7 when I2 button receive 3 Clicks |
| 10 | Timer to switch OFF the Channel 1 | Defines the time after which the Channel 1 is switched OFF |
| 11 | Timer to switch OFF the Channel 2 | Defines the time after which the Channel 2 is switched OFF |
| 12 | Timer to switch ON the Channel 1 | Defines the time after which the Channel 1 is switched ON |
| 13 | Timer to switch ON the Channel 2 | Defines the time after which the Channel 2 is switched ON |
| 40 | Local Scenario | Defines the behavior of the device Channels |
| 60 | Start-up status | Defines the status of the device following a restart. |
| 62 | Type of external switch both inputs | Defines the type of external switch connected both to input 1 and input 2. |
| 63 | Type of external switch input 2 | Define the switch type connected to the input 2 |
Define which sequences of clicks control the load connected to Channel 1/2. Define which sequences of clicks control the load connected to both Channel 1 and Channel 2, if parameter No. 2 is set to its default value. Otherwise parameter No.1 sets the clicks sequence only for Channel 1 and parameter No. 2 sets the clicks sequence for Channel 2 The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disabled |
| 1 | ONE_CLICK |
| 2 | TWO_CLICKS |
| 3 | ONE_CLICK or TWO_CLICKS |
| 4 | THREE_CLICKS |
| 5 | ONE_CLICK or THREE_CLICKS |
| 6 | TWO_CLICKS or THREE_CLICKS |
| 7 | ONE_CLICK, TWO_CLICKS or THREE_CLICKS |
The manufacturer defined default value is 7 (ONE_CLICK, TWO_CLICKS or THREE_CLICKS).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Define which sequences of click control the load connected to Channel 2
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disabled |
| 1 | ONE_CLICK |
| 2 | TWO_CLICKS |
| 3 | ONE_CLICK or TWO_CLICKS |
| 4 | THREE_CLICKS |
| 5 | ONE_CLICK or THREE_CLICKS |
| 6 | TWO_CLICKS or THREE_CLICKS |
| 7 | ONE_CLICK, TWO_CLICKS or THREE_CLICKS |
| 8 | EQUAL_TO_CHANNEL_1 |
The manufacturer defined default value is 8 (EQUAL_TO_CHANNEL_1).
This parameter has the configuration ID config_2_1 and is of type INTEGER.
Value used for devices belonging to Group 2 when I1 button receive 1 Click
The following option values may be configured -:
| Value | Description |
|---|---|
| -1 | Basic Set ON |
| 0 | Basic Set OFF |
| 100 | Basic Set with same value of channel status |
The manufacturer defined default value is 100 (Basic Set with same value of channel status).
This parameter has the configuration ID config_4_1 and is of type INTEGER.
Value used for devices belonging to Group 5 when I2 button receive 1 Click
The following option values may be configured -:
| Value | Description |
|---|---|
| -1 | Basic Set ON |
| 0 | Basic Set OFF |
| 100 | Basic Set with same value of channel status |
The manufacturer defined default value is 100 (Basic Set with same value of channel status).
This parameter has the configuration ID config_5_1 and is of type INTEGER.
Value used for devices belonging to Group 3 when I1 button receive 2 Clicks
The following option values may be configured -:
| Value | Description |
|---|---|
| -1 | Basic Set ON |
| 0 | Basic Set OFF |
| 100 | Basic Set with same value of channel status |
The manufacturer defined default value is 100 (Basic Set with same value of channel status).
This parameter has the configuration ID config_6_1 and is of type INTEGER.
Value used for devices belonging to Group 6 when I2 button receive 2 Clicks
The following option values may be configured -:
| Value | Description |
|---|---|
| -1 | Basic Set ON |
| 0 | Basic Set OFF |
| 100 | Basic Set with same value of channel status |
The manufacturer defined default value is 100 (Basic Set with same value of channel status).
This parameter has the configuration ID config_7_1 and is of type INTEGER.
Value used for devices belonging to Group 4 when I1 button receive 3 Clicks
The following option values may be configured -:
| Value | Description |
|---|---|
| -1 | Basic Set ON |
| 0 | Basic Set OFF |
| 100 | Basic Set with same value of channel status |
The manufacturer defined default value is 100 (Basic Set with same value of channel status).
This parameter has the configuration ID config_8_1 and is of type INTEGER.
Value used for devices belonging to Group 7 when I2 button receive 3 Clicks
The following option values may be configured -:
| Value | Description |
|---|---|
| -1 | Basic Set ON |
| 0 | Basic Set OFF |
| 100 | Basic Set with same value of channel status |
The manufacturer defined default value is 100 (Basic Set with same value of channel status).
This parameter has the configuration ID config_9_1 and is of type INTEGER.
Defines the time after which the Channel 1 is switched OFF
Values in the range 0 to 32000 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_10_2 and is of type INTEGER.
Defines the time after which the Channel 2 is switched OFF
Values in the range 0 to 32000 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_11_2 and is of type INTEGER.
Defines the time after which the Channel 1 is switched ON
Values in the range 0 to 32000 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_12_2 and is of type INTEGER.
Defines the time after which the Channel 2 is switched ON
Values in the range 0 to 32000 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_13_2 and is of type INTEGER.
Defines the behavior of the device Channels Defines the behavior of the device Channels when the I1/I2 buttons receive a valid number of clicks (see Parameters No. 1 and No. 2). The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | INDIPENDENT_CHANNELS |
| 1 | NEVER_BOTH_ON |
| 2 | SEQUENCING_RELAY |
The manufacturer defined default value is 0 (INDIPENDENT_CHANNELS).
This parameter has the configuration ID config_40_1 and is of type INTEGER.
Defines the status of the device following a restart.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | OFF_OFF - Both Channel 1 and Channel 2 OFF |
| 1 | OFF_ON - Channel 1 OFF, Channel 2 ON |
| 2 | ON_OFF - Channel 1 ON, Channel 2 OFF |
| 3 | ON_ON - Both Channel 1 and Channel 2 ON |
| 4 | PREVIOUS STATUS - Status prior to restart |
The manufacturer defined default value is 4 (PREVIOUS STATUS - Status prior to restart).
This parameter has the configuration ID config_60_1 and is of type INTEGER.
Defines the type of external switch connected both to input 1 and input 2. Defines the type of external switch connected both to input 1 and input 2, if parameter No. 63 is set in its default value. Otherwise parameter No. 62 defines only the switch connected to the input 1 and parameter No. 63 the switch connected to the input 2. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | IGNORE |
| 1 | BUTTON |
| 2 | SWITCH |
The manufacturer defined default value is 1 (BUTTON).
This parameter has the configuration ID config_62_1 and is of type INTEGER.
Define the switch type connected to the input 2
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | IGNORE |
| 1 | BUTTON |
| 2 | SWITCH |
| 3 | EQUAL TO SWITCH 1 |
The manufacturer defined default value is 3 (EQUAL TO SWITCH 1).
This parameter has the configuration ID config_63_1 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 WDS2 supports 7 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 8 nodes.
Association group 2 supports 8 nodes.
Association group 3 supports 8 nodes.
Association group 4 supports 8 nodes.
Association group 5 supports 8 nodes.
Association group 6 supports 8 nodes.
Association group 7 supports 8 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_METER_V1 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_MULTI_CHANNEL_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1 | |
| COMMAND_CLASS_ASSOCIATION_V1 | |
| COMMAND_CLASS_VERSION_V1 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V1 | |
| COMMAND_CLASS_SECURITY_V1 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_METER_V1 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_METER_V1 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.