Geräteprofil · Verschiedenes

USV über NUT-Server (Network UPS Tools)

Hinweis: Dieses Profil ist nach der offiziellen NUT-Protokollbeschreibung (Network protocol information, networkupstools.org) erstellt.

Das Profil liest eine USV (APC, Eaton, CyberPower, Riello, …) nicht direkt, sondern über einen NUT-Server (upsd, TCP-Port 3493). Die USV hängt per USB oder Netzwerk an diesem Server; nomos fragt nur den Server ab. Das Profil ist nur lesend – Befehle an die USV (Selbsttest, Abschalten, Beeper) werden nicht gesendet.

Voraussetzungen

1. Ein laufender NUT-Server, an dem die USV angeschlossen ist, z. B.:
   • Synology DSM: Systemsteuerung → Hardware & Energie → USV: „USV-Unterstützung aktivieren“ und „Netzwerk-USV-Server aktivieren“, dann unter „Zugelassene DiskStation-Geräte“ die IP-Adresse des nomos Controllers eintragen
   • QNAP QTS: Systemsteuerung → System → Externes Gerät → USV: „Netzwerk-USV-Support aktivieren“ und die IP-Adresse des nomos Controllers in die Liste der zugelassenen IP-Adressen eintragen
   • Linux, Raspberry Pi oder ein fertiges NUT-Paket: upsd muss im Netz lauschen (LISTEN 0.0.0.0 3493 in upsd.conf) und der Controller darf nicht per Firewall gesperrt sein
2. Der Name der USV auf dem NUT-Server (der Name in ups.conf, bei Synology und QNAP fest ups). Auf einem Linux-Server zeigt upsc -l <server> alle Namen an.
3. Der nomos Controller muss den NUT-Server per TCP auf Port 3493 erreichen.

Für das reine Lesen ist keine Anmeldung nötig – Benutzername und Passwort (bei Synology monuser/secret) braucht NUT nur für Schreibbefehle und für upsmon. Das Profil sendet deshalb keine Zugangsdaten.

Einrichtung

1. Skills → Add-ons: Profil importieren
2. Gerät anlegen und die IP-Adresse des NUT-Servers eintragen (z. B. die der Synology). Bitte eine IP-Adresse verwenden, keinen Hostnamen.
3. UPS-Name prüfen: Standard ist ups (passt für Synology und QNAP); bei einem eigenen NUT-Server den Namen aus ups.conf eintragen
4. Der Port 3493 ist vorbelegt und nur bei einem abweichend konfigurierten Server zu ändern

Datenbereich

Abgefragt werden alle 10 Sekunden ups.status, alle 30 Sekunden die Batterie- und Leistungswerte und stündlich Hersteller und Modell (jeweils GET VAR <ups> <variable>).

• Status (status): der wichtigste Zustand aus ups.status. NUT meldet mehrere Kennungen gleichzeitig (z. B. OB DISCHRG LB); angezeigt wird die mit der höchsten Priorität: Zwangsabschaltung (FSD) → USV-Ausgang aus (OFF) → Überlast (OVER) → Batterie schwach (LB) → Batteriebetrieb/Stromausfall (OB) → Batterie tauschen (RB) → Bypass aktiv (BYPASS) → Alarm (ALARM) → Laufzeitkalibrierung (CAL) → Batterietest (TEST) → Batterie entlädt (DISCHRG) → Online, Spannung wird gesenkt (TRIM) → Online, Spannung wird angehoben (BOOST) → Batterie hoch (HB) → Online, ECO-Modus (HE/ECO) → Online, Batterie lädt (CHRG) → Online (OL). Zusätzlich: „Keine Daten von der USV“ (ERR DATA-STALE), „NUT-Treiber nicht mit der USV verbunden“ (ERR DRIVER-NOT-CONNECTED), „Unbekannter USV-Name“ (ERR UNKNOWN-UPS), „Zugriff verweigert“ (ERR ACCESS-DENIED), „Unbekannt“ (keine bekannte Kennung)
• Störung (malfunction): an bei Batteriebetrieb (OB), Batterie schwach (LB), Überlast, Batterie tauschen, Bypass, Alarm, Zwangsabschaltung, USV-Ausgang aus sowie bei jeder Fehlerantwort des NUT-Servers auf die Statusabfrage. Ein Stromausfall wird damit bewusst als Störung gemeldet.
• Batteriebetrieb (on_battery), Batterie schwach (low_battery), Lädt (charging), Überlast (overload), Batterie tauschen (replace_battery) – jeweils eigene Ja/Nein-Werte aus den einzelnen Kennungen
• Batterieladung (battery, %, battery.charge) und Restlaufzeit (runtime, Minuten, aus battery.runtime in Sekunden)
• Last (load, %, ups.load), Eingangsspannung und Ausgangsspannung (V), Ausgangsleistung (W, ups.realpower)
• Ausgeblendet: Batteriespannung, die rohen NUT-Kennungen (ups_status, z. B. OL CHRG), Hersteller und Modell
• Erreichbarkeit (reachable): aus der TCP-Verbindung zum NUT-Server; jede Statusabfrage dient zugleich als Lebenszeichen – bleibt die Antwort 2 Sekunden aus, wird die Verbindung getrennt und neu aufgebaut

Hinweise

• Nicht jede USV liefert jeden Wert. Einfache Geräte (z. B. APC Back-UPS) melden oft keine Ausgangsspannung oder Leistung; diese Werte bleiben dann leer. Welche Variablen vorhanden sind, zeigt upsc <ups>@<server>.
• „Erreichbar“ beschreibt nur den NUT-Server. Hat der Server die Verbindung zur USV verloren (USB-Kabel gezogen), bleibt er erreichbar; der Status zeigt dann „Keine Daten von der USV“ bzw. „NUT-Treiber nicht verbunden“ und die Störung ist aktiv.
• Lässt der NUT-Server den Controller nicht zu (Synology/QNAP: IP fehlt in der Liste), wird die Verbindung je nach Server abgewiesen (dann nicht erreichbar) oder mit ERR ACCESS-DENIED beantwortet (Status „Zugriff verweigert“).
• Das Profil liest genau eine USV – die unter „UPS-Name“ eingetragene. Weitere USVs am selben NUT-Server werden nicht erfasst.
• Das Profil fährt keine Geräte herunter und ersetzt keinen NUT-Client (upsmon) auf Servern, die bei Stromausfall sauber herunterfahren sollen.