Skip to content

Latest commit

 

History

History
452 lines (265 loc) · 18.3 KB

fgss001_0_0.md

File metadata and controls

452 lines (265 loc) · 18.3 KB
layout title
documentation
FGSS001 - ZWave

{% include base.html %}

FGSS001 Smoke Sensor

This describes the Z-Wave device FGSS001, manufactured by Fibargroup with the thing type UID of fibaro_fgss001_00_000.

The device is in the category of Smoke Detector, defining Smoke detectors.

FGSS001 product image

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

Overview

Wakeup Information

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

Channels

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

Channel Channel Id Category Item Type
Sensor (temperature) sensor_temperature Temperature Number:Temperature
Battery Level battery-level Battery Number
Clock Time Offset time_offset Temperature Number
Alarm (smoke) alarm_smoke Smoke Switch
Alarm (general) alarm_general Door Switch
Alarm (heat) alarm_heat Switch

Sensor (temperature)

Indicates the current temperature.

The sensor_temperature channel supports the Number:Temperature item and is in the Temperature category.

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.

Clock Time Offset

Provides the current time difference for the devices time.

The time_offset channel supports the Number item and is in the Temperature category.

Alarm (smoke)

Indicates if a smoke is triggered.

The alarm_smoke channel supports the Switch item and is in the Smoke 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

Alarm (general)

Indicates if an alarm is triggered.

The alarm_general 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

Alarm (heat)

Indicates if a heat alarm is triggered.

The alarm_heat 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

Device Configuration

The following table provides a summary of the 18 configuration parameters available in the FGSS001. Detailed information on each parameter can be found in the sections below.

Param Name Description
1 Alarm Cancellation Delay Additional delay after an alarm has ceased. The parameter allows you to specify additional time, after which the alarm is cancelled once its violation has ceased.
2 Acoustic and visual signals On / Off in case of alarm parameter allows for LED indicator and acoustic alarm deactivation in case of smoke detection
5 Type of alarm frame sent to 1-st association group (SMOKE) parameter determines a type of command frame sent by the Sensor in case smoke detection has been detected or cancelled
7 Forced Level of Dimming group 1 Value of the parameter specifying the forced level of dimming / opening sun blinds when comes 'switch on' / 'open' command to devices from association group no. 1.
In the case of alarm frames the alarm priority is specified. Possible parameter setti
10 Interval between successive readings of temperature sensors Interval between successive readings of temperature from all sensors connected to the device in seconds. Note: taking temperature readings from the sensor does not result in sending a temperature condition report to the central hub.
12 Insensitiveness to temperature changes.
13 Transmitting the alarm or control frame broadcast mode Transmitting the alarm or control frame in 'broadcast' mode (i.e. to all devices within range), information sent in this mode is not repeated by the mesh network.
NOTE: If the broadcast mode of information transmission is activated for a given
73 Temperature measurement compensation Temperature value to be added to or deducted from the current measured temperature
-1000 0,1°C - 1000 0,1°C
80 Z-Wave range test interval Time period between the consecutive Z-Wave network range tests.
0 10min[10min-24h] - 17 10min[10min-24h] -> 0 – Z-Wave network range test inactive
81 Temperature alarm threshold 0 -> 0 – temperature alarm inactive
2 °C - 100 °C -> Temperature
82 Smoke Sensor sensitivity There are 3 levels of sensitivity to smoke presence. Level 1 means the highest sensitivity.
83 Black Box sensitivity level Parameter specifies temperature and smoke level after which the Black Box starts recording them.
84 Malfunction alarm Time interval in which malfuntion alarm, if detected, is repeated using visual and acoustic alarms.
-126 100ms[100ms-25,5s] - 127 100ms[100ms-25,5s]
85 Temperature alarm Time interval in which temperature alarm, if detected, is repeated using visual and acoustic alarms.
-126 100ms[100ms-25,5s] - 127 100ms[100ms-25,5s] -> 5 means 500ms
86 Lack of the Z-Wave range alarm Time interval in which lack of the Z-Wave network alarm, if detected, is repeated using visual and acoustic alarms.
1 5s [5s-24h] - 17280 5s [5s-24h] -> 360 means 30min
87 Low battery alarm Time interval in which low battery alarm, if detected, is repeated using visual and acoustic alarms.
1 5s [5s-24h] - 17280 5s [5s-24h] -> 360 means 30min
88 Temperature measurement compensation for report Consider temperature measurement compensation (parameter 73) when sending temperature report.
89 Tamper alarm Activates/inactivates temper switch alarm
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: Alarm Cancellation Delay

Additional delay after an alarm has ceased. The parameter allows you to specify additional time, after which the alarm is cancelled once its violation has ceased.

Values in the range 0 to 3600 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_1_2 and is of type INTEGER.

Parameter 2: Acoustic and visual signals On / Off in case of alarm

parameter allows for LED indicator and acoustic alarm deactivation in case of smoke detection

The following option values may be configured -:

Value Description
0 acoustic and visual alarms inactive
1 acoustic alarm inactive, visual alarm active
2 acoustic alarm active, visual alarm inactive
3 acoustic and visual alarms active

The manufacturer defined default value is 3 (acoustic and visual alarms active).

This parameter has the configuration ID config_2_1 and is of type INTEGER.

Parameter 5: Type of alarm frame sent to 1-st association group (SMOKE)

parameter determines a type of command frame sent by the Sensor in case smoke detection has been detected or cancelled

The following option values may be configured -:

Value Description
0 ALARM SENSOR (SMOKE)
255 BASIC_SET

The manufacturer defined default value is 255 (BASIC_SET).

This parameter has the configuration ID config_5_1 and is of type INTEGER.

Parameter 7: Forced Level of Dimming group 1

