🚨 Disclaimer: I'm not a Python developer! This project is built with enthusiasm and a lot of trial and error. Expect some "vibe coding" along the way! 😅
This unofficial integration connects your NexBlue EV charging devices to Home Assistant, allowing you to monitor and control your chargers from your smart home dashboard.
This integration sets up the following platforms:
| Platform | Description |
|---|---|
binary_sensor |
🟢 Charger connection, vehicle connection, charging state, and error status |
sensor |
📊 Power, energy, current, voltage, last session data, and charger configuration diagnostics |
number |
🔢 Adjust the charger current limit |
switch |
🔌 Start and stop charging |
| Entity | Description |
|---|---|
| Connected | Whether the charger is connected to the NexBlue cloud |
| Vehicle Connected | Whether a vehicle is plugged in |
| Charging | Whether the charger is actively charging |
| Error | Whether the charger is in an error state |
Live data:
| Entity | Unit | Description |
|---|---|---|
| Charging State | — | Human-readable charger state (e.g. Charging, Finished, Available) |
| Power | kW | Current charging power |
| Energy (Session) | kWh | Energy delivered in the current session |
| Energy (Total / Lifetime) | kWh | Total energy delivered by the charger |
| Energy Today | kWh | Energy delivered today |
| Current Limit | A | Active current limit |
| Network Status | — | Connectivity type (WiFi, LTE, Ethernet) |
| Voltage L1 / L2 / L3 | V | Per-phase voltage |
| Current L1 / L2 / L3 | A | Per-phase current |
| Circuit Fuse | A | Installed circuit fuse rating |
| Cable Current Limit | A | Maximum current supported by the connected cable |
| Cable Lock Mode | — | Cable locking behaviour (Lock While Charging / Always Locked) |
| LED Brightness | % | Charger LED brightness level |
Last session (diagnostic):
| Entity | Description |
|---|---|
| Last Session Start | Timestamp when the last session started |
| Last Session End | Timestamp when the last session ended |
| Last Session Energy | Energy delivered in the last session (kWh) |
| Last Session Stop Reason | Why the last session ended (e.g. EVDisconnected, Remote) |
Charger configuration (diagnostic):
| Entity | Description |
|---|---|
| Access Level | Whether charging is restricted to authorised users only |
| Phase Mode | Single phase or three phase charging mode |
| UK Regulation Mode | Whether UK smart charging regulation mode is enabled |
| Protocol Version | OCPP protocol version reported by the charger |
| Entity | Range | Description |
|---|---|---|
| Current Limit | 6–32 A | Set the maximum charging current |
| Entity | Description |
|---|---|
| Charging | Start or stop an active charging session |
Click the button above, or manually:
- Make sure HACS is installed in your Home Assistant instance
- Add this repository as a custom repository in HACS:
- Go to HACS → Integrations → ⋮ (menu) → Custom repositories
- Enter
https://github.com/AndrewBarber/nexblue_hassas the repository URL - Select
Integrationas the category - Click Add
- Search for "NexBlue" and click Download
- Restart Home Assistant
- Open the directory for your HA configuration (where
configuration.yamllives) - Create a
custom_componentsdirectory if one doesn't exist - Inside
custom_components, create a folder callednexblue_hass - Download all files from
custom_components/nexblue_hass/in this repository into that folder - Restart Home Assistant
- In Home Assistant go to Settings → Integrations
- Click + Add Integration and search for "NexBlue"
- Enter your NexBlue account credentials (the same ones used in the NexBlue app)
Your credentials are stored locally in Home Assistant and are only used to authenticate with the NexBlue API.
The integration handles token refresh automatically:
- Access tokens expire after 1 day
- Refresh tokens expire after 30 days
This integration is under active development. If you encounter any issues, please report them on the GitHub issues page.
If you want to contribute, please read the Contribution guidelines.
If you find this integration useful, consider buying me a coffee!
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.
Code template was mainly taken from @Ludeeus's integration_blueprint template.