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.

About

This Home Assistant integration provides extended local control and monitoring for Smappee EV chargers, including charging modes, current limits, availability control, LED brightness, and status feedback. It is intended for users who want to integrate their Smappee EV charger more deeply into Home Assistant, EVCC, or other energy management setups. Depending on your device and configuration, energy-related data may also be available.

Feel free to join the Discord channel if you have questions, want to share feedback, or would like to contribute!

Breaking changes in the 2026.7.x version

Caution

Review your Home Assistant configuration after upgrading. Entity names and device assignments have changed and older config entries may rebuild their entity/device registry during reauthentication. As a result, entity IDs can change.

🔧 Features

This custom integration unlocks more control over your Smappee charger and connects it directly to Home Assistant. It is based on the Smappee Dashboard API calls and mqtt.smappee.net.

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.
• Dashboard v10/v11 calls are used for charging mode, start, pause, stop, percentage/current limit, LED brightness, min surplus percentage and availability.
• 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.

✅ Direct Charger Control

• Pause charging via smappee_ev.pause_charging (Dashboard v10 action)
• Stop charging sessions from Home Assistant
• Set fixed charging currents (in Amps, with one decimal step)
• Change Wallbox availability (set available/unavailable)
• Target a specific connector by selecting service_location_id and/or connector_id, 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
• Always-on power sensor for the site's background or standby consumption, based on the MQTT alwaysOn value
• 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

• Most values for currents/brightnesses are always integers (no floats in UI), except for current limits which are 1 decimal precision. The integration converts the requested current to the nearest supported percentage for the connector's configured range.
• 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:

• 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) use Dashboard v10/v11 calls when Dashboard authentication and device ids are available. The integration no longer documents or exposes the old legacy control path.

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.

📐 Automation Blueprints

Smappee: Forgot to Scan RFID Badge

Sends a push notification to your phone when your EV has been plugged into the Smappee charger for a configurable amount of time without starting a charging session — a reminder to scan your RFID badge.

What it does

• Monitors charger status: Watches for the cable_connected state on your Smappee EVSE sensor.
• Configurable delay: Waits a set amount of time (default: 5 minutes) before alerting, to allow for normal badge scanning.
• Mobile notification: Sends a push notification to your phone via the Home Assistant Companion app.

Easy Import

Click the button below to import this blueprint into your Home Assistant instance:

Manual Setup

1. Download blueprints/automation/forgot_to_scan_rfid_badge.yaml.

2. Place it in your Home Assistant config directory:

   config/blueprints/automation/forgot_to_scan_rfid_badge.yaml
   

3. Go to Settings → Automations & Scenes → Blueprints, click Reload Blueprints, then Create Automation.

---

Smappee: Charger status and sun-based LED brightness

Adjusts the Smappee charger LED brightness based on charger availability (2% when available) and sun state with configurable offsets.

Features

• Charger-aware: Sets LED to 2% brightness when the charger status is "available".
• Sun-triggered fallback: When not available, adjusts brightness based on sunrise and sunset.
• Configurable offsets: Shift the trigger time before or after sunrise/sunset (e.g. -00:30:00 to trigger 30 minutes early).
• Configurable brightness: Set independent brightness percentages for daytime and nighttime.

Import

Click the button below to import this blueprint into your Home Assistant instance:

Setup

1. Download blueprints/automation/sun_charger_state_led.yaml.

2. Place it in your Home Assistant config directory:

   config/blueprints/automation/sun_charger_state_led.yaml

3. Go to Settings → Automations & Scenes → Blueprints, click Reload Blueprints, then Create Automation.

💡 Notes

I built this project 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 like it a lot.
If you want to contribute to this please read the Contribution guidelines

☕ Support

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

Star History