Jalousien

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

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' := 'Blinds'}
{attribute 'iot.BlindsPositionValueVisible' := 'true'}
{attribute 'iot.BlindsPositionSliderVisible' := 'true'}
{attribute 'iot.BlindsAngleValueVisible' := 'true'}
{attribute 'iot.BlindsAngleSliderVisible' := 'true'}
{attribute 'iot.BlindsModeVisible' := 'true'}
{attribute 'iot.BlindsModeChangeable' := 'true'}
stBlindsWidgetSample : ST_BlindsWidgetSample;

Attribut	Datentyp	Beschreibung
iot.ReadOnly	BOOL	Legt fest, ob das Widget auf Seite der App nur Lesezugriff (TRUE) oder zusätzlich auch 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: Blinds.
iot.BlindsPositionValueVisible	BOOL	Legt fest, ob der Positionswert angezeigt wird (TRUE) oder nicht (FALSE).
iot.BlindsPositionSliderVisible	BOOL	Legt fest, ob der Slider für den Positionswert angezeigt wird (TRUE) oder nicht (FALSE).
iot.BlindsAngleValueVisible	BOOL	Legt fest, ob der Winkelwert angezeigt wird (TRUE) oder nicht (FALSE).
iot.BlindsAngleSliderVisible	BOOL	Legt fest, ob der Slider für den Winkelwert angezeigt wird (TRUE) oder nicht (FALSE).
iot.BlindsModeVisible	BOOL	Legt fest, ob der Modus angezeigt wird (TRUE) oder nicht (FALSE).
iot.BlindsModeChangeable	BOOL	Legt fest, ob der Modus einstellbar ist (TRUE) oder nicht (FALSE).

TYPE ST_BlindsWidgetSample :
STRUCT
    sDisplayName     : STRING := '';
    bActive : BOOL;
    bPositionUp      : BOOL;
    bPositionDown    : BOOL;
    bAngleUp         : BOOL;
    bAngleDown       : BOOL;
    {attribute 'iot.Unit' := '%'}
    {attribute 'iot.MinValue' := '0'}
    {attribute 'iot.MaxValue' := '100'}
    nPositionValue   : INT;
    nPositionRequest : INT;
    {attribute 'iot.Unit' := '°'}
    {attribute 'iot.MinValue' := '-90'}
    {attribute 'iot.MaxValue' := '90'}
    nAngleValue      : INT;
    nAngleRequest    : INT;
    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.
bActive	BOOL	Vorgesehen, um eine Aktivierung der Jalousien zu erkennen.	Klicken auf die Fläche des Widgets an Stellen, wo keine anderen Kontrollelemente sind.
bPositionUp	BOOL	Vorgesehen für das Hochfahren der Jalousien.	Button auf der linken Seite des oberen Sliders.
bPositionDown	BOOL	Vorgesehen für das Herunterfahren der Jalousien.	Button auf der rechten Seite des oberen Sliders.
bAngleUp	BOOL	Vorgesehen für das Stellen des Winkelwertes in Richtung des minimalen Wertes.	Button auf der linken Seite des unteren Sliders.
bAngleDown	BOOL	Vorgesehen für das Stellen des Winkelwertes in Richtung des maximalen Wertes.	Button auf der rechten Seite des unteren Sliders.
iot.Unit	STRING	Einheit des Positionswertes.	Einheit hinter dem ersten Zahlenwert.
iot.MinValue	INT	Untere Grenze des Positionswertes.	Nur in der SPS abgebildet.
iot.MaxValue	INT	Obere Grenze des Positionswertes.	Nur in der SPS abgebildet.
nPositionValue	INT	Positionswert der Jalousien.	Der erste der beiden Zahlenwerte.
nPositionRequest	INT	Zielwert der Position der Jalousien.	Der Wert, der im Moment des Loslassens des oberen Sliders an die App geschickt wird.
iot.Unit	STRING	Einheit des Winkelwertes.	Einheit hinter dem zweiten Zahlenwert.
iot.MinValue	INT	Untere Grenze des Winkelwertes.	Nur in der SPS abgebildet.
iot.MaxValue	INT	Obere Grenze des Winkelwertes.	Nur in der SPS abgebildet.
nAngleValue	INT	Winkelwert der Jalousien.	Der zweite der beiden Zahlenwerte.
nAngleRequest	INT	Zielwert der Position der Jalousien.	Der Wert, der im Moment des Loslassens des unteren Sliders an die App geschickt wird.
sMode	STRING	Modus der Jalousien.	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.