Smappee EV Home Assistant Integration (HACS)

Important

This is a personal project developed by me and is not affiliated with, maintained, authorized, or endorsed by 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"".

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.

🔧 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.

✅ Charging Mode Control

• Two different service paths to set the charging modes:

  • The regular smappee_ev.set_charging_mode service, which works with the integration's existing mode flow (SMART, SOLAR, NORMAL).
  • The newer smappee_ev.set_charging_mode_chargingstations service, which calls Smappee's chargingstations endpoint directly and supports NORMAL, SMART, and PAUSED, with an optional limit for NORMAL. This advanced service seems to be more stable but requires to be manually called.

• Apply the selected UI mode with the Set Charging Mode button, take care that this uses the set_charging_mode service.

• Use the chargingstations service for direct connector control with NORMAL, SMART, or PAUSED, including an optional limit in AMPERE or PERCENTAGE when using NORMAL

✅ Direct Charger Control

• Start, Pause, or 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 (%)

✅ 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

⚡️ 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

• Serial number of your charging station
  → You can find it in the Smappee dashboard (go to EV line → click to view serial number)

🧩 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.

The integration currently exposes two charging-mode paths:

• The regular Home Assistant entities and smappee_ev.set_charging_mode service work with the integration's existing mode flow (SMART, SOLAR, NORMAL).
• The newer smappee_ev.set_charging_mode_chargingstations service calls Smappee's chargingstations endpoint directly and supports NORMAL, SMART, and PAUSED, with an optional limit for NORMAL.

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: