This Home Assistant integration allows you to monitor and control your APsystems EZHI inverter via the local API. It provides sensors for real-time data and controls for power settings.
- Monitor PV Power & Energy: Track photovoltaic power generation and total energy production.
- Battery Monitoring: View battery state, charge/discharge rates, and temperature.
- Grid Interaction: Monitor power flow to and from the grid.
- Power Control: Set the maximum power output of your inverter.
Before installing this integration, you need to:
- Ensure your APsystems EZHI inverter is connected to your local network
- Activate local mode on the inverter through the APsystems app
- Set a static IP address for the inverter in your router (recommended)
- Add this repository as a custom repository in HACS
- Install the integration from HACS
- Restart Home Assistant
- Add the integration through the Home Assistant UI (Settings > Devices & Services)
- Download the latest release
- Extract the
apsystems_ezhi_local
folder to yourcustom_components
directory - Restart Home Assistant
- Add the integration through the Home Assistant UI
- Go to Settings > Devices & Services
- Click "Add Integration" in the bottom right
- Search for "APsystems EZHI Local API" and click on it
- Enter the inverter's IP address and name
- Click "Submit"
- Photovoltaic Power: Current power generation from solar panels (W)
- Photovoltaic Energy: Total energy generation from solar panels (kWh)
- Battery Power: Current battery charge/discharge rate (W)
- Battery State of Charge: Current battery charge percentage (%)
- Battery State of Health: Battery health percentage (%)
- Battery Temperature: Battery temperature (°C)
- Battery Total Charge Energy: Total energy charged to the battery (kWh)
- Battery Total Discharge Energy: Total energy discharged from the battery (kWh)
- On-Grid Power: Current power flow to/from the grid (W)
- On-Grid Output Energy: Total energy output to the grid (kWh)
- On-Grid Input Energy: Total energy input from the grid (kWh)
- Off-Grid Power: Current power flow to/from off-grid loads (W)
- Off-Grid Output Energy: Total energy output to off-grid loads (kWh)
- Off-Grid Input Energy: Total energy input from off-grid sources (kWh)
- Device Temperature: Inverter temperature (°C)
- Max Output Power: Set the maximum power output of the inverter (W)
- Ensure the inverter is connected to your network
- Verify that local mode is enabled in the APsystems app
- Check that the IP address is correct
- Ensure the inverter is powered on and operating normally
This project is released under the MIT License.
This integration is based on the APsystems EZ1 API Home Assistant integration by Sonnenladen GmbH.