Home Assistant integration for Epever solar charge controllers via Modbus TCP (WiFi dongle).
- Real-time monitoring of PV (solar panel) voltage, current, and power
- Battery voltage, current, and power monitoring
- Load voltage, current, and power monitoring
- Device temperature monitoring
- Configurable via UI (config flow)
- Supports Modbus TCP communication over WiFi
- Open HACS in your Home Assistant instance
- Go to Integrations
- Click the three dots menu (⋮) in the top right corner
- Select Custom repositories
- Enter the following:
- Repository:
https://github.com/zuzkins/ha-epever - Category:
Integration
- Repository:
- Click Add
- The integration will appear in HACS
- Click Download to install it
- Restart Home Assistant
- Download the latest release from the releases page
- Extract the
zepeverfolder - Copy the
zepeverfolder to yourcustom_componentsdirectory in your Home Assistant configuration directory - Restart Home Assistant
- Go to Settings → Devices & Services
- Click Add Integration
- Search for Epever
- Enter the following information:
- Device Name: A human-friendly name for your device
- Device Address: The hostname or IP address of the WiFi dongle (e.g.,
192.168.1.100orepever.local) - Device Port: The TCP port for Modbus TCP communication (default:
9999)
- Click Submit
- Home Assistant 2024.1.0 or later
- Epever WiFi dongle connected to your charge controller
- Network connectivity between Home Assistant and the WiFi dongle
- Python package:
pymodbus==3.11.2(installed automatically)
- PV Voltage - Solar panel voltage
- PV Current - Solar panel current
- PV Power - Solar panel power output
- Battery Voltage - Battery voltage
- Battery Current - Battery current (positive = charging, negative = discharging)
- Battery Power - Battery power
- Load Voltage - Load output voltage
- Load Current - Load output current
- Load Power - Load power consumption
- Device Temperature - Charge controller temperature
- Integration not found: Make sure you've restarted Home Assistant after installation
- Connection errors: Verify the device address (IP or hostname) and port are correct. Ensure the WiFi dongle is accessible from your Home Assistant instance
- No data: Check that your device address and port match your WiFi dongle configuration. Try pinging the device address to verify network connectivity
This project is licensed under the MIT License.