| layout | title |
|---|---|
documentation |
WDS - ZWave |
{% include base.html %}
This describes the Z-Wave device WDS, manufactured by wiDom with the thing type UID of widom_wds_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 WDS 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.
Universal Double Switch is an ON/OFF control device designed to independently control two separate loads, suited for use as both a local and remote switch. Similarly to the other WiDom “in wall” devices, it can be fully integrated into pre-existing systems and configured to associate configurable behaviours to a specific number of clicks, in full integration with the Z-Wave home automation ecosystem.
Each of its two channels features an integrated consumption measurement device. The Universal Double Switch also boasts the lowest energy consumption on the market.
At the same time, it is completely configurable so that it can adapt to the most varied needs while also being ready to be used without needing additional configurations in order to operate.
Thanks to the framework developed by WiDom, the various types of “events” on the “External Switch” can be recognised and associated to actions to be performed on the device, on any associated devices, on all devices on the network. The events that the system recognises are the number of “clicks” or hold on the External Switch.
External switch: External button or switch connected to the input I1 or I2
Events: The actions performed on the external Switch: Clicks or Hold.
Click: If the external switch is a button (when pressed it autonomously returns to the initial position), a click means pressing and then releasing it. If the external switch is bistable (when pressed it does not return to the initial position), a single click means one single flip of the switch.
Technical Specifications
Power Supply: 230 VAC±10% 50/60 Hz
Maximum Load on Relay Resistive Loads: 8 A for each channel; 10A for both channels
Limit Temperature: 105 °C
Work Temperature: -10 – 40 °C
Radio Protocol Z-Wave: 868,4 MHz
Radio Range: Up to 100 m outdoor, Up to 40 m indoor
Dimensions (WxDxH): 37x37x17 mm
Consumption: < 260 mW in standby; < 480 mW with one working load; < 700 mW with both working loads
Electrical IP Rating: IP 20
Actuator element: Relay
Conformity: CE, RoHS
The device supports both the Network Wide Inclusion (which offers the opportunity of inclusion into a network even if the device is not directly connected to the controller) and the Normal Inclusion mechanisms.
If the device is not included into a Z-Wave network, a single click on the (B) button or on one of the external switches will launch the process of traditional inclusion. If the device inclusion procedure does not start within 2 seconds, the Network Wide Inclusion network will be launched lasting a variable amount of time between 15-30 seconds.
INFO: Through the inclusion procedure, activated with a single click on one of the external switches, the system determines the type of external switch (see parameter No. 62).
Only a controller can remove a device from the network. WiDom Universal Double Switch is compatible with all Z-Wave certified controllers. After the exclusion procedure has been activated by the controller, the device can be removed, putting it in Exclusion Mode by three consecutive clicks on the (B) button or on the external switch, when available.
The following table summarises the channels available for the WDS -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Switch | switch_binary | switch_binary | Switch | Switch |
| Electric meter (watts) | meter_watts | meter_watts | Energy | Number |
| Switch 1 | switch_binary1 | switch_binary | Switch | Switch |
| Electric meter (watts) 1 | meter_watts1 | meter_watts | Energy | Number |
| Switch 2 | switch_binary2 | switch_binary | Switch | Switch |
| Electric meter (watts) 2 | meter_watts2 | meter_watts | 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.
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.
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 15 configuration parameters available in the WDS. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Status upon receipt of 1 click | Defines the status of the output O1/O2 after 1 Click |
| 2 | Status upon receipt of 2 clicks | Defines the status of the output O1/O2 after 2 Clicks |
| 3 | Type of outputs | Defines how the outputs are controlled |
| 4 | Number of clicks that control the device | Defines the Clicks on the Switches that control associated devices |
| 5 | Level used to control association group 2 and 3 | Defines how to control the devices associated to group 2 and 3. |
| 6 | Level used to control association group 4 and 5. | Defines how to control the devices associated to group 4 and 5. |
| 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 |
| 20 | Status after Multi-Channel Basic Set command | Defines how Basic Set commands controlling outputs |
| 21 | Outputs status upon receipt of a Basic Set command | Define which channels are controlled by Basic Set command |
| 60 | Start-up status | Defines the status of the device following a restart. |
| 61 | Configuration reset | Defines which parameters should be reset to default values |
| 62 | Type of external switch | Defines the type of external switch connected to the device |
| Switch All Mode | Set the mode for the switch when receiving SWITCH ALL commands |
Defines the status of the output O1/O2 after 1 Click Defines the status of the output O1/O2 when the switch connected to I1/I2 receives 1 Click
INFO:
0 – IN_OUT configuration is available on WiDom Universal Double Switch starting from the
firmware version 1.40.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | IN_OUT |
| 1 | TOGGLE |
| 2 | On |
| 3 | Off |
| 4 | IGNORE |
The manufacturer defined default value is 1 (TOGGLE).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Defines the status of the output O1/O2 after 2 Clicks Defines the status of the output O1/O2 when the switch connected to I1/I2 receives 2 Clicks The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | TOGGLE |
| 2 | On |
| 3 | Off |
| 4 | IGNORE |
The manufacturer defined default value is 1 (TOGGLE).
This parameter has the configuration ID config_2_1 and is of type INTEGER.
Defines how the outputs are controlled Defines if the outputs are controlled individually, as a traditional device with two channels, or if its behaviour simulates a single pole double throw relay
Parameter value and device reaction
0 – SINGLE CHANNELS (Default Value)
Channel 1 and Channel 2 are controlled individually
From 1 to 9 – SINGLE POLE DOUBLE THROW RELAY
The two channels are in opposite status. If the Channel 1 is close the Channel 2 is open, if the Channel 1 is open the Channel 2 is close. The value of the parameter defines the closing delay of the relay in tenth of seconds
From 10 to 19 – SEQUENCING RELAY
Channels are toggled in this way: both channels ON, only channel 1 ON, only channel 2 ON, both channels OFF. The value of the parameter, deducted of 9, defines the closing delay of the relay in tenth of seconds.
From 20 to 39 – SELECTOR
Both channels can be OFF but they can never be ON simultaneously. It can be used for fan coil control, roller shutters, and in general for two-speed systems. The value of the parameter, deducted of 19, defines the closing delay of the relay in tenth of seconds.
INFO: 0 – configuration is available on WiDom Universal Double Switch starting from the firmware version 1.40. Values in the range 0 to 39 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Defines the Clicks on the Switches that control associated devices Defines the number of clicks on the Switch 1 or Switch 2 that enable the control of the correspondent associated devices
TIP:
Through this parameter, together the setting of the parameters 1 and 2, it is possible to control simultaneously the local load and the associated devices (e.g. 1 click control both local load and associated devices) or in totally independent way (e.g. 1 click control only the local load, 2 clicks control only the associated devices). The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | Controlled by 1 Click |
| 2 | Controlled by 2 Clicks |
The manufacturer defined default value is 2 (Controlled by 2 Clicks).
This parameter has the configuration ID config_4_1 and is of type INTEGER.
Defines how to control the devices associated to group 2 and 3.
0 – SWITCH_OFF
The associated devices are switched OFF
-1 – SWITCH_ON
The associated devices are switched ON
The associated devices (dimmer, roller shutters) are set to the indicated level (only for devices associated to group 3)
100 – RELAY_STATUS (Default Value)
If the Relay 1 is ON/OFF, the associated devices are ON/OFF
101 – RELAY_STATUS_BUT_IGNORE_IF_OFF
If the Relay 1 is ON the associated devices are ON; if it is OFF no action is taken on the associated devices
102 – RELAY_STATUS_BUT_IGNORE_IF_ON
If the Relay 1 is OFF the associated devices are OFF; if it is ON no action is taken on the associated devices
103 – RELAY_OPPOSITE_BUT_IGNORE_IF_OFF
If the Relay 1 is ON the associated devices are OFF; if it is OFF no action is taken on the associated devices
104 – RELAY_OPPOSITE_BUT_IGNORE_IF_ON
If the Relay 1 is OFF the associated devices are ON; if it is ON no action is taken on the associated devices
105 – RELAY_OPPOSITE
If the Relay 1 is ON/OFF, the associated devices are OFF/ON
No action is taken on the associated devices Values in the range -1 to 106 may be set.
The manufacturer defined default value is 100.
This parameter has the configuration ID config_5_1 and is of type INTEGER.
Defines how to control the devices associated to group 4 and 5.
0 – SWITCH_OFF
The associated devices are switched OFF
-1 – SWITCH_ON
The associated devices are switched ON
The associated devices (dimmer, roller shutters) are set to the indicated level (only for devices associated to group 3)
100 – RELAY_STATUS (Default Value)
If the Relay 1 is ON/OFF, the associated devices are ON/OFF
101 – RELAY_STATUS_BUT_IGNORE_IF_OFF
If the Relay 1 is ON the associated devices are ON; if it is OFF no action is taken on the associated devices
102 – RELAY_STATUS_BUT_IGNORE_IF_ON
If the Relay 1 is OFF the associated devices are OFF; if it is ON no action is taken on the associated devices
103 – RELAY_OPPOSITE_BUT_IGNORE_IF_OFF
If the Relay 1 is ON the associated devices are OFF; if it is OFF no action is taken on the associated devices
104 – RELAY_OPPOSITE_BUT_IGNORE_IF_ON
If the Relay 1 is OFF the associated devices are ON; if it is ON no action is taken on the associated devices
105 – RELAY_OPPOSITE
If the Relay 1 is ON/OFF, the associated devices are OFF/ON
No action is taken on the associated devices Values in the range -1 to 106 may be set.
The manufacturer defined default value is 100.
This parameter has the configuration ID config_6_1 and is of type INTEGER.
Defines the time after which the Channel 1 is switched OFF 0 (Default Value): Timer disabled
From 1 to 32000 (seconds): After this time the relay of the Channel 1 is 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 0 (Default Value): Timer disabled
From 1 to 32000 (seconds): After this time the relay of the Channel 2 is 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 0 (Default Value): Timer disabled
From 1 to 32000 (seconds): After this time the relay of the Channel 1 is 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 0 (Default Value): Timer disabled
From 1 to 32000 (seconds): After this time the relay of the Channel 2 is 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.
This is a read only parameter.
Defines how Basic Set commands controlling outputs The two channels can be controlled individually by Z-Wave network. The status of the channels upon receipt of a Multi-Channel Basic Set command is defined by the value set on the parameter. The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | As Received |
| 2 | Ignore if ON |
| 3 | Ignore if OFF |
| 4 | IGNORE |
The manufacturer defined default value is 1 (As Received).
This parameter has the configuration ID config_20_1 and is of type INTEGER.
Define which channels are controlled by Basic Set command The channels of the device can be controlled individually from all other Z-Wave devices that support the multichannel feature. In order to support also the integration with no-multichannel systems, this parameter allows to define if the receipt of a no-multichannel systems, this parameter allows to define if the receipt of a no-multichannel command controls only the Channel 1 or both. The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | CHANNEL 1 |
| 3 | BOTH CHANNELS |
The manufacturer defined default value is 3 (BOTH CHANNELS).
This parameter has the configuration ID config_21_2 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 |
| 1 | ON_OFF |
| 2 | OFF_ON |
| 3 | ON_ON |
| 4 | PREVIOUS STATUS |
The manufacturer defined default value is 4 (PREVIOUS STATUS).
This parameter has the configuration ID config_60_1 and is of type INTEGER.
Defines which parameters should be reset to default values
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | FACTORY RESET |
| 1 | ASSOCIATIONS RESET |
| 2 | CONFIGURATIONS RESET |
| 3 | RESTART DEVICE |
| 4 | IGNORE |
The manufacturer defined default value is 4 (IGNORE).
This parameter has the configuration ID config_61_1 and is of type INTEGER.
Defines the type of external switch connected to the device
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.
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 WDS supports 5 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. Devices to receive notifications on: status changes; instantaneous power level; device local reset
Association group 1 supports 8 nodes.
Devices controlled by switch 1
Association group 2 supports 8 nodes.
Devices controlled by switch 1
Association group 3 supports 8 nodes.
Devices controlled by switch 2
Association group 4 supports 8 nodes.
Devices controlled by switch 2
Association group 5 supports 8 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_METER_V3 | |
| COMMAND_CLASS_MULTI_CHANNEL_V2 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_ASSOCIATION_V1 | |
| COMMAND_CLASS_VERSION_V1 |
| 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.