Zum Hauptinhalt springen

Wallbox Smart-Home-Integration, kostenlos und Open Source

Wallbox-Integration für Gladys Assistant

Monitor and control your Wallbox EV chargers via the Wallbox cloud.

Auf GitHub ansehenAlle externen Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

This integration monitors and controls your Wallbox electric vehicle chargers through the Wallbox cloud: charging power, state of charge, added energy (total / green / grid), pause/resume, lock, maximum charging current and "Solar charging" (Eco-Smart) mode.

It is inspired by the Home Assistant integration and uses the same API library.

Prerequisites​

  • An active Wallbox account (https://my.wallbox.com).
  • Your charger(s) registered on that account.
  • To control the charger (pause, lock, max current, Eco-Smart), the account must have admin rights on the station.

Configuration​

  1. Install the integration from the Gladys catalog.
  2. Enter the username (your Wallbox account email) and password.
  3. Choose the refresh interval (15 to 3600 seconds, 90 by default).

The integration automatically discovers all chargers on the account and publishes one device per charger. No local network access required: everything goes through the Wallbox cloud.

Published devices​

Values are published in Gladys units (kW, kWh, %, km, km/h, A), rounded to at most 3 decimal places (the energy price keeps its 4 decimals, e.g. 0.1734 €/kWh).

Each charger exposes:

  • Sensors: state of charge (%), charging power (kW), added energy (kWh), added green energy (kWh), added grid energy (kWh), added range (km), charging speed (km/h), max available power (A), status text (e.g. "Charging", "Paused"), currency.
  • Controls: pause / resume, lock / unlock, maximum charging current (A), maximum ICP current (A), energy price (€/kWh, value typed by hand from 0 to 1), "Solar charging" (Off / Eco-Smart / Full solar), resume-schedule and firmware-update buttons.

Some capabilities are model-specific and only appear when the charger supports them (same behaviour as Home Assistant): for example discharged energy on bidirectional stations (the QS series).

Security​

  • The password of your Wallbox account is stored encrypted by Gladys and never sent back to the frontend (secret field).
  • Every request goes over HTTPS to api.wall-box.com and user-api.wall-box.com.
  • Because this is a cloud API, the transport badge of each device is cloud under normal operation, and switches to unreachable when the Wallbox API stops responding or refuses your credentials.

Troubleshooting​

  • "Wallbox refused the credentials": wrong username or password (secret field), or the account has no rights on the station. Check in the Wallbox portal.
  • "Wallbox cloud unreachable": network issue or the Wallbox API is temporarily unavailable. The badge switches to unreachable.
  • No discharge / ICP current data: your charger model (e.g. Pulsar Plus) does not provide these measurements — the integration does not publish them, like Home Assistant.
  • Pause / resume not working: some stations only allow pausing when a vehicle is plugged in, and the account must have admin rights.

Known limitations​

  • The Wallbox API rate-limits requests (HTTP 429): too low a refresh interval can hit these limits. The 90-second default is a good balance. The effective interval is multiplied by the number of chargers on the account (90s x N), like Home Assistant.
  • The integration relies on Wallbox's undocumented public API; Wallbox may change it without notice.

Konfigurationseinstellungen​

Diese Einstellungen fragt Wallbox in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Getting startedsectionNeinConnect with your Wallbox account (https://my.wallbox.com). The integration discovers every charging station attached to the account and publishes one device each. No local network access required: everything goes through the Wallbox cloud.
Wallbox usernamestringJaThe email address used to sign in to your Wallbox account.
Wallbox passwordsecretJaThe password of your Wallbox account. It is stored encrypted by Gladys and never sent to the frontend. Requires an admin-level account to control the charger.
Refresh interval (s)numberNeinHow often the Wallbox cloud API is polled, in seconds. The default 90 s balances freshness with the Wallbox API rate limits. The effective interval is multiplied by the number of chargers (90s x N).

So installierst du Wallbox in Gladys​

  1. Öffne in Gladys Integrationen: Wallbox erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/echopouet/gladys-wallbox:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/EchoPouet/gladys-wallbox.

Wallbox benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Wallbox ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von EchoPouet veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am