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.

FGS223 Double Switch 2

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

The device is in the category of Wall Switch, defining Any device attached to the wall that controls a binary status of something, for ex. a light switch.

FGS223 product image

The FGS223 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data from other devices.

Overview

FIBARO Switch 2 is designed to be installed in standard wall switch boxes or anywhere else where it is necessary to control electric devices. FIBARO Switch 2 allows to control connected devices either via the Z-Wave+ network or via a switch connected directly to it and is equipped with active power and energy consumption metering functionality.

Main features of FIBARO Switch 2:

  • Compatible with any Z-Wave or Z-Wave+ Controller,
  • Supports protected mode (Z-Wave network security mode) with
  • AES-128 encryption,
  • Advanced microprocessor control,
  • Active power and energy metering functionality,
  • Works with various types of switches – momentary, toggle, three-way, etc,
  • To be installed in wall switch boxes of dimensions allowing for installation, conforming to provisions of applicable regulations,
  • FIBARO Switch 2 is an extension unit.

Inclusion Information

Put controller into inclusion mode and triple click S1 switch

Exclusion Information

Put controller into exclusion mode and triple click S1 switch

Channels

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

Channel Channel Id Category Item Type
Electric meter (kWh) meter_kwh Energy Number
Electric meter (watts) meter_watts Energy Number
Meter Reset meter_reset Energy Switch
Scene Number scene_number   Number
Alarm alarm_general Door Switch
Send notification notification_send   Number
Switch 1 switch_binary1 Switch Switch
Electric meter (kWh) 1 meter_kwh1 Energy Number
Electric meter (watts) 1 meter_watts1 Energy Number
Switch 2 switch_binary2 Switch Switch
Electric meter (kWh) 2 meter_kwh2 Energy Number
Electric meter (watts) 2 meter_watts2 Energy Number

Electric meter (kWh)

Indicates the energy consumption (kWh).

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

Electric meter (watts)

Indicates the instantaneous power consumption.

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

Meter Reset

Reset the meter.

The meter_reset channel supports the Switch item and is in the Energy category.

Scene Number

Triggers when a scene button is pressed.

The scene_number channel supports the Number item.

Alarm

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

Send notification

Sends a notification.

The notification_send channel supports the Number item.

Switch 1

Switch the power on and off.

The switch_binary1 channel supports the Switch item and is in the Switch category.

Electric meter (kWh) 1

Indicates the energy consumption (kWh).

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

Electric meter (watts) 1

Indicates the instantaneous power consumption.

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

Switch 2

Switch the power on and off.

The switch_binary2 channel supports the Switch item and is in the Switch category.

Electric meter (kWh) 2

Indicates the energy consumption (kWh).

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

Electric meter (watts) 2

Indicates the instantaneous power consumption.

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

Device Configuration

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

Param Name Description
9 Restore state after power failure Restore state after power failure
10 First channel operating mode First channel - operating mode
11 1st ch. reaction to switch First channel - reaction to switch for delay/auto ON/OFF modes
12 time parameter for delay/auto ON/OFF modes First channel - time parameter for delay/auto ON/OFF modes
13 1st ch. pulse time for flashing mode First channel - pulse time for flashing mode
15 2nd ch. operating mode Second channel - operating mode
16 2nd ch. reaction to switch Second channel - reaction to switch for delay/auto ON/OFF modes
17 2nd ch. time parameter for delay Second channel - time parameter for delay/auto ON/OFF modes
18 2nd ch. pulse time for flashing mode Second channel - pulse time for flashing mode
20 Switch type Switch type
21 Flashing mode - reports Flashing mode - reports
27 Associations in Z-Wave network security mode Associations in Z-Wave network security mode
28 S1 switch - scenes sent S1 switch - scenes sent
29 S2 switch - scenes sent S2 switch - scenes sent
30 S1 assocs. sent to 2nd and 3rd group S1 switch - associations sent to 2nd and 3rd association groups
31 S1 ON val sent to 2nd and 3rd groups S1 switch - Switch ON value sent to 2nd and 3rd association groups
32 S1 OFF val sent to 2nd and 3rd groups S1 switch - Switch ON value sent to 2nd and 3rd association groups
33 S1 DblClick val sent to 2nd and 3rd groups S1 switch - Double Click value sent to 2nd and 3rd association groups
35 S2 assocs. sent to 4th and 5th group S2 switch - associations sent to 4th and 5th association groups
36 S2 ON val sent to 4th and 5th groups S2 switch - Switch ON value sent to 4th and 5th association groups
36 S2 ON val sent to 4th and 5th groups S2 switch - Switch ON value sent to 4th and 5th association groups
37 S2 OFF val sent to 4th and 5th groups S2 switch - Switch OFF value sent to 4th and 5th association groups
38 S2 DblClick val sent to 4th and 5th groups  
40 Reaction to General Alarm Reaction to General Alarm
41 Reaction to Flood Alarm Reaction to Flood Alarm
42 Reaction to CO/CO2/Smoke Alarm Reaction to CO/CO2/Smoke Alarm
43 Reaction to Heat Alarm Reaction to Heat Alarm
44 Flashing alarm duration Flashing alarm duration
50 First channel - power reports First channel - power reports
51 1st ch min time between reports First channel - minimal time between power reports
53 1st ch energy reports First channel - energy reports
54 Second channel - power reports Second channel - power reports
55 2nd ch min time between reports Second channel - minimal time between power reports
57 2nd ch energy reports Second channel - energy reports
58 Periodic power reports Periodic power reports
59 Periodic energy reports Periodic energy reports
60 Include own energy Measuring energy consumed by the device itself

Parameter 9: Restore state after power failure

Restore state after power failure This parameter determines if the device will return to state prior to the power failure after power is restored. The following option values may be configured -:

Value Description
0 off after power loss
1 restore last state

The manufacturer defined default value is 1 (restore last state).

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

Parameter 10: First channel operating mode

First channel - operating mode This parameter allows to choose operating for the 1st channel controlled by the S1 switch. The following option values may be configured -:

Value Description
0 standard operation
1 delay ON
2 delay OFF
3 auto ON
4 auto OFF
5 flashing mode

The manufacturer defined default value is 0 (standard operation).

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

Parameter 11: 1st ch. reaction to switch

First channel - reaction to switch for delay/auto ON/OFF modes This parameter determines how the device in timed mode reacts to pushing the switch connected to the S1 terminal. The following option values may be configured -:

Value Description
0 cancel mode and set target state
1 no reaction to switch - mode runs until it ends
2 reset timer - start counting from the beginning

The manufacturer defined default value is 0 (cancel mode and set target state).

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

Parameter 12: time parameter for delay/auto ON/OFF modes

First channel - time parameter for delay/auto ON/OFF modes This parameter allows to set time parameter used in timed modes.

Available settings: 0 (0.1s), 1-32000 (1-32000s, 1s step) - time parameter

Default setting: 50 (50s) Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 50.

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

Parameter 13: 1st ch. pulse time for flashing mode

First channel - pulse time for flashing mode This parameter allows to set time of switching to opposite state in flashing mode

Available settings: 1-32000 (0.1-3200.0s, 0.1s step) - time parameter

Default setting: 5 (0.5s) Values in the range 1 to 32000 may be set.

The manufacturer defined default value is 5.

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

Parameter 15: 2nd ch. operating mode

Second channel - operating mode This parameter allows to choose operating for the 1st channel controlled by the S2 switch. The following option values may be configured -:

Value Description
0 standard operation
1 delay ON
2 delay OFF
3 auto ON
4 auto OFF
5 flashing mode

The manufacturer defined default value is 0 (standard operation).

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

Parameter 16: 2nd ch. reaction to switch

Second channel - reaction to switch for delay/auto ON/OFF modes

The following option values may be configured -:

Value Description
0 cancel mode and set target state
1 no reaction to switch - mode runs until it ends
2 reset timer - start counting from the beginning

The manufacturer defined default value is 0 (cancel mode and set target state).

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

Parameter 17: 2nd ch. time parameter for delay

Second channel - time parameter for delay/auto ON/OFF modes This parameter allows to set time parameter used in timed modes.

Available settings: 0 (0.1s), 1-32000 (1-32000s, 1s step) - time parameter

Default setting: 50 (50s) Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 50.

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

Parameter 18: 2nd ch. pulse time for flashing mode

Second channel - pulse time for flashing mode This parameter allows to set time of switching to opposite state in flashing mode

Available settings: 1-32000 (0.1-3200.0s, 0.1s step) - time parameter

Default setting: 5 (0.5s) Values in the range 1 to 32000 may be set.

The manufacturer defined default value is 5.

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

Parameter 20: Switch type

Switch type This parameter defines as what type the device should treat the switch connected to the S1 and S2 terminals The following option values may be configured -:

Value Description
0 momentary switch
1 toggle switch stable
2 toggle switch

The manufacturer defined default value is 2 (toggle switch).

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

Parameter 21: Flashing mode - reports

Flashing mode - reports

The following option values may be configured -:

Value Description
0 the device does not send reports
1 the device sends reports

The manufacturer defined default value is 0 (the device does not send reports).

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

Parameter 27: 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. This parameter does not apply to 1st „Lifeline” group. The following option values may be configured -:

Value Description
0 no group sent as secure
1 2nd group sent as secure
2 3rd group sent as secure
4 4th group sent as secure
8 5th group sent as secure
15 all groups sent as secure

The manufacturer defined default value is 15 (all groups sent as secure).

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

Parameter 28: S1 switch - scenes sent

S1 switch - scenes sent This parameter determines which actions result in sending scene IDs assigned to them The following option values may be configured, in addition to values in the range 0 to 15 -:

Value Description
0 no scenes sent
1 Key pressed 1 time
2 Key pressed 2 times
4 Key pressed 3 times
8 Key Hold Down and Key Released

The manufacturer defined default value is 0 (no scenes sent).

This parameter has the configuration ID config_28_1 and is of type INTEGER. This is a read only parameter.

Parameter 29: S2 switch - scenes sent

S2 switch - scenes sent This parameter determines which actions result in sending scene IDs assigned to them. The following option values may be configured, in addition to values in the range 0 to 15 -:

Value Description
0 no scenes sent
1 Key pressed 1 time
2 Key pressed 2 times
4 Key pressed 3 times
8 Key Hold Down and Key Released

The manufacturer defined default value is 0 (no scenes sent).

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

Parameter 30: S1 assocs. sent to 2nd and 3rd group

S1 switch - associations sent to 2nd and 3rd association groups This parameter determines which actions are ignored when sending commands to devices associated in 2nd and 3rd association group. All actions are active by default. The following option values may be configured, in addition to values in the range 0 to 15 -:

Value Description
0 All actions are active by default
1 ignore turning ON with 1 click of the switch
2 ignore turning OFF with 1 click of the switch
4 ignore holding and releasing the switch
8 ignore double click of the switch

The manufacturer defined default value is 0 (All actions are active by default).

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

Parameter 31: S1 ON val sent to 2nd and 3rd groups

S1 switch - Switch ON value sent to 2nd and 3rd association groups

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 255.

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

Parameter 32: S1 OFF val sent to 2nd and 3rd groups

S1 switch - Switch ON value sent to 2nd and 3rd association groups This parameter defines value sent with Switch OFF command to devices associated in 2nd and 3rd association group. Values in the range 0 to 255 may be set.

The manufacturer defined default value is 0.

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

Parameter 33: S1 DblClick val sent to 2nd and 3rd groups

S1 switch - Double Click value sent to 2nd and 3rd association groups This parameter defines value sent with Double Click command to devices associated in 2nd and 3rd association group. Values in the range 0 to 255 may be set.

