| layout | title |
|---|---|
documentation |
ZWA008 - ZWave |
{% include base.html %}
This describes the Z-Wave device ZWA008, manufactured by Aeotec Limited with the thing type UID of aeotec_zwa008_00_000.
The device is in the category of Sensor, defining Device used to measure something.
The ZWA008 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 ZWA008 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 Door/ Window Sensor 7 is a small window position sensor for your smart home, it monitors window and their exact opening position and lets your know when a window is tilted or completely opened. It also supports connecting external binary sensors through the dry binary contact of the Door/ Window sensor.
Tripple click the tamper switch
Tripple click the tamper switch
The ZWA008 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.
Hit the tamper switch once.
The following table summarises the channels available for the ZWA008 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Binary Sensor | sensor_binary | sensor_binary | Switch | |
| Scene Number | scene_number | scene_number | Number | |
| Door Sensor | sensor_door | sensor_door | Door | Contact |
| Alarm (tamper) | alarm_tamper | alarm_tamper | Switch | |
| Battery Level | battery-level | system.battery_level | Battery | Number |
Indicates if a sensor has triggered.
The sensor_binary channel is of type sensor_binary and supports the Switch item. 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 |
|---|---|
| ON | Triggered |
| OFF | Untriggered |
Triggers when a scene button is pressed.
The scene_number channel 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 |
Indicates if the door/window is open or closed.
The sensor_door channel is of type sensor_door and supports the Contact item and is in the Door 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 Contact item type -:
| Value | Label |
|---|---|
| OPEN | Open |
| CLOSED | Closed |
Indicates if the tamper alarm is triggered.
The alarm_tamper channel is of type alarm_tamper and supports the Switch item. 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 |
Represents the battery level as a percentage (0-100%). Bindings for things supporting battery level in a different format (e.g. 4 levels) should convert to a percentage to provide a consistent battery level reading.
The system.battery-level channel is of type system.battery-level and supports the Number item and is in the Battery category.
This channel provides the battery level as a percentage and also reflects the low battery warning state. If the battery state is in low battery warning state, this will read 0%.
The following table provides a summary of the 15 configuration parameters available in the ZWA008. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Sensor Operation Mode | Defines if internal magnet sensor or the external terminal input is detected |
| 2 | Sensor State Polarity | Defines the polarity of the magnet sensor |
| 3 | Visual LED Indications | Defines when the red LED will indicate events. |
| 4 | Range Test after double click | Allows to enable the activation of a Z-Wave range. |
| 5 | 2nd Association Group Trigger | Sending a BASIC command to all devices of Association Group 2 |
| 6 | Command Sent to Devices of Association Group 2 | This parameter defines which commands is sent to 2nd Association Group |
| 7 | BASIC command value sent to 2nd Assoc Group on On | BASIC command value sent to 2nd Association Group on ‘On‘ event |
| 8 | BASIC command value sent to 2nd Assoc Group on Off | BASIC command value sent to 2nd Association Group on ‘Off‘ event |
| 9 | Time Delay of ‘On‘ command frame | Time Delay of ‘On‘ command frame |
| 10 | Time Delay of ‘Off‘ command frame | Time Delay of ‘Off‘ command frame |
| 11 | Delay of Tamper Alarm Cancellation | Delay of Tamper Alarm Cancellation |
| 12 | Reporting Tamper Alarm Cancellation | Reporting Tamper Alarm Cancellation |
| 13 | Central Scene Event Functionality | Central Scene Event Functionality |
| 14 | Tilt Sensor Functionality | Tilt Sensor Functionality |
| 15 | Tilt Sensor Sensitivity | Tilt Sensor Sensitivity |
| Wakeup Interval | Sets the interval at which the device will accept commands from the controller | |
| Wakeup Node | Sets the node ID of the device to receive the wakeup notifications |
Defines if internal magnet sensor or the external terminal input is detected This parameter defines if the internal magnet sensor or the external terminal input is detected and used to issue alarm notification. There is always one input active only. The other sensor input the deactivated. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Internal Magnet Sensor Used |
| 1 | External Terminal Inputs Used |
The manufacturer defined default value is 0 (Internal Magnet Sensor Used).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Defines the polarity of the magnet sensor
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Closed when Magnet in proximity |
| 1 | Opened when Magnet in proximity |
The manufacturer defined default value is 0 (Closed when Magnet in proximity).
This parameter has the configuration ID config_2_1 and is of type INTEGER.
Defines when the red LED will indicate events. Disabling all indications may extend battery life.
<td>
<strong>Description</strong>
</td>
<td>
No Indications
</td>
<td>
Open/Close Status Change
</td>
<td>
Wake Up
</td>
<td>
Device Tampering
</td>
| Setting |
| Byte 1: 00000001 |
| Byte 1: 00000010 |
| Byte 1: 00000100 |
| Byte 1: 00010000 |
The manufacturer defined default value is 7.
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Allows to enable the activation of a Z-Wave range. Allows to enable the activation of a Z-Wave range test with double clicking the tamper switch. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disabled |
| 1 | Enabled |
The manufacturer defined default value is 0 (Disabled).
This parameter has the configuration ID config_4_1 and is of type INTEGER.
Sending a BASIC command to all devices of Association Group 2 This parameter defines the status of the magnet switch that causes sending a BASIC command to all devices of Association Group 2 The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Switch after ‘Open‘ and ‘Close‘ |
| 1 | Switch after ‘Open‘ |
| 2 | Switch after ‘Close‘ |
The manufacturer defined default value is 0 (Switch after ‘Open‘ and ‘Close‘).
This parameter has the configuration ID config_5_1 and is of type INTEGER.
This parameter defines which commands is sent to 2nd Association Group
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | On |
| 1 | Off |
| 2 | On and Off |
The manufacturer defined default value is 2 (On and Off).
This parameter has the configuration ID config_6_1 and is of type INTEGER.
BASIC command value sent to 2nd Association Group on ‘On‘ event
Values in the range 0 to 255 may be set.
The manufacturer defined default value is 255.
This parameter has the configuration ID config_7_1 and is of type INTEGER.
BASIC command value sent to 2nd Association Group on ‘Off‘ event
Values in the range 0 to 255 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_8_1 and is of type INTEGER.
Time Delay of ‘On‘ command frame
Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_9_2 and is of type INTEGER.
Time Delay of ‘Off‘ command frame
Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_10_2 and is of type INTEGER.
Delay of Tamper Alarm Cancellation
Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_11_2 and is of type INTEGER.
Reporting Tamper Alarm Cancellation
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Do not send Report |
| 1 | Send Report |
The manufacturer defined default value is 1 (Send Report).
This parameter has the configuration ID config_12_1 and is of type INTEGER.
Central Scene Event Functionality
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disabled |
| 1 | Enabled |
The manufacturer defined default value is 0 (Disabled).
This parameter has the configuration ID config_13_1 and is of type INTEGER.
Tilt Sensor Functionality
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disabled |
| 1 | Enabled |
The manufacturer defined default value is 1 (Enabled).
This parameter has the configuration ID config_14_1 and is of type INTEGER.
Tilt Sensor Sensitivity
Values in the range 0 to 100 may be set.
The manufacturer defined default value is 50.
This parameter has the configuration ID config_15_1 and is of type INTEGER.
The wakeup interval sets the period at which the device will listen for messages from the controller. This is required for battery devices that sleep most of the time in order to conserve battery life. The device will wake up at this interval and send a message to the controller to tell it that it can accept messages - after a few seconds, it will go back to sleep if there is no further communications.
This setting is defined in seconds. It is advisable not to set this interval too short or it could impact battery life. A period of 1 hour (3600 seconds) is suitable in most instances.
Note that this setting does not affect the devices ability to send sensor data, or notification events.
This parameter has the configuration ID wakeup_interval and is of type INTEGER.
When sleeping devices wake up, they send a notification to a listening device. Normally, this device is the network controller, and normally the controller will set this automatically to its own address. In the event that the network contains multiple controllers, it may be necessary to configure this to a node that is not the main controller. This is an advanced setting and should not be changed without a full understanding of the impact.
This parameter has the configuration ID wakeup_node 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 ZWA008 supports 4 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.
Association group 1 supports 5 nodes.
Control devices when magnet or external dry contacts trips
Association group 2 supports 5 nodes.
Sends alarm message when magnet controlled or external dry sensor trips.
Association group 3 supports 5 nodes.
Sends alarm messages when tamper is tripped
Association group 4 supports 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_SENSOR_BINARY_V2 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_CENTRAL_SCENE_V3 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_ALARM_V8 | |
| COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2 | |
| COMMAND_CLASS_POWERLEVEL_V1 | |
| COMMAND_CLASS_FIRMWARE_UPDATE_MD_V4 | |
| COMMAND_CLASS_BATTERY_V1 | |
| COMMAND_CLASS_WAKE_UP_V2 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_VERSION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 | |
| COMMAND_CLASS_SECURITY_V2 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.