EG4 Web Monitor für Home Assistant (Marketplace-Integration)

Installationen: 279 teilen Analysedaten
GitHub-Sterne: 85
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v3.5.0, 25. Oktober 2026
Kategorie: Energie, Solar und Batteriespeicher
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: eg4_web_monitor
Quelle: github.com/joyfulhouse/eg4_web_monitor
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von joyfulhouse/eg4_web_monitor.

Überblick

EG4 Web Monitor verbindet EG4- und Luxpower-Wechselrichter, GridBOSS-Einheiten und Batterien mit Home Assistant. Die Daten können lokal über Modbus TCP, einen WiFi-Dongle oder USB/RS485-Seriell gelesen werden, über die Cloud-API oder in einem Hybridmodus, der beides kombiniert. Im Hybridmodus werden die lokalen Daten um reine Cloud-Funktionen wie die Synchronisierung der Sommerzeit ergänzt, und Schreibzugriffe zur Steuerung greifen auf die Cloud zurück, wenn die lokale Verbindung unterbrochen ist. Es stellt Sensoren für Leistung, Spannung, Strom, Frequenz, Batteriezustand und mehr bereit, dazu Steuerungen für Schnellladung, Batterie-Backup, Betriebsmodus, Ladepläne und SOC-Grenzen. Optionen zur Datenvalidierung schützen vor fehlerhaft gelesenen lokalen Registern, und eine Aktion ruft das Ereignisprotokoll des Portals für Störungen und Warnungen ab. Die Einrichtung erfolgt in der Benutzeroberfläche, und die Abfrageintervalle können in den Optionen angepasst werden.

Zusammenfassung der README und des Codes von joyfulhouse/eg4_web_monitor, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Schalter
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Cloud API Zugangsdaten

Benutzername
Passwort
Basis-URL
SSL-Zertifikat überprüfenSSL-Zertifikatsprüfung für sichere Verbindungen aktivieren
Sommerzeit-SynchronisierungSommerzeit-Einstellungen automatisch basierend auf Ihrer Home Assistant Zeitzone mit dem Wechselrichter synchronisieren

Station auswählen

Station/AnlageWählen Sie die Solaranlage, die Sie überwachen möchten

Netzwerk-Scan Einstellungen

IP-Bereich (CIDR)Netzwerkbereich in CIDR-Notation (z.B. 192.168.1.0/24). Automatisch aus Ihrem Home Assistant-Netzwerk erkannt.
Nach Modbus TCP scannen (Port 502)
Nach WiFi-Dongles scannen (Port 8000)
Verbindungs-Timeout (Sekunden)Wartezeit für jedes Gerät. Niedriger = schnellerer Scan, höher = zuverlässiger.

Schritt 4

Gerät auswählen

Verbindung über Modbus TCP

Gateway IP-AdresseIP-Adresse Ihres RS485-zu-Ethernet-Adapters (z.B. 192.168.1.100)
PortTCP-Port (Standard: 502)
Geräte-IDModbus Slave-ID (Standard: 1)

Verbindung über WiFi Dongle

Dongle IP-AdresseIP-Adresse Ihres WiFi-Dongles in Ihrem lokalen Netzwerk
Dongle-Seriennummer10-stellige Dongle-Seriennummer (BJ/BA für Wechselrichter, DJ für GridBOSS)
Wechselrichter-Seriennummer10-stellige Seriennummer vom Gerätetypenschild (erforderlich für Authentifizierung)
PortTCP-Port (Standard: 8000)

Verbindung über USB Seriell

Serieller PortWählen Sie Ihren USB-Seriell-Adapter oder geben Sie ihn manuell ein
BaudrateKommunikationsgeschwindigkeit (Standard: 19200)
ParitätParitätsbit-Einstellung (Standard: Keine)
StoppbitsAnzahl der Stoppbits (Standard: 1)
Geräte-IDModbus Slave-ID (Standard: 1)

Seriellen Port-Pfad eingeben

Serieller Port-Pfadz.B. /dev/ttyUSB0 (Linux), COM1 (Windows), /dev/tty.usbserial-* (macOS)

Nach der Einrichtung

Sensor-Update-Intervall (Sekunden)
Modbus-Aktualisierungsintervall (Sekunden)
WiFi-Dongle-Aktualisierungsintervall (Sekunden)
HTTP/Cloud-Abfrageintervall (Sekunden)
Parameter-Aktualisierungsintervall (Minuten)
Bibliothek-Debug-ProtokollierungDEBUG-Protokollierung für die pylxpweb-Bibliothek aktivieren (zeigt API-Anfragen, Antworten und interne Bibliotheksoperationen)
Registerdaten-ValidierungKorruptionserkennung für lokale Registerlesevorgänge aktivieren. Prüft physikalische Grenzen (SoC, Frequenz, Smart-Port-Status) und Energie-Monotonie. Nur aktivieren bei instabilen Registerlesevorgängen (Geister-Entitäten, Energiespitzen, ungültige Werte).
Modbus-LeseblockgrößeWie viele Register pro Modbus-Anfrage beim lokalen Abruf gelesen werden. Konservativ verwendet kleine Gruppenlesungen, die jeder Dongle und jede Firmware unterstützt. Schnell liest bis zu 120 Register auf einmal für schnellere Abfragen, aber ältere Dongle-Firmware unterstützt nur Lesungen von ~40 Registern — schlägt eine große Lesung fehl, fällt die Integration automatisch (mit einer Warnung) auf Konservativ zurück, bis zum nächsten Neuladen.
AC-gekoppelte PV in Gesamtwerte einbeziehenAC-gekoppelte Solar-Wechselrichterleistung (von GridBOSS Smart Ports) zu den PV-Gesamtwerten der Parallelgruppe hinzufügen
Batterie-LadesteuerungWie Ihre Batterie entscheidet, wann das Laden GESTOPPT wird: SOC (geschlossener Regelkreis, BMS-Lithium) oder Spannung (offener Regelkreis, Blei-Säure / ohne BMS). Die nicht ausgewählten Grenzwert-Steuerelemente sind standardmäßig ausgeblendet. ⚠️ Eine Änderung konfiguriert auch Ihren Wechselrichter um.
Batterie-EntladesteuerungWie Ihre Batterie entscheidet, wann das Entladen GESTOPPT wird: SOC (geschlossener Regelkreis, BMS-Lithium) oder Spannung (offener Regelkreis, Blei-Säure / ohne BMS). Die nicht ausgewählten Abschalt-Steuerelemente sind standardmäßig ausgeblendet. ⚠️ Eine Änderung konfiguriert auch Ihren Wechselrichter um.
Abfrageintervall (Sekunden)

