| layout | title |
|---|---|
documentation |
WSP1 - ZWave |
{% include base.html %}
This describes the Z-Wave device WSP1, manufactured by wiDom with the thing type UID of widom_wsp1_00_000.
The device is in the category of Power Outlet, defining Small devices to be plugged into a power socket in a wall which stick there.
The WSP1 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 Plug is able to detect overvoltage and/or overcurrent events and indicate them through a multicolor LED. Furthermore, it protects appliances from eventual overload. A very innovative design, which integrates a complex system that allows a precise energy consumption monitoring. The integration of these features in its very small size product, make it unique on the market.
The device is equipped with contact protection technology (Zero Crossing) which reduces the electrical stress on the relay contacts and ensures a longer life. The open / closed switching of the device always occur when the instantaneous value of voltage is 0.
It operates in any Z-Wave network with other Z-Wave/Z-Wave Plus certified devices and controllers from any other manufacturer. As a constantly powered node, WiDom Smart Plug will act as repeater regardless of the vendor in order to increase the reliability of the network.
If the device is not included into a Z-Wave network, three consecutive clicks on the Push Button 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 and will last between 15-30 seconds.
After activating the exclusion function by the controller, the device can be removed by setting it in Exclusion Mode by three consecutive clicks on the Push Button.
The following table summarises the channels available for the WSP1 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Switch | switch_binary | switch_binary | Switch | Switch |
| Electric meter (volts) | meter_voltage | meter_voltage | Energy | Number |
| Electric meter (watts) | meter_watts | meter_watts | Energy | Number |
| Electric meter (kWh) | meter_kwh | meter_kwh | Energy | Number |
| Meter Reset | meter_reset | meter_reset | Energy | 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 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 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.
Reset the meter.
The meter_reset channel is of type meter_reset and supports the Switch item and is in the Energy category.
The following table provides a summary of the 11 configuration parameters available in the WSP1. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Local load control | Defines which sequences of click control the local load. |
| 2 | Level used to control group 4 | Level used to control group 4 |
| 3 | Level used to control group 5 | Level used to control group 5 |
| 4 | Overvoltage level | Overvoltage level |
| 5 | Overvoltage Timer | Overvoltage Timer |
| 6 | Overvoltage Alarm Reset | Overvoltage Alarm Reset |
| 7 | Level used to control group 3 | Level used to control the devices associated to group 3 |
| 8 | Overcurrent level | Overcurrent level |
| 9 | Overcurrent Timer | Overcurrent Timer |
| 10 | Overcurrent Alarm Reset | Overcurrent Alarm Reset |
| 11 | Level used to control group 2 | Level used to control the devices associated to group 2 |
Defines which sequences of click control the local load.
The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | ONE_CLICK |
| 2 | TWO_CLICKS |
| 3 | ONE_CLICK or TWO_CLICKS |
The manufacturer defined default value is 3 (ONE_CLICK or TWO_CLICKS ).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Level used to control group 4 Defines how to control the devices associated to 1 click event. Values in the range -1 to 100 may be set.
The manufacturer defined default value is 100.
This parameter has the configuration ID config_2_1 and is of type INTEGER.
Level used to control group 5 Defines how to control the devices associated to 2 clicks event. Values in the range -1 to 100 may be set.
The manufacturer defined default value is 100.
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Overvoltage level Defines the voltage level (in Volts) beyond which an overvoltage event is identified and the overvoltage timer is activated. The timer is reset when the event ceases, i.e. when the voltage returns below the overvoltage level. As soon as an overvoltage event occurs, the LED starts a BLUE blinking. If the overvoltage event ceases before the overvoltage timer expires, the blue blinking is stopped, otherwise the alarm is generated and the blinking reset is established by parameter 6. Values in the range 110 to 260 may be set.
The manufacturer defined default value is 253.
This parameter has the configuration ID config_4_2 and is of type INTEGER.
Overvoltage Timer Define the time (seconds) in which the voltage must persist above the overvoltage level so that an alarm is generated. Values in the range 1 to 3600 may be set.
The manufacturer defined default value is 5.
This parameter has the configuration ID config_5_2 and is of type INTEGER.
Overvoltage Alarm Reset Define how to reset the overvoltage alarm and breaks off the blue blinking. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | MANUAL |
| 1 | OVER_VOLTAGE_END |
The manufacturer defined default value is 0 (MANUAL).
This parameter has the configuration ID config_6_1 and is of type INTEGER.
Level used to control the devices associated to group 3 Define how to control the devices associated to the overvoltage alarm Values in the range -1 to 99 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_7_1 and is of type INTEGER.
Overcurrent level Defines the current level (in Amps) beyond which an overcurrent event is identified and the overcurrent timer is activated. The timer is reset when the event ceases, i.e. when the current returns below the overcurrent level. As soon as an overcurrent event occurs, the led starts a red blinking. If the overcurrent event ceases before the overcurrent timer expires, the red blinking is stopped, otherwise the alarm is generated and the blinking reset is established by parameter 10. Values in the range 1 to 12 may be set.
The manufacturer defined default value is 12.
This parameter has the configuration ID config_8_1 and is of type INTEGER.
Overcurrent Timer Define the time (seconds) in which the current must persist above the overcurrent level so that an alarm is generated and the relay is opened. Values in the range 1 to 3600 may be set.
The manufacturer defined default value is 10.
This parameter has the configuration ID config_9_2 and is of type INTEGER.
Overcurrent Alarm Reset Define how to reset the over-current alarm and breaks off the red blinking. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | MANUAL |
| 1 | OVER_CURRENT_END |
The manufacturer defined default value is 1 (OVER_CURRENT_END).
This parameter has the configuration ID config_10_1 and is of type INTEGER.
Level used to control the devices associated to group 2 Define how to control the devices associated to the overcurrent alarm. Values in the range -1 to 99 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_11_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 WSP1 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. Lifeline: Nodes belonging to this groups will receive changes related to the relay status and power consumption
Association group 1 supports 8 nodes.
Over Current: Nodes belonging to this groups will be controlled by a basic set if over current event occurs
Association group 2 supports 8 nodes.
Over Voltage: Nodes belonging to this groups will be controlled by a basic set if over voltage event occurs
Association group 3 supports 8 nodes.
Control 1 Click: Nodes belonging to this groups will be controlled by a basic set if the button receives one click
Association group 4 supports 8 nodes.
Control 2 Clicks: Nodes belonging to this groups will be controlled by a basic set if the button receives two clicks
Association group 5 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_ZWAVEPLUS_INFO_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 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.