Value of the parameter specifying the forced level of dimming / opening sun blinds when comes 'switch on' / 'open' command to devices from association group no. 1.
In the case of alarm frames the alarm priority is specified. Possible parameter setti

Values in the range 1 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.

Parameter 10: Interval between successive readings of temperature sensors

Interval between successive readings of temperature from all sensors connected to the device in seconds. Note: taking temperature readings from the sensor does not result in sending a temperature condition report to the central hub.

Values in the range 1 to 32767 may be set.

The manufacturer defined default value is 300.

This parameter has the configuration ID config_10_2 and is of type INTEGER.

Parameter 12: Insensitiveness to temperature changes.

Values in the range 0 to 100 may be set.

The manufacturer defined default value is 20.

This parameter has the configuration ID config_12_1 and is of type INTEGER.

Parameter 13: Transmitting the alarm or control frame broadcast mode

Transmitting the alarm or control frame in 'broadcast' mode (i.e. to all devices within range), information sent in this mode is not repeated by the mesh network.
NOTE: If the broadcast mode of information transmission is activated for a given

The following option values may be configured -:

Value Description
0 Broadcast inactive
1 Smoke broadcast mode active, Tamper broadcast mode inactive
2 Smoke broadcast mode inactive, Tamper broadcast mode active
3 Smoke and Tamper broadcast mode active

The manufacturer defined default value is 0 (Broadcast inactive).

This parameter has the configuration ID config_13_1 and is of type INTEGER.

Parameter 73: Temperature measurement compensation

Temperature value to be added to or deducted from the current measured temperature
-1000 0,1°C - 1000 0,1°C

Values in the range -1000 to 1000 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_73_2 and is of type INTEGER.

Parameter 80: Z-Wave range test interval

Time period between the consecutive Z-Wave network range tests.
0 10min[10min-24h] - 17 10min[10min-24h] -> 0 – Z-Wave network range test inactive

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_80_1 and is of type INTEGER.

Parameter 81: Temperature alarm threshold

0 -> 0 – temperature alarm inactive
2 °C - 100 °C -> Temperature

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 54.

This parameter has the configuration ID config_81_1 and is of type INTEGER.

Parameter 82: Smoke Sensor sensitivity

There are 3 levels of sensitivity to smoke presence. Level 1 means the highest sensitivity.

The following option values may be configured -:

Value Description
1 High
2 Medium
3 Low

The manufacturer defined default value is 2 (Medium).

This parameter has the configuration ID config_82_1 and is of type INTEGER.

Parameter 83: Black Box sensitivity level

Parameter specifies temperature and smoke level after which the Black Box starts recording them.

The following option values may be configured -:

Value Description
1 High
2 Medium
3 Low

The manufacturer defined default value is 0.

This parameter has the configuration ID config_83_1 and is of type INTEGER.

Parameter 84: Malfunction alarm

Time interval in which malfuntion alarm, if detected, is repeated using visual and acoustic alarms.
-126 100ms[100ms-25,5s] - 127 100ms[100ms-25,5s]

Values in the range -126 to 127 may be set.

The manufacturer defined default value is 10.

This parameter has the configuration ID config_84_1 and is of type INTEGER.

Parameter 85: Temperature alarm

Time interval in which temperature alarm, if detected, is repeated using visual and acoustic alarms.
-126 100ms[100ms-25,5s] - 127 100ms[100ms-25,5s] -> 5 means 500ms

Values in the range -126 to 127 may be set.

The manufacturer defined default value is 5.

This parameter has the configuration ID config_85_1 and is of type INTEGER.

Parameter 86: Lack of the Z-Wave range alarm

Time interval in which lack of the Z-Wave network alarm, if detected, is repeated using visual and acoustic alarms.
1 5s [5s-24h] - 17280 5s [5s-24h] -> 360 means 30min

Values in the range 1 to 17280 may be set.

The manufacturer defined default value is 360.

This parameter has the configuration ID config_86_2 and is of type INTEGER.

Parameter 87: Low battery alarm

Time interval in which low battery alarm, if detected, is repeated using visual and acoustic alarms.
1 5s [5s-24h] - 17280 5s [5s-24h] -> 360 means 30min

Values in the range 1 to 17280 may be set.

The manufacturer defined default value is 360.

This parameter has the configuration ID config_87_2 and is of type INTEGER.

Parameter 88: Temperature measurement compensation for report

Consider temperature measurement compensation (parameter 73) when sending temperature report.

The following option values may be configured -:

Value Description
0 Ignore temperature compensation
1 Include temperature compensation

The manufacturer defined default value is 0 (Ignore temperature compensation).

This parameter has the configuration ID config_88_1 and is of type INTEGER.

Parameter 89: Tamper alarm

Activates/inactivates temper switch alarm

The following option values may be configured -:

Value Description
0 Tamper alarm inactive
1 Tamper alarm active, with cancellation option available
2 Tamper alarm active, without cancellation option

The manufacturer defined default value is 1 (Tamper alarm active, with cancellation option available).

This parameter has the configuration ID config_89_1 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 FGSS001 supports 3 association groups.

Group 1: Fire Status

Association group 1 supports 5 nodes.

Group 2: TMP Button

Association group 2 supports 5 nodes.

Group 3: Device Status

Association group 3 supports 1 node.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SENSOR_MULTILEVEL_V1
COMMAND_CLASS_CRC_16_ENCAP_V1
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_BATTERY_V1
COMMAND_CLASS_WAKE_UP_V1
COMMAND_CLASS_ASSOCIATION_V1
COMMAND_CLASS_VERSION_V1
COMMAND_CLASS_TIME_PARAMETERS_V1
COMMAND_CLASS_SENSOR_ALARM_V1

Documentation Links


Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.