RGBW-Beleuchtung

Das beschriebene Widget eignet sich für die Bedienung von RGBW-Beleuchtungen aus der App. Die verschiedenen Konfigurationsmöglichkeiten werden im Folgenden beschrieben. In der Abbildung sind alle verfügbaren Features des Widgets aktiv.

Die folgende Abbildung zeigt die Farbpalette, die durch das Klicken auf das Farbpalettensymbol sichtbar wird.

Das Widget wird als Unterstruktur in der Gesamtstruktur der SendData()-Methode übergeben. Für den Aufbau des Widgets werden bei der Deklaration der Struktur verschiedene SPS-Attribute verwendet.

{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;

Attribut	Datentyp	Beschreibung
iot.ReadOnly	BOOL	Legt fest, ob das Widget auf Seite der App nur Lesezugriff (TRUE) oder auch zusätzlich Schreibzugriff in die SPS (FALSE) bekommt.
iot.DisplayName	STRING	Der Anzeigename des Widgets in der App. Dieser wird von sDisplayName überschrieben, sobald sDisplayName kein Leerstring ist.
iot.WidgetType	STRING	Typangabe für das Widget, in diesem Fall: RGBW.
iot.LightValueVisible	BOOL	Legt fest, ob der Dimmwert angezeigt wird (TRUE) oder nicht (FALSE).
iot.LightSliderVisible	BOOL	Legt fest, ob der obere der beiden Slider (für den Dimmwert des Lichts) sichtbar ist (TRUE) oder nicht (FALSE).
iot.LightColorPaletteVisible	BOOL	Legt fest, ob die Farbpalette angezeigt wird (TRUE) oder nicht (FALSE).
iot.LightColorTemperatureSliderVisible	BOOL	Legt fest, ob der untere der beiden Slider (für die Farbtemperatur) sichtbar ist (TRUE) oder nicht (FALSE).
iot.LightModeVisible	BOOL	Legt fest, ob der Modus angezeigt wird (TRUE) oder nicht (FALSE).
iot.LightModeChangeable	BOOL	Legt fest, ob der Modus einstellbar ist (TRUE) oder nicht (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

Attribut	Datentyp	Beschreibung	Abbildung im Widget
sDisplayName	STRING	Legt den Anzeigenamen des Widgets fest und überschreibt das SPS-Attribut 'iot.DisplayName'.	Anzeigetext des Widgets.
bLight	BOOL	Schaltet die Beleuchtung an (TRUE) oder aus (FALSE).	Kippschalter rechts oben.
iot.Unit	STRING	Einheit des Dimmwertes.	Einheit hinter dem Zahlenwert.
iot.MinValue	INT	Untere Grenze des Dimmwertes.	Auf der linken Seite unter dem oberen Slider.
iot.MaxValue	INT	Obere Grenze des Dimmwertes.	Auf der rechten Seite unter dem oberen Slider.
nLight	INT	Dimmwert der Beleuchtung.	Zahlenwert und zusätzlich Abbildung in der Füllung des oberen Sliders.
nHueValue	INT	Der Hue-Farbwert im Wertebereich von 0 (rot) bis 360 (wieder rot).	Die Gradanzahl des Kreises in der Farbpalette.
nSaturation	INT	Sättigung des Farbwertes im Wertebereich von 0 (grau) bis 100 (ausgewählte Farbe).	Ganz oben in der Farbpalette ist der Wert 0 und ganz unten in der Farbpalette ist der Wert 100.
iot.MinValue	INT	Untere Grenze des Farbtemperaturwertes.	Keine explizite Anzeige, definiert den Wertebereich des unteren Sliders.
iot.MaxValue	INT	Obere Grenze des Farbtemperaturwertes.	Keine explizite Anzeige, definiert den Wertebereich des unteren Sliders.
nColorTemperature	INT	Wert der Farbtemperatur.	Anzeige im unteren Slider.
sMode	STRING	Modus der Beleuchtung.	Der aktuell angezeigte Modus.
aModes	ARRAY [0..n] OF STRING	Array der verschiedenen durch den Benutzer einstellbaren Modi.	Durch Drücken auf den aktuellen Modus können die einstellbaren Modi eingeblendet werden.