Energiemonitoring

Das beschriebene Widget eignet sich für die Darstellung von Energiedaten der App. Die verschiedenen Konfigurationsmöglichkeiten werden im Folgenden beschrieben. In der Abbildung sind alle verfügbaren Features des Widgets aktiv. Die im Widget dargestellten Werte haben keinen Anspruch darauf, realistisch zu sein. Sie sollen lediglich verschiedene Möglichkeiten der Darstellung zeigen.

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' := 'EnergyMonitoring'}
{attribute 'iot.EnergyMonitoringPhase2Visible' := 'true'}
{attribute 'iot.EnergyMonitoringPhase3Visible' := 'true'}
stEnergyMonitoringWidgetSample : ST_EnergyMonitoringWidgetSample;

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: EnergyMonitoring.
iot.EnergyMonitoringPhase2Visible	BOOL	Legt fest, ob die Werte der zweiten Phase angezeigt werden (TRUE) oder nicht (FALSE).
iot.EnergyMonitoringPhase3Visible	BOOL	Legt fest, ob die Werte der dritten Phase angezeigt werden (TRUE) oder nicht (FALSE).

TYPE ST_EnergyMonitoringWidgetSample :
STRUCT
    sDisplayName                 : STRING;
    sStatus                      : STRING;
    aThreePhaseMaxPower          : ARRAY[0..2] OF LREAL;
    aThreePhaseCurrentPower      : ARRAY[0..2] OF LREAL;
    aThreePhasePowerUnits        : ARRAY[0..2] OF STRING;
    aThreePhaseAmperage          : ARRAY[0..2] OF LREAL;
    aThreePhaseAmperageUnits     : ARRAY[0..2] OF STRING;
    aThreePhaseVoltage           : ARRAY[0..2] OF LREAL;
    aThreePhaseVoltageUnits      : ARRAY[0..2] OF STRING;
    nPowerQualityFactor          : LREAL;    
    nCurrentPower                : LREAL;
    sPowerUnit                   : STRING;
    nEnergy                      : LREAL;
    sEnergyUnit                  : STRING;
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.
sStatus	STRING	Vorgesehen, um den Status des Energiemonitorings anzugeben.	Text unter dem Anzeigetext des Widgets.
aThreePhaseMaxPower	ARRAY [0..2] OF LREAL	Die drei Maximalwerte der Leistung der drei Phasen.	Skalierung der drei rot gefüllten Kreise.
aThreePhaseCurrentPower	ARRAY [0..2] OF LREAL	Die aktuelle Leistung der drei Phasen.	Ausfüllung der roten Kreise und Wert über den Kreisen.
aThreePhasePowerUnits	ARRAY [0..2] OF STRING	Vorgesehen, um die Einheiten der drei Leistungen festzulegen. Mehr zur Verarbeitung der Einheiten finden Sie weiter unten in diesem Kapitel.	Einheiten hinter dem Wert über den Kreisen.
aThreePhaseAmperage	ARRAY [0..2] OF LREAL	Die drei Werte der Stromstärken der drei Phasen.	Wert der oberen Zahl in den Kreisen.
aThreePhaseAmperageUnits	ARRAY [0..2] OF STRING	Vorgesehen, um die Einheiten der drei Stromstärken festzulegen. Mehr zur Verarbeitung der Einheiten finden Sie weiter unten in diesem Kapitel.	Einheit hinter dem oberen Wert in den Kreisen.
aThreePhaseVoltage	ARRAY [0..2] OF LREAL	Die drei Werte der Spannungen der drei Phasen.	Wert der unteren Zahl in den Kreisen.
aThreePhaseVoltageUnits	ARRAY [0..2] OF STRING	Vorgesehen, um die Einheiten der drei Spannungen festzulegen. Mehr zur Verarbeitung der Einheiten finden Sie weiter unten in diesem Kapitel.	Einheit hinter dem unteren Wert in den Kreisen.
nPowerQualityFactor	LREAL	Der Power Quality Faktor.	In der vorliegenden Abbildung als „Power Quality Factor“.
nCurrentPower	LREAL	Die aktuelle Gesamtleistung.	In der vorliegenden Abbildung als „Power“ gekennzeichnet.
sPowerUnit	STRING	Einheit der aktuellen Gesamtleistung.	Hinter dem Wert für „Power“.
nEnergy	LREAL	Die bisher geladene Energie des aktuellen Ladevorgangs.	In der vorliegenden Abbildung als „Energy“ gekennzeichnet.
sEnergyUnit	STRING	Einheit der bisher geladenen Energie.	Hinter dem Wert für „Energy“.

Automatische Umrechnung von Einheiten

Ausgehend von der in den jeweiligen Arrays angegebenen Basiseinheit wird der aktuelle Wert automatisch im Bereich zwischen nano (10^-9) und exa (10^18) umgerechnet, um eine sinnvolle Darstellung im Widget zu ermöglichen.

Wenn beispielsweise als Basiseinheit A angegeben ist, würde ein Wert von 0,0001 A als 100 µA angezeigt werden. Wenn der Wert 10000 A beträgt, würden 10kA angezeigt werden.