Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- home_assistant:home_assistant_rezepte:apcusv_einbinden [06.11.2026] – kolja
+++ home_assistant:home_assistant_rezepte:apcusv_einbinden [07.11.2026] (aktuell) – kolja
@@ Zeile 1: / Zeile 1: @@
 ====== Raspberry Pi als APC-USV-Server für Home Assistant ======
-**Aufbau:** APC Smart-UPS SMT1500I -> USB -> Raspberry Pi mit apcupsd -> TCP 3551 -> Home Assistant. Getestet mit Raspberry Pi B+ und Raspberry Pi OS Legacy Lite.
+**Aufbau:** APC Smart-UPS SMT1500I → USB → Raspberry Pi mit apcupsd → TCP 3551 → Home Assistant. Getestet mit Raspberry Pi B+ und Raspberry Pi OS Legacy Lite.
 Später ist serielles RS-232-Modbus vorgesehen (Stabilere Verbindung)
@@ Zeile 8: / Zeile 8: @@
   - Raspberry Pi OS Lite installieren, SSH und Netzwerk einrichten; eine feste IP/DHCP-Reservierung verwenden. Pi und Netzwerk für einen Stromausfall ebenfalls über die USV versorgen.
-  - USV zunächst per USB mit dem Pi verbinden. Im USV-Menü **Advanced / Configuration / Modbus** aktivieren.
+  - USV zunächst per USB mit dem Pi verbinden. Im USV-Menü **Advanced / Configuration / Modbus**  aktivieren.
   - Software installieren:
@@ Zeile 14: / Zeile 14: @@
 sudo apt update
 sudo apt install -y apcupsd cron
 </code>
@@ Zeile 20: / Zeile 22: @@
 <code bash>
 sudo nano /etc/apcupsd/apcupsd.conf
 </code>
@@ Zeile 37: / Zeile 41: @@
 TIMEOUT 0
 KILLDELAY 0
 </code>
-**Begründung:** ''DEVICE'' bleibt bei USB-Modbus leer. ''POLLTIME 30'' liest die USV ungefähr alle 30 Sekunden aus. ''NISIP 0.0.0.0'' erlaubt Netzwerkzugriffe: Port 3551 nur im vertrauenswürdigen LAN freigeben. Die Batteriegrenzen betreffen apcupsd auf dem Pi; andere Geräte werden dadurch nicht automatisch heruntergefahren.
+**Begründung:**  ''DEVICE''  bleibt bei USB-Modbus leer. ''POLLTIME 30''  liest die USV ungefähr alle 30 Sekunden aus. ''NISIP 0.0.0.0''  erlaubt Netzwerkzugriffe: Port 3551 nur im vertrauenswürdigen LAN freigeben. Die Batteriegrenzen betreffen apcupsd auf dem Pi; andere Geräte werden dadurch nicht automatisch heruntergefahren.
-Bei älteren Installationen ggf. ''ISCONFIGURED=yes'' in ''/etc/default/apcupsd'' setzen.
+Bei älteren Installationen ggf. ''ISCONFIGURED=yes''  in ''/etc/default/apcupsd''  setzen.
+ <font inherit/inherit;;#e74c3c;;inherit>**ACHTUNG:**</font>  Die Zeiten unbeding an die eigenen Bedürfnisse anpassen. Einige Proxmox Server brauchen realtiv lange zum sicheren Herunterfahren.
+Dort müssen BATTERYLEVEL und MINUTES erhöht werden.
+Diese beiden sind eine ODER Entscheidung. Je nachdem, welche Kondition zuerst eintritt, also wie hier 10% Batterielevel oder 5 Minuten Restlaufzeit.
 <code bash>
@@ Zeile 47: / Zeile 55: @@
 sudo systemctl restart apcupsd
 apcaccess status | grep -E '^(DATE|STATUS|END APC)'
 </code>
-''DATE'' muss aktuell sein; ''STATUS'' lautet normalerweise ''ONLINE''.
+''DATE''  muss aktuell sein; ''STATUS''  lautet normalerweise ''ONLINE''.
 ===== 3. In Home Assistant einbinden =====
-**Einstellungen -> Geräte & Dienste -> Integration hinzufügen -> APC UPS Daemon**. IP des Pi und Port **3551** eintragen.
+**Einstellungen → Geräte & Dienste → Integration hinzufügen → APC UPS Daemon**. IP des Pi und Port **3551**  eintragen.
-Die HA-Integration fragt standardmäßig **alle 60 Sekunden** ab. Die 30 Sekunden ''POLLTIME'' auf dem Pi bedeuten daher keine 30-Sekunden-Aktualisierung in HA. Bei einem Freeze können Werte kurzzeitig deutlich älter werden. Für Abschaltautomationen die Datenaktualität und das Ausfallverhalten berücksichtigen.
+Die HA-Integration fragt standardmäßig **alle 60 Sekunden**  ab. Die 30 Sekunden ''POLLTIME''  auf dem Pi bedeuten daher keine 30-Sekunden-Aktualisierung in HA. Bei einem Freeze können Werte kurzzeitig deutlich älter werden. Für Abschaltautomationen die Datenaktualität und das Ausfallverhalten berücksichtigen.
 ===== 4. Dienst bei Prozessabsturz neu starten =====
