| layout | title |
|---|---|
documentation |
ZW129 - ZWave |
{% include base.html %}
This describes the Z-Wave device ZW129, manufactured by AEON Labs with the thing type UID of aeon_zw129_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 ZW129 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is unable to participate in the routing of data from other devices.
The ZW129 does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. Refer to the Wakeup Information section below for further information.
Aeotec WallMote is an intelligent Z-Wave remote controller that mounted on a wall.
It has 2 touch buttons that you can easily control the Z-Wave devices in your home network via touching, long pressing or sliding the button areas. Its surface has a RGB LED to indicate the button actions also accompanied by touch beep and vibration.
The WallMote Quad is also a security Z-Wave device and supports Over The Air (OTA) feature for the products firmware upgrade.
Including WallMote Quad as a non-secure device:
If you want your WallMote Quad as a non-security device in your Z-wave network, you just need to press the Action Button once on WallMote Quad when you use a controller/gateway to add/include it. The green LED will be on for 2 seconds and then the orange LED will fast blink for 10 minutes (if the WallMote Quad does not receive the Wake Up No More Info command from primary Controller) to indicate the inclusion is successful
Including WallMote Quad as a secure device:
In order to take full advantage of all functionality the WallMote Quad, you may want your WallMote Quad is a security device that uses secure/encrypted message to communicate in Z-wave network, so a security enabled controller/gateway is needed for the WallMote Quad to be used as a security device. You need to press the WallMote Quad’s Action Button 2 times within 1 second when your security controller/gateway starts the network inclusion. The blue LED will be on for 2 seconds and then the orange LED will fast blink for 10 minutes (if the WallMote Quad does not receive the Wake Up No More Info command from primary Controller) to indicate the inclusion is successful.
Your WallMote Quad can be removed from your Z-Wave network at any time. You'll need to use your Z-Wave network's main controller/ gateway. To do this, please refer to the part of their respective manuals that tell you how to remove devices from your network.
- Put your primary controller into device removal mode.
- Unlock your WallMote Quad from the Back Mount plate and take the WallMote Quad unit near to your primary controller.
- Press the Action Button on your WallMote Quad.
If your WallMote Quad is successfully removed from the Z-Wave network, the LED will become a colourful gradient for a few seconds and then turn off. If the removing was unsuccessful, the red LED will be solid for 2 seconds and then turn off, repeat the above steps.
The ZW129 does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. The wakeup period can be configured in the user interface - it is advisable not to make this too short as it will impact battery life - a reasonable compromise is 1 hour.
The wakeup period does not impact the devices ability to report events or sensor data. The device can be manually woken with a button press on the device as described below - note that triggering a device to send an event is not the same as a wakeup notification, and this will not allow the controller to communicate with the device.
In order to send your WallMote Quad new configuration commands from your Z-Wave controller or gateway, it will need to be woken up.
Remove your WallMote Quad unit from its Back Mounting Plate, press and hold the Action Button for 3 seconds(the buzzer chirp once and the orange LED will be ON) on the back of the WallMote Quad unit and then release it. This will trigger and send a wake up notification command to your controller/gateway, then your WallMote Quad will wake up for 10 minutes and the orange LED will fast blink while it is awake (if the WallMote Quad does not receive the Wake Up No More Info from the primary Controller).
The following table summarises the channels available for the ZW129 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Switch [Deprecated] | switch_binary | switch_binary | Switch | Switch |
| Dimmer | switch_dimmer | switch_dimmer | DimmableLight | Dimmer |
| Electric meter (watts) | meter_watts | meter_watts | Energy | Number |
| Electric meter (kWh) | meter_kwh | meter_kwh | Energy | Number |
| Scene Number | scene_number | scene_number | Number |
Delete
Switch the power on and off.
The switch_binary channel and is of type switch_binary and supports the Switch item and is in the Switch category.
Note: This channel is marked as deprecated so should not be used.
delete
The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.
The switch_dimmer channel and is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.
Delete - Device does not have meter channels
Indicates the instantaneous power consumption.
The meter_watts channel and 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.
Delete - Device does not have meter channels
Indicates the energy consumption (kWh).
The meter_kwh channel and 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.
Triggers when a scene button is pressed.
The scene_number channel and is of type scene_number and supports the Number item.
This channel provides the scene, and the event as a decimal value in the form <scene>.<event>. The scene number is set by the device, and the event is as follows -:
| Event ID | Event Description |
|---|---|
| 0 | Single key press |
| 1 | Key released |
| 2 | Key held down |
| 3 | Double keypress |
| 4 | Tripple keypress |
| 5 | 4 x keypress |
| 6 | 5 x keypress |
The following table provides a summary of the 7 configuration parameters available in the ZW129. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Touch sound | Enable/disable the touch sound. |
| 2 | Touch vibration | Enable/disable the touch vibration. |
| 3 | Button slide | Enable/disable the function of button slide. |
| 4 | Notification report | Which notification to be sent to the associated devices. |
| 5 | Color | Configure which color will be displayed when a button is pressed |
| 39 | Low battery value | Set the low battery value |
| 255 | Reset the WallMote Quad | Reset the WallMote Quad to factory default. |
Enable/disable the touch sound.
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_1_1 and is of type INTEGER.
Enable/disable the touch vibration.
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_2_1 and is of type INTEGER.
Enable/disable the function of button slide.
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_3_1 and is of type INTEGER.
Which notification to be sent to the associated devices. To set which notification would be sent to the associated devices (Group 1) when pressing the buttons. When the parameter is set to 3, slide functionality on the buttons is activated. The following option values may be configured -:
| Value | Description |
|---|---|
| 1 | Central scene |
| 3 | Central scene and config |
The manufacturer defined default value is 1 (Central scene).
This parameter has the configuration ID config_4_1 and is of type INTEGER.
Configure which color will be displayed when a button is pressed Each color component occupies a single byte. To calculate the color value do:
color = ((((Red * 256) + Green) * 256) + Blue) * 256
Value 1 = Red
Value 2 = Green
Value 3 = Blue
Value 4 = Reserved Values in the range 0 to 2147483647 may be set.
The manufacturer defined default value is 65280.
This parameter has the configuration ID config_5_4 and is of type INTEGER.
Set the low battery value
Values in the range 0 to 50 may be set.
The manufacturer defined default value is 5.
This parameter has the configuration ID config_39_1 and is of type INTEGER.
Reset the WallMote Quad to factory default.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Reset to factory default |
| 1431655765 | Reset and remove |
The manufacturer defined default value is 0 (Reset to factory default).
This parameter has the configuration ID config_255_4_wo and is of type INTEGER.
This is a write only parameter.
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 ZW129 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. Z-Wave Plus Lifeline When touching the Button 1 to 4, the Central Scene Notificcation command will be sent to the associated node (1) in Association group 1.
Association group 1 supports 1 node.
On/off control via button 1 When touching the Button 1, the Basic Set command will be sent to the associated nodes in Association group 2.
Association group 2 supports 5 nodes.
Dim control via button 1 When touching the Button 1, the Multilevel Switch Set command will be sent to the associated nodes in Association group 3
Association group 3 supports 5 nodes.
On/off control via button 2 When touching the Button 2, the Basic Set command will be sent to the associated nodes in Association group 4.
Association group 4 supports 5 nodes.
Dim control via button 2 When touching the Button 2, the Multilevel Switch Set command will be sent to the associated nodes in Association group 5.
Association group 5 supports 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_SWITCH_BINARY_V1 | |
| COMMAND_CLASS_SWITCH_MULTILEVEL_V3 | |
| COMMAND_CLASS_METER_V3 | |
| COMMAND_CLASS_CENTRAL_SCENE_V1 | Linked to BASIC |
| COMMAND_CLASS_MULTI_CHANNEL_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1 | |
| COMMAND_CLASS_ASSOCIATION_V1 | |
| COMMAND_CLASS_VERSION_V1 |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_CENTRAL_SCENE_V1 | Linked to BASIC |
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_CENTRAL_SCENE_V1 | Linked to BASIC |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.