The openHAB Documentation Has Moved

The documentation has moved to openhab.org/docs and openhab.org/addons.

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

ZW056 Doorbell

This describes the Z-Wave device ZW056, manufactured by AEON Labs with the thing type UID of aeon_zw056_00_000.

ZW056 product image

The ZW056 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 from other devices.

Overview

Aeon Labs Doorbell is a switch binary device based on Z-wave enhanced slave library V6.51.06.

The Doorbell supports playing MP3 music files with a press of this doorbell. It has a 16MB flash memory that can store up to 100 ringtones. The volume can be adjusted manually via short press on the Volume Button, also you can switch the doorbell sound to the next via long press on the Volume Button. You may change/update your doorbell ringtone at any point in time you want by connecting your Doorbell to your PC to update the sound track on your Doorbell’s flash memory.

Inclusion Information

1. Install Doorbell, and plug it into the socket of AC Power.
2. Let the primary controller into inclusion mode (If you don’t know how to do this, please refer to its manual).
3. Press the Action Button.
4. If the inclusion is failed, please repeat the process from step 2.

Exclusion Information

1. Install Doorbell, and plug it into the socket of AC Power.
2. Let the primary controller into exclusion mode (If you don’t know how to do this, refer to its manual).
3. Press the Action Button.
4. If the remove is failed, please repeat the process from step 2.

Note: If Doorbell is removed from Z-wave network, it will be reset to factory default.

Channels

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

Channel Channel Id Category Item Type
Switch switch_binary Switch Switch
Volume config_decimal   Decimal
Repititions config_decimal   Decimal
Play Chime Now config_decimal   Decimal
Doorbell Notifications config_decimal   Decimal
Button Battery Status config_decimal   Decimal

Switch

Switch the power on and off.

The switch_binary channel supports the Switch item and is in the Switch category.

Volume

Generic class for configuration parameter.

The config_decimal channel supports the Decimal item.

Repititions

Generic class for configuration parameter.

The config_decimal channel supports the Decimal item.

Play Chime Now

Generic class for configuration parameter.

The config_decimal channel supports the Decimal item.

Doorbell Notifications

Generic class for configuration parameter.

The config_decimal channel supports the Decimal item.

Button Battery Status

Generic class for configuration parameter.

The config_decimal channel supports the Decimal item.

Device Configuration

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

Param Name Description
2 Repetitions of ringtone Set the repetitions for playing doorbell ringtone.
5 Default ringtone Set the default doorbell ringtone. Default=1
6 Ringtone to play Set a ringtone to play. Default=0
7 Control items Control current output
8 Ringtone volume Default=10
10 Define button- and button+ action Define functions of “Button ‐” and “Button+”.
11 Define long press button- and button+ Define short/long button presses
42 Get wireless button battery status Alert for low battery
80 Enable Notifications Enable to send notifications to associated devices (Group1)
81 Enable/disable battery group notification Notifies Group 1 when battery state is low
241 Pair doorbell with button Starts wireless button pairing mode
252 Lock configuration Lock configuration
255 Reset Reset to factory settings

Parameter 2: Repetitions of ringtone

Set the repetitions for playing doorbell ringtone. Value=1 to 255, the range of repetition is 1 to 100. Value =0, ignore. Note: If the time of playing doorbell ringtone is more than 20s, the volume of ringtone will reduce to silence no matter how many repetitions of doorbell ringtone are set. Values in the range 0 to 100 may be set.

The manufacturer defined default value is 2.

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

Parameter 5: Default ringtone

Set the default doorbell ringtone. Default=1

Values in the range 1 to 100 may be set.

The manufacturer defined default value is 1.

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

Parameter 6: Ringtone to play

Set a ringtone to play. Default=0 Set this to any ringtone (1-100) to have it play that ringtone. The following option values may be configured, in addition to values in the range 0 to 100 -:

Value Description
0 Stop
255 play the default ringtone

The manufacturer defined default value is 0 (Stop).

This parameter has the configuration ID config_6_1_wo and is of type INTEGER. This is a write only parameter.

