ST_UPSStatus
TYPE ST_UPSStatus
STRUCT
Vendor : STRING; (* UPS vendor name *)
Model : STRING; (* UPS model name *)
FirmwareRev : STRING; (* UPS firmware revision *)
SerialNumber : STRING; (* UPS serial number *)
BatteryLifePercent : DWORD; (* The percent of battery capacity remaining in the UPS (0..100%) *)
BatteryLifeTime : DWORD; (* Remaining UPS run time, in minutes *)
eBatteryStatus : E_BatteryStatus; (* UPS battery state *)
eCommStatus : E_UpsCommStatus; (* Status of the communication path to the UPS *)
ePowerStatus : E_UpsPowerStatus; (* Status of utility-supplied power into the UPS *)
nPowerFailCnt : DWORD; (* Power Fail counter. Increments every time the UPS service detects power fail *)
dwChargeFlags : DWORD; (* Battery charge status flags. This member can be one or more of the following values.Bits0..7 := General battery status flags (if all bits are set to 0 => unknown status)
Bit0 := High (bit set => high battery charge)
Bit1 := Low (bit set => low battery charge)
Bit2 := Critical (bit set => battery is near empty)
Bit3 := Charging (bit set => battery is charging)
Bits4..6 := reserved (all bits are 0)
Bit7 := No Battery (bit set => battery not found or not connected, bit not set => battery is existing or unknown state)
Bits8..15 := Special status information (if all bits are set to 0 => state ok or unknown state)
Bit8 := UPS Fan Error (bit set => fan hardware reports an error, bit not set => fan is ok)
Bit9 := Over Temperature (bit set => over temperature detected, bit not set => temperature is ok)
Bit10 := Service Interval Notify (bit set => service interval time expired, bit not set =>service interval time not expired )
Bit11 := Under Temperature (bit set => under temperature detected , bit not set => temperature is ok )
Bit12 := Fuse Not Ok (bit set => fuse broken or missed, bit not set => fuse ok)
Bit13 := Alarm1 (reserved for later use, bit is 0)
Bit14 := Alarm2 (reserved for later use, bit is 0)
Bit15 := Alarm3 (reserved for later use, bit is 0)
Bits16..31 := (reserved for later use, all bits are 0)
*)
END_STRUCT
END_TYPE
Nicht alle USV-Modelle können alle Statusinformationen liefern.
X: Die Statusinformation ist bei diesem Modell vorhanden.
*) Nur vorhanden, wenn das Model "Smart Signaling to any APC UPS & TwinCAT" konfiguriert wurde.
Statusinformation | Beckhoff | Beckhoff | Beckhoff | Beckhoff | APC | APC | Beschreibung |
|---|---|---|---|---|---|---|---|
Vendor | X | X | X | X | X | X | Herstellername. |
Model | X | X | X | X | X | X | Modelstring. Leerstring, wenn keine USV konfiguriert wurde. |
FirmwareRev | X | X | X | X | X | X | Versionsinformationen zur USV-Firmware. Leerstring, wenn die USV diesen Parameter nicht unterstützt. |
SerialNumber | X | X | Keine | X | X | X | Seriennummer der USV. Leerstring, wenn die USV diesen Parameter nicht unterstützt. |
BatteryLifePercent | X | X | Keine | X | 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 | 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 | X | Akku-Status (Typ: E_BatteryStatus). |
eCommStatus | X | X | X | X | X | X | Status der Kommunikation zur USV (Typ: E_UpsCommStatus). |
ePowerStatus | X | X | X | X | X | X | Status der externen Spannungsversorgung (Typ: E_UpsPowerStatus). |
nPowerFailCnt | X | 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 Intervall 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 Intervall Service ist abgelaufen. Implementiert in der USV-Softwareversion >= 3.0.0.8; | High (Bit 0 gesetzt) wenn Akku voll geladen.
Charging (Bit 3 gesetzt)
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) Die konfigurierte Akku-Service-Intervallzeit 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 | Keine | Akku-Ladestatus-Flags und spezielle Statusinformationen. |
Voraussetzungen
Entwicklungsumgebung | Zielplattform | USV Hardware | Einzubindende SPS-Bibliotheken (Kategoriegruppe) |
|---|---|---|---|
TwinCAT v3.1.0 | PC oder CX (x86, x64, ARM) |
| Tc2_IoFunctions (IO) |