Skip to content

Latest commit

 

History

History
564 lines (367 loc) · 24.6 KB

zen25_2_0.md

File metadata and controls

564 lines (367 loc) · 24.6 KB
layout title
documentation
ZEN25 - ZWave

{% include base.html %}

ZEN25 Double Plug v2

This describes the Z-Wave device ZEN25, manufactured by Zooz with the thing type UID of zooz_zen25_02_000. This version of the device is limited to firmware versions above 2.0

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.

ZEN25 product image

The ZEN25 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.

Overview

The Double Plug works great as a low profile on/off device for a couple of lamps or small appliances (10A total between both outlets). But it can serve as a smart power monitor, a signal tester, or extender as well. It's fast, it's secure, and it's small.

As always, we've included a bunch of useful settings for you to customize the plug so you get the most of it. There is a built-in timer for remote reboots of connected devices or the option to turn off manual control. But if you find anything missing, just let us know and we'll add it

Inclusion Information

AUTO INCLUSION

  1. Initiate inclusion (pairing) in the app (or web interface). Not sure how? [email protected]
  2. Plug the device into a grounded 120 VAC receptacle you’re planning to use it at (it doesn’t need to be close. Put your Z-Wave hub into inclusion mode and click the Z-Wave button 3 times quickly. The LED indicators will start blinking and the Double Plug will join the network automatically. If it lights up in yellow, inclusion has failed.
  3. You will see 4 new on/off devices in your app: 2 channels for on/off control, 1 channel for on/off monitoring (the USB port reporting charging/ charged status, no control), and 1 master node to control both outlets at the same time and to access and adjust advanced settings in (if your hub supports parameter input).

MANUAL INCLUSION

Put your Z-Wave hub into inclusion mode and click the Z-Wave button 3 times quickly.

Exclusion Information

  1. Bring the plug within direct range of your Z-Wave gateway (hub).
  2. Put the Z-Wave hub into exclusion mode (not sure how to do that? [email protected]).
  3. Press and release the Z-Wave button 3 times quickly.
  4. Your hub will confirm exclusion and all of the channels (child outlets) and the main device will disappear from your controller's device list.

General Usage Information

Range Test Tool

You can easily check if the Double Plug is within your Z-Wave hub’s range:

Press and hold the Z-Wave button for 6 to 8 seconds until the LED indicator turns violet. The LED indicator will then report signal strength.

  • Solid green = direct communication with the primary controller is stable
  • Flashing green = direct communication with the primary controller is established but signal is weak
  • Solid orange = stable communication with hub via repeaters
  • Flashing orange = communication with the primary controller is established via repeaters but signal is weak
  • Solid red = communication with the primary controller has failed

Press and release the Z-Wave button to exit testing mode.

NOTE: This function may only be activated once the Double Plug has been included to a Z-Wave network.

Channels

The following table summarises the channels available for the ZEN25 -:

Channel Name Channel ID Channel Type Category Item Type
Switch switch_binary switch_binary Switch Switch
Electric meter (kWh) meter_kwh meter_kwh Energy Number
Electric meter (watts) meter_watts meter_watts Energy Number
Electric meter (volts) meter_voltage meter_voltage Energy Number
Electric meter (amps) meter_current meter_current Energy Number
Reset Meter [Deprecated] meter_reset meter_reset Energy Switch
Reporting Interval Watts config_decimal config_decimal Number
Alarm (power) alarm_power alarm_power Energy Switch
Switch 1 switch_binary1 switch_binary Switch Switch
Electric meter (kWh) 1 meter_kwh1 meter_kwh Energy Number
Electric meter (watts) 1 meter_watts1 meter_watts Energy Number
Electric meter (volts) 1 meter_voltage1 meter_voltage Energy Number
Electric meter (amps) 1 meter_current1 meter_current Energy Number
Reset Meter [Deprecated] meter_reset1 meter_reset Energy Switch
Switch 2 switch_binary2 switch_binary Switch Switch
Electric meter (kWh) 2 meter_kwh2 meter_kwh Energy Number
Electric meter (watts) 2 meter_watts2 meter_watts Energy Number
Electric meter (volts) 2 meter_voltage2 meter_voltage Energy Number
Electric meter (amps) 2 meter_current2 meter_current Energy Number
Reset Meter [Deprecated] meter_reset2 meter_reset Energy Switch
Switch 3 switch_binary3 switch_binary Switch Switch

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.

Electric meter (kWh)

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.

Electric meter (watts)

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.

Electric meter (volts)

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.

Electric meter (amps)

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.

Reset Meter [Deprecated]

Reset the meter.

The meter_reset channel is of type meter_reset and supports the Switch item and is in the Energy category.

Note: This channel is marked as deprecated so should not be used.

Reporting Interval Watts

Change the reporting interval to reduce network traffic during off hours

Generic class for configuration parameter.

The config_decimal channel is of type config_decimal and supports the Number item.

Alarm (power)

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 1

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.

Electric meter (kWh) 1

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.

Electric meter (watts) 1

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.

Electric meter (volts) 1

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.

Electric meter (amps) 1

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.

Reset Meter [Deprecated]

Reset the meter.

The meter_reset1 channel is of type meter_reset and supports the Switch item and is in the Energy category.

Note: This channel is marked as deprecated so should not be used.

Switch 2

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.

Electric meter (kWh) 2

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.

Electric meter (watts) 2

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.

Electric meter (volts) 2

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.

Electric meter (amps) 2

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.

Reset Meter [Deprecated]

Reset the meter.

The meter_reset2 channel is of type meter_reset and supports the Switch item and is in the Energy category.

Note: This channel is marked as deprecated so should not be used.

Switch 3

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.

Device Configuration

The following table provides a summary of the 18 configuration parameters available in the ZEN25. Detailed information on each parameter can be found in the sections below.

Param Name Description
1 On/Off After Power On/Off Status After Power Failure
2 Wattage Threshold Power Wattage Report Value Threshold
3 Wattage Frequency Power Wattage Report Frequency
4 Energy Frequency Energy (kWh) Report Frequency
5 Voltage Frequency Voltage (V) Report Frequency
6 Current Frequency Electrical Current (A) Report Frequency
7 Overload Protection Overload Protection
8 Enable Auto-Off (Left) Enable Auto Turn-Off Timer for Left Outlet
9 Turn-Off Time (Left) Auto Turn-Off Time for Left Outlet
10 Enable Auto-On (Left) Enable Auto Turn-On Timer for Left Outlet
11 Turn-On Time (Left) Auto Turn-On Time for Left Outlet
12 Enable Auto-Off (Right) Enable Auto Turn-Off Timer for Right Outlet
13 Turn-Off Time (Right) Auto Turn-Off Time for Right Outlet
14 Enable Auto-On (Right) Enable Auto Turn-On Timer for Right Outlet
15 Turn-On Time (Right) Auto Turn-On Time for Right Outlet
16 Manual Control Enable/Disable Manual Control
17 LED Mode LED Indicator Mode
18 Reports Enable/Disable Energy and USB Reports

Parameter 1: On/Off After Power

On/Off Status After Power Failure Choose the recovery state for your Double Plug’s outlets if power outage occurs. The following option values may be configured -:

Value Description
0 Previous State
1 On
2 Off

The manufacturer defined default value is 0 (Previous State).

This parameter has the configuration ID config_1_1 and is of type INTEGER.

Parameter 2: Wattage Threshold

Power Wattage Report Value Threshold Choose how you want your Double Plug to report power consumption to your hub. The number entered as value corresponds to the number of Watts the appliance needs to go over for the change to be reported. So if 5 Watts are entered by default, the Double Plug will report any change in power usage over 5 Watts for each outlet (whether it’s at least 5 Watts more or 5 Watts less compared to previous report). 0 = Disable. Values in the range 0 to 65535 may be set.

The manufacturer defined default value is 10.

This parameter has the configuration ID config_2_4 and is of type INTEGER.

Parameter 3: Wattage Frequency

Power Wattage Report Frequency The number entered as value corresponds to the number of seconds. So if 30 is entered by default, the Double Plug will report power consumption (Wattage) every 30 seconds. Values in the range 30 to 2678400 may be set.

The manufacturer defined default value is 30.

This parameter has the configuration ID config_3_4 and is of type INTEGER.

Parameter 4: Energy Frequency

Energy (kWh) Report Frequency Choose how often you want your Double Plug to report power consumption (W) to your controller (hub). The number entered as value corresponds to the number of seconds. So if 300 is entered by default, the Double Plug will report energy usage every 300 seconds (5 minutes). Values in the range 30 to 2678400 may be set.

The manufacturer defined default value is 300.

This parameter has the configuration ID config_4_4 and is of type INTEGER.

Parameter 5: Voltage Frequency

Voltage (V) Report Frequency Choose how often you want your Double Plug to report voltage to your controller (hub). The number entered as value corresponds to the number of seconds. So if 300 is entered by default, the Double Plug will report voltage every 300 seconds (5 minutes). Values in the range 30 to 2678400 may be set.

The manufacturer defined default value is 300.

This parameter has the configuration ID config_5_4 and is of type INTEGER.

Parameter 6: Current Frequency

Electrical Current (A) Report Frequency Choose how often you want your Double Plug to report electrical current (A) to your controller (hub). The number entered as value corresponds to the number of seconds. So if 300 is entered by default, the Double Plug will report current every 300 seconds (5 minutes). Values in the range 30 to 2678400 may be set.

The manufacturer defined default value is 300.

This parameter has the configuration ID config_6_4 and is of type INTEGER.

Parameter 7: Overload Protection

Overload Protection Set the amp level for overload protection to kick in. The number entered as the value corresponds to the total number of amps the Double Plug needs to detect across both outlets to turn off automatically and send a notification to the hub and associated devices. Values in the range 1 to 10 may be set.

The manufacturer defined default value is 10.

This parameter has the configuration ID config_7_1 and is of type INTEGER.

Parameter 8: Enable Auto-Off (Left)

Enable Auto Turn-Off Timer for Left Outlet Use this parameter to enable or disable the auto turn-off timer for the left (CH1) outlet. If this feature is enabled, the device connected to CH1 outlet will automatically turn off after a fixed period of time from being turned on (set in parameter 9). The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

This parameter has the configuration ID config_8_1 and is of type INTEGER.

Parameter 9: Turn-Off Time (Left)

Auto Turn-Off Time for Left Outlet Use this parameter to set the time after which you want the device connected to the left (CH1) outlet to automatically turn off once it has been turned on. The number entered as value corresponds to the number of minutes. Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

This parameter has the configuration ID config_9_4 and is of type INTEGER.

Parameter 10: Enable Auto-On (Left)

Enable Auto Turn-On Timer for Left Outlet Use this parameter to enable or disable the auto turn-on timer for the left (CH1) outlet. If this feature is enabled, the device connected to CH1 outlet will automatically turn on after a fixed period of time from being turned off (set in parameter 11). The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

This parameter has the configuration ID config_10_1 and is of type INTEGER.

Parameter 11: Turn-On Time (Left)

Auto Turn-On Time for Left Outlet Use this parameter to set the time after which you want the device connected to the left (CH1) outlet to automatically turn on once it has been turned off. The number entered as value corresponds to the number of minutes. Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

This parameter has the configuration ID config_11_4 and is of type INTEGER.

Parameter 12: Enable Auto-Off (Right)

Enable Auto Turn-Off Timer for Right Outlet Use this parameter to enable or disable the auto turn-off timer for the right (CH2) outlet. If this feature is enabled, the device connected to CH2 outlet will automatically turn off after a fixed period of time from being turned on (set in parameter 13). The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

This parameter has the configuration ID config_12_1 and is of type INTEGER.

Parameter 13: Turn-Off Time (Right)

Auto Turn-Off Time for Right Outlet Use this parameter to set the time after which you want the device connected to the right (CH2) outlet to automatically turn off once it has been turned on. The number entered as value corresponds to the number of minutes. Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

This parameter has the configuration ID config_13_4 and is of type INTEGER.

Parameter 14: Enable Auto-On (Right)

Enable Auto Turn-On Timer for Right Outlet Use this parameter to enable or disable the auto turn-on timer for the right (CH2) outlet. If this feature is enabled, the device connected to CH2 outlet will automatically turn on after a fixed period of time from being turned off (set in parameter 15). The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 0 (Disable).

This parameter has the configuration ID config_14_1 and is of type INTEGER.

Parameter 15: Turn-On Time (Right)

Auto Turn-On Time for Right Outlet Use this parameter to set the time after which you want the device connected to the right (CH2) outlet to automatically turn on once it has been turned off. The number entered as value corresponds to the number of minutes. Values in the range 1 to 65535 may be set.

The manufacturer defined default value is 60.

This parameter has the configuration ID config_15_4 and is of type INTEGER.

Parameter 16: Manual Control

Enable/Disable Manual Control Choose if you want to use the Z-Wave button on the Double Plug to turn the outlets on or off manually or if you want to disable this function. If this parameter is set to 0 (disabled), you will only be able to turn any of the outlets on or off remotely using your Z-Wave gateway controller. The following option values may be configured -:

Value Description
0 Disable
1 Enable

The manufacturer defined default value is 1 (Enable).

This parameter has the configuration ID config_16_1 and is of type INTEGER.

Parameter 17: LED Mode

LED Indicator Mode Choose if you want the LED indicators next to each outlet to come on when power is on or off, or if you want to disable them. The following option values may be configured -:

Value Description
0 Always On
1 Follow Outlet
2 Momentary
3 Always Off

The manufacturer defined default value is 1 (Follow Outlet).

This parameter has the configuration ID config_17_1 and is of type INTEGER.

Parameter 18: Reports

Enable/Disable Energy and USB Reports Choose if you want the plug to report power use or on/off activity in the USB port to the hub. The following option values may be configured -:

Value Description
0 energy and USB reports enabled
1 energy and USB reports disabled
2 energy reports for left outlet disabled
3 energy reports for right outlet disabled
4 USB reports disabled

The manufacturer defined default value is 0 (energy and USB reports enabled ).

This parameter has the configuration ID config_18_1 and is of type INTEGER.

Association Groups

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 ZEN25 supports 2 association groups.

Group 1: Lifeline

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.

Group 2: Basic set notifications

Association group 2 supports 1 node.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_BINARY_V1 Linked to BASIC
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_V8
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_POWERLEVEL_V1
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_VERSION_V2
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3

Endpoint 1

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_BINARY_V1 Linked to BASIC
COMMAND_CLASS_METER_V3
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3

Endpoint 2

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_BINARY_V1 Linked to BASIC
COMMAND_CLASS_METER_V3
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3

Endpoint 3

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_BINARY_V1 Linked to BASIC
COMMAND_CLASS_METER_V3
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3

Documentation Links


Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.