EG4 Web Monitor
joyfulhouse
Ouvrir dans Home Assistant
Sur Home Assistant 2026.11 ou une version ultérieure ? L’ouvrir dans la Marketplace
- Installations
- 279 partagent leurs statistiques
- Étoiles GitHub
- 85
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v3.5.0,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
eg4_web_monitor- Problèmes
- Signaler un problème
Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.
Captures d’écran Extraites du README de joyfulhouse/eg4_web_monitor.
À propos
EG4 Web Monitor connecte les onduleurs EG4 et Luxpower, les unités GridBOSS et les batteries à Home Assistant. Il peut lire les données en local via Modbus TCP, un dongle WiFi ou une liaison série USB/RS485, via l'API cloud, ou dans un mode hybride qui combine les deux. En mode hybride, les données locales sont enrichies par des fonctions réservées au cloud, comme la synchronisation de l'heure d'été, et les écritures de commande basculent vers le cloud lorsque la liaison locale est coupée. Il fournit des capteurs pour la puissance, la tension, le courant, la fréquence, l'état de la batterie et plus encore, ainsi que des commandes pour la charge rapide, le secours sur batterie, le mode de fonctionnement, les plages de charge et les limites de SOC. Des options de validation des données protègent contre les lectures corrompues des registres locaux, et une action récupère le journal des événements du portail pour les défauts et les avertissements. La configuration se fait dans l'interface, et les intervalles d'interrogation peuvent être ajustés dans les options.
Résumé automatique du README et du code de joyfulhouse/eg4_web_monitor, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Identifiants de l'API cloud
- Nom d'utilisateur
- Mot de passe
- URL de base
- Verifier le certificat SSLActiver la verification du certificat SSL pour des connexions securisees
- Synchronisation de l'heure d'eteSynchroniser automatiquement les parametres d'heure d'ete de votre onduleur en fonction du fuseau horaire de Home Assistant
Selectionner une station
- Station/InstallationSelectionnez l'installation solaire que vous souhaitez surveiller
Parametres de scan reseau
- Plage IP (CIDR)Plage reseau en notation CIDR (ex. : 192.168.1.0/24). Detectee automatiquement depuis votre reseau Home Assistant.
- Scanner Modbus TCP (port 502)
- Scanner les dongles WiFi (port 8000)
- Delai de connexion (secondes)Temps d'attente pour la reponse de chaque appareil. Plus bas = scan plus rapide, plus haut = plus fiable.
Étape 4
- Selectionner un appareil
Connexion via Modbus TCP
- Adresse IP de la passerelleAdresse IP de votre adaptateur RS485-vers-Ethernet (ex. : 192.168.1.100)
- PortPort TCP (par defaut : 502)
- ID d'uniteID esclave Modbus (par defaut : 1)
Connexion via dongle WiFi
- Adresse IP du dongleAdresse IP de votre dongle WiFi sur votre reseau local
- Numero de serie du dongleNumero de serie du dongle a 10 caracteres (BJ/BA pour onduleurs, DJ pour GridBOSS)
- Numero de serie de l'onduleurNumero de serie a 10 caracteres sur la plaque signaletique de l'appareil (requis pour l'authentification)
- PortPort TCP (par defaut : 8000)
Connexion via USB Serie
- Port serieSelectionnez votre adaptateur serie USB ou entrez manuellement
- Debit en baudsVitesse de communication (par defaut : 19200)
- PariteParametre du bit de parite (par defaut : Aucun)
- Bits d'arretNombre de bits d'arret (par defaut : 1)
- ID d'uniteID esclave Modbus (par defaut : 1)
Entrer le chemin du port serie
- Chemin du port serieex. : /dev/ttyUSB0 (Linux), COM1 (Windows), /dev/tty.usbserial-* (macOS)
Après la mise en place
- Intervalle de mise a jour des capteurs (secondes)
- Intervalle de mise a jour Modbus (secondes)
- Intervalle de mise a jour WiFi Dongle (secondes)
- Intervalle d'interrogation HTTP/cloud (secondes)
- Intervalle d'actualisation des parametres (minutes)
- Journalisation de debogage de la bibliothequeActiver la journalisation DEBUG pour la bibliotheque pylxpweb (affiche les requetes API, les reponses et les operations internes de la bibliotheque)
- Validation des Données de RegistreActiver la détection de corruption pour les lectures de registres locaux. Valide les limites physiques (SoC, fréquence, état des ports intelligents) et la monotonie énergétique. À activer uniquement en cas de lectures instables (entités fantômes, pics d'énergie, valeurs invalides).
- Taille de bloc de lecture ModbusNombre de registres lus par requête Modbus lors de l'interrogation locale. Conservateur utilise de petites lectures groupées prises en charge par tous les dongles et firmwares. Rapide lit jusqu'à 120 registres à la fois pour une interrogation plus rapide, mais les anciens firmwares de dongle ne prennent en charge que des lectures d'environ 40 registres — si une grande lecture échoue, l'intégration revient automatiquement à Conservateur (avec un avertissement) jusqu'au prochain rechargement.
- Inclure le PV couplé CA dans les totauxAjouter la puissance de l'onduleur solaire couplé CA (depuis les Smart Ports du GridBOSS) aux totaux PV du groupe parallèle
- Contrôle de charge de la batterieComment votre batterie décide d'ARRÊTER la charge : SOC (boucle fermée, lithium avec BMS) ou Tension (boucle ouverte, plomb-acide / sans BMS). Les commandes de limite non sélectionnées sont masquées par défaut. ⚠️ Modifier ce réglage reconfigure aussi votre onduleur.
- Contrôle de décharge de la batterieComment votre batterie décide d'ARRÊTER la décharge : SOC (boucle fermée, lithium avec BMS) ou Tension (boucle ouverte, plomb-acide / sans BMS). Les commandes de coupure non sélectionnées sont masquées par défaut. ⚠️ Modifier ce réglage reconfigure aussi votre onduleur.
- Intervalle d'interrogation (secondes)
Textes issus du code de joyfulhouse/eg4_web_monitor. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesConnectivite du dongle, Hors réseau, Programmation de charge AC active, Programmation AC First active
- BoutonsActualiser les donnees, Effacer la programmation de charge AC, Effacer la programmation AC First
- NombresLimite SOC de charge systeme, Puissance de charge AC, Puissance de charge PV, Tension de demarrage PV, Limite SOC de charge AC, SOC de début de couplage AC, SOC de fin de couplage AC, Durée de charge rapide, Coupure SOC, Puissance de revente au réseau, Puissance d'écrêtage réseau 2, SOC d'écrêtage réseau 1 et 10 autres
- SélecteursMode de fonctionnement, Mode d'entree PV
- CapteursPuissance AC, Tension AC, Courant AC, Frequence, Puissance DC, Tension DC, Courant DC, Puissance batterie, Tension batterie, Courant batterie, Etat de charge, Etat de sante et 75 autres
- InterrupteursCharge rapide, Secours batterie (EPS), Mode hors reseau, Export zéro rapide, Partage de batterie, Couplage AC, Réseau toujours actif, Charge intelligente
- HeuresHeure de début de charge AC 1, Heure de fin de charge AC 1, Heure de début de charge AC 2, Heure de fin de charge AC 2, Heure de début de charge AC 3, Heure de fin de charge AC 3, Heure de début AC First 1, Heure de fin AC First 1, Heure de début AC First 2, Heure de fin AC First 2, Heure de début AC First 3, Heure de fin AC First 3 et 26 autres
Actions
- Actualiser les donneesChamps : ID de l'entree de configuration
- Réconcilier l'historique énergétiqueChamps : Heures de rétrospective, Date de début, Date de fin, ID d'entrée de configuration
- Importer les données historiquesChamps : Entrée de configuration, Date de début, Date de fin, Simulation
- Récupérer les événementsRécupère le journal d'événements récent du portail (défauts, avertissements, notifications) pour un appareil ou pour tous les onduleurs/GridBOSS d'une entrée de configuration, et le renvoie comme données de réponse. Certains événements n'existent que dans le journal d'événements du portail ; ce service complète donc les capteurs de défaut/avertissement basés sur les registres. Nécessite des identifiants cloud (mode de connexion HTTP ou hybride).Champs : Entrée de configuration, Numéro de série de l'appareil, Nombre d'événements
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Validation des données recommandée pour WiFi dongle, Duplicate cloud configuration could not be migrated
Extrait du 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.
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 279 partagent leurs statistiques
- Étoiles GitHub
- 85
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v3.5.0,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
eg4_web_monitor- Problèmes
- Signaler un problème
