A Home Assistant integration for EcoVolter II EV chargers that enables you to locally control basic charging functions such as turning charging on and off, setting target current, and monitoring whether your vehicle is plugged in or actively charging. It uses their API.
Only EcoVolter II (2nd generation) with local control is supported by this integration. If you have 1st generation with cloud API using iXmanager app, you can use iXmanager Integration.
I originally created this integration for my own use, but thought others might find it helpful as well. Enjoy! :-)
- Make sure you have HACS installed in your Home Assistant instance
- Add this repository as a custom repository in HACS:
- Go to HACS → Settings → Repositories
- Click the "+" button
- Add repository:
samuelg0rd0n/ha-ecovolter-integration - Category: Integration
- Search for "EcoVolter" in HACS → Integrations
- Click "Download" and then "Restart Home Assistant"
- Add the integration via Settings → Devices & Services → Add Integration → Search for "EcoVolter"
- Download or clone this repository
- Copy the
custom_components/ecovolterfolder to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Add the integration via Settings → Devices & Services → Add Integration → Search for "EcoVolter"
- In Home Assistant, go to Settings → Devices & Services
- Click Add Integration
- Search for "EcoVolter" and select it
- Enter your EcoVolter charger's serial number. This can be found in the EV-Manager (iOS/Android app) or directly printed on the charger.
- Enter your charger's secret key. By default this is the same as your serial number. As of August 2025, EcoVolter says that the option to set secret key will be added to EV-Manager in the upcoming versions.
- If your network setup does not support mDNS, enter the charger URL.
- You can modify the default polling interval.
- Click Submit
- Charging Status – Indicates whether the charger is actively charging your vehicle
- Vehicle Connected – Detects if a vehicle is plugged into the charger
- Boost Mode Available – Shows if boost-mode charging is currently available
- Boost Mode Active – Displays whether boost-mode charging is currently active
- 3-Phase Mode Available – Shows if 3-phase charging is available at the connected socket
- 3-Phase Mode Active – Indicates whether 3-phase charging is currently in use
- Charging Schedule Active – Signals whether a charging schedule (calendar) is controlling the charger
- Charging Enabled – Enables or disables charging entirely
- 3-Phase Mode Control – Switch between single-phase and three-phase charging
- Boost Mode Enabled – Activates or deactivates boost mode
- Local Panel Enabled – Enables or disables local panel (on-device) control
- Target Current – Desired charging current (6–16 A)
- Boost Current – Charging current during boost period (6–16 A)
- Maximum Current – Upper limit for target and boost current (6–16 A)
- Boost Time – Duration of the boost-current period, in seconds (up to 24 h)
- Energy Price – Configurable price per kWh, used for calculating charging cost
- Currency – Selects the currency used for cost calculations
- Actual Power – Real-time charging power (kW)
- Charged Energy – Energy delivered during the current session (kWh)
- Charging Cost – Calculated session cost in the selected currency
- Charging Time – Elapsed time of the current charging session (seconds)
- Remaining Boost Time – Remaining duration of the active boost period (seconds)
- Current (L1–L3) – Measured current on each phase (A)
- Voltage (L1–L3) – Voltage on each phase (V)
- Temperature Current Limit – Current limit imposed by thermal protection (A)
- Adapter Max Current – Maximum current allowed by the connected adapter (A)
Temperatures (diagnostic): (°C)
- Internal Temperature
- Adapter Temperatures (1–3)
- Relay Temperatures (1–2)
- Charging Power (Max) — Reported maximum charging power (kW)
- Total Charged Energy — Lifetime energy delivered (kWh)
- Total Charging Time — Lifetime charging time (seconds)
- Total Charging Count — Lifetime number of charging sessions
- Charger Type — Hardware capability (3×16 A or 3×32 A)
- Charging Power (Max) — Reported maximum charging power (kW)
- Home Assistant 2023.8.0 or newer
- EcoVolter II (2nd generation) EV charger with network connectivity
- Base URL (with IP address or DNS record) unless you are using mDNS in your setup
- Integration not found: Make sure you've restarted Home Assistant after installation
- Connection failed: Verify your charger's serial number, URL and network connectivity
- Authentication error: Check your charger's secret key
If you encounter any issues or have questions, please:
- Check the troubleshooting section above
- Review the Home Assistant logs for error messages
- Open an issue on this repository with detailed information about your setup