Electrolux / AEG Smart-Home-Integration, kostenlos und Open Source
Electrolux- und AEG-Geräte: Programme, Restzeit, Kühlschrank, Klimageräte, Luftreiniger.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolge und steuere deine vernetzten Geräte der Electrolux-Gruppe in Gladys — Electrolux, AEG, Zanussi, Frigidaire: Waschmaschinen, Waschtrockner, Wäschetrockner, Geschirrspüler, Backöfen, Kühlschränke, mobile und Fenster-Klimageräte, Luftreiniger, Luftentfeuchter und Pure-i9-Saugroboter. Die Integration nutzt die offizielle Electrolux Group Developer API (developer.electrolux.one), mit dem Konto deiner Electrolux- oder AEG-App.
Ohne die Geräte und ohne Electrolux-Konto entwickelt: Feedback willkommen. Der Code ist an echten Antworten der API geprüft, die mit dem offiziellen SDK von Electrolux veröffentlicht wurden, noch nicht an einem echten Gerät.
Community-Integration, nicht mit Electrolux Group verbunden. Electrolux, AEG, Zanussi und Frigidaire sind Marken ihrer Inhaber.
Überblick
Jedes Gerät deines Kontos wird ein Gladys-Gerät. Seine Funktionen werden aus dem gebaut, was das Gerät Electrolux meldet (seine „Fähigkeiten“), nicht aus einer Modellliste: Eine Waschmaschine ohne Türsensor bekommt keine Tür, ein Kühlschrank mit drittem Fach bekommt dessen Solltemperatur.
- Waschmaschinen, Waschtrockner, Trockner, Geschirrspüler: Zustand (aus, startbereit, Startaufschub, in Betrieb, pausiert, Programmende, Alarm), Programm, Programmphase, Restzeit, voraussichtliches Ende, Zeit bis zum aufgeschobenen Start, Tür, „Fernstart aktiviert“, Warnungen.
- Backöfen (ein oder zwei Garräume): Zustand, Programm, Garraumtemperatur, Solltemperatur (nur lesend), Kerntemperaturfühler, Restzeit, voraussichtliches Ende, Tür, Beleuchtung.
- Kühlschränke: Solltemperatur jedes Fachs (Kühlschrank, Gefrierschrank, Zusatzfach), Tür jedes Fachs, Schnellmodus, Luftfeuchtigkeit, Wasser- und Luftfilter, Warnungen (Tür offen geblieben, Temperaturalarm).
- Klimageräte (klassische und die neueren mobilen „DAM“-Modelle): Ein/Aus, Modus, Solltemperatur, Lüftergeschwindigkeit, Raumtemperatur, Filter.
- Luftreiniger: Ein/Aus, Modus, Lüftergeschwindigkeit, PM2.5, PM10, flüchtige organische Verbindungen, CO2, Luftfeuchtigkeit, Temperatur, Filterlebensdauer, je nach Modell.
- Luftentfeuchter: Ein/Aus, Luftfeuchtigkeit, Filter. Saugroboter: Zustand und Batterie. Kochfelder und Dunstabzugshauben: Zustand und Warnungen.
Dazu kommen ein Dashboard-Widget der laufenden Programme, zwei Szenen-Auslöser („Programm beendet“, „Warnung eines Geräts“) und eine Szenen-Aktion, um ein Programm zu pausieren, fortzusetzen, zu stoppen — und, wenn du es erlaubst, zu starten.
Voraussetzungen
- Gladys 5.1.0 oder neuer.
- Deine Geräte in der Electrolux- oder AEG-App gekoppelt (My Electrolux, My AEG, Electrolux Kitchen…), mit einem Passwort auf dem Konto (ein nur mit Google oder Apple angelegtes Konto kann sich nicht im Portal anmelden: Lege zuerst in der App ein Passwort fest).
- Eine Internetverbindung: Electrolux hat keine lokale API, alles läuft über die Electrolux-Cloud.
Konfiguration
- Öffne das Electrolux-Entwicklerportal (developer.electrolux.one) und melde dich mit dem Konto deiner App an.
- Erstelle im Dashboard einen API-Schlüssel. Kopiere ihn.
- Erzeuge ebenfalls im Dashboard ein Token-Paar (Zugriffstoken und Aktualisierungstoken). Kopiere das Aktualisierungstoken: Das Zugriffstoken brauchst du nicht.
- Öffne in Gladys Integrationen → Electrolux / AEG → Konfiguration, füge den API-Schlüssel und das Aktualisierungstoken ein, wähle die Sprache der Funktionsnamen und speichere.
- Klick auf Verbindung testen: Die Meldung listet deine Geräte und die API-Aufrufe der letzten 24 Stunden.
- Öffne den Reiter Entdecken und füge die gewünschten Geräte hinzu.
Das Aktualisierungstoken gilt nur einmal. Bei jeder Erneuerung des Zugriffs
(alle 12 Stunden) gibt Electrolux ein neues Aktualisierungstoken aus, und das
alte funktioniert nicht mehr. Die Integration bewahrt das aktuelle in ihrem
eigenen Speicher auf (/data): Du fügst ein Token nur einmal ein. Fügst du
später ein anderes ein, ersetzt es das gespeicherte. Verwende das in Gladys
eingefügte Token nicht in einem anderen Werkzeug: Eines der beiden würde
seinen Zugriff verlieren.
Der Fernstart von Waschmaschinen ist standardmäßig aus. Schalte „Fernstart von Waschmaschinen erlauben“ nur ein, wenn eine Szene eine Waschmaschine starten soll (siehe „Befehle und Sicherheit“).
Was jedes Gerät kann
| Funktion | Geräte | Werte |
|---|---|---|
| Zustand | alle | Aus, Startbereit, Startaufschub, In Betrieb, Pausiert, Programmende, Alarm, Nicht verbunden… |
| Warnungen | wenn das Gerät welche meldet | Die aktiven Warnungen im Klartext („Salz fehlt“, „Tür offen geblieben“), sonst „—“ |
| Programm, Programmphase | Wäsche, Geschirr, Backöfen | Programmname wie Electrolux ihn nennt (Englisch), Phase in deiner Sprache |
| Restzeit, Startaufschub noch | Wäsche, Geschirr, Backöfen | Minuten |
| Voraussichtliches Ende | Wäsche, Geschirr, Backöfen | Uhrzeit („14:35“), „—“ wenn nichts läuft |
| Tür | Wäsche, Geschirr, Backöfen, Kühlschrankfächer | Offen / geschlossen |
| Fernstart aktiviert | Wäsche, Geschirr | An, wenn der Fernstart am Gerät aktiviert ist |
| Temperatur, Solltemperatur, Kerntemperatur | Backöfen | °C, nur lesend |
| Beleuchtung | Backöfen | An / aus (steuerbar) |
| Solltemperatur, Schnellmodus | Kühlschrankfächer | °C im Bereich des Geräts / an-aus (steuerbar) |
| Ein/Aus, Modus, Solltemperatur, Lüfter | Klimageräte | Steuerbar |
| Ein/Aus, Modus, Lüftergeschwindigkeit | Luftreiniger | Steuerbar (Lüfter nur im manuellen Modus) |
| PM2.5, PM10, VOC, CO2, Luftfeuchtigkeit, Temperatur, Filter | Luftreiniger | Wenn das Modell sie misst |
| Luftfeuchtigkeit, Filter | Kühlschränke, Luftentfeuchter | % / Gut, Bald nachkaufen, Jetzt ersetzen, Reinigen |
| Batterie | Saugroboter | % (sechs Stufen) |
Jedes Gerät zeigt außerdem ein Cloud-Abzeichen, oder nicht erreichbar, wenn es nicht mit der Electrolux-Cloud verbunden ist; seine anderen Werte bleiben dann bei den zuletzt bekannten.
Befehle und Sicherheit
Die Regel ist die der Miele-Integration: Nichts, was heizt, wird aus der Ferne gestartet.
- Backöfen und Kochfelder: nur lesend, bis auf die Backofenbeleuchtung. Ein Backofen darf über die Szenen-Aktion gestoppt werden (die sichere Richtung), nie gestartet oder eingestellt.
- Trockner und Waschtrockner: nur Pause und Stopp. Kein Start, kein Fortsetzen (es würde wieder heizen).
- Geschirrspüler: Pause, Fortsetzen, Stopp. Kein Fernstart.
- Waschmaschinen: Pause, Fortsetzen, Stopp, und Start nur, wenn alle drei Bedingungen erfüllt sind: „Fernstart von Waschmaschinen erlauben“ ist in Gladys eingeschaltet, der Fernstart ist an der Maschine aktiviert (du hast sie beladen, das Programm gewählt und die Fernstart-Taste gedrückt), und die Maschine ist startbereit.
- Kühlschränke, Klimageräte, Luftreiniger, Luftentfeuchter: Die Funktionen sind steuerbar (Solltemperaturen, Modi, Ein/Aus).
Vor jedem Senden prüft die Integration, dass das Gerät verbunden ist, seine Fernsteuerung aktiviert ist und es den Befehl in seinem aktuellen Zustand annimmt (Electrolux beschreibt das in den Fähigkeiten). Sonst wird der Befehl mit einer klaren Meldung abgelehnt statt mit einem Fehler von Electrolux.
Aktualisierung und Kontingente
Die Electrolux-API erlaubt 5000 Aufrufe pro Tag und API-Schlüssel, 10 pro Sekunde und 5 gleichzeitig. Die Integration bleibt weit darunter:
- Die Integration hört den Live-Stream von Electrolux: Eine Änderung (Programmende, offene Tür) kommt in Sekunden an, für einen Aufruf pro Verbindung.
- Zur Sicherheit liest die Integration das ganze Konto alle 30 Minuten.
- Ist der Live-Stream nicht verfügbar, liest die Integration so oft, wie 2000 Aufrufe pro Tag es erlauben: etwa alle 2 Minuten bei ein oder zwei Geräten, alle 12 Minuten bei fünfzehn.
- Das Lesen stoppt von selbst bei 80 % des Tageskontingents (Befehle behalten Spielraum) und nach einer Antwort „zu viele Anfragen“ von Electrolux, für die verlangte Dauer.
Ein vollständiges Lesen kostet einen Aufruf plus einen pro Gerät; die Fähigkeiten eines Geräts werden einmal gelesen, danach nur nach einem Firmware-Update. Die Abfrage der Geräte durch Gladys (einmal pro Minute) ist nur eine Rückfallebene: Die Integration ignoriert sie, wenn sie gerade gelesen hat.
Widget
Füge das Widget Electrolux-Geräte zu einem Dashboard hinzu: Es listet die Waschmaschinen, Trockner, Geschirrspüler und Backöfen, die laufen, auf einen aufgeschobenen Start warten, pausiert sind, Alarm melden, fertig oder startbereit sind — die laufenden zuerst, mit der Restzeit als Abzeichen, dem Programm, der Phase und dem voraussichtlichen Ende. Läuft nichts, sagt es eine Zeile. Es folgt der Sprache deiner Gladys-Oberfläche.
Szenen-Auslöser und -Aktionen
- Auslöser „Electrolux-Programm beendet“: Eine Waschmaschine, ein Trockner, Geschirrspüler oder Backofen hat das Programm beendet. Filtere auf ein Gerät oder lass das Feld leer für alle. Variablen: Gerätename, Programm.
- Auslöser „Warnung eines Electrolux-Geräts“: Ein Gerät meldet eine neue Warnung (Tür offen geblieben, Wasserleck, Salz fehlt, Filter ersetzen, Alarm…). Ein Ereignis pro neuer Warnung. Variablen: Gerätename, Warnung im Klartext, Warncode.
- Aktion „Electrolux-Programm steuern“: startet (Waschmaschine, falls erlaubt), pausiert, setzt fort oder stoppt das Programm eines Geräts. Ausgabe: „Befehl gesendet“.
Szenen-Beispiele
- Wäsche fertig: Auslöser „Electrolux-Programm beendet“ auf der Waschmaschine → „Die Wäsche ist fertig ({{triggerEvent.data.program}})“ an die Familie senden.
- Waschen im Nachttarif: Abends die Maschine beladen, das Programm wählen und die Fernstart-Taste drücken. Eine Szene um 22:30 (Nachttarif) führt die Aktion „Electrolux-Programm steuern“ → Starten aus.
- Kühlschranktür: Auslöser „Warnung eines Electrolux-Geräts“ auf dem Kühlschrank → „{{triggerEvent.data.device_name}}: {{triggerEvent.data.alert}}“ senden.
- Schlafzimmer kühlen: Steigt die Schlafzimmertemperatur über 26 °C, das Klimagerät im Modus Kühlen auf 24 °C einschalten.
Fehlerbehebung
- „Electrolux hat den API-Schlüssel oder die Tokens abgelehnt“: Das Aktualisierungstoken wurde anderswo verbraucht oder widerrufen. Erzeuge im Portal ein neues Token-Paar und füge das neue Aktualisierungstoken in die Konfiguration ein.
- „Kontingent der Electrolux-API erreicht“: Ein anderes Werkzeug nutzt denselben API-Schlüssel, oder es gab viele Neustarts. Das Lesen startet von selbst wieder; erstelle für jedes Werkzeug einen eigenen API-Schlüssel.
- Kein Gerät: Prüfe, dass die Geräte in der Electrolux- oder AEG-App mit demselben Konto gekoppelt sind, und klick dann auf Verbindung testen.
- Ein Befehl wird abgelehnt: Die Meldung sagt warum — Fernsteuerung am Gerät aus, Gerät nicht verbunden, Befehl im aktuellen Zustand nicht angenommen (vor dem Stoppen pausieren) oder Fernstart nicht erlaubt.
- Werte ändern sich verspätet: Der Live-Stream ist für deinen Schlüssel vielleicht nicht verfügbar; die Integration liest dann alle paar Minuten (siehe „Aktualisierung und Kontingente“).
- Logs: Die Logs sind absichtlich ruhig. Setz
LOG_LEVEL=debug, um jedes Lesen und jeden gesendeten Zustand zu sehen.
Einschränkungen
- Ohne Geräte und Konto entwickelt: Das Verhalten an echten Geräten muss noch bestätigt werden. Feedback ist willkommen.
- Programmnamen kommen von Electrolux, auf Englisch.
- Klimagerät-Modi, die Gladys nicht kennt (zum Beispiel Eco), werden nicht angeboten; die Modus-Funktion zeigt dann keinen Wert.
- Kühlschränke melden ihre Solltemperaturen; wenige melden die gemessene Temperatur, die nur angezeigt wird, wenn das Gerät sie liefert.
- Saugroboter sind nur lesend (Zustand und Batterie); Hauben und Kochfelder zeigen Zustand und Warnungen.
- Programme werden am Gerät gewählt: Die Integration wählt weder Programm noch Optionen.
- Die Kontingentzahlen stammen aus dem Entwicklerportal, so wie andere Projekte sie berichten; Electrolux kann sie ändern.
Daten und Datenschutz
Der eingefügte API-Schlüssel und das Aktualisierungstoken bleiben in der
Gladys-Konfiguration; die aktuellen Tokens liegen im eigenen Speicher der
Integration (/data, nur für sie lesbar). Keines davon erscheint je in den
Logs. Die Integration spricht nur mit api.developer.electrolux.one und mit
der Live-Stream-Adresse, die Electrolux angibt.
Konfigurationseinstellungen
Diese Einstellungen fragt Electrolux / AEG in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Bevor du anfängst | section | Nein | Electrolux hat keine lokale API: Alles läuft über die Electrolux-Cloud, mit dem Konto der Electrolux- oder AEG-App. Melde dich mit diesem Konto im Electrolux-Entwicklerportal an, erstelle einen API-Schlüssel und erzeuge dann ein Token-Paar (Zugriffs- und Aktualisierungstoken). Füge unten den API-Schlüssel und das Aktualisierungstoken ein und speichere. Das Aktualisierungstoken ändert sich bei jeder Nutzung: Die Integration behält das aktuelle, füge es also nur einmal ein. |
| API-Schlüssel | secret | Ja | Im Electrolux-Entwicklerportal erstellter API-Schlüssel. |
| Aktualisierungstoken | secret | Ja | Mit dem Schlüssel erzeugtes Aktualisierungstoken. Füge nur dann ein neues ein, wenn Electrolux das aktuelle ablehnt. |
| Fernstart von Waschmaschinen erlauben | boolean | Nein | Standardmäßig aus. Eingeschaltet darf eine Szene eine Waschmaschine starten, deren Fernstart an der Maschine aktiviert ist. Nie einen Backofen, Trockner oder Waschtrockner. |
| Sprache | select | Nein | Funktionsnamen neuer Geräte, Zustände und Widget. Programmnamen kommen von Electrolux, auf Englisch. |
So installierst du Electrolux / AEG in Gladys
- Öffne in Gladys Integrationen: Electrolux / AEG erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-electrolux:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-electrolux.
Electrolux / AEG 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
Electrolux / AEG 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 guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation