Skip to content

Latest commit

 

History

History
executable file
·
528 lines (335 loc) · 19.6 KB

fgrgbw_0_0.md

File metadata and controls

executable file
·
528 lines (335 loc) · 19.6 KB
layout title
documentation
FGRGBW - ZWave

{% include base.html %}

FGRGBW RGBW Controller

This describes the Z-Wave device FGRGBW, manufactured by Fibargroup with the thing type UID of fibaro_fgrgbw_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.

FGRGBW product image

The FGRGBW 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 between other devices in the mesh network.

Overview

Fibaro RGBW Controller is a universal, Z-Wave compatible RGB / RGBW controller. Fibaro RGBW Controller uses PWM output signal, which enables it to control LED, RGB, RGBW strips, halogen lights and fans. Controlled devices may be powered by 12 or 24 VDC. In addition the device supports up to four, 0V - 10V analog sensors, such as temperature sensors, humidity sensors, wind sensors, air quality sensors, light sensors etc. All IN and OUT terminals may be user configured for LED control or 0V-10V signal readouts.

Inclusion Information

Triple click the B-button or any switch connected to I1-I4 inputs

Exclusion Information

Triple click the B-button or any switch connected to I1-I4 inputs

General Usage Information

**Warning!

**

  1. Fibaro RGBW Controller is dedicated to operate in low voltage circuits of 12VDC or 24VDC. Connecting higher voltage load may result in Fibaro RGBW Controller damage.
  2. Fibaro RGBW Controller must be powered by the same voltage as the connected light source. I.e. if controlling 12V LED strip, the module must be connected to 12V power supply. Similarly, if controlling 24V RGBW strip, Fibaro RGBW Controller must be powered by 24V voltage supply.
  3. Fibaro RGBW Controller has 0-10V input. There is no 0-10V output. Output is controlled by PWM at 244Hz.
  4. Fibaro RGBW Controller must be powered by 12VDC or 24 VDC stabilized power supply with outputs load capacity matched to loads voltage.
  5. Sensors using 0-10V interface use wire connection to inputs I1 - I4. Maximum length of 0-10V connection line is 10 m. Observe sensor's manufacturer recommendations towards 0-10V line diameter.
  6. In case of connecting long RGBW/RGB/LED strips voltage drops may occur, resulting in lower light brightness further from R/G/B/W outputs. To eliminate this effect it's recommended to connect few shorter strips in serial connection instead of one long strip connected parallel. Maximum recommended wire length, used to connect R/G/B/W outputs with a RGBW/RGB/LED strip is 10 m. Observe connected loads manufacturer recommendations towards connection wire diameter.

Channels

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

Channel Name Channel ID Channel Type Category Item Type
Dimmer switch_dimmer switch_dimmer DimmableLight Dimmer
Sensor (power) sensor_power sensor_power Energy Number
Electric meter (watts) meter_watts meter_watts Energy Number
Electric meter (kWh) meter_kwh meter_kwh Energy Number
Color color_color color_color ColorLight Color
Start animation scene_number scene_number Number
Red switch_dimmer2 switch_dimmer DimmableLight Dimmer
Green switch_dimmer3 switch_dimmer DimmableLight Dimmer
Blue switch_dimmer4 switch_dimmer DimmableLight Dimmer
White switch_dimmer5 switch_dimmer DimmableLight Dimmer

Dimmer

The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.

The switch_dimmer channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.

Sensor (power)

Indicates the energy consumption (kWh).

The sensor_power channel is of type sensor_power and 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 is of type meter_watts and 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 (kWh)

Indicates the energy consumption (kWh).

The meter_kwh channel is of type meter_kwh and 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.

Color

The color channel allows to control the color of a light. It is also possible to dim values and switch the light on and off.

The color_color channel is of type color_color and supports the Color item and is in the ColorLight category.

Start animation

Triggers when a scene button is pressed.

The scene_number channel is of type scene_number and supports the Number item.

Red

The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.

The switch_dimmer2 channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.

Green

The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.

The switch_dimmer3 channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.

Blue

The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.

The switch_dimmer4 channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.

White

The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off.

The switch_dimmer5 channel is of type switch_dimmer and supports the Dimmer item and is in the DimmableLight category.

Device Configuration

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

Param Name Description
1 ALL ON / ALL OFF function activation Activation/deactivation of ALL ON/ALL OFF functions.
6 Associations command class choice Associations command class choice
8 Outputs state change mode MODE1, Example: change saturation level from 0% to 99%
9 Step value (for MODE1) Step value (relevant for MODE1)
10 Time between steps (relevant for MODE1) Time between steps (relevant for MODE1).
11 Time for changing from start to end value Step value (relevant for MODE1).
12 Maximum Brightening level Maximum Brightening level.
13 Minimum dim level Minimum dim level.
14 Inputs/Outputs configuration Relevant for main controllers other than Home Center 2 only
16 Remember device status after power failure Define how will the Plug react after the power supply is back on.
30 Alarm response Alarm response
38 Alarm sequence program Alarm sequence program.
39 Active PROGRAM alarm time Active PROGRAM alarm time.
42 Command class reporting Outputs status change Command class reporting Outputs status change.
43 Reporting 0-10v analog inputs change threshold Defines which input voltage must change to be reported
44 Power load reporting frequency Parameter defines Time between reports.
45 Reporting energy consumption changes Reporting energy consumption changes
71 Response to BRIGHTNESS set to 0% Response to BRIGHTNESS set to 0%.
72 Starting animation program Starting predefined program when device set to work in RGB/RGBW mode
73 Triple click action Triple click action, default setting: 0
Switch All Mode Set the mode for the switch when receiving SWITCH ALL commands

Parameter 1: ALL ON / ALL OFF function activation

Activation/deactivation of ALL ON/ALL OFF functions. By default, ALL ON active ALL OFF active. The following option values may be configured -:

Value Description
-1 ALL ON active ALL OFF active
0 ALL ON inactive ALL OFF inactive
1 ALL ON inactive ALL OFF active
2 ALL ON active ALL OFF inactive

The manufacturer defined default value is 255.

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

Parameter 6: Associations command class choice

Associations command class choice Associations command class choice.

By default, Normal (Dimmer) - BASIC_SET/SWITCH_MULTILEVEL_START/STOP The following option values may be configured -:

Value Description
0 Normal (Dimmer)
1 Normal (RGBW)
2 Normal (RGBW) - COLOR_CONTROL_SET
3 Brightness
4 Rainbow (RGBW)

The manufacturer defined default value is 0 (Normal (Dimmer)).

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

Parameter 8: Outputs state change mode

MODE1, Example: change saturation level from 0% to 99% Parameter 9: Step = 5, Parameter 10: Time between steps: 10ms, Default setting: MODE1 The following option values may be configured -:

Value Description
0 MODE1
1 MODE2

The manufacturer defined default value is 0 (MODE1).

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

Parameter 9: Step value (for MODE1)

Step value (relevant for MODE1)

Values in the range 1 to 255 may be set.

The manufacturer defined default value is 1.

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

Parameter 10: Time between steps (relevant for MODE1)

Time between steps (relevant for MODE1). Default setting: 10 ms  0 - immediate change of state, available settings: 1 - 60000 ms. Values in the range 0 to 60000 may be set.

The manufacturer defined default value is 10.

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

Parameter 11: Time for changing from start to end value

Step value (relevant for MODE1).

  • Default setting: 67 (3s)
  • 0: immediate change
  • 1-63: 20-126 [ms] value*20ms
  • 65-127: 1-63 [s] (value-64)*1s
  • 129-191: 10-630 [s] (value-128)*10s Values in the range 0 to 255 may be set.

The manufacturer defined default value is 67.

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

Parameter 12: Maximum Brightening level

Maximum Brightening level. Default setting: 255, available settings: 3 - 255. Values in the range 3 to 255 may be set.

The manufacturer defined default value is 255.

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

Parameter 13: Minimum dim level

Minimum dim level. Default setting: 2, available settings: 3 - 255. Values in the range 2 to 255 may be set.

The manufacturer defined default value is 2.

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

Parameter 14: Inputs/Outputs configuration

Relevant for main controllers other than Home Center 2 only Inputs/Outputs configuration - relevant for main controllers other than Home Center 2 only.
Default setting: 4369, Controlled device: RGBW, toggle switch inputs (NORMAL MODE). Values in the range 0 to 65535 may be set.

The manufacturer defined default value is 4369.

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

Parameter 16: Remember device status after power failure

Define how will the Plug react after the power supply is back on. Define how will the Plug react after the power supply is back on. The following option values may be configured -:

Value Description
0 Do not remember state
1 Remember state before power failure

The manufacturer defined default value is 1 (Remember state before power failure).

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

Parameter 30: Alarm response

Alarm response Alarm of any type (General alarm, flood alarm, smoke alarm: CO, CO2, temperature alarm.)                             

