The openHAB Documentation Has Moved

The documentation has moved to openhab.org/docs and openhab.org/addons.

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

FGDW002 Fibaro Door Window Sensor 2

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.

FGDW002 product image

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

Overview

Wakeup Information

Available settings: 0 or 3600-64800 (in seconds (1-18h), 3600s (1h)
step)
Default setting: 21600 (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).

Longer time interval means less frequent communication and thus a longer battery life.

Channels

The following table summarises the channels available for the FGDW002 -:

Channel Channel Id Category Item Type
Sensor (temperature) sensor_temperature Temperature Number
Tamper alarm alarm_tamper   Switch
Door sensor sensor_door Door Contact
Alarm (power) alarm_power Door Switch
Battery Level battery-level Battery Number

Sensor (temperature)

Indicates the current temperature.

The sensor_temperature channel supports the Number item and is in the Temperature category. This is a read only channel so will only be updated following state changes from the device.

Tamper alarm

Indicates if the tamper alarm is triggered.

The alarm_tamper channel 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

Door sensor

Indicates if the door/window is open or closed.

The sensor_door channel 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

Alarm (power)

Indicates if a power alarm is triggered.

The alarm_power channel supports the Switch 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 Switch item type -:

Value Label
OFF Ok
ON Alarm

Battery Level

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 battery-level channel supports the Number item and is in the Battery category.

Device Configuration

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 frame sent to 2nd association group Value of ON command frame sent to 2nd association group
13 Value of OFF command frame 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

Parameter 1: Door/window state

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.

Parameter 2: Visual LED indications - Open/close

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.

Parameter 2: Visual LED indications - wake up

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.

Parameter 2: Visual LED indications - tampering

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.

Parameter 3: Associations in Z-Wave network Security Mode

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.

Parameter 11: 2nd association group triggers

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.

Parameter 12: Value of ON command frame sent to 2nd association group

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.

Parameter 13: Value of OFF command frame sent to 2nd association group

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.

Parameter 14: Association for opening - time delay

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.

Parameter 15: Association for closing - time delay

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.

Parameter 30: Tamper - alarm cancellation delay

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.

Parameter 31: Tamper - reporting alarm cancellation

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.

Parameter 50: Interval of temperature measurements

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.

Parameter 51: Temperature reports threshold

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.

Parameter 52: Interval of temperature reports

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.

Parameter 53: Temperature offset

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.

Parameter 54: Temperature alarm reports

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.

Parameter 55: High temperature alarm threshold

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.

Parameter 56: Low temperature alarm threshold

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.

Wakeup Interval

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.

Wakeup Node

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

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.

Group 1: Lifeline

reports the device status and allows for assigning single device only (main controller by default). This group supports 1 nodes.

Group 2: On/Off

is assigned to the device status - Hall effect sensor (sends Basic Set command frames) This group supports 5 nodes.

Group 3: Tamper

is assigned to the TMP switch (sends alarm command frames) This group supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1  
COMMAND_CLASS_BASIC_V1  
COMMAND_CLASS_APPLICATION_STATUS_V1  
COMMAND_CLASS_SENSOR_BINARY_V0 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.