EG4 Web Monitor voor Home Assistant (Marketplace-integratie)

Installaties: 279 die analysegegevens delen
GitHub-sterren: 85
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v3.5.0, 25 oktober 2026
Categorie: Energie, Zonne-energie en batterijen
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: eg4_web_monitor
Bron: github.com/joyfulhouse/eg4_web_monitor
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Screenshots Uit de README van joyfulhouse/eg4_web_monitor.

Over dit item

EG4 Web Monitor verbindt EG4- en Luxpower-omvormers, GridBOSS-units en accu's met Home Assistant. Het kan gegevens lokaal uitlezen via Modbus TCP, een WiFi-dongle of USB/RS485-serieel, via de cloud-API, of in een hybride modus die beide combineert. In de hybride modus worden lokale gegevens aangevuld met functies die alleen in de cloud beschikbaar zijn, zoals synchronisatie van de zomertijd, en schrijfopdrachten voor bediening vallen terug op de cloud als de lokale verbinding uitvalt. Het biedt sensoren voor vermogen, spanning, stroomsterkte, frequentie, accustatus en meer, plus bediening voor snel laden, accureserve, bedrijfsmodus, laadschema's en SOC-limieten. Opties voor gegevensvalidatie beschermen tegen beschadigde lokale registerwaarden, en een actie haalt het gebeurtenislogboek van het portaal op voor storingen en waarschuwingen. De installatie gebeurt in de UI en de pollinginterval kan in de opties worden aangepast.

Automatische samenvatting van de README en de code van joyfulhouse/eg4_web_monitor, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Cloud API-inloggegevens

Gebruikersnaam
Wachtwoord
Basis-URL
SSL-certificaat verifiërenSSL-certificaatverificatie inschakelen voor beveiligde verbindingen
Zomertijd-synchronisatieZomertijdinstellingen automatisch synchroniseren met uw omvormer op basis van uw Home Assistant-tijdzone

Selecteer station

Station/InstallatieSelecteer de zonne-installatie die u wilt monitoren

Netwerkscan-instellingen

IP-bereik (CIDR)Netwerkbereik in CIDR-notatie (bijv. 192.168.1.0/24). Automatisch gedetecteerd vanuit uw Home Assistant-netwerk.
Scannen naar Modbus TCP (poort 502)
Scannen naar WiFi-dongles (poort 8000)
Verbindingstimeout (seconden)Wachttijd per apparaat. Lager = snellere scan, hoger = betrouwbaarder.

Stap 4

Selecteer apparaat

Verbinden via Modbus TCP

Gateway IP-adresIP-adres van uw RS485-naar-Ethernet adapter (bijv. 192.168.1.100)
PoortTCP-poort (standaard: 502)
Unit-IDModbus slave-ID (standaard: 1)

Verbinden via WiFi Dongle

Dongle IP-adresIP-adres van uw WiFi-dongle op uw lokale netwerk
Dongle-serienummer10-teken dongle-serienummer (BJ/BA voor omvormers, DJ voor GridBOSS)
Omvormer-serienummer10-teken serienummer van het apparaat-typeplaatje (vereist voor authenticatie)
PoortTCP-poort (standaard: 8000)

Verbinden via USB Serieel

Seriële poortSelecteer uw USB seriële adapter of voer handmatig in
BaudrateCommunicatiesnelheid (standaard: 19200)
PariteitPariteitsbitinstelling (standaard: Geen)
StopbitsAantal stopbits (standaard: 1)
Unit-IDModbus slave-ID (standaard: 1)

Serieel poortpad invoeren

Serieel poortpadbijv. /dev/ttyUSB0 (Linux), COM1 (Windows), /dev/tty.usbserial-* (macOS)

Na het instellen

