RGBW lighting
The described widget is suitable for operating RGBW lighting from the app. The various configuration options are described below. In the figure all available features of the widget are active.
![RGBW lighting 1:](Images/png/9007214943700235__Web.png)
The following illustration shows the color palette that becomes visible by clicking on the color palette icon.
![RGBW lighting 2:](Images/png/9007214943701899__Web.png)
The widget is transferred as a substructure in the overall structure of the SendData() method. To build the widget, various PLC attributes are used when declaring the structure.
{attribute 'iot.ReadOnly' := 'false'}
{attribute 'iot.DisplayName' := 'Name for Widget'}
{attribute 'iot.WidgetType' := 'RGBW'}
{attribute 'iot.LightValueVisible' := 'true'}
{attribute 'iot.LightSliderVisible' := 'true'}
{attribute 'iot.LightColorPaletteVisible' := 'true'}
{attribute 'iot.LightColorTemperatureSliderVisible' := 'true'}
{attribute 'iot.LightModeVisible' := 'true'}
{attribute 'iot.LightModeChangeable' := 'true'}
stGeneralWidgetSample : ST_RGBWWidgetSample;
Attribute | Data type | Description |
---|---|---|
iot.ReadOnly | BOOL | Determines whether the widget on the app side gets only read access (TRUE) or also additional write access to the PLC (FALSE). |
iot.DisplayName | STRING | The display name of the widget in the app. This will be overwritten by sDisplayName as soon as sDisplayName is not an empty string. |
iot.WidgetType | STRING | Type specification for the widget, in this case: RGBW. |
iot.LightValueVisible | BOOL | Determines whether the dimming value is displayed (TRUE) or not (FALSE). |
iot.LightSliderVisible | BOOL | Determines whether the upper of the two sliders (for the dimming value of the light) is visible (TRUE) or not (FALSE). |
ioT.LightColorPaletteVisible | BOOL | Determines whether the color palette is displayed (TRUE) or not (FALSE). |
ioT.LightColorTemperatureSliderVisible | BOOL | Determines whether the lower of the two sliders (for the color temperature) is visible (TRUE) or not (FALSE). |
iot.LightModeVisible | BOOL | Determines whether the mode is displayed (TRUE) or not (FALSE). |
iot.LightModeChangeable | BOOL | Determines whether the mode is adjustable (TRUE) or not (FALSE). |
TYPE ST_RGBWWidgetSample :
STRUCT
sDisplayName : STRING := '';
bLight : BOOL := FALSE;
{attribute 'iot.Unit' := '%'}
{attribute 'iot.MinValue' := '0'}
{attribute 'iot.MaxValue' := '100'}
nLight : INT := 100;
nHueValue : INT := 57;
nSaturation : INT := 100;
{attribute 'iot.MinValue' := '2400'}
{attribute 'iot.MaxValue' := '6500'}
nColorTemperature : INT := 3500;
sMode : STRING := 'Automatic';
aModes : ARRAY[0..1] OF STRING := ['Manual', 'Automatic'];
END_STRUCT
END_TYPE
Attribute | Data type | Description | Display in widget |
---|---|---|---|
sDisplayName | STRING | Determines the display name of the widget and overwrites the PLC attribute 'iot.DisplayName'. | Display text of the widget. |
bLight | BOOL | Switches the lighting on (TRUE) or off (FALSE). | Toggle switch top right. |
iot.Unit | STRING | Unit of the dimming value. | Unit after the numerical value. |
iot.MinValue | INT | Lower limit of the dimming value. | On the left side under the top slider. |
iot.MaxValue | INT | Upper limit of the dimming value. | On the right side under the top slider. |
nLight | INT | Dimming value of the lighting. | Numerical value and additional image in the filling of the upper slider. |
nHueValue | INT | The Hue color value in the value range from 0 (red) to 360 (red again). | The number of degrees of the circle in the color palette. |
nSaturation | INT | Saturation of the color value in the value range from 0 (grey) to 100 (selected color). | At the top of the color palette, the value is 0 and at the bottom of the color palette, the value is 100. |
iot.MinValue | INT | Lower limit of the color temperature value. | No explicit display, defines the value range of the lower slider. |
iot.MaxValue | INT | Upper limit of the color temperature value. | No explicit display, defines the value range of the lower slider. |
nColorTemperature | INT | Value of the color temperature. | Display in the lower slider. |
sMode | STRING | Mode of lighting. | The currently displayed mode. |
aModes | ARRAY [0..n] OF STRING | Array of the different modes that can be set by the user. | By pressing on the current mode, the adjustable modes can be displayed. |