Texte aus dem Code von joyfulhouse/eg4_web_monitor. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenDongle-Verbindung, Inselbetrieb, AC-Ladeplan aktiv, AC-First-Zeitplan aktiv
TastenDaten aktualisieren, AC-Ladeplan löschen, AC-First-Zeitplan löschen
ZahlenSystem-Lade-SOC-Grenzwert, AC-Ladeleistung, PV-Ladeleistung, PV-Startspannung, AC-Lade-SOC-Grenzwert, AC-Kopplung Start-SOC, AC-Kopplung End-SOC, Schnellladedauer, SOC-Abschaltgrenze, Netzeinspeiseleistung, Netz-Lastspitzenkappung Leistung 2, Netz-Lastspitzenkappung SOC 1 und 10 weitere
AuswahlfelderBetriebsmodus, PV-Eingangsmodus
SensorenAC-Leistung, AC-Spannung, AC-Strom, Frequenz, DC-Leistung, DC-Spannung, DC-Strom, Batterieleistung, Batteriespannung, Batteriestrom, Ladezustand, Zustandsbewertung und 75 weitere
SchalterSchnellladung, Batterie-Backup (EPS), Inselbetrieb, Schneller Null-Export, Batterie teilen, AC-Kopplung, Netz immer an, Intelligente Last
UhrzeitenAC-Ladestartzeit 1, AC-Ladeendzeit 1, AC-Ladestartzeit 2, AC-Ladeendzeit 2, AC-Ladestartzeit 3, AC-Ladeendzeit 3, AC-First-Startzeit 1, AC-First-Endzeit 1, AC-First-Startzeit 2, AC-First-Endzeit 2, AC-First-Startzeit 3, AC-First-Endzeit 3 und 26 weitere

Aktionen

Daten aktualisierenFelder: Konfigurationseintrags-ID
Energieverlauf abgleichenFelder: Rückblick (Stunden), Startdatum, Enddatum, Konfigurationseintrags-ID
Historische Daten importierenFelder: Konfigurationseintrag, Startdatum, Enddatum, Testlauf
Ereignisse abrufenRuft das aktuelle Portal-Ereignisprotokoll (Fehler, Warnungen, Hinweise) für ein Gerät oder alle Wechselrichter/GridBOSS-Geräte eines Konfigurationseintrags ab und gibt es als Antwortdaten zurück. Einige Ereignisse existieren nur im Ereignisprotokoll des Portals und ergänzen so die registerbasierten Fehler-/Warnungssensoren. Erfordert Cloud-Zugangsdaten (HTTP- oder Hybrid-Verbindungsmodus).Felder: Konfigurationseintrag, Geräteseriennummer, Anzahl der Ereignisse

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Datenvalidierung empfohlen für WiFi dongle, Duplicate cloud configuration could not be migrated

Aus der README

Monitor and control EG4 solar inverters, GridBOSS, and batteries in Home Assistant over local Modbus, WiFi dongle, serial, cloud API, or hybrid connectivity.
Local & cloud connectivity: Modbus TCP, WiFi dongle, USB/RS485 serial, cloud API, or hybrid mode.
Broad device support: FlexBOSS21, FlexBOSS18, 18kPV, 12kPV, XP inverters, LXP-EU (three-phase), LXP-LB-BR (Brazil 10kW), GridBOSS, and individual batteries.
Real-time monitoring: power, voltage, current, temperature, frequency, and energy statistics with split-phase per-leg detail.
Fast local polling: 5-second updates over Modbus TCP or serial (30 seconds over the WiFi dongle, whose reads are slower) — no internet dependency.
Hybrid mode: enrich local data with cloud-only features such as DST auto-sync, and fall back to the cloud for control writes when the local link is down.
Data integrity: WiFi dongle cross-request validation, canary checks, and energy monotonicity guards protect against corrupt readings.
Control & automation: quick charge, battery backup (EPS), operating modes, SOC limits, charge/discharge currents, and GridBOSS smart port configuration.
BMS diagnostics: bank-level cell voltage, temperature, current limits, and cycle count — always available, no CAN bus needed.
Battery tracking: round-robin battery cache with per-battery last-seen timestamps for systems with more than four batteries.
Multi-station support: monitor multiple solar installations from one account.

Aus der README von joyfulhouse/eg4_web_monitor, MIT License. Gekürzt.