Sensorupdate-interval (seconden)
Modbus update-interval (seconden)
WiFi Dongle update-interval (seconden)
HTTP/cloud-polling interval (seconden)
Parameterverversingsinterval (minuten)
Bibliotheek-debuglogboekregistratieDEBUG-logboekregistratie inschakelen voor de pylxpweb-bibliotheek (toont API-verzoeken, -antwoorden en interne bibliotheekoperaties)
Registerdata ValidatieCorruptiedetectie voor lokale registerlezingen inschakelen. Valideert fysieke grenzen (SoC, frequentie, smartpoortstatus) en energiemonotoniteit. Alleen inschakelen bij instabiele registerlezingen (spookentiteiten, energiepieken, ongeldige waarden).
Modbus-leesblokgrootteHoeveel registers per Modbus-verzoek worden gelezen bij lokale polling. Conservatief gebruikt kleine gegroepeerde uitlezingen die elke dongle en firmware ondersteunt. Snel leest tot 120 registers tegelijk voor snellere polling, maar oudere dongle-firmware ondersteunt alleen uitlezingen van ~40 registers — mislukt een grote uitlezing, dan valt de integratie automatisch (met een waarschuwing) terug op Conservatief tot de volgende herlaadbeurt.
AC-gekoppelde PV opnemen in totalenAC-gekoppeld zonne-invertervermogen (van GridBOSS Smart Ports) toevoegen aan de PV-totalen van de parallelle groep
BatterijlaadbesturingHoe uw batterij bepaalt wanneer het laden STOPT: SOC (gesloten lus, lithium met BMS) of Spanning (open lus, loodzuur / zonder BMS). De niet-geselecteerde limietbedieningen zijn standaard verborgen. ⚠️ Wijzigen herconfigureert ook uw omvormer.
BatterijontlaadbesturingHoe uw batterij bepaalt wanneer het ontladen STOPT: SOC (gesloten lus, lithium met BMS) of Spanning (open lus, loodzuur / zonder BMS). De niet-geselecteerde afschakelbedieningen zijn standaard verborgen. ⚠️ Wijzigen herconfigureert ook uw omvormer.
Pollinginterval (seconden)

Teksten uit de code van joyfulhouse/eg4_web_monitor. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenDongle-connectiviteit, Off-grid, AC-laadschema actief, AC First-schema actief
KnoppenGegevens vernieuwen, AC-laadschema wissen, AC First-schema wissen
NummersSysteem laad-SOC-limiet, AC-laadvermogen, PV-laadvermogen, PV startspanning, AC-laad-SOC-limiet, AC-koppeling start-SOC, AC-koppeling eind-SOC, Snel laden duur, SOC-uitschakeling, Terugleververmogen, Netpiekafvlakking vermogen 2, Netpiekafvlakking SOC 1 en nog 10
SelectiesBedrijfsmodus, PV invoermodus
SensorenAC-vermogen, AC-spanning, AC-stroom, Frequentie, DC-vermogen, DC-spanning, DC-stroom, Batterijvermogen, Batterijspanning, Batterijstroom, Laadtoestand, Gezondheidstoestand en nog 75
SchakelaarsSnel laden, Batterij-backup (EPS), Off-grid modus, Snelle nul-export, Batterij delen, AC-koppeling, Net altijd aan, Slimme belasting
TijdenStarttijd AC-laden 1, Eindtijd AC-laden 1, Starttijd AC-laden 2, Eindtijd AC-laden 2, Starttijd AC-laden 3, Eindtijd AC-laden 3, Starttijd AC First 1, Eindtijd AC First 1, Starttijd AC First 2, Eindtijd AC First 2, Starttijd AC First 3, Eindtijd AC First 3 en nog 26

Acties

Gegevens vernieuwenVelden: Configuratie-invoer-ID
Energiegeschiedenis afstemmenVelden: Terugkijkuren, Startdatum, Einddatum, Configuratie-invoer-ID
Historische gegevens importerenVelden: Configuratie-item, Startdatum, Einddatum, Proefrun
Gebeurtenissen ophalenHaalt het recente gebeurtenissenlogboek van het portaal op (storingen, waarschuwingen, meldingen) voor één apparaat of alle omvormers/GridBOSS-apparaten van een configuratie-item en geeft dit terug als responsgegevens. Sommige gebeurtenissen bestaan alleen in het gebeurtenissenlogboek van het portaal en vullen zo de op registers gebaseerde storings-/waarschuwingssensoren aan. Vereist cloudreferenties (HTTP- of hybride verbindingsmodus).Velden: Configuratie-item, Serienummer van apparaat, Aantal gebeurtenissen

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Datavalidatie aanbevolen voor WiFi dongle, Duplicate cloud configuration could not be migrated

Uit de 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.

Uit de README van joyfulhouse/eg4_web_monitor, MIT License. Ingekort.