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.

The following illustration shows the color palette that becomes visible by clicking on the color palette icon.

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.