The manufacturer defined default value is 99.

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

Parameter 35: S2 assocs. sent to 4th and 5th group

S2 switch - associations sent to 4th and 5th association groups This parameter determines which actions result in sending commands to devices associated in 4th and 5th association group. All actions are active by default. The following option values may be configured, in addition to values in the range 0 to 15 -:

Value Description
0 All actions are active by default
1 ignore turning on with 1 click of the switch
2 ignore turning off with 1 click of the switch
4 ignore holding and releasing the switch
8 ignore double click of the switch

The manufacturer defined default value is 0 (All actions are active by default).

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

Parameter 36: S2 ON val sent to 4th and 5th groups

S2 switch - Switch ON value sent to 4th and 5th association groups

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 255.

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

Parameter 36: S2 ON val sent to 4th and 5th groups

S2 switch - Switch ON value sent to 4th and 5th association groups

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 255.

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

Parameter 37: S2 OFF val sent to 4th and 5th groups

S2 switch - Switch OFF value sent to 4th and 5th association groups

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 0.

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

Parameter 38: S2 DblClick val sent to 4th and 5th groups

Values in the range 0 to 255 may be set.

The manufacturer defined default value is 99.

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

Parameter 40: Reaction to General Alarm

Reaction to General Alarm This parameter determines how the device will react to General Alarm frame. The following option values may be configured -:

Value Description
0 alarm frame is ignored
1 turn ON after receiving the alarm frame
2 turn OFF after receiving the alarm frame
3 flash after receiving the alarm frame

The manufacturer defined default value is 3 (flash after receiving the alarm frame).

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

Parameter 41: Reaction to Flood Alarm

Reaction to Flood Alarm

The following option values may be configured -:

Value Description
0 alarm frame is ignored
1 turn ON after receiving the alarm frame
2 turn OFF after receiving the alarm frame
3 flash after receiving the alarm frame

The manufacturer defined default value is 2 (turn OFF after receiving the alarm frame).

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

Parameter 42: Reaction to CO/CO2/Smoke Alarm

Reaction to CO/CO2/Smoke Alarm

The following option values may be configured -:

Value Description
0 alarm frame is ignored
1 turn ON after receiving the alarm frame
2 turn OFF after receiving the alarm frame
3 flash after receiving the alarm frame

The manufacturer defined default value is 3 (flash after receiving the alarm frame).

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

Parameter 43: Reaction to Heat Alarm

Reaction to Heat Alarm

The following option values may be configured -:

Value Description
0 alarm frame is ignored
1 turn ON after receiving the alarm frame
2 turn OFF after receiving the alarm frame
3 flash after receiving the alarm frame

The manufacturer defined default value is 1 (turn ON after receiving the alarm frame).

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

Parameter 44: Flashing alarm duration

Flashing alarm duration This parameter allows to set duration of flashing alarm mode.

Available settings: 1-32000 (1-32000s, 1s step) - duration

Default setting: 600 (10min) Values in the range 1 to 32000 may be set.

The manufacturer defined default value is 600.

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

Parameter 50: First channel - power reports

First channel - power reports This parameter determines the minimum change in consumed power that will result in sending new power report to the main controller.

Available settings:

  • 0 - reports are disabled
  • 1-100 (1-100%) - change in power Values in the range 0 to 100 may be set.

The manufacturer defined default value is 20.

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

Parameter 51: 1st ch min time between reports

First channel - minimal time between power reports This parameter determines minimum time that has to elapse before sending new power report to the main controller.

Available settings:

0 - reports are disabled

1-120 (1-120s) - report interval

Default setting: 10 (10s) Values in the range 0 to 120 may be set.

The manufacturer defined default value is 10.

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

Parameter 53: 1st ch energy reports

First channel - energy reports This parameter determines minimum time that has to elapse before

sending new power report to the main controller.

Available settings:

0 - reports are disabled

