ST_UPSStatus


TYPE ST_UPSStatus
STRUCT
    Vendor             : STRING;         (* Reports the UPS vendor name as displayable string. *)
 Model             : STRING;         (* Reports the UPS model name as displayable string. *)
 FirmwareRev         : STRING;     (* Reports the UPS firmware revision as a displayable string. *)
 SerialNumber         : STRING;     (* Reports the UPS serial number as a displayable string. *)
 BatteryLifePercent     : DWORD;            (* The percent of battery capacity remaining in the UPS, represented as a value in the range of 0 through 100. *)
 BatteryLifeTime             : DWORD;            (* The amount of remaining UPS run time, in minutes. *)
 eBatteryStatus         : E_BatteryStatus;    (* The current status of the UPS batteries. *)
 eCommStatus         : E_UpsCommStatus;    (* The status of the communication path to the UPS. *)
 ePowerStatus         : E_UpsPowerStatus; (* Reports the status of utility-supplied power into the UPS. *)
 nPowerFailCnt         : DWORD;            (* Power fail counter. Increments every time the UPS service detects power fail. *)
 dwChargeFlags         : DWORD;            (* Most reserved for future use.
        Battery charge status flags. This member can be one or more of the following values.
        0: Unknown status     (all bits set to 0)
        1: High         (bit 0 is set)
        2: Low         (bit 1 is set)
        4: Critical            (bit 2 is set) 
          8: Charging            (bit 3 is set)
        - -         (bits 4 - 6 reserved)
        128: No battery     (bit 7 is set)
        256: UPS fan error     (bit 8 is set)
        - -         (bits 9 reserved)
        1024: Service interval message    (bit 10 is set)
        - -         (bits 11 - 31 reserved)
     *)
END_STRUCT
END_TYPE

E_UpsPowerStatus E_UpsCommStatus E_BatteryStatus

Nicht alle USV-Modelle können alle Statusinformationen liefern.

X : Die Statusinformation ist bei diesem Model vorhanden.

Statusinformation	Beckhoff P24Vxxxx USV	Beckhoff 24V USV an der CP903x-Karte	APC Back-UPS Pro 280	APC Smart-UPS 420	Beschreibung
Vendor	X	X	X	X	Herstellername.
Model	X	X	X	X	Modelstring. Leerstring, wenn keine USV konfiguriert wurde.
FirmwareRev	X	X	X	X	Versionsinformationen zur USV-Firmware. Leerstring, wenn die USV diesen Parameter nicht unterstützt.
SerialNumber	X	Keine	X	X	Seriennummer der USV. Leerstring, wenn die USV diesen Parameter nicht unterstützt.
BatteryLifePercent	X	Keine	X	X	Verbliebene Batterielaufzeit in Prozent. Der Wert ist immer NULL wenn die USV diesen Parameter nicht liefern kann.
BatteryLifeTime	X	Keine	X	X	Verbliebene Batterielaufzeit in Minuten. Der Wert ist immer NULL wenn die USV diesen Parameter nicht liefern kann.
eBatteryStatus	BatteryUnknownStatus wenn keine Batterie vorhanden ist, ab USV-Softwareversion >=2.0.0.6 und USV-Firmware >= 25.1.I BatteryOk	BatteryUnknownStatus wenn keine Batterie vorhanden ist. BatteryOk	X	X	Batteriestatus.
eCommStatus	X	X	X	X	Status der Kommunikation zur USV.
ePowerStatus	X	X	X	X	Status der externen Spannungsversorgung.
nPowerFailCnt	X	X	*X	*X	Power-Fail-Zähler. Der Zähler wird inkrementiert wenn ein Spannungsausfall vom USV-Service erkannt wurde.
dwChargeFlags	No battery (Bit 7 gesetzt) ab USV-Softwareversion >=2.0.0.6 und Firmware >= 25.1.I Die Existenz der Batterie wird jede Minute überprüft. UPS fan error (Bit 8 gesetzt) ab USV-Softwareversion >=2.0.0.7 und Firmware >=40.1.I Der USV Lüfterstatus wird jede Minute überprüft. Erfordert eine neuere (zweite) Hardwarerevision! Akkuwechsel Interval-Service ist abgelaufen (Bit 10 gesetzt). Implementiert in der USV-Softwareversion >= 3.0.0.8;	High (Bit 0 gesetzt) wenn Batterie voll geladen. Charging (Bit 3 gesetzt) No battery (Bit 7 gesetzt) wenn keine Batterie gefunden wurde.	Keine	Keine	Batterie-Ladestatus-Flags.

*) Nur vorhanden, wenn das Model "Smart Signaling to any APC UPS & TwinCAT" konfiguriert wurde.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	USV-Hardware	Einzubindende SPS-Bibliotheken
TwinCAT v2.8.0, Build > 745 TwinCAT v2.9.0, Build > 945	PC (i386)	Beckhoff P24Vxxxx USV; Integrierte Beckhoff Industrie-PC 24V USV an der CP903x-Karte (PCI/ISA); Die mit Beckhoff Industrie-PC ausgelieferten APC-Geräte die das Smartprotokoll unterstützen und mit dem Windows USV-Dienst konfiguriert werden können.	TcIoFunctions.Lib ( Standard.Lib; TcBase.Lib; TcSystem.Lib; TcUtilities.Lib werden automatisch eingebunden )