| layout | title |
|---|---|
documentation |
FGDW002 - ZWave |
{% include base.html %}
This describes the Z-Wave device FGDW002, manufactured by Fibargroup with the thing type UID of fibaro_fgdw002_00_000.
The device is in the category of Sensor, defining Device used to measure something.
The FGDW002 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 FGDW002 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.
FIBARO Door/Window Sensor 2 is a wireless, battery powered Hall effect contact sensor, compatible with the Z-Wave Plus standard. Changing the device’s status will automatically send signal to the Z-Wave controller and associated devices.
Sensor can be used to trigger scenes and wherever there is a need for information about opening or closing of doors, windows, garage doors, etc. Opening is detected by separating the sensor’s body and the magnet.
In addition the FIBARO Door/Window Sensor 2 is equipped with a built-in temperature sensor.
Main features of FIBARO Door/Window Sensor 2
- Compatible with any Z-Wave or Z-Wave+ Controller,
- Supports protected mode (Z-Wave network Security Mode) with AES-128 encryption
- Door/window opening detected through separation of Sensor’s body and a magnet
- Built-in temperature sensor
- Detects tampering, when detached or opened
- Easily mounted on doors, windows, garage gates and roller blinds
- Battery powered
- Visual LED indicator signalling status of the device
- 7 color variations.
- Place the Door/Window Sensor 2 within the direct range of your Z-Wave controller.
- Set the main controller in (Security/non-Security Mode) add mode (see the controller’s manual).
- Quickly, three times press one of the TMP buttons (while the other button is pressed).
- Wait for the adding process to end.
- Successful adding will be confirmed by the Z-Wave controller’s message.
- Place the Door/Window Sensor 2 within the direct range of your Z-Wave controller.
- Set the main controller into remove mode (see the controller’s manual).
- Quickly, three times press one of the TMP buttons (while the other button is pressed).
- Wait for the removing process to end.
- Successful removing will be confirmed by the Z-Wave controller’s message.
The FGDW002 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.
Available settings: 0 or 3600-64800 (in seconds (1-18h), 3600s (1h) step). Default setting: 21600 seconds (6h)
The Door/Window Sensor will wake up after each defined time interval and always try to connect with the main controller. After a successful communication attempt, the sensor will update configuration parameters, associations and settings and will go into standby mode.
After failed communication attempt (e.g. lack of Z-Wave range) the device will go into standby mode and retry to establish connection with the main controller after the next time interval.
Setting wake up interval to 0 disables sending Wake Up Notification frame automatically. Wake up may be still performed manually by a clicking one of the TMP buttons (while the other button is pressed).
**Resetting the Door/Window Sensor 2: **
Reset procedure allows to restore the device back to its factory settings, which means all information about the Z-Wave controller and user configuration will be deleted. In order to reset the device:
- Open the cover.
- Remove the battery.
- Install the battery while holding both TMP buttons.
- Visual LED indicator will be flashing slowly for 5 seconds - keep holding the buttons.
- Release one button when the LED indicator starts flashing quickly.
- Click released button once to confirm launching of reset procedure.
- Wait a few seconds until a long blink of the LED indicator. Do not remove the battery.
- Visual LED indicator will blink 5 times quickly to confirm the reset.
NOTE
Resetting the device is not the recommended way of removing the device from the Z-Wave network. Use reset procedure only if the primary controller is missing or inoperable. Certain device removal can be achieved by the procedure of removing described in “Adding/removing the device”.
The following table summarises the channels available for the FGDW002 -:
| Channel Name | Channel ID | Channel Type | Category | Item Type |
|---|---|---|---|---|
| Sensor (Temperature) | sensor_temperature | sensor_temperature | Temperature | Number:Temperature |
| Alarm (Tamper) | alarm_tamper | alarm_tamper | Switch | |
| Sensor (Door) | sensor_door | sensor_door | Door | Contact |
| Alarm (Power) | alarm_power | alarm_power | Energy | Switch |
| Alarm (Heat) | alarm_heat | alarm_heat | Fire | 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 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 |
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 a power alarm is triggered.
The alarm_power channel is of type alarm_power and supports the Switch item and is in the Energy 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 |
Indicates if a heat alarm is triggered.
The alarm_heat channel is of type alarm_heat and supports the Switch item and is in the Fire 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 19 configuration parameters available in the FGDW002. Detailed information on each parameter can be found in the sections below.
| Param | Name | Description |
|---|---|---|
| 1 | Door/window state | What state is door/window when the magnet is close to the sensor |
| 2 | Visual LED indications - Open/close | Visual LED indications - Open/close |
| 2 | Visual LED indications - wake up | Visual LED indications - wake up |
| 2 | Visual LED indications - tampering | Visual LED indications - tampering |
| 3 | Associations in Z-Wave network Security Mode | Associations in Z-Wave network Security Mode |
| 11 | 2nd association group triggers | 2nd association group triggers |
| 12 | Value of ON command sent to 2nd association group | Value of ON command frame sent to 2nd association group |
| 13 | Value of OFF command sent to 2nd association group | Value of OFF command frame sent to 2nd association group |
| 14 | Association for opening - time delay | Association for opening - time delay |
| 15 | Association for closing - time delay | Association for closing - time delay |
| 30 | Tamper - alarm cancellation delay | Tamper - alarm cancellation delay |
| 31 | Tamper - reporting alarm cancellation | Tamper - reporting alarm cancellation |
| 50 | Interval of temperature measurements | Interval of temperature measurements |
| 51 | Temperature reports threshold | Temperature reports threshold |
| 52 | Interval of temperature reports | Interval of temperature reports |
| 53 | Temperature offset | Temperature offset |
| 54 | Temperature alarm reports | Temperature alarm reports |
| 55 | High temperature alarm threshold | High temperature alarm threshold |
| 56 | Low temperature alarm threshold | Low temperature alarm threshold |
| 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 |
What state is door/window when the magnet is close to the sensor 0 - closed when magnet near
1 - opened when magnet near The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | closed when magnet near |
| 1 | opened when magnet near |
The manufacturer defined default value is 0 (closed when magnet near).
This parameter has the configuration ID config_1_1 and is of type INTEGER.
Visual LED indications - Open/close
Set or reset the indication of opening/closing status change (input IN) by the visual LED indicator.
Disabling events might extend battery life.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | no indication |
| 1 | open/close indication |
The manufacturer defined default value is 0 (no indication).
This parameter has the configuration ID config_2_1_00000001 and is of type INTEGER.
Visual LED indications - wake up
Show indication of wake up events by the visual LED indicator.
Disabling events might extend battery life.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | no indication |
| 2 | Enable wake up notification |
The manufacturer defined default value is 1.
This parameter has the configuration ID config_2_1_00000002 and is of type INTEGER.
Visual LED indications - tampering
Enable or disable device tampering events indicated by the visual LED indicator.
Disabling events might extend battery life.
The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | no indication |
| 4 | Enable indication of device tampering |
The manufacturer defined default value is 1.
This parameter has the configuration ID config_2_1_00000004 and is of type INTEGER.
Associations in Z-Wave network Security Mode This parameter defines how commands are sent in specified association groups: as secure or non-secure. Parameter is active only in Z-Wave network Security Mode. It does not apply to 1st group "Lifeline". The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | none of the groups sent as secure |
| 1 | 2nd group "On/Off" sent as secure |
| 2 | 3rd group "Tamper" sent as secure |
| 3 | 2nd and 3rd group sent as secure |
The manufacturer defined default value is 3 (2nd and 3rd group sent as secure).
This parameter has the configuration ID config_3_1 and is of type INTEGER.
2nd association group triggers Parameter defines events which result in sending on/off commands to devices added to the 2nd association group.
These commands are sent alternately to switch the devices on and off. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | switch after opening and closing |
| 1 | switch after opening (parameter 12) |
| 2 | switch after closing (parameter 13) |
The manufacturer defined default value is 0 (switch after opening and closing).
This parameter has the configuration ID config_11_1 and is of type INTEGER.
Value of ON command frame sent to 2nd association group Value sent to devices in 2nd association group when opening is detected The value of 0 turns OFF the device, 255 turns it ON. In case of associating devices allowing smooth control, values 1-99 allow to set an associated device to a specified level. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 255.
This parameter has the configuration ID config_12_2 and is of type INTEGER.
Value of OFF command frame sent to 2nd association group Value sent to devices in 2nd association group when closing is detected The value of 0 turns OFF the device, 255 turns it ON. In case of associating devices allowing smooth control, values 1-99 allow to set an associated device to a specified level. Values in the range 0 to 255 may be set.
The manufacturer defined default value is 255.
This parameter has the configuration ID config_13_2 and is of type INTEGER.
Association for opening - time delay Time that must elapse from opening to send the command frame to to devices in 2nd association group. Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_14_2 and is of type INTEGER.
Association for closing - time delay Time (in seconds) that must elapse from closing to send the command frame to devices in 2nd association group Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_15_2 and is of type INTEGER.
Tamper - alarm cancellation delay Time period after which a tamper alarm will be cancelled. Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 5.
This parameter has the configuration ID config_30_2 and is of type INTEGER.
Tamper - reporting alarm cancellation Reporting cancellation of tamper alarm to the controller and 3rd association group. The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | do not send tamper cancellation report |
| 1 | send tamper cancellation report |
The manufacturer defined default value is 0 (do not send tamper cancellation report).
This parameter has the configuration ID config_31_1 and is of type INTEGER.
Interval of temperature measurements This parameter defines how often the temperature will be measured. The shorter the time, the more frequently the temperature will be measured, but the battery life will shorten. Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 300.
This parameter has the configuration ID config_50_2 and is of type INTEGER.
Temperature reports threshold This parameter defines the change of temperature in comparison with last reported, resulting in temperature report being sent to the main controller.
Available settings:
- 0 - temperature reports based on threshold disabled
- 1-300 - temperature threshold (0.1-30°C, 0.1°C step) Values in the range 0 to 300 may be set.
The manufacturer defined default value is 10.
This parameter has the configuration ID config_51_2 and is of type INTEGER.
Interval of temperature reports This parameter determines how often the temperature reports will be sent to the main controller (regardless of parameters 50 and 51).
Available settings:
- 0 - periodic temperature reports disabled
- 300-32400 - time in seconds Values in the range 0 to 32400 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_52_2 and is of type INTEGER.
Temperature offset The value to be added to the actual temperature, measured by the sensor (temperature compensation). Available settings: -1000–1000 (-100–100°C, 0.1°C step) Values in the range -1000 to 1000 may be set.
The manufacturer defined default value is 0.
This parameter has the configuration ID config_53_2 and is of type INTEGER.
Temperature alarm reports Temperature alarms reported to the Z-Wave controller. Thresholds are set in parameters 55 and 56. Available settings: 0 - temperature alarms disabled 1 - high temperature alarm 2 - low temperature alarm 3 - high and low temperature alarms enabled The following option values may be configured -:
| Value | Description |
|---|---|
| 0 | temperature alarms disabled |
| 1 | high temperature alarm |
| 2 | low temperature alarm |
| 3 | high and low temperature alarms enabled |
The manufacturer defined default value is 0 (temperature alarms disabled).
This parameter has the configuration ID config_54_1 and is of type INTEGER.
High temperature alarm threshold If temperature is higher than set value, overheat notification will be sent and high temperature alarm will be triggered (if activated).
Available settings:
- 1-600 (0.1-60°C, 0.1°C step) Values in the range 1 to 600 may be set.
The manufacturer defined default value is 350.
This parameter has the configuration ID config_55_2 and is of type INTEGER.
Low temperature alarm threshold If temperature is lower than the set value, underheat notification will be sent and low temperature alarm will be triggered (if activated). Available settings: 0-599 (0-59.9°C, 0.1°C step) Values in the range 0 to 599 may be set.
The manufacturer defined default value is 100.
This parameter has the configuration ID config_56_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 FGDW002 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. reports the device status and allows for assigning single device only (main controller by default). reports the device status and allows for assigning single device only (main controller by default).
Association group 1 supports 1 node.
is assigned to the device status - Hall effect sensor (sends Basic Set command frames) is assigned to the device status - Hall effect sensor (sends Basic Set command frames).
Association group 2 supports 5 nodes.
is assigned to the TMP switch (sends alarm command frames) is assigned to the TMP switch (sends alarm command frames)
Association group 3 supports 5 nodes.
| Command Class | Comment |
|---|---|
| COMMAND_CLASS_NO_OPERATION_V1 | |
| COMMAND_CLASS_BASIC_V1 | |
| COMMAND_CLASS_APPLICATION_STATUS_V1 | |
| COMMAND_CLASS_SENSOR_BINARY_V1 | Linked to BASIC |
| COMMAND_CLASS_SENSOR_MULTILEVEL_V5 | |
| COMMAND_CLASS_CRC_16_ENCAP_V1 | |
| COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1 | |
| COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1 | |
| COMMAND_CLASS_ZWAVEPLUS_INFO_V1 | |
| COMMAND_CLASS_CONFIGURATION_V1 | |
| COMMAND_CLASS_ALARM_V5 | |
| 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 |
Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.