@@ Zeile 61: / Zeile 71: @@
 <code bash>
 sudo systemctl edit apcupsd
-</code>
+</code>
 <code>
 [Service]
 Restart=on-failure
 RestartSec=10s
 </code>
@@ Zeile 72: / Zeile 85: @@
 sudo systemctl daemon-reload
 sudo systemctl restart apcupsd
 </code>
-**Grenze:** Ein eingefrorener USB-Modbus-Datenstrom stoppt den Prozess nicht zwingend. Deshalb ist zusätzlich ein Watchdog nötig.
+**Grenze:**  Ein eingefrorener USB-Modbus-Datenstrom stoppt den Prozess nicht zwingend. Deshalb ist zusätzlich ein Watchdog nötig.
 ===== 5. USB-Modbus-Freeze automatisch beheben =====
-**Beobachteter Fehler:** ''END APC'' zeigt die aktuelle Abfragezeit, aber ''DATE'' bleibt auf der letzten erfolgreichen USV-Datenübertragung stehen. Ein Neustart von ''apcupsd'' stellte die Kommunikation wieder her. **Nicht** die Netzspannung ''LINEV'' vergleichen: Ein konstanter Messwert ist kein Fehlernachweis.
+**Beobachteter Fehler:**''END APC''  zeigt die aktuelle Abfragezeit, aber ''DATE''  bleibt auf der letzten erfolgreichen USV-Datenübertragung stehen. Ein Neustart von ''apcupsd''  stellte die Kommunikation wieder her. **Nicht**  die Netzspannung ''LINEV''  vergleichen: Ein konstanter Messwert ist kein Fehlernachweis.
-Der Watchdog läuft **jede Minute**, meldet ein ''DATE''-Alter über **120 Sekunden**, bestätigt den Fehler nach **10 Sekunden** und startet ''apcupsd'' neu. Zwischen zwei Neustarts liegen mindestens **15 Minuten**. ''LOWBATT'' und ''SHUTTING DOWN'' sind geschützt. Ereignisse werden im Journal protokolliert.
+Der Watchdog läuft **jede Minute**, meldet ein ''DATE''-Alter über **120 Sekunden**, bestätigt den Fehler nach **10 Sekunden**  und startet ''apcupsd''  neu. Zwischen zwei Neustarts liegen mindestens **15 Minuten**. ''LOWBATT''  und ''SHUTTING DOWN''  sind geschützt. Ereignisse werden im Journal protokolliert.
 Skript erstellen:
@@ Zeile 86: / Zeile 101: @@
 <code bash>
 sudo nano /usr/local/sbin/apcupsd-watchdog.sh
 </code>
-Den folgenden Inhalt **ab der ersten Zeile** einfügen. Der komplette Skriptinhalt steht in einem einzigen DokuWiki-Codeblock:
+Den folgenden Inhalt **ab der ersten Zeile**  einfügen. Der komplette Skriptinhalt steht in einem einzigen DokuWiki-Codeblock:
 <code bash>
@@ Zeile 179: / Zeile 196: @@
     exit 1
 fi
 </code>
-**Wichtig:** Die erste Zeile der Skriptdatei muss ''#!/usr/bin/env bash'' sein, ohne Leerzeile davor. Danach testen und Cronjob anlegen:
+**Wichtig:**  Die erste Zeile der Skriptdatei muss ''#!/usr/bin/env bash''  sein, ohne Leerzeile davor. Danach testen und Cronjob anlegen:
 <code bash>
@@ Zeile 188: / Zeile 207: @@
 sudo /usr/local/sbin/apcupsd-watchdog.sh --check
 sudo crontab -e
-</code>
-Dort **nur diesen einen** Watchdog eintragen:
+</code>
+Dort **nur diesen einen**  Watchdog eintragen:
 <code>
 * * * * * /usr/local/sbin/apcupsd-watchdog.sh
 </code>
@@ Zeile 202: / Zeile 224: @@
 systemctl is-active cron
 sudo journalctl -t apcupsd-watchdog --since "24 hours ago" --no-pager
 </code>
