Smappee EV Home Assistant Integration (HACS)

Important

This is a personal project developed by me and I am not affiliated with Smappee in any way. Use at your own risk.

🧠 Credits

The original code started as a fork of gvnuland/smappee_ev, so credits for the initial working version goes to ""@gvnuland"". However, the codebase has been completely refactored, resulting in a new and independent integration.

This integration is designed to be complementary to the official Smappee integration, offering additional control features for Smappee EV charging. However, energy data may also be available in this integration. Feel free to join the discord channel if you have questions or want to contribute!

🔧 Features

This custom integration unlocks more control over your Smappee charger and connects it directly to Home Assistant. It goes far beyond the official integration, which lacks support for the full EV charger API. It is based on the Smappee API and mqtt.smappee.net.

The main ambition is to have independent control of the Smappee EV charger via Home Assistant and eventually add those sensors in other energy management systems.

API architecture

• MQTT remains the live data source for power, current, energy and fast charger state.
• Smappee Dashboard REST API v10/v11 is used for discovery, station details, charger configuration, capacity protection, overload protection, recent sessions and charger availability.
• Confirmed Dashboard v10/v11 calls are used for charging mode, start, pause, stop, percentage/current limit, LED brightness, min surplus percentage and availability when a Dashboard token is available.
• The existing app1pub.smappee.net/dev/v3 API is kept only for legacy entries without a Dashboard refresh token, and for the explicitly legacy set_charging_mode_chargingstations service.
• Dashboard configuration data refreshes at most every 30 minutes, with a forced refresh shortly after supported dashboard writes.

✅ Charging Mode Control

• UI controls (select, number slider, Set Charging Mode button) use Dashboard v10 actions when a Dashboard token is available.
• The EVCC switch uses Dashboard v10 actions for enable (STANDARD) and disable (PAUSED) when a Dashboard token is available.
• smappee_ev.set_charging_mode sets mode via the same dashboard-first path: STANDARD, SMART, or SOLAR.
• smappee_ev.set_charging_mode_chargingstations provides direct chargingstations control: NORMAL, SMART, or PAUSED, with an optional limit in AMPERE or PERCENTAGE.

✅ Direct Charger Control

• Pause charging via smappee_ev.pause_charging (Dashboard v10 action) or smappee_ev.pause_charging_chargingstations (explicit legacy chargingstations endpoint)
• Stop charging sessions from Home Assistant
• Set fixed charging currents (in Amps)
• Change Wallbox availability (set available/unavailable)
• Target a specific connector directly through the chargingstations endpoint when needed, which is especially useful in multi-station setups

✅ LED Brightness Control

• Adjust LED ring brightness (%) via Dashboard v10 config writes when a Dashboard token is available.

✅ Charger State Feedback

• Real-time Session State:
  • CHARGING, PAUSED, SUSPENDED, etc.
• EVCC State for in-depth diagnostics (e.g. state A/B/C/E)
• EVCC Status to represent the connector status similar as the dashboard
• Session energy sensor per connector: shows the latest Smappee cloud charging session energy in kWh and exposes the session metadata as attributes
• Support Grid sensor per connector: shows the maximum grid assistance current (A) configured on the charger
• Charging mode is correctly restored from Home Assistant's persistent state after a restart (MQTT confirms or corrects it shortly after boot)

⚡️ Advanced / Developer Notes

• All values for currents/brightnesses are always integers (no floats in UI)
• Integration tested on:
  • Smappee EV Wall Home (single and double cable)
  • Smappee EV One Business
  • Should work similarly on other Smappee chargers using the same API

📘 Integration into other energy management systems

• EVCC integration – Learn how to use these Home Assistant sensors for EVCC.
• openEMS integration - Learn how to use these Home Assistant sensors for openEMS. (under construction)
• emhass integration - Learn how to use these Home Assistant sensors for emhass. (under construction)

⚠️ Important

This is a HACS custom integration. Do not try to add this repository as an add-on in Home Assistant - it won't work that way.

📦 Installation Instructions

Step 1. Add the Integration via HACS

Note

🚀 Great news! The integration has been officially approved by HACS, no need to add it manually anymore! 🎉

Method 1: Install via HACS (Recommended)

1. In Home Assistant, go to HACS → Integrations.
2. Search for Smappee EV.
3. Click the download button in the right bottom side
4. Restart Home Assistant.

Method 2: Manual Installation

1. Download the latest release from GitHub.
2. Copy the smappee_ev folder to your Home Assistant custom_components directory.
3. Restart Home Assistant.

Step 2. Configure the Integration

During setup, you will be prompted to enter:

• Client ID and Client Secret
  → Request these by emailing support@smappee.com

• Username on the Smappee dashboard

• Password on the Smappee dashboard

🧩 Entities

More information on the specifics of the entities/buttons/services can be found in the docs. Take care: names are subject to change as users can rename their Smappee device.

All main UI controls (select, buttons, number slider, EVCC switch and LED light) now use Dashboard v10/v11 calls when Dashboard authentication and device ids are available. For entries with a stored Dashboard refresh token, the integration no longer silently falls back to app1pub v3 for those controls. The smappee_ev.set_charging_mode_chargingstations service still provides direct access to the legacy chargingstations endpoint when needed.

This is the current version of the entities (for my EV Wall Home single connector)

⚠️ Note
The Smappee APP is sometimes not correct or responsive. Better to use the online Smappee Dashboard to check functionality.

💡 Notes

I built this fork because I own a Smappee EV Wall Home and wanted deeper control through Home Assistant.
The goal is to offer reliable support for charging mode switching and eventually more smart charging controls. I am also looking into EVCC integration.

Contributions, feedback, or bug reports are very welcome! I am not a programmer, but I'll do my best.

☕ Support

If this integration is useful to you, feel free to support its development:

Star History