--- title: "EG4 Web Monitor" description: "EG4 Web Monitor is a Marketplace integration for Home Assistant. It has 279 installs sharing analytics, works locally and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/joyfulhouse-eg4-web-monitor" url: "https://vulpo.app/integrations/marketplace/joyfulhouse-eg4-web-monitor.md" last-updated: "2026-10-22" version: "1.4" --- # EG4 Web Monitor > EG4 Web Monitor is a Marketplace integration for Home Assistant. It has 279 installs sharing analytics, works locally and was last updated October 25, 2026. EG4 Web Monitor connects EG4 and Luxpower inverters, GridBOSS units and batteries to Home Assistant. It can read data locally over Modbus TCP, a WiFi dongle or USB/RS485 serial, through the cloud API, or in a hybrid mode that combines both. In hybrid mode, local data is enriched with cloud-only features such as daylight saving time sync, and control writes fall back to the cloud when the local link is down. It provides sensors for power, voltage, current, frequency, battery state and more, plus controls for quick charge, battery backup, operating mode, charge schedules and SOC limits. Data validation options guard against corrupt local register reads, and an action fetches the portal event log for faults and warnings. Setup is done in the UI, and polling intervals can be adjusted in the options. Automatic summary of the README and code of joyfulhouse/eg4\_web\_monitor. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=joyfulhouse&repository=eg4_web_monitor&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=joyfulhouse&repository=eg4_web_monitor&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Cloud API Credentials - **Username** - **Password** - **Base URL** - **Verify SSL Certificate**: Enable SSL certificate verification for secure connections - **DST Synchronization**: Automatically synchronize Daylight Saving Time settings to your inverter based on your Home Assistant timezone ### Select Station - **Station/Plant**: Select the solar installation you want to monitor ### Network Scan Settings - **IP Range (CIDR)**: Network range in CIDR notation (e.g., 192.168.1.0/24). Auto-detected from your Home Assistant network. - **Scan for Modbus TCP (port 502)** - **Scan for WiFi Dongles (port 8000)** - **Connection Timeout (seconds)**: How long to wait for each device to respond. Lower = faster scan, higher = more reliable. ### Network scan results - **Select Device** ### Connect via Modbus TCP - **Gateway IP Address**: IP address of your RS485-to-Ethernet adapter (e.g., 192.168.1.100) - **Port**: TCP port (default: 502) - **Unit ID**: Modbus slave ID (default: 1) ### Connect via WiFi Dongle - **Dongle IP Address**: IP address of your WiFi dongle on your local network - **Dongle Serial Number**: 10-character dongle serial (BJ/BA for inverters, DJ for GridBOSS) - **Inverter Serial Number**: 10-character serial from device nameplate (required for authentication) - **Port**: TCP port (default: 8000) ### Connect via USB Serial - **Serial Port**: Select your USB serial adapter or enter manually - **Baud Rate**: Communication speed (default: 19200) - **Parity**: Parity bit setting (default: None) - **Stop Bits**: Number of stop bits (default: 1) - **Unit ID**: Modbus slave ID (default: 1) ### Enter Serial Port Path - **Serial Port Path**: e.g., /dev/ttyUSB0 (Linux), COM1 (Windows), /dev/tty.usbserial-\* (macOS), or esphome://host:6053 for an ESPHome serial proxy ### After setup - **Sensor Update Interval (seconds)** - **Modbus Update Interval (seconds)** - **WiFi Dongle Update Interval (seconds)** - **HTTP/Cloud Polling Interval (seconds)** - **Parameter Refresh Interval (minutes)** - **Library Debug Logging**: Enable DEBUG logging for the pylxpweb library (shows API requests, responses, and internal library operations) - **Register Data Validation**: Enable corruption detection for local register reads. Validates physical bounds (SoC, frequency, smart port status) and energy monotonicity. Only enable if you experience unstable register reads (ghost entities, energy spikes, invalid values). - **Modbus Read Block Size**: How many registers to read per Modbus request when polling locally. Conservative uses small grouped reads that every dongle and firmware supports. Fast reads up to 120 registers at once for faster polling, but older dongle firmware only supports ~40-register reads — if a large read fails, the integration automatically falls back to Conservative (with a warning) until the next reload. - **Include AC-Coupled PV in Totals**: Add AC-coupled solar inverter power (from GridBOSS smart ports) to parallel group PV totals - **Battery Charge Control**: How your battery decides when to STOP charging: SOC (closed-loop, BMS lithium) or Voltage (open-loop, lead-acid / no BMS). The non-selected limit controls are hidden by default. ⚠️ Changing this also reconfigures your inverter. - **Battery Discharge Control**: How your battery decides when to STOP discharging: SOC (closed-loop, BMS lithium) or Voltage (open-loop, lead-acid / no BMS). The non-selected cutoff controls are hidden by default. ⚠️ Changing this also reconfigures your inverter. - **Polling interval (seconds)** Texts from the code of [joyfulhouse/eg4\_web\_monitor](https://github.com/joyfulhouse/eg4_web_monitor). ## Entities - **Binary sensors**: Dongle Connectivity, Off-Grid, AC Charge Schedule Active, AC First Schedule Active - **Buttons**: Refresh Data, Clear AC Charge Schedule, Clear AC First Schedule - **Numbers**: System Charge SOC Limit, AC Charge Power, PV Charge Power, PV Start Voltage, AC Charge SOC Limit, AC Couple Start SOC, AC Couple End SOC, Quick Charge Duration, SOC Cut-Off, Grid Sell Back Power, Grid Peak Shaving Power 2, Grid Peak Shaving SOC 1, and 10 more - **Selects**: Operating Mode, PV Input Mode - **Sensors**: AC Power, AC Voltage, AC Current, Frequency, DC Power, DC Voltage, DC Current, Battery Power, Battery Voltage, Battery Current, State of Charge, State of Health, and 75 more - **Switches**: Quick Charge, Battery Backup (EPS), Off Grid Mode, Fast Zero Export, Share Battery, AC Couple, Grid Always On, Smart Load - **Times**: AC Charge Start Time 1, AC Charge End Time 1, AC Charge Start Time 2, AC Charge End Time 2, AC Charge Start Time 3, AC Charge End Time 3, AC First Start Time 1, AC First End Time 1, AC First Start Time 2, AC First End Time 2, AC First Start Time 3, AC First End Time 3, and 26 more ## Actions - **Refresh Data** Fields: Configuration Entry ID - **Reconcile Energy History** Fields: Lookback Hours, Start Date, End Date, Configuration Entry ID - **Import Historical Data** Fields: Config Entry, Start Date, End Date, Dry Run - **Fetch Events**: Fetch the recent portal event log (faults, warnings, notices) for one device or every inverter/GridBOSS in a configuration entry, and return it as response data. Some events exist only in the portal's event log, so this complements the register-backed fault/warning sensors. Requires cloud credentials (HTTP or Hybrid connection mode). Fields: Config Entry, Device Serial, Event Count ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Data validation recommended for WiFi dongle, Duplicate cloud configuration could not be migrated ## From the 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. From the README of [joyfulhouse/eg4\_web\_monitor](https://github.com/joyfulhouse/eg4_web_monitor#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Number: 279 installs sharing analytics; 85 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v3.5.0, last updated October 25, 2026 - Domain: `eg4_web_monitor` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/b80cecb64a5b1a6b.webp (from joyfulhouse/eg4\_web\_monitor's README) - Screenshot: https://vulpo.app/integrations-img/0479d2ddafbc31a8.webp (from joyfulhouse/eg4\_web\_monitor's README) In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/joyfulhouse-eg4-web-monitor --- - HTML version of this page: https://vulpo.app/integrations/marketplace/joyfulhouse-eg4-web-monitor - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml