Intégration domotique Lubluelu SL68 (Tuya), gratuite et open source

Contrôlez l'aspirateur Lubluelu SL68 et d'autres robots Tuya en local sur le réseau.

• Publiée par LM1LC3N7
• Appareils
• Version 0.3.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations externes

Contrôlez l'aspirateur robot Lubluelu SL68 — et d'autres robots aspirateurs basés sur Tuya/Smart Life — depuis Gladys, directement sur votre réseau local. Pas de passerelle supplémentaire, pas besoin de garder l'application du téléphone ouverte.

Vue d'ensemble

Le contrôle au quotidien (marche/pause, mode, niveau d'eau, aspiration, retour à la base) passe directement par le réseau local, chiffré de la même façon que l'application Smart Life/Tuya Smart — aucun aller-retour cloud une fois la configuration terminée. La configuration initiale a seulement besoin de joindre votre compte Tuya une fois, pour deux choses :

• récupérer le local_key de l'appareil, la clé de chiffrement requise pour le contrôle local (elle n'est jamais diffusée sur le réseau local, seulement disponible via votre compte Tuya) ;
• connaître les fonctionnalités réellement présentes sur votre aspirateur (marche/pause, mode, niveau d'eau, aspiration, batterie...) — lues depuis le catalogue Tuya de votre appareil, sans supposition.

Deux façons d'y arriver — choisissez celle qui vous convient, ou configurez les deux :

• Compte Smart Life (recommandé) — aucun compte développeur, rien à copier : scannez un QR code avec l'application déjà utilisée pour l'aspirateur, et tous les appareils du compte sont découverts automatiquement, exactement comme dans l'application officielle.
• Compte Tuya Cloud (avancé) — un projet Tuya IoT Platform gratuit, pour celles et ceux qui en ont déjà un ou préfèrent le contrôle explicite par appareil qu'il offre.

Le local_key change à chaque nouvelle liaison de l'aspirateur au cloud : cette intégration le revérifie donc périodiquement en arrière-plan (quelle que soit la méthode) — vous n'aurez jamais à refaire la configuration pour cette raison.

Ces fonctionnalités apparaissent par aspirateur, automatiquement adaptées à ce que votre appareil signale réellement (tous les aspirateurs n'ont pas toutes ces fonctions). Leurs noms sont en français ou en anglais selon le champ Langue des noms d'appareil (Gladys garde le nom donné à l'ajout de l'appareil) :

• État — ce que fait le robot : en nettoyage, en pause, retour à la base, en charge, sur la base, arrêté, en erreur. Gladys l'affiche en badge, et il peut déclencher une scène (« quand l'aspirateur est revenu sur sa base »).
• Marche / Pause — lancer, arrêter ou mettre en pause le nettoyage en cours.
• Mode — un menu déroulant (Intelligent, Le long des murs, Zone ciblée, Pièces choisies, Serpillière, Retour à la base...).
• Retour à la base — un bouton en un clic.
• Débit d'eau — débit de la serpillière, si votre aspirateur a une fonction de lavage.
• Puissance d'aspiration — si votre aspirateur signale un niveau d'aspiration.
• Batterie — lecture seule, 0-100 %.
• Surface nettoyée / Durée de nettoyage — du nettoyage en cours ou du dernier, et leurs totaux.
• Code de défaut — lecture seule, 0 en fonctionnement normal.
• Localiser le robot — fait biper l'aspirateur, si pris en charge.
• Brosse principale / Brosse latérale / Filtre / Serpillière — durée de vie restante, et un bouton Réinitialiser pour chacune après remplacement de la pièce.
• Ne pas déranger — si votre aspirateur a des heures silencieuses.
• Zone - … — un bouton par zone de nettoyage (voir « Zones de nettoyage » ci-dessous).

Nécessite Gladys 5.1 ou plus récent.

Widgets du tableau de bord

Ajoutez-les depuis l'éditeur du tableau de bord (Ajouter un widget, puis cette intégration). Chacun affiche l'aspirateur choisi dans ses réglages, ou le premier. Ils complètent la boîte Appareils du cœur, qui reste l'endroit de tous les réglages (menus, interrupteurs) :

• Aspirateur robot — le robot d'un coup d'œil : batterie, état, programme, aspiration, eau, surface et durée du nettoyage en cours, défaut en rouge, liaison locale ou cloud ; et les touches du quotidien de sa télécommande : Démarrer (ou Pause / Reprendre, selon l'état), Retour base, Localiser, Arrêter.
• Nettoyage express — jusqu'à quatre nettoyages en un geste, pour une tablette murale. Chaque bouton est un programme (intelligent, bords, ciblé, serpillière) ou un nom de zone, saisi dans les réglages du widget. Vide, il propose les programmes puis les zones de l'aspirateur. Le programme en cours est coché.
• Télécommande aspirateur — pilotage manuel : avancer, tourner à gauche, à droite, stop, avec l'état et la batterie. Seulement sur les aspirateurs qui acceptent la commande de direction ; gardez le robot en vue.
• Entretien aspirateur — la durée de vie restante de chaque pièce en jauges, la plus usée d'abord, et une touche de remise à zéro (avec confirmation) pour chaque pièce usée, une fois remplacée.

Scènes

Déclencheurs (Quand… dans une scène) :

• Aspirateur : nettoyage terminé — le robot a fini un nettoyage et regagné sa base. Transmet la surface, la durée et la batterie aux actions suivantes (pour un message comme « Nettoyage terminé : {{area_m2}} m² en {{duration_min}} min »).
• Aspirateur : erreur — le robot signale un défaut (bloqué, roue, brosse, bac...), avec sa description.
• Aspirateur : pièce usée — la durée de vie restante d'une pièce est passée sous 10 %.

L'État du robot est aussi un état d'appareil classique, utilisable comme déclencheur.

Actions (Alors…) :

• Aspirateur : lancer un nettoyage — programme, aspiration et débit d'eau appliqués ensemble, puis départ : une carte au lieu de trois. Inchangé garde le réglage actuel du robot.
• Aspirateur : nettoyer une zone — nettoyer une zone par son nom, tel qu'il apparaît sur les boutons de zone de l'aspirateur (« Zone - Cuisine » → Cuisine). Majuscules et accents sont ignorés et un début de nom suffit s'il est unique (chamb pour « Chambres ») ; si plusieurs zones commencent pareil, le journal de la scène les liste. Gladys ne sait pas encore proposer les zones dans un menu déroulant ici ; l'action native Contrôler les appareils peut proposer les boutons « Zone - … » de l'aspirateur dans une liste.

Zones de nettoyage (robots LiDAR)

Sur les robots qui nettoient pièce par pièce (robots LiDAR avec des pièces dans l'app Smart Life), Gladys peut envoyer le robot nettoyer une pièce, plusieurs pièces, ou une zone dessinée dans l'app :

1. Le plus simple — la mémoriser depuis l'app. Lancez une fois le nettoyage de la pièce ou de la zone depuis l'app Smart Life, pendant que l'intégration tourne. Puis, dans l'écran de configuration de l'intégration, lancez Mémoriser la dernière zone : choisissez l'aspirateur, donnez un nom (« Cuisine »). Gladys peut ensuite la relancer à tout moment.
2. Ou saisissez les pièces par numéro, dans Pièces par numéro (avancé) : Cuisine=2, Salon=0+1, Chambres=3+4x2 (+ pour plusieurs pièces, x2 pour deux passages). Les numéros sont ceux du robot : l'intégration les journalise à chaque nettoyage de pièce lancé depuis l'app.

Ouvrez ensuite l'onglet Découverte et cliquez sur Mettre à jour sur l'aspirateur : chaque zone reçoit son bouton Zone - …, utilisable depuis le tableau de bord, le widget Nettoyage express et l'action de scène Aspirateur : nettoyer une zone. Oublier une zone mémorisée en retire une. Refaire la carte du logement dans l'app peut renuméroter les pièces : mémorisez à nouveau les zones après une nouvelle carte.

Prérequis

• L'aspirateur déjà configuré et fonctionnel dans l'application Smart Life ou Tuya Smart.
• La « Découverte réseau locale » (ou équivalent) activée pour l'appareil dans l'application Smart Life/Tuya Smart (généralement activée par défaut) — certains modèles ne diffusent leur présence sur le réseau local que si cette option est activée.

Configuration — Compte Smart Life (recommandé)

L'écran de configuration de cette intégration suit ces étapes de haut en bas, numérotées :

1. 1. Compte Smart Life : ouvrez l'application sur votre téléphone, allez dans Moi > Paramètres > Compte et sécurité > Code utilisateur, copiez-le, puis collez-le dans le champ Code utilisateur Smart Life.
2. 2. Enregistrez : cliquez sur Enregistrer avant de continuer — l'étape suivante a besoin que ce code soit déjà enregistré, sinon elle échoue avec une erreur.
3. 3. Connecter et scanner le QR code : cliquez sur ce bouton, un QR code s'ouvre. Dans l'application Smart Life/Tuya Smart, appuyez sur + > Scanner, visez le QR code, puis validez Confirmer la connexion. L'application peut indiquer que la connexion est pour « Home Assistant » — c'est normal, cette intégration utilise le même mécanisme officiel Tuya que l'intégration Home Assistant ; ne confirmez que si vous venez de lancer cette connexion vous-même.
4. Ouvrez l'onglet Découverte et lancez un scan — tous les appareils du compte apparaissent automatiquement, avec les fonctionnalités que chacun prend réellement en charge. Ajoutez ceux que vous voulez.

Et voilà — ajouter un nouvel aspirateur plus tard, c'est juste : l'appairer dans l'application Smart Life, puis Découverte > Scanner dans Gladys. Rien à configurer par appareil.

Configuration — Compte Tuya Cloud (avancé)

1. Rendez-vous sur iot.tuya.com, créez un projet Cloud (le modèle gratuit « Smart Home » suffit).
2. Dans l'onglet Devices du projet, choisissez Link Tuya App Account et scannez le QR code avec l'application Smart Life/Tuya Smart utilisée pour l'aspirateur. Ses appareils apparaissent alors dans All Devices.
3. Copiez l'Access ID/Client ID et l'Access Secret/Client Secret du projet (onglet Overview) dans l'écran de configuration de cette intégration, ainsi que la région dans laquelle le projet a été créé (visible dans l'URL du projet : eu/us/cn/in).
4. Copiez le Device ID de l'aspirateur depuis la liste All Devices dans le champ Identifiant(s) d'appareil (séparés par des virgules si plusieurs aspirateurs).
5. Enregistrez, ouvrez l'onglet Découverte, lancez un scan, puis ajoutez le(s) appareil(s).

Les deux méthodes peuvent tourner en même temps ; un identifiant d'appareil configuré via le compte Tuya Cloud est prioritaire sur le même appareil trouvé via le compte Smart Life.

Une action Tester la connexion est disponible depuis l'écran de configuration pour chaque aspirateur ajouté : elle indique si la session locale est active, et le dernier état connu de l'aspirateur (ou son état lu via le cloud si la session locale est indisponible).

Si l'IP locale de l'aspirateur n'est pas trouvée automatiquement

La découverte s'appuie sur l'annonce de l'aspirateur sur le réseau local (la même diffusion que celle utilisée par l'application du téléphone) — la méthode Compte Smart Life fournit aussi l'IP connue des serveurs Tuya comme seconde source. Si aucune des deux ne la trouve (diffusion bloquée entre VLAN, certains réseaux Wi-Fi maillés...), renseignez le champ IP(s) locale(s) manuelle(s) (avancé) : device_id=ip, par exemple eb1234567890abcdef01=192.168.1.42. Une IP fixe ou une réservation DHCP pour l'aspirateur est alors recommandée.

Une seule connexion à la fois

Comme la plupart des outils de contrôle local Tuya, un seul client peut détenir la session TCP locale de l'aspirateur à la fois. Garder l'application Smart Life/Tuya Smart ouverte sur l'écran de l'aspirateur en même temps que cette intégration est connectée peut rendre les deux instables — c'est une limite du micrologiciel de l'aspirateur lui-même, pas quelque chose que cette intégration peut contourner.

Dépannage

• « No room or zone clean seen since the integration started » en mémorisant une zone : lancez le nettoyage de pièce/zone depuis l'app Smart Life après le démarrage de l'intégration, attendez quelques secondes, puis relancez l'action. Si l'erreur persiste, votre robot ne signale pas sa sélection de pièces : saisissez les pièces par numéro.

• Un bouton de zone ne fait rien : les numéros de pièces ont pu changer après une nouvelle carte dans l'app — mémorisez à nouveau la zone.

• « Entrez d'abord votre code utilisateur Smart Life » alors qu'il est bien rempli : le formulaire n'a pas été enregistré avant de cliquer sur le bouton de connexion — ce sont deux actions séparées. Cliquez sur Enregistrer, attendez la confirmation, puis cliquez sur 3. Connecter et scanner le QR code. Si l'erreur persiste, vérifiez les logs de l'intégration (docker logs) : depuis la version 0.2.2, une tentative échouée y affiche le détail exact.

• Le QR code n'est pas confirmé / expire : il expire en 1-2 minutes — rouvrez-le (cliquez à nouveau sur Connecter) et scannez rapidement. Si l'application ne le reconnaît pas comme valide, essayez de changer Application du QR (avancé) entre Smart Life et Tuya Smart dans l'écran de configuration puis reconnectez-vous.

• Découvert mais bloqué sur « non connecté » : vérifiez le secours d'IP locale manuelle ci-dessus, et assurez-vous que rien d'autre (l'application du téléphone, un autre outil d'automatisation) ne détient déjà la session locale.

• Badge « Session locale injoignable, bascule sur l'API cloud Tuya » : l'intégration continue de fonctionner via les commandes/l'état du cloud pendant qu'elle retente la connexion locale en arrière-plan — les commandes continuent de fonctionner, avec juste plus de latence et un aller-retour cloud jusqu'à ce que la session locale soit rétablie.

• Une fonctionnalité attendue (ex. Water level) est absente : le catalogue Tuya de votre aspirateur ne signale peut-être pas ce code, ou le signale sous un nom que cette intégration ne reconnaît pas encore. Consultez les logs de l'intégration (LOG_LEVEL=debug) pour voir le schéma brut récupéré depuis Tuya.

• L'intégration journalise tout ce qu'elle fait : consultez les logs de l'intégration depuis l'interface Gladys (ou docker logs sur l'hôte) avec LOG_LEVEL=debug pour le détail complet.

Paramètres de configuration

Voici les paramètres demandés par Lubluelu SL68 (Tuya) dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Langue des noms d'appareil	select	Non	Noms des fonctionnalités et des choix créés dans Gladys, et des messages des évènements de scène. Les widgets suivent toujours votre langue.
1. Compte Smart Life (simple, recommandé)	section	Non	Aucun compte développeur Tuya nécessaire. Entrez votre code utilisateur Smart Life ci-dessous — Moi > Paramètres > Compte et sécurité > Code utilisateur dans l'app.
Code utilisateur Smart Life	string	Non
2. Enregistrez	section	Non	Cliquez sur Enregistrer maintenant, avant de continuer — l'étape 3 ci-dessous a besoin que le code utilisateur que vous venez d'entrer soit déjà enregistré, sinon elle échouera.
3. Connecter et scanner le QR code	account_link	Non	Ouvre un QR code — scannez-le avec l'application Smart Life/Tuya Smart et validez « Confirmer la connexion ». Tous les appareils de votre compte sont alors découverts automatiquement.
Application du QR (avancé)	select	Non	À changer seulement si le scan ou la confirmation ne fonctionne pas pour votre compte.
Alternative : Compte Tuya Cloud (avancé, optionnel)	section	Non	Une fois configuré, cet aspirateur est piloté directement sur votre réseau local, sans aller-retour cloud pour les commandes du quotidien. Mais le local_key de l'appareil (et son renouvellement dans le temps) ne se trouve que derrière le compte Tuya Cloud utilisé par votre application Smart Life/Tuya Smart : un projet Tuya IoT Platform gratuit est donc requis une fois — créez un projet Cloud, liez votre compte Smart Life/Tuya Smart (onglet Appareils -> Lier un compte d'application Tuya, scannez le QR code avec l'app), puis copiez l'Access ID/Client ID et l'Access Secret/Client Secret du projet ci-dessous, ainsi que le Device ID de l'aspirateur depuis la liste Tous les appareils.
Access ID / Client ID	secret	Non
Access Secret / Client Secret	secret	Non
Centre de données Tuya	select	Non	Le centre de données dans lequel votre projet Cloud a été créé (visible dans son URL sur Tuya IoT Platform : eu/us/cn/in).
Identifiant(s) d'appareil	string	Non	Le Device ID de l'aspirateur, depuis la liste Tous les appareils de Tuya IoT Platform (onglet Appareils). Plusieurs aspirateurs : séparez les identifiants par des virgules. Inutile avec la méthode Compte Smart Life ci-dessus, qui découvre tous les appareils automatiquement.
IP(s) locale(s) manuelle(s) (avancé)	string	Non	Utile seulement si le scan de diffusion réseau automatique ne trouve pas l'IP d'un appareil (VLAN bloqué, « Découverte réseau locale » désactivée dans l'app...). Paires device_id=ip séparées par des virgules, ex. « eb1234...=192.168.1.42 ».
Intervalle de rafraîchissement Tuya Cloud (min)	number	Non	Fréquence de revérification du local_key et de l'IP auprès de l'API Cloud Tuya. Le local_key change à chaque re-liaison de l'appareil au cloud : ce rafraîchissement doit donc tourner régulièrement, même si le contrôle au quotidien reste local.
Version du protocole local (avancé)	select	Non	Utilisé en secours uniquement tant que le scan de diffusion réseau n'a pas identifié la version propre à l'appareil. La plupart des appareils depuis 2020 utilisent 3.3 ou 3.4, les plus récents 3.5.
Zones de nettoyage (robots LiDAR)	section	Non	Nettoyez une pièce, plusieurs pièces ou une zone dessinée dans l'app, depuis un bouton, un widget ou une scène. Le plus simple : lancez une fois le nettoyage depuis l'app Smart Life, puis l'action « Mémoriser la dernière zone » ci-dessous avec un nom. Ou saisissez les pièces par leur numéro (l'intégration journalise les numéros à chaque nettoyage de pièce lancé depuis l'app). Cliquez ensuite sur « Mettre à jour » sur l'aspirateur dans l'onglet Découverte.
Pièces par numéro (avancé)	string	Non	Paires nom=numéros séparées par des virgules, plusieurs pièces jointes par +, x2 pour deux passages. Exemple : « Cuisine=2, Salon=0+1, Chambres=3+4x2 ».

Comment installer Lubluelu SL68 (Tuya) dans Gladys

1. Dans Gladys, ouvrez Intégrations : Lubluelu SL68 (Tuya) apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-lubluelu-vaccum:0.3.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-lubluelu-vaccum.

Lubluelu SL68 (Tuya) nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Lubluelu SL68 (Tuya) est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations externes
• Découvrir les intégrations natives intégrées à Gladys
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