🚨 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 |
🟢 Show charger connection status, vehicle connection, charging state, and error status |
sensor |
📊 Display power, energy (session & total), current, voltage, status, and WiFi signal strength |
switch |
🔌 Control charging (start/stop) |
- Connected: Shows if the charger is connected to the NexBlue cloud
- Vehicle Connected: Indicates if a vehicle is plugged into the charger
- Charging: Shows if the charger is actively charging a vehicle
- Error: Indicates if the charger is in an error state
- Power: Current charging power in kW
- Energy (Session): Energy delivered in the current charging session in kWh
- Energy (Total): Total energy delivered by the charger in kWh
- Current: Charging current in amperes
- Voltage: Charging voltage in volts
- Status: Textual status of the charger
- WiFi Signal: Signal strength of the charger's WiFi connection
- Charging: Start or stop charging
- 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
- Click on "+ Explore & Download Repositories" and search for "NexBlue"
- Click "Download" on the NexBlue integration
- Restart Home Assistant
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml) - If you do not have a
custom_componentsdirectory (folder) there, you need to create it - In the
custom_componentsdirectory (folder) create a new folder callednexblue_hass - Download all the files from the
custom_components/nexblue_hass/directory (folder) in this repository - Place the files you downloaded in the new directory (folder) you created
- Restart Home Assistant
- In the Home Assistant UI go to "Configuration" → "Integrations"
- Click "+" and search for "NexBlue"
- Enter your NexBlue account credentials (the same ones you use for the NexBlue app)
This integration requires your NexBlue account credentials to authenticate with the NexBlue API. Your credentials are stored locally in Home Assistant and are only used to authenticate with the NexBlue API.
The integration handles authentication tokens securely:
- Access tokens expire after 1 day
- Refresh tokens expire after 30 days
- The integration automatically refreshes tokens when needed
This integration uses the official NexBlue API endpoints as documented in their OpenAPI specification. The API specification is stored locally in the docs/api directory and can be updated using the provided script in scripts/update_api_spec.sh.
This integration is still under development! Features are being added and bugs are being fixed. If you encounter any issues, please report them on the GitHub issues page.
If you want to contribute to this project, please read the Contribution guidelines. Even if you're not a Python expert (like me!), your input is valuable!
If you find this integration useful, consider buying me a coffee! It helps me continue developing and maintaining this project.
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.
Code template was mainly taken from @Ludeeus's integration_blueprint template.