Passerelle Electrolux vers MQTT (électroménager connecté Electrolux, AEG, Zanussi)

Bonjour à tous,

Je viens d’intégrer mon four Electrolux dans Jeedom, même principe que ma passerelle Liebherr : autant la partager.

De quoi il s’agit

Electrolux a ouvert fin 2024 un portail développeur officiel pour ses appareils connectés. La passerelle fait le pont entre cette API et MQTT, au format MQTT Discovery : le plugin MQTT Discovery crée l’équipement et toutes ses commandes tout seul, il n’y a rien à déclarer à la main.

Ça couvre les marques du groupe (Electrolux, AEG, Zanussi…). Le plugin Home Connect ne les gère pas, lui c’est BSH : Bosch, Siemens, Neff, Gaggenau.

Et comme la précédente : c’est un conteneur Docker, pas un plugin Jeedom. Si ça intéresse du monde, je peux en sortir une version plugin, dites-le moi ici.

Ce que ça remonte

Sur mon four vapeur (Vapeur 800 MealAssist SteamPro), 37 entités : l’état de cuisson, les 19 programmes, la température et la consigne (réglables depuis Jeedom), le temps restant et l’heure de fin, la sonde à cœur, le niveau du réservoir d’eau, les rappels de détartrage et de nettoyage, l’état de la porte, la sécurité enfant, l’éclairage.

La liste est construite à partir des capabilities que l’appareil déclare lui-même, rien n’est écrit en dur : lave-linge, lave-vaisselle, froid, hotte et climatisation devraient passer aussi. Je n’ai testé en vrai que le four, les autres familles ne le sont que contre les jeux de capabilities du SDK.

Prérequis

Un broker MQTT, le plugin MQTT Discovery, l’appareil déjà appairé dans l’application Electrolux, et deux identifiants à générer sur le portail développeur : une clé API sur developer.electrolux.one/dashboard, puis un couple access/refresh token sur developer.electrolux.one/generateToken. C’est gratuit et immédiat.

:warning: Il faut que electrolux figure dans les « topics de données » du plugin MQTT Discovery, sinon rien n’apparaît. Pas besoin de le taper à la main : démarrez le démon, attendez une minute et rafraîchissez la page de configuration du plugin, il propose lui-même les racines qu’il a découvertes avec un bouton +.

:warning: Montez bien un volume sur /config. Electrolux renvoie un nouveau refresh token à chaque renouvellement (l’access token vit 12 h) : sans persistance, le premier redémarrage du conteneur repart sur un jeton déjà consommé et l’intégration est morte.

Deux choses à savoir

Pas de polling : l’API expose un flux SSE, les changements arrivent en temps réel, avec repli automatique en polling 5 min si le flux tombe. Pas d’API locale ni de Matter sur ces appareils en revanche, tout passe par le cloud.

Le pilotage à distance dépend du four, pas de la passerelle : il faut activer « télécommande » sur l’écran de l’appareil, et ça se coupe tout seul au bout d’un moment (réglementation UE). La supervision, elle, marche en permanence. Et si vous ne voulez pas piloter du tout, ELECTROLUX_READ_ONLY=true ne laisse que les infos.

Le pont importe electrolux-group-developer-sdk, le SDK publié par Electrolux lui-même, plutôt que du code maison, comme ça il suivra les évolutions de l’API. Image multi-arch amd64/arm64 sur GHCR, et gabarit dans Community Applications pour ceux qui sont sous Unraid.

Bonne journée à tous.
Richard

2 « J'aime »

Hello,
je teste actuellement ton bridge, et il fonctionne très bien, merci beaucoup pour le devel et le partage.

J’ai un lave-linge Electrolux PerfectCare 700 avec AutoDose, et il semble que certaines informations disponibles ne sont pas publiées via mqtt.
j’avoue, je me suis fais aidée par une IA pour la comparaison entre ce qui est dispo avec l’API et ce qui est publié.

j’ai d’ailleurs ouvert une issue sur ton github dans ce sens:

Encore merci pour ton travail

Ne t’inquiete pas mon IA va gérer la demande de ton IA…

1 « J'aime »

Monde moderne… Triste…

Corrigé : le lave-linge déclare ses capacités « à plat » (userSelections/programUID) alors que l’état arrive imbriqué, le pont ne retrouvait donc jamais la valeur. Il suffit de récupérer l’image latest. Programme en cours, consommation d’eau et niveaux de lessive devraient maintenant remonter. Dis-moi si l’un d’eux reste vide.

1 « J'aime »

Merci beaucoup pour ta réactivité !!!

Beaucoup de nouveaux attributs désormais, je vais me dépatouiller avec ça (ou plutôt Cloclo va m’aider :smiley: )

Je te fais un retour rapide

Merkiiiii

Ce sujet a été automatiquement fermé après 24 heures suivant le dernier commentaire. Aucune réponse n’est permise dorénavant.