Home Assistant integration for Alfen Eve NG9xx and AHP series EV chargers via Modbus TCP.
- 🔌 Real-time monitoring - Voltage, current, power, energy for all phases
- 🚗 Car status detection - Connected, charging, disconnected states
- ⚡ Load balancing control - Set maximum charging current dynamically
- 🛡️ Max current protection - Prevents setting current above station limit
- 📊 Session tracking - Energy consumed and duration per charging session
- 🔄 Auto-renew max current - Prevents timeout to safe current mode
- 🏢 Multi-socket support - Works with dual socket chargers
- 🌐 SCN support - Smart Charging Network: per-phase consumption, actual/max/safe current and enable state, with a control to set the max current per phase
- 🗣️ Localized UI - Entity names and states are translated into English, Dutch, German, French, Finnish, Norwegian, Swedish and Danish, following your Home Assistant language setting
- 🩺 Diagnostics - Download a redacted diagnostics report from Settings → Devices & Services for bug reports
- 🚑 Repair notifications - Flags known issues (e.g. outdated NG9xx firmware) directly in Settings → Repairs
- Home Assistant 2025.10.0 or newer
- A supported Alfen charger (see Supported Platforms) with:
- The minimum firmware version for your platform
- Active Load Balancing license enabled
- Modbus TCP enabled on the charger
| Platform | Minimum firmware | Notes |
|---|---|---|
| Eve NG9xx | 4.2.0 (adds Modbus TCP support); 6.4.0+ recommended | Fixes a power budget reset bug — see Known Issues |
| AHP (e.g. AHP02-60227) | 2.6.0 (release notes) — currently the latest AHP firmware | Requires integration v0.2.1+; earlier versions fail every poll cycle because AHP rejects Modbus reads that don't align to register value boundaries (#40) |
- Open HACS in Home Assistant
- Search for "Alfen Modbus"
- Click Install
- Restart Home Assistant
- Copy
custom_components/alfen_modbusto yourconfig/custom_components/folder - Restart Home Assistant
- Go to Settings → Devices & Services
- Click Add Integration
- Search for Alfen Modbus
- Enter your charger's IP address and port (default: 502)
Entity names and on/off states follow the language set in your Home Assistant profile. Currently translated: 🇬🇧 English, 🇳🇱 Dutch, 🇩🇪 German, 🇫🇷 French, 🇫🇮 Finnish, 🇳🇴 Norwegian, 🇸🇪 Swedish and 🇩🇰 Danish. Any other language falls back to English.
Per-socket entities (voltages, currents, power, energy, ...) only show a socket number in the name (e.g. "Socket 2 voltage L1-N") when Read Socket 2 is enabled; single-socket setups get a plain name instead.
Missing your language or spotted an incorrect translation? Pull requests adding or fixing a custom_components/alfen_modbus/translations/<lang>.json file are very welcome.
- Acquire the Active Load Balancing license from Alfen
- Enable Active Load Balancing via the Alfen Service Installer app
- Set Data Source to "Energy Management System" for slave mode
See the Alfen Smart Charging Manual for details.
| Category | Sensors |
|---|---|
| Device | Name, Manufacturer, Serial, Firmware, Platform |
| Station | Max Current, Temperature, Backoffice Connection |
| Socket | Voltages (L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1) |
| Currents (L1, L2, L3, N, Sum) | |
| Power (Real, Apparent, Reactive per phase + Sum) | |
| Energy (Delivered, Consumed per phase + Sum) | |
| Mode 3 State, Availability, Charging Phases | |
| Derived | Car Connected, Car Charging, Charger Enabled, Session Wh, Session Duration |
| SCN (if enabled) | Total Consumption, Actual Max Current and Safe Current per phase, Max Current Enabled |
| Control | Description |
|---|---|
| Max Current | Set the maximum charging current (load balancing) |
| Phase Mode | Select 1-phase ("1") or 3-phase ("3") charging |
| Charger Enabled | Switch that stops (0 A) or resumes (allowed max current) charging via the max-current setpoint |
| SCN Max Current per phase (if enabled) | Set the maximum current for the Smart Charging Network as a whole, per phase |
EVCC's generic Home Assistant charger lets you map its fields directly to entities from this integration. See docs/evcc.md for a step-by-step walkthrough of EVCC's configuration wizard.
| EVCC field | Entity | Notes |
|---|---|---|
| Charging status sensor | sensor.alfen_mode_3_state |
Reports the raw IEC 61851 Mode 3 State (A, B1, B2, C1, C2, D1, D2, E, F). Add the state overrides below so EVCC maps it to its A/B/C. |
| States for status A | E,F |
Error / EVSE-disabled states, grouped with "ready" the same way this integration's Car Connected sensor does. |
| States for status B | B1,B2,C1,D1 |
Connected but not drawing current. |
| States for status C | C2,D2 |
Actively charging (PWM applied). |
| Enabled status sensor | binary_sensor.alfen_charger_enabled |
On when the max-current setpoint is above 0 A. |
| Enable switch | switch.alfen_charger_enabled |
Off writes 0 A to the max-current register; on restores the station's currently allowed max current. |
| Maximum current entity | number.alfen_max_current_limit_s1 |
Must be this writable number entity, not the read-only sensor.alfen_actual_max_current. |
| Power entity | sensor.alfen_real_power_sum |
|
| Energy entity | sensor.alfen_real_energy_delivered_sum |
Reported in Wh; add a template sensor to convert to kWh if EVCC doesn't scale it for you. |
| L1 / L2 / L3 current entity | sensor.alfen_current_l1 / _l2 / _l3 |
|
| L1 / L2 / L3 voltage entity | sensor.alfen_voltage_l1_n / _l2_n / _l3_n |
|
| Phase switching entity | select.alfen_usable_phases |
Options are the literal values "1" and "3". |
With Read Socket 2 enabled, socket 2's entity IDs get a _socket_2 suffix (e.g. sensor.alfen_current_l1_socket_2, switch.alfen_charger_enabled_socket_2).
Note: Alfen has no dedicated enable/disable coil — the charger-enabled switch and sensor are derived from the max-current setpoint (register 1210). Turning charging off/on this way is equivalent to setting
number.alfen_max_current_limit_s1to 0 A or back to its allowed maximum; don't drive both the switch and the number entity from automations at the same time to avoid fighting setpoints.
- Power budget may reset to 0A when no car is connected (fixed in NG9xx firmware 6.4.0-4210). The integration raises a repair notification in Settings → Repairs if it detects an NG9xx charger on older firmware.
- Reallin power meter (post-2021): Chargers with a Reallin power meter produced after 2021 only export a subset of measurement values. Per-phase energy, apparent energy, and reactive energy sensors will show as "unavailable" (NaN). This is a hardware limitation, not a bug.
- AHP platform, integration < v0.2.1: all entities stay unavailable because a single oversized Modbus read fails on every poll cycle. Update to v0.2.1 or newer (#40).
- Breaking change: the Phase Mode select's options changed from
"1 Phase"/"3 Phases"to the literal values"1"/"3"(needed for EVCC compatibility). Update any automation, script, or dashboard that matches on the old option text.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.