-**Praxisnachweis:** Am 06.11.2026 erkannte der Watchdog ein ''DATE''-Alter von 164 s, startete ''apcupsd'' neu und stellte die Daten wieder her. Das umgeht den Freeze, beseitigt aber nicht dessen USB-Modbus-Ursache. Die USV-Abschaltung darf nicht allein von möglicherweise veralteten HA-Sensorwerten abhängen.
+**Praxisnachweis:**  Am 06.11.2026 erkannte der Watchdog ein ''DATE''-Alter von 164 s, startete ''apcupsd''  neu und stellte die Daten wieder her. Das umgeht den Freeze, beseitigt aber nicht dessen USB-Modbus-Ursache. Die USV-Abschaltung darf nicht allein von möglicherweise veralteten HA-Sensorwerten abhängen.
-===== 6. Späterer Umstieg auf serielles Modbus (RS-232) =====
+.
-Bei der SMT1500I sind USB-Modbus-Freezes dokumentiert. **RS-232-Modbus** vermeidet den betroffenen USB-Modbus-Kommunikationsweg und ist voraussichtlich stabiler, ohne eine absolute Garantie zu bieten.
+----
-Benötigt werden das passende **APC-Kabel AP940-0625A** (USV-Buchse mit RJ45/RJ50-Bauform auf DB9) und ein Linux-kompatibler **USB-RS232-Adapter**. Der APC-Anschluss ist **kein Ethernet und kein RS485**. Wegen der speziellen Pinbelegung kein beliebiges Kabel verwenden.
+===== Umstieg auf serielles Modbus (RS-232) =====
-Pinout: [[https://pinoutguide.com/UPS/apc_0625_cable_pinout.shtml]]
+Bei der SMT1500I sind USB-Modbus-Freezes dokumentiert. **RS-232-Modbus**  vermeidet den betroffenen USB-Modbus-Kommunikationsweg und ist voraussichtlich stabiler, ohne eine absolute Garantie zu bieten.
+Benötigt werden das passende **APC-Kabel AP940-0625A**  (USV-Buchse mit RJ45/RJ50-Bauform auf DB9) und ein Linux-kompatibler **USB-RS232-Adapter**. Der APC-Anschluss ist **kein Ethernet und kein RS485**. Wegen der speziellen Pinbelegung kein beliebiges Kabel verwenden.
+Pinout: [[https://pinoutguide.com/UPS/apc_0625_cable_pinout.shtml|APC Smart-UPS 5G cable pins and signals]]
 Nach dem Umstecken serielle Schnittstelle ermitteln:
@@ Zeile 218: / Zeile 246: @@
 <code bash>
 ls -l /dev/serial/by-id/
 </code>
-In ''/etc/apcupsd/apcupsd.conf'' nur die Verbindung ändern (Gerätepfad anpassen):
+Beispiel:
+<code bash>
+DEVICE /dev/serial/by-id/usb-Prolific_Technology_Inc._USB-Serial_Controller_D-if00-port0
+</code>
+In ''/etc/apcupsd/apcupsd.conf''  nur die Verbindung ändern (Gerätepfad anpassen):
 <code>
 UPSCABLE smart
 UPSTYPE modbus
 DEVICE /dev/serial/by-id/usb-DEIN_ADAPTER
 </code>
@@ Zeile 231: / Zeile 270: @@
 sudo systemctl restart apcupsd
 apcaccess status | grep -E '^(DATE|STATUS|END APC)'
 </code>
-**Port 3551, Home-Assistant-Integration und Watchdog bleiben gleich.** Die serielle Variante muss nach dem Umbau noch praktisch getestet werden.
+**Port 3551, Home-Assistant-Integration und Watchdog bleiben gleich.**  Die serielle Variante muss nach dem Umbau noch praktisch getestet werden.
-===== 7. Fehlersuche =====
+----
+===== 6. Fehlersuche =====
 <code bash>
@@ Zeile 242: / Zeile 287: @@
 sudo journalctl -u apcupsd -n 40 --no-pager
 sudo journalctl -t apcupsd-watchdog -n 30 --no-pager
+sudo  journalctl -u apcupsd --since "today"
 </code>
-  * ''DATE'' alt, ''END APC'' aktuell: USB-Modbus-Daten eingefroren.
+  * ''DATE''  alt, ''END APC''  aktuell: USB-Modbus-Daten eingefroren.
-  * ''DATE'' aktuell, HA-Werte alt: Netzwerk oder HA-Integration prüfen.
+  * ''DATE''  aktuell, HA-Werte alt: Netzwerk oder HA-Integration prüfen.
   * Im Test waren Pi-Unterspannung (''throttled=0x0'') und USB-Autosuspend (''power/control=on'') unauffällig.
+===== 7. Zusätzliche Netzwerk-Clients anbinden (Master/Slave-Betrieb) =====
+Wenn an der APC Smart-UPS 1500 mehrere Server oder Systeme (z. B. ein Proxmox-Server, ein PC oder ein zweites NAS) betrieben werden, müssen auch diese über einen Stromausfall informiert werden. Da das USB-Kabel physisch im Raspberry Pi (**Master**) steckt, können weitere Systeme als **Netzwerk-Clients (Slaves)**  eingerichtet werden. Diese lauschen über das Netzwerk dem Pi.
+Die Installation von ''apcupsd''  auf dem Ziel-Client erfolgt analog zu den Schritten 1 und 2. In der Konfigurationsdatei des Clients müssen jedoch die Netzwerk-Parameter angepasst werden.
+==== Schritt 1: Konfiguration auf dem Client-System anpassen ====
+Datei auf dem zusätzlichen Server öffnen:
+<code>
+sudo nano /etc/apcupsd/apcupsd.conf
+</code>
+Folgende Werte setzen und darauf achten, dass keine doppelten, aktiven Einträge in der Datei stehen bleiben (alte USB-Einträge mit ''#''  auskommentieren):
+<code ini>
+# Verbindungstyp auf Netzwerk (Ethernet) umstellen
+UPSCABLE ether
+UPSTYPE net
+# IP-Adresse und Port des Raspberry Pi (Masters) eintragen
+DEVICE 192.168.10.248:3551
+# Abfrage-Intervall zum Master (in Sekunden)
+POLLTIME 30
+# Erhöhte Sicherheits-Grenzwerte für den Client
+BATTERYLEVEL 20
+MINUTES 10
+</code>
+Dienst auf dem Client neu starten:
+<code>
+sudo systemctl restart apcupsd
+</code>
+==== Erklärung der Sicherheits-Grenzwerte (Wichtig!) ====
+Die Werte ''BATTERYLEVEL''  und ''MINUTES''  wurden auf dem Client bewusst **höher angesetzt**  als auf dem Raspberry Pi (Master):
+* **BATTERYLEVEL 20:**  Der Client fährt bereits bei **20 % Restkapazität**  kontrolliert herunter. * **MINUTES 10:**  Der Client fährt herunter, sobald die verbleibende Akkulaufzeit unter **10 Minuten**  fällt.
+**Der Kaskaden-Ablauf im Ernstfall:**  Durch diese Staffelung wird verhindert, dass der Raspberry Pi (Master) zeitgleich mit den Clients herunterfährt. Der Pi bleibt länger aktiv und stellt sicher, dass er die Abschalt-Befehle im Netzwerk erfolgreich an alle Clients senden kann. Erst wenn die Clients sicher ausgeschaltet sind und die USV weiter gegen die kritische 5-%-Marke sinkt, fährt sich der Pi als allerletztes Gerät im Rack herunter.
+^Parameter^Einstellung^Einfache Erklärung|
+|**UPSCABLE** |''ether'' |Sagt dem System, dass die USV nicht per Kupferdraht (USB), sondern virtuell über das Netzwerk-Kabel (Ethernet) erreichbar ist.|
+|**UPSTYPE** |''net'' |Stellt den Treiber in den Client-Modus. Das System sucht nicht nach physikalischer Hardware, sondern lauscht auf USV-Daten aus dem Netzwerk.|
+----
+Dokumentation bei Kolja [[:blackout_shutdown_doku_bei_kolja|Link]]
+----
 ===== Quellen und weiterführende Links =====
@@ Zeile 259: / Zeile 366: @@
   * [[https://www.se.com/de/de/product/AP940-0625A/|Schneider Electric – Serielles Kabel AP940-0625A]]
   * [[https://www.se.com/ph/en/faqs/FA156800/|Schneider Electric – Warnung vor falschen seriellen Kabeln]]
 ===== Bilder =====
-{{ :home_assistant:apc_ha_integration.jpeg?direct&600 |}}
+{{  :home_assistant:apc_ha_integration.jpeg?direct&600  |ASCII���Screenshot}}
-{{:home_assistant:apc_ha_sensoren.jpeg?direct&400 |}}
+{{:home_assistant:apc_ha_sensoren.jpeg?direct&400  |ASCII���Screenshot}}
-{{:home_assistant:apc_ha_diagnose.jpeg?direct&400 |}}
+{{:home_assistant:apc_ha_diagnose.jpeg?direct&400  |ASCII���Screenshot}}

Werkzeuge

Navigationsmenüs und Suche

Wikiübergreifende Schnellsuche

Seitenstatus

Standortanzeiger

Seiten-Werkzeuge

Metainformationen zur Seite

Unterschiede