Default setting: INACTIVE The following option values may be configured -:

Value Description
0 INACTIVE
1 ALARM ON
2 ALARM OFF
3 ALARM PROGRAM

The manufacturer defined default value is 0 (INACTIVE).

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

Parameter 38: Alarm sequence program

Alarm sequence program. Default setting: 10, 1-10 specifies alarm program number. Values in the range 1 to 10 may be set.

The manufacturer defined default value is 10.

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

Parameter 39: Active PROGRAM alarm time

Active PROGRAM alarm time. Default setting: 600s, 1-65534 specifies alarm time in seconds. Values in the range 1 to 65534 may be set.

The manufacturer defined default value is 600.

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

Parameter 42: Command class reporting Outputs status change

Command class reporting Outputs status change.

The following option values may be configured -:

Value Description
0 Inputs and controllers actions (SWITCH MULTILEVEL)
1 Inputs actions (SWITCH MULTILEVEL)
2 Inputs actions (COLOR CONTROL)

The manufacturer defined default value is 0 (Inputs and controllers actions (SWITCH MULTILEVEL)).

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

Parameter 43: Reporting 0-10v analog inputs change threshold

Defines which input voltage must change to be reported Parameter defines a value by which input voltage must change in order to be reported to the main controller.
New value is calculated based on last reported value, default setting: 5 Values in the range 1 to 100 may be set.

The manufacturer defined default value is 5.

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

Parameter 44: Power load reporting frequency

Parameter defines Time between reports. Parameter defines Time between reports. The report will be sent if last reported value differs from the current value, else reports will also be sent in case of polling. Default setting: 3 600 (s) Values in the range 0 to 65534 may be set.

The manufacturer defined default value is 30.

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

Parameter 45: Reporting energy consumption changes

Reporting energy consumption changes Defines the required change in power to generate an unsolicited power report. New, reported energy value is calculated based on last reported value. Default setting: 10 (0,1 kWh). Values in the range 0 to 255 may be set.

The manufacturer defined default value is 1.

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

Parameter 71: Response to BRIGHTNESS set to 0%

Response to BRIGHTNESS set to 0%.

The following option values may be configured -:

Value Description
0 Set to white (all channels controlled together)
1 last set colour is memorized

The manufacturer defined default value is 1 (last set colour is memorized).

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

Parameter 72: Starting animation program

Starting predefined program when device set to work in RGB/RGBW mode Starting predefined program when device set to work in RGB/RGBW mode (parameter 14) - relevant for main controllers other than Home Center 2 only. Default setting: 1 Values in the range 1 to 10 may be set.

The manufacturer defined default value is 1.

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

Parameter 73: Triple click action

Triple click action, default setting: 0

The following option values may be configured -:

Value Description
0 NODE INFO control frame is sent
1 starting favourite program

The manufacturer defined default value is 0 (NODE INFO control frame is sent).

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

Switch All Mode

Set the mode for the switch when receiving SWITCH ALL commands.

The following option values may be configured -:

Value Description
0 Exclude from All On and All Off groups
1 Include in All On group
2 Include in All Off group
255 Include in All On and All Off groups

This parameter has the configuration ID switchall_mode 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 FGRGBW supports 5 association groups.

Group 1: Assigned to IN1 input

Association group 1 supports 5 nodes.

Group 2: Assigned to IN2 input

Association group 2 supports 5 nodes.

Group 3: Assigned to IN3 input

Association group 3 supports 5 nodes.

Group 4: Assigned to IN4 input

Association group 4 supports 5 nodes.

Group 5: Reports device status

Association group 5 supports 1 node.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_MULTILEVEL_V1 Linked to BASIC
COMMAND_CLASS_SWITCH_ALL_V1
COMMAND_CLASS_SENSOR_MULTILEVEL_V2
COMMAND_CLASS_METER_V2
COMMAND_CLASS_SWITCH_COLOR_V1
COMMAND_CLASS_MULTI_CHANNEL_V2
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_ASSOCIATION_V1
COMMAND_CLASS_VERSION_V1

Endpoint 1

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_MULTILEVEL_V1 Linked to BASIC

Endpoint 2

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_MULTILEVEL_V1 Linked to BASIC

Endpoint 3

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_MULTILEVEL_V1 Linked to BASIC

Endpoint 4

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_MULTILEVEL_V1 Linked to BASIC

Endpoint 5

Command Class Comment
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SWITCH_MULTILEVEL_V1 Linked to BASIC

Documentation Links


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