1-32000 (0.01 - 320 kWh) - change in energy

Default: 100 (1 KWh) Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 100.

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

Parameter 54: Second channel - power reports

Second channel - power reports This parameter determines the minimum change in consumed power that will result in sending new power report to the main controller.

Available settings:

  • 0 - reports are disabled
  • 1-100 (1-100%) - change in power Values in the range 0 to 100 may be set.

The manufacturer defined default value is 20.

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

Parameter 55: 2nd ch min time between reports

Second channel - minimal time between power reports This parameter determines minimum time that has to elapse before sending new power report to the main controller.

Available settings:

0 - periodic reports are disabled

1-120 (1-120s) - report interval

Default setting: 10 (10s) Values in the range 0 to 120 may be set.

The manufacturer defined default value is 10.

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

Parameter 57: 2nd ch energy reports

Second channel - energy reports This parameter determines the minimum change in consumed energy that will result in sending new energy report to the main controller.

Available settings:

0 - reports are disabled

1-32000 (0.01 - 320 kWh) - change in energy

Default setting: 100 (1 KWh) Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 100.

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

Parameter 58: Periodic power reports

Periodic power reports This parameter determines in what time interval the periodic power reports are sent to the main controller.

Available settings:

0 - periodic reports are disabled

1-32000 (1-32000s) - report interval

Default setting: 3600 (1h) Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 3600.

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

Parameter 59: Periodic energy reports

Periodic energy reports This parameter determines in what time interval the periodic energy reports are sent to the main controller.

Available settings:

0 - periodic reports are disabled

1-32000 (1-32000s) - report interval

Default setting: 3600 (1h) Values in the range 0 to 32000 may be set.

The manufacturer defined default value is 3600.

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

Parameter 60: Include own energy

Measuring energy consumed by the device itself This parameter determines whether energy metering should include the amount of energy consumed by the device itself. Results are being added to energy reports for first endpoint. The following option values may be configured -:

Value Description
0 function inactive
1 function active

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

This parameter has the configuration ID config_60_1 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 FGS223 supports 5 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 (S1)

On/Off (S1) is assigned to switch connected to the S1 terminal (uses Basic command class) This group supports 5 nodes.

Group 3: Dimmer (S1)

“Dimmer (S1)” is assigned to switch connected to the S1 terminal (uses Switch Multilevel command class) This group supports 5 nodes.

Group 4: On/Off (S2)

On/Off (S2) is assigned to switch connected to the S2 terminal (uses Basic command class) This group supports 5 nodes.

Group 5: Dimmer (S2)

Dimmer (S2) is assigned to switch connected to the S2 terminal (uses Switch Multilevel command class) 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_SWITCH_BINARY_V1| Linked to BASIC| | COMMAND_CLASS_METER_V3| | | COMMAND_CLASS_CRC_16_ENCAP_V1| | | COMMAND_CLASS_CENTRAL_SCENE_V1| | | COMMAND_CLASS_MULTI_CHANNEL_V2| | | COMMAND_CLASS_CONFIGURATION_V1| | | COMMAND_CLASS_ALARM_V1| | | COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1| | | COMMAND_CLASS_ASSOCIATION_V1| | | COMMAND_CLASS_VERSION_V1| |

Endpoint 1

| Command Class | Comment | |—————|———| | COMMAND_CLASS_BASIC_V0| | | COMMAND_CLASS_SWITCH_BINARY_V1| Linked to BASIC| | COMMAND_CLASS_METER_V3| | | COMMAND_CLASS_ASSOCIATION_V1| | | COMMAND_CLASS_VERSION_V1| |

Endpoint 2

Command Class Comment
COMMAND_CLASS_BASIC_V0  
COMMAND_CLASS_SWITCH_BINARY_V1 Linked to BASIC
COMMAND_CLASS_METER_V3  
COMMAND_CLASS_ASSOCIATION_V1  
COMMAND_CLASS_VERSION_V1  

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