---
layout: documentation
title: ZW056 - ZWave
---

{% include base.html %}

# ZW056 Doorbell
This describes the Z-Wave device *ZW056*, manufactured by *[AEON Labs](http://aeotec.com/)* with the thing type UID of ```aeon_zw056_00_000```.

The device is in the category of *Door*, defining Door sensors.

![ZW056 product image](https://opensmarthouse.org/zwavedatabase/263/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 between other devices in the mesh network.

## 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 Name | Channel ID | Channel Type | Category | Item Type |
|--------------|------------|--------------|----------|-----------|
| Switch | switch_binary | switch_binary | Switch | Switch | 
| Volume | config_decimal | config_decimal |  | Number | 
| Repititions | config_decimal | config_decimal |  | Number | 
| Play Chime Now | config_decimal | config_decimal |  | Number | 
| Doorbell Notifications | config_decimal | config_decimal |  | Number | 
| Button Battery Status | config_decimal | config_decimal |  | Number | 

### 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.

### Volume
Generic class for configuration parameter.

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

### Repititions
Generic class for configuration parameter.

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

### Play Chime Now
Generic class for configuration parameter.

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

### Doorbell Notifications
Generic class for configuration parameter.

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

### Button Battery Status
Generic class for configuration parameter.

The ```config_decimal``` channel is of type ```config_decimal``` and supports the ```Number``` 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 | “‐” is previous, “+” is next |
| 1 | "‐” is next, “+” is previous |

The manufacturer defined default value is ```0``` (“‐” is previous, “+” 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 changes vol, long changes ringtone |
| 1 | long changes vol, short changes ringtone |

The manufacturer defined default value is ```0``` (short changes vol, long changes 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

When the state of Doorbell (trigger to turn on/off the rington  
e ) is changed:  
1, Set Configuration parameter 80 to 0： Reserved (Default).  
2, Set Configuration parameter 80 to 1： Send Hail CC.  
3. Set Configuration parameter 80 to 2: Send the Basic  
Report.

Association group 1 supports 5 nodes.

### Group 2: Forward basic set

Forward the Basic Set, Switch Binary Set, Switch Multilevel  
Start Level Change, Switch Multilevel Stop Level Change,  
Switch Multilevel Set, Scene Activation Set to associated  
nodes in Group 2 when the Doorbell receives the Basic Set,  
Switch Binary Set, Switch Multilevel Start Level Change,  
Switch Multilevel Stop Level Change, Switch Multilevel Set,  
Scene Activation Set commands from main controller.

Association group 2 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_V1| |
| 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_V1| |
| COMMAND_CLASS_ASSOCIATION_V1| |
| COMMAND_CLASS_VERSION_V1| |
| COMMAND_CLASS_SECURITY_V1| |

### Documentation Links

* [English User Manual](https://opensmarthouse.org/zwavedatabase/263/reference/Doorbell-manual-20150604-.pdf)
* [Engineering manual](https://opensmarthouse.org/zwavedatabase/263/reference/aeon-labs-Doorbell-Gen5-engineering-manual.pdf)

---

Did you spot an error in the above definition or want to improve the content?
You can [contribute to the database here](https://opensmarthouse.org/zwavedatabase/263).