| layout | title |
|---|---|
documentation |
ZWA005 - ZWave |
{% include base.html %}
This describes the Z-Wave device ZWA005, manufactured by Aeotec Limited with the thing type UID of aeotec_zwa005_00_000.
The device is in the category of Sensor, defining Device used to measure something.
The ZWA005 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 ZWA005 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 TriSensor is a universal Z-Wave Plus compatible product, consists of temperature, lighting and motion sensors, powered by a CR123A battery. It can be included and operated in any Z-Wave network with other Z-Wave certified devices from other manufacturers and/or other applications. By the built-in motion sensor, an alarm will be sent to the gateway when the motion sensor is triggered.
Press once TriSensor’s Action Button. If it is the first installation, the yellow LED will keep solid until whole network processing is complete. If successful, the LED will flash white -> green -> white -> green, after 2 seconds finished. If failed, the yellow LED lasts for 30 seconds, then the green LED flashes once. If it is the S2 encryption network, please enter the first 5 digits of DSK.
Press once TriSensor’s Action Button, the Purple LED will keep solid until whole network processing is complete. If the exclusion is successful, the LED will flash white -> green - >white -> green and then LED will pulse a blue. If failed, the yellow LED lasts for 30 seconds, then the green LED flashes once.
The ZWA005 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.
Press and hold the button at least 2s until Red Led is on and then release the button,device will send wakeup notification to controller if device is in a Z-Wave network.
- Power up the device.
- Press and hold the button for 15s until Red Led is blinking,then release the button.
Note: Please use this procedure only when the network primary controller is missing or otherwise inoperable.
The following table summarises the channels available for the ZWA005 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Sensor (temperature) | sensor_temperature | sensor_temperature | Temperature | Number:Temperature |
| Sensor (luminance) | sensor_luminance | sensor_luminance | Number | |
| Motion Alarm | alarm_motion | alarm_motion | Motion | Switch |
| Battery Level | battery-level | system.battery_level | Battery | Number |
Indicates the current temperature.
The sensor_temperature channel is of type sensor_temperature and supports the Number:Temperature item and is in the Temperature category.
Indicates the current light reading.
The sensor_luminance channel is of type sensor_luminance and supports the Number item. This is a read only channel so will only be updated following state changes from the device.
Indicates if a motion alarm is triggered.
The alarm_motion channel is of type alarm_motion and supports the Switch item and is in the Motion 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 |
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 20 configuration parameters available in the ZWA005. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Motion Retrigger Time | Delay before the motion event can be re-triggered |
| 2 | Motion Clear Time | Time until the motion event is cleared |
| 3 | Motion Sensitivity | Motion sensor sensitivity on a scale from 1-11 |
| 4 | Motion Sensor Report Mode | Sets the report to send when motion is detected |
| 5 | Send BASIC_SET to Associated nodes | Send BASIC_SET when events are triggered |
| 6 | Basic Set Value Settings for Group 2 | Values to send to Group 2 |
| 7 | Temperature Alarm Value | Alert nodes when temperature is above this value |
| 10 | LED Indicate Disable | Whether to blink the LED when motion is detected |
| 11 | LED Color For Motion Event Report | LED color when sending a motion event report |
| 12 | Led Color For Temperature Sensor Report | LED color when sending a temperature sensor report |
| 13 | Led Color For Light Sensor Report | LED color when sending a light sensor report |
| 15 | Led Color For Wakeup Notification Report | LED color when sending a wakeup report |
| 20 | Temperature Scale | Report temperature in Celsius or Fahrenheit |
| 21 | Temperature Threshold Value to Report | Minimum temperature change to report |
| 22 | Light intensity Threshold Value to Report | Minimum light intensity change to report |
| 23 | Temperature Sensor Report Interval | Interval for timed temperature reports |
| 24 | Light Sensor Report Interval | Interval for timed light level reports |
| 30 | Temperature Offset Value | Adjustment for temperature measurements |
| 31 | Light Intensity Offset Value | Adjustment for light intensity measurements |
| 100 | Light Sensor Calibrated Coefficient | Calibration coefficient for light measurements |
| 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 |
Delay before the motion event can be re-triggered This parameter is configured the delay time before PIR sensor can be triggered again to reset motion timeout counter. Values in the range 0 to 32767 may be set.
The manufacturer defined default value is 30.
This parameter has the configuration ID config_1_2 and is of type INTEGER.
Time until the motion event is cleared This parameter is configured the time to clear motion event after a motion event detected. Time to motion clear, the device will send a clear event report to controller and send BASIC_SET= 0x00 to nodes associated in group 2. Values in the range 0 to 32767 may be set.
The manufacturer defined default value is 240.
This parameter has the configuration ID config_2_2 and is of type INTEGER.
Motion sensor sensitivity on a scale from 1-11 This parameter is configured the sensitivity that motion detect. Values in the range 0 to 11 may be set.
The manufacturer defined default value is 11.
This parameter has the configuration ID config_3_1 and is of type INTEGER.
Sets the report to send when motion is detected
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Notification Reports |
| 1 | Binary Sensor |
The manufacturer defined default value is 0 (Notification Reports).
This parameter has the configuration ID config_4_1 and is of type INTEGER.
Send BASIC_SET when events are triggered This parameter enables sending BASIC_SET command to nodes that associated in group 2 and group 3. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disabled |
| 1 | Group 2 |
| 2 | Group 3 |
| 3 | Group 2 and 3 |
The manufacturer defined default value is 3 (Group 2 and 3).
This parameter has the configuration ID config_5_1 and is of type INTEGER.
Values to send to Group 2
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Set 0xFF on triggered, 0x00 on cleared |
| 1 | Set 0x00 on triggered, 0xFF on cleared |
| 2 | Set 0xFF on motion triggered |
| 3 | Set 0x00 on motion triggered |
| 4 | Set 0x00 on motion cleared |
| 5 | Set 0xFF on motion cleared |
The manufacturer defined default value is 0 (Set 0xFF on triggered, 0x00 on cleared).
This parameter has the configuration ID config_6_1 and is of type INTEGER.
Alert nodes when temperature is above this value This parameter is configured the threshold value that alarm level for temperature. When the current ambient temperature value is larger than this configuration value, device will send a BASIC_SET = 0xFF to nodes associated in group 3. If current temperature value is less than this value, device will send a BASIC_SET = 0x00 to nodes associated in group 3. Values in the range -400 to 1185 may be set.
The manufacturer defined default value is 239.
This parameter has the configuration ID config_7_2 and is of type INTEGER.
Whether to blink the LED when motion is detected This parameter is configured the Led light on disable or enable. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disable Led Blink |
| 1 | Enable Led Blink |
The manufacturer defined default value is 1 (Enable Led Blink).
This parameter has the configuration ID config_10_1 and is of type INTEGER.
LED color when sending a motion event report
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disable |
| 1 | Red |
| 2 | Green |
| 3 | Blue |
| 4 | Yellow |
| 5 | Pink |
| 6 | Cyan |
| 7 | Purple |
| 8 | Orange |
The manufacturer defined default value is 2 (Green).
This parameter has the configuration ID config_11_1 and is of type INTEGER.
LED color when sending a temperature sensor report
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disable |
| 1 | Red |
| 2 | Green |
| 3 | Blue |
| 4 | Yellow |
| 5 | Pink |
| 6 | Cyan |
| 7 | Purple |
| 8 | Orange |
The manufacturer defined default value is 0 (Disable).
This parameter has the configuration ID config_12_1 and is of type INTEGER.
LED color when sending a light sensor report
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disable |
| 1 | Red |
| 2 | Green |
| 3 | Blue |
| 4 | Yellow |
| 5 | Pink |
| 6 | Cyan |
| 7 | Purple |
| 8 | Orange |
The manufacturer defined default value is 0 (Disable).
This parameter has the configuration ID config_13_1 and is of type INTEGER.
LED color when sending a wakeup report
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Disable |
| 1 | Red |
| 2 | Green |
| 3 | Blue |
| 4 | Yellow |
| 5 | Pink |
| 6 | Cyan |
| 7 | Purple |
| 8 | Orange |
The manufacturer defined default value is 0 (Disable).
This parameter has the configuration ID config_15_1 and is of type INTEGER.
Report temperature in Celsius or Fahrenheit
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | Celsius |
| 1 | Fahrenheit |
The manufacturer defined default value is 0 (Celsius).
This parameter has the configuration ID config_20_1 and is of type INTEGER.
Minimum temperature change to report Change threshold value for change in temperature to induce an automatic report for temperature sensor. Setting of value 20 can be a change of -2.0 or +2.0 (C or F depending on Parameter No.20) to induce automatic report or setting a value of 2 will be a change of 0.2(C or F). Values in the range 0 to 250 may be set.
The manufacturer defined default value is 25.
This parameter has the configuration ID config_21_2 and is of type INTEGER.
Minimum light intensity change to report Change threshold value for change in light sensor to induce an automatic report for temperature sensor. Values in the range 0 to 10000 may be set.
The manufacturer defined default value is 100.
This parameter has the configuration ID config_22_2 and is of type INTEGER.
Interval for timed temperature reports This parameter is configured the time interval for temperature sensor report. This value is larger, the battery life is longer. And the temperature value changed is not obvious. Values in the range 0 to 32767 may be set.
The manufacturer defined default value is 3600.
This parameter has the configuration ID config_23_2 and is of type INTEGER.
Interval for timed light level reports This parameter is configured the time interval for light sensor report. This value is larger, the battery life is longer. And the light intensity changed is not obvious. Values in the range 0 to 32767 may be set.
The manufacturer defined default value is 3600.
This parameter has the configuration ID config_24_2 and is of type INTEGER.
Adjustment for temperature measurements The current measuring temperature value can be add and minus a value by this setting. Values in the range -200 to 200 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_30_2 and is of type INTEGER.
Adjustment for light intensity measurements The current measuring light intensity value can be add and minus a value by this setting. Values in the range -1000 to 1000 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_31_2 and is of type INTEGER.
Calibration coefficient for light measurements This configuration defines the calibrated scale for ambient light intensity. Because the method and position that the sensor mounted and the cover of sensor will bring measurement error, user can get more real light intensity by this parameter setting. User should run the steps as blows for calibrating:
- Set this parameter value to default (Assumes the sensor has been added in a Z- Wave Network).
- Place a digital luxmeter close to sensor and keep the same direction, monitor the light intensity value (Vm) which report to controller and record it. The same time user should record the value (Vs) of luxmeter.
- The scale calibration formula: k = Vm / Vs.
- The value of k is then multiplied by 1024 and rounded to the nearest whole number.
- Set the value getting in 5) to this parameter, calibrate finished.
For example, Vm = 300, Vs = 2600, then k = 2600 / 300 = 8.6667,
k = 8.6667 * 1024 = 8874.7 ≈ 8875. In this case, the parameter should be set to 8875.
Values in the range 1 to 32767 may be set.
The manufacturer defined default value is 1024.
This parameter has the configuration ID config_100_2 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 ZWA005 supports 3 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.
Group 2 is controlling group, all nodes associated in this group will be controlled through BASIC_SET command by the device when device detects a movement event. Basic Set Value is decided by Configuration Parameter 6.
Association group 2 supports 5 nodes.
Group 3 is controlling group, all nodes associated in this group will be controlled through BASIC_SET command by the device when device detects a movement event. Basic Set Value is decided by Configuration Parameter 6.
Association group 3 supports 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_SENSOR_BINARY_V2 | |
| COMMAND_CLASS_SENSOR_MULTILEVEL_V7 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| 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_BATTERY_V1 | |
| COMMAND_CLASS_WAKE_UP_V2 | |
| COMMAND_CLASS_ASSOCIATION_V2 | |
| COMMAND_CLASS_VERSION_V2 | |
| COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V3 | |
| COMMAND_CLASS_SECURITY_V1 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.