TYPE ST_UPSStatus

TYPE ST_UPSStatus
STRUCT
 Vendor                  : STRING;(* USV-Herstellername*)
 Model                   : STRING;(* USV-Modelstring*)
 FirmwareRev             : STRING;(* Versionsinformationen zur USV-Firmware*)
 SerialNumber            : STRING;(* Seriennummer der USV*)
 BatteryLifePercent      : DWORD;(* Verbliebene Akkulaufzeit in Prozent (0..100%)*)
 BatteryLifeTime         : DWORD;(* Verbliebene Akkulaufzeit in Minuten*)
 eBatteryStatus          : E_BatteryStatus;(* USV-Akkustatus*)
 eCommStatus             : E_UpsCommStatus;(* Status der Kommunikation zur USV*)
 ePowerStatus            : E_UpsPowerStatus;(* Status der externen Spannungsversorgung*)
 nPowerFailCnt           : DWORD;(* Power-Fail-Zähler. Der Zähler wird inkrementiert wenn ein Spannungsaufall vom USV-Service erkannt wurde*)
 dwChargeFlags           : DWORD;(* Akku und spezielle Statusinformationen. Es können eins oder mehrere Bits gleichzeitig gesetzt sein. 
        Bits0..7 := Allgemeine Akku-Statusinformation (wenn alle Bits Null sind => Status unbekannt)
                Bit0 := High (Bit gesetzt => Ladestatus hoch)
                Bit1 := Low (Bit gesetzt => Ladestatus niedrig)
                Bit2 := Critical (Bit gesetzt => Ladestatus kritisch)
                Bit3 := Charging (Bit gesetzt => Akku wird geladen)
                Bits4..6 := zur Zeit reserviert (alle Bits sind 0)
                Bit7 := No Battery (Bit gesetzt => Akku fehlt oder wurde abgeklemmt)
        Bits8..15 := Spezielle Statusinformationen (alle Bits sind 0 => Status in Ordnung oder unbekannt)
                Bit8 := UPS Fan Error (Bit gesetzt => Lüfterhardware meldet einen Fehler, Bit nicht gesetzt => kein Fehler detektiert)
                Bit9 := Over Temperature (Bit gesetzt => Übertemperatur wurde von der Hardware detektiert, Bit nicht gesetzt => keine Übertemperatur detektiert)
                Bit10 := Service Interval Notify (Bit gesetzt => Intervalezeit ist abgelaufen, Bit nicht gesetzt =>Intervalzeit ist noch nicht abgelaufen )
                Bit11 := Under Temperature (Bit gesetzt => Untertemperatur wurde von der Hardware detektiert, Bit nicht gesetzt => keine Untertemperatur detektiert)
                Bit12 := Fuse Not Ok (Bit gesetzt => Sicherung defekt oder fehlt, Bit nicht gesetzt => Sicherung ist in Ordnung)
                Bit13 := Alarm1 (zur Zeit reserviert, Bit ist 0)
                Bit14 := Alarm2 (zur Zeit reserviert, Bit ist 0)
                Bit15 := Alarm3 (zur Zeit reserviert, Bit ist 0)
        Bits16..31 := zur Zeit reserviert, alle Bits sind 0)
         *)
END_STRUCT
END_TYPE

 

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

X : Die Statusinformation ist bei diesem Model vorhanden.

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

Statusinformation

Beckhoff
HID UPS,
BAPI v1

Beckhoff
P24Vxxxx

Beckhoff
CP903x ISA/PCI-Karte

Beckhoff
CX2100-09x4

APC
Back-UPS Pro 280,
Smart-UPS 420

Beschreibung

Vendor

X

X

X

X

X

Herstellername.

Model

X

X

X

X

X

Modelstring. Leerstring, wenn keine USV konfiguriert wurde.

FirmwareRev

X

X

X

X

X

Versionsinformationen zur USV-Firmware. Leerstring, wenn die USV diesen Parameter nicht unterstützt.

SerialNumber

X

X

Keine

X

X

Seriennummer der USV. Leerstring, wenn die USV diesen Parameter nicht unterstützt. 

BatteryLifePercent

X

X

Keine

X

X

Verbliebene Akkulaufzeit in Prozent. Der Wert ist immer NULL wenn die USV diesen Parameter nicht liefern kann.

BatteryLifeTime

X

X

Keine

X

X

Verbliebene Akkulaufzeit in Minuten.  Der Wert ist immer NULL wenn die USV diesen Parameter nicht liefern kann.

eBatteryStatus

  • BatteryOk
  • BatteryUnknownStatus wenn kein Akku vorhanden ist, ab USV-Softwareversion >=2.0.0.6 und USV-Firmware >= 25.1.I.
  • BatteryOk
  • BatteryUnknownStatus wenn kein Akku vorhanden ist.
  • BatteryOk
  • BatteryUnknownStatus wenn kein Akku vorhanden ist (gilt nur für das Model mit "Smart Battery" und nicht mit Kondensatoren).
  • BatteryOk

X

Akku-Status.

eCommStatus

X

X

X

X

X

Status der Kommunikation zur USV.

ePowerStatus

X

X

X

X

X

Status der externen Spannungsversorgung.

nPowerFailCnt

X

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-Firmware >= 33.12-0 wenn kein Akku angeschlossen.
  • Service Interval Notify (Bit 10 gesetzt).Der konfigurierte Akkuwechsel Interval-Service ist abgelaufen.
  • No Battery (Bit 7 gesetzt) ab USV-Softwareversion >=2.0.0.6 und Firmware >= 25.1.I Die Existenz des Akkus 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!
  • Service Interval Notify (Bit 10 gesetzt).Der konfigurierte Akkuwechsel Interval-Service ist abgelaufen . Implementiert in der USV-Softwareversion >= 3.0.0.8.
  • High (Bit 0 gesetzt) wenn Akku voll geladen.
  • Charging (Bit 3 gesetzt) wenn Akku lädt.
  • No Battery (Bit 7 gesetzt) wenn kein Akku gefunden wurde.
  • No Battery (Bit 7 gesetzt). Keine Kommunikation zum Akku (gilt nur für das Model mit "Smart Battery" und nicht mit Kondensatoren).
  • Over Temperature (Bit 9 gesetzt) wenn Übertemperatur detektiert wurde und das Laden des Akkus unterbrochen wurde. Erfordert eine neuere (zweite) Hardwarerevision. Implementiert in der USV-Softwareversion >= 3.0.0.18.
  • Service Interval Notify (Bit 10 gesetzt) Der konfigurierte Akku-Service-Intervalzeit ist abgelaufen.
  • Under Temperature (Bit 11 gesetzt) wenn Untertemperatur detektiert wurde und das Laden des Akkus unterbrochen wurde. Erfordert eine neuere (zweite) Hardwarerevision. Implementiert in der USV-Softwareversion >= 3.0.0.18.
  • Fuse Not Ok (Bit 12 gesetzt) Die "Smart Battery"-Sicherung ist defekt oder nicht vorhanden. Erfordert eine neuere (zweite) Hardwarerevision. Implementiert in der USV-Softwareversion >= 3.0.0.18.

Keine

Akku-Ladestatus-Flags und spezielle Statusinformationen.

USV-Hardware

Zielplattform

Entwicklungsumgebung

Einzubindende SPS-Bibliotheken

  • Beckhoff HID UPS;
  • Beckhoff BAPI v1;
  • Beckhoff P24Vxxxx;
  • Beckhoff CP903x-Karte (PCI/ISA);
  • Beckhoff CX2100-09x4 Modelle (z.B. CX2100-0904 oder CX2100-0914 + "Smart Battery" CX2900-0192);
  • Die mit Beckhoff Industrie-PC ausgelieferten APC-Geräte die das Smartprotokoll unterstützen und mit dem Windows USV-Dienst konfiguriert werden können;

PC oder CX

TwinCAT v2.8.0, Build > 745

TwinCAT v2.9.0, Build > 945

TcIoFunctions.Lib

( Standard.Lib; TcBase.Lib; TcSystem.Lib; TcUtilities.Lib werden automatisch eingebunden )

TwinCAT v3.0 und höher

Tc2_IoFunctions