Parameter 7: Control items

Control current output Control items: Value=1, play Value=2, stop Value=3, pause Value=4, Next Value=5, Previous Other, ignore The following option values may be configured -:

Value Description
0 Ignore
1 Play
2 Stop
3 Pause
4 Next
5 Previous

The manufacturer defined default value is 0 (Ignore).

This parameter has the configuration ID config_7_1_wo and is of type INTEGER. This is a write only parameter.

Parameter 8: Ringtone volume

Default=10

Values in the range 0 to 10 may be set.

The manufacturer defined default value is 10.

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

Parameter 10: Define button- and button+ action

Define functions of “Button ‐” and “Button+”. 0: button- is previous, button+ is next

1: button- is next, button+ is previous The following option values may be configured -:

Value Description
0 “Button ‐” is previous, “Button+” is next
1 “Button ‐” is next, “Button+” is previous

The manufacturer defined default value is 0 (“Button ‐” is previous, “Button+” is next).

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

Parameter 11: Define long press button- and button+

Define short/long button presses 0: short pressing changes volume, long pressing changes
default ringtone.
1: long pressing changes volume, short pressing changes
default ringtone. The following option values may be configured -:

Value Description
0 short press changes vol, long press changes default ringtone
1 long press changes vol, short press changes default ringtone

The manufacturer defined default value is 0 (short press changes vol, long press changes default ringtone).

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

Parameter 42: Get wireless button battery status

Alert for low battery 0x00: normal battery level

0xff: low battery level

set 0x00: cancel low battery alert The following option values may be configured -:

Value Description
0 Battery Level Good
255 Low Battery

The manufacturer defined default value is 0 (Battery Level Good).

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

Parameter 80: Enable Notifications

Enable to send notifications to associated devices (Group1) Enable/disable to send notifications to associated devices (Group 1) when the state of Doorbell is changed (0=nothing, 1=hail CC, 2=basic CC report) The following option values may be configured -:

Value Description
0 nothing
1 hail CC
2 basic CC report

The manufacturer defined default value is 0 (nothing).

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

Parameter 81: Enable/disable battery group notification

Notifies Group 1 when battery state is low Enable/disable to send notifications to associated devices (Group
1) when the Wireless Button’s battery is in low battery state
(0=nothing, 1=Configuration report 0x2A) The following option values may be configured -:

Value Description
0 nothing
1 Configuration report parameter 42

The manufacturer defined default value is 0 (nothing).

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

Parameter 241: Pair doorbell with button

Starts wireless button pairing mode Pair the Wireless Button with Doorbell.
Value=0x55555555, Start the Wireless Button pairing mode and
the blue Led will blink slowly, short press the Wireless Button
once, if the blue Led change to be solid, which means the pairing
is successful. Otherwise, repeat the steps.
It will automatically exit the pairing mode after 8s if there is no
pressing action of the Wireless Button.
Note:
You can send this configuration Get CC to ask the pairing result:
If configuration report value=0x00000000, which means the
pairing is failed.
If configuration report value =0xFFFFFFFF, which means the
pairing is successful. Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

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

Parameter 252: Lock configuration

Lock configuration 0: config not locked

1: config locked Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

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

Parameter 255: Reset

Reset to factory settings 1. Size=0x01, Configuration Value=0x00:
Reset configuration setting.
2. Size=0x04, Configuration Value=0x55555555:
Reset Factory setting. Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_255_4 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 ZW056 supports 2 association groups.

Group 1: Group 1

This group supports 5 nodes.

Group 2: Forward basic set

This group supports 5 nodes.

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_ASSOCIATION_GRP_INFO_V0  
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1  
COMMAND_CLASS_ZWAVEPLUS_INFO_V1  
COMMAND_CLASS_CONFIGURATION_V1  
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1  
COMMAND_CLASS_POWERLEVEL_V1  
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V0  
COMMAND_CLASS_ASSOCIATION_V1  
COMMAND_CLASS_VERSION_V1  
COMMAND_CLASS_SECURITY_V0  

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