Hello @Lokkye je tai fais un pr pour ajouter un widget et des actions et declencheur.
main ← vincentBesseau:feat/vacuum-map
ouvert 11:53AM - 05 Oct 26 UTC
## Résumé
Deux ajouts pour l'intégration Roborock :
1. **Carte de l'aspirateur… en widget de dashboard** (SDK `0.14`, widgets Gladys `5.1`).
2. **Déclencheurs et actions de scène** (l'aspirateur dans l'éditeur de scènes).
## 1. Carte en widget
- **Récupération** : `get_map_v1` (frame protocole `301`, déchiffrement AES‑128‑CBC + gunzip), transport local-first avec repli cloud.
- **Parseur RRMap** : format binaire → objet structuré (segments, robot, base, trajet, zones interdites, murs virtuels…), réconcilié avec `get_room_mapping` pour les **noms de pièces**.
- **Rendu PNG maison** (via `node:zlib`, sans dépendance) proche de l'app : pièces colorées, murs fins, zones interdites, murs virtuels, base/robot, **fond transparent** (s'adapte au thème clair/sombre).
- **Widget « Aspirateur »** : tuiles batterie / surface, carte, bloc état (état, dernier nettoyage, durée, **% de chaque consommable**) et **4 boutons** — Démarrer + Retour base fixes, et **2 boutons configurables** via les réglages.
- **Timestamp de début du dernier nettoyage** (`get_clean_summary`, mis en cache).
## 2. Scènes
Déclaré dans le manifest (`scene_triggers` / `scene_actions`), branché sur les données déjà pollées et les commandes RPC existantes.
**Déclencheurs** (émis sur transition via `publishSceneEvent`) :
`cleaning_started`, `cleaning_finished` (durée, surface), `returned_to_dock`, `battery_low` (≤ 20 %), `charging_complete`, `robot_error` (code + libellé), `consumable_worn` (≤ 10 %, par consommable), `state_changed`.
**Actions** (`onSceneAction`, chacune avec un champ `vacuum`) :
`start_cleaning`, `pause_cleaning`, `stop_cleaning`, `return_to_dock`, `clean_rooms` (noms de pièces → `app_segment_clean`), `set_fan_power` (silencieux/équilibré/turbo/max), `run_routine` (nom de routine → `executeRoutine`).
Les transitions sont détectées via un instantané par robot mis en cache entre deux polls (le premier poll ne fait qu'amorcer le cache). Les seuils sont gérés côté intégration (les filtres de scène sont à égalité seulement) et le niveau/pourcentage est exposé en variable de scène.
## Points d'attention
- ⚠️ **`gladys_version` passe à `>=5.1.0`** : les widgets de dashboard nécessitent Gladys 5.1.0 (c'était `>=4.86.0` sur `main`).
- **Bump de version patch** : `2.3.0` → `2.3.1`.
- **Transport local QV35A** : silencieux en TCP local quand il est à la base (en charge) → repli automatique sur le cloud, documenté.
## Tests
- `114` tests passent (`node --test`), `eslint` et `prettier --check` clean.
## Suite possible
Demande de fonctionnalité pour une **carte interactive** (sélection de pièces au clic → nettoyage ciblé), qui nécessiterait un composant frontend côté cœur : https://community.gladysassistant.com/t/composant-carte-interactive-zones-cliquables-pour-les-widgets-dintegration-externe/10959
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Jai aussi fais une demande pour un jour sélectionner sur la map les pièces a nettoyer et ainsi faire évoluerce widget
Bonjour
Je développe un widget pour l’intégration externe Roborock qui affiche la carte de l’aspirateur (via onWidgetGetImage). Le rendu fonctionne très bien, mais je bute sur une limite du vocabulaire des widgets : il n’existe aucun moyen de rendre la carte interactive.
Aujourd’hui dans un widget on ne dispose que de composants statiques (image, value, gauge, status, chart, card-list) + button (plafonné à 4). Les limites concrètes :
• la carte est une image figée : impossible d…
Je ne sais pas si vous avez vu ce qui a été fait pour les intégrations externes Robot Dreame (Demande d'intégration externe pour robot aspirateur/laveur DREAME - #39 par Chris75 ) et l’intégration Robot Mammotion (Intégration externe - Mammotion - #41 par prohand )
Les ayant longuement testé, je suis vraiment très satisfait du résultat car maintenant je peux me passer des applis officielles de la marque pour toutes les fonctions et réglages essentiels
Et ça été développé par @guim31 @prohand en 1 semaine
guim31
Octobre 5, 2026, 7:25
23
Oui mais ça c’est parce qu’on est trop forts
Haha (pour prompter Claude !)
Lokkye
Octobre 6, 2026, 12:20
24
Merci beaucoup pour ta PR, je suis en train de la relire et de te faire quelque retour
as tu remarqué qu’il y avait des issue sur le repo :
Lokkye
Octobre 6, 2026, 2:00
28
Non, je ne sais pas pk je n’ai pas reçu les mails , « je » suis en train de faire les fixes
Lokkye
Octobre 6, 2026, 2:07
29
Version 2.5.0 publié avec le code de @spenceur et 2 fixes
guim31
Octobre 6, 2026, 2:52
30
Cool ce nouveau widget !!
@Lokkye
j’ai fais une correction sur le saut de l’image qui n’était pas très jolie et ajouter une condition pour les scenes
main ← vincentBesseau:feat/map-live-rendering
ouvert 04:42PM - 06 Oct 26 UTC
## Résumé
Rend le **widget carte** stable au rafraîchissement et **quasi temps … réel pendant un nettoyage**, sans changer le vocabulaire du widget (toujours un PNG rendu côté serveur).
Avant : à chaque rafraîchissement la carte pouvait **« sauter »** (se redimensionner / clignoter), et elle n'avançait qu'au `ttl` du contenu.
## Ce que ça corrige
### A. Rendu à cadre fixe (`src/roborock/mapRender.js`)
La taille de sortie est désormais dérivée du **crop stable** (les pièces nommées) via une nouvelle option `targetLongestPx`, au lieu du poids en octets. Le même logement rend **toujours aux mêmes dimensions** → plus de reflow/rescale quand seuls le robot et le tracé bougent. Le garde-fou octets reste (réduction déterministe de la cible).
### B. Clé d'image = hash du rendu (`src/devices/mapWidget.js`, `index.js`)
La clé d'image est maintenant un **hash des octets PNG** (plus `mapSequence`). Le cœur ne **remplace l'`<img>` que si l'image a réellement changé** → plus de flash quand rien n'a bougé. `MAP_RENDER_VERSION` 7 → 8 pour invalider l'ancien cache. Le garde-fou 64 caractères de la clé est conservé.
### C. Quasi temps réel pendant le nettoyage (`index.js`)
- Suivi des robots ayant une **session de nettoyage active**.
- Pendant le nettoyage : cache carte **~8 s** (au lieu de 60 s) + **nudge `requestWidgetRefresh` toutes les ~15 s** (plafond cœur 1/10 s, no-op si aucun widget ouvert).
- Au repos : cache 60 s, pas de nudge.
→ La carte avance « par pas » de ~15 s pendant le ménage, puis se met en veille à la base.
## Limite connue
Le léger flash de chargement quand l'image change **vraiment** (pendant un nettoyage) reste géré par le frontend du cœur — une intégration externe ne peut pas faire de cross-fade. A + B le réduisent au strict minimum (même taille, swap uniquement sur vrai changement).
## D. Condition de scène « Nettoyé aujourd'hui »
Nouvelle feature **read-only `cleaned-today`** (0/1, 1 = l'aspirateur a tourné aujourd'hui), dérivée du dernier début de nettoyage. Elle permet une **condition de scène** « est-ce que l'aspirateur a tourné aujourd'hui ? » (ex. ne lancer un nettoyage que s'il n'a pas déjà tourné). Toujours publiée (même 0) pour que les deux branches de la condition fonctionnent. (`src/devices/lastClean.js`, `src/devices/convertDevice.js`, `index.js`.)
## Tests
- `128` tests passent (`node --test`), `eslint` OK.
- Nouveaux tests : dimensions de sortie stables quand seul le robot bouge (A) ; round-trip de la clé avec signature hash (B) ; `isCleanedToday` / état 0-1 (D).
Basé sur `main` (2.5.0) → **2.5.1** (patch).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Désolé du fix a cette heure ci
bonjour je ne vois pas ma carte ? dois je faire autre chose ?
Lokkye
Octobre 7, 2026, 5:39
33
@spenceur Dsl pour le temps de réaction mais un « petit » mal de tête ma tenu compagnie toute la soirée. J’ai fait une petit modif dans ta PR, il faudrait eviter de modifier le numero de version dans les PR car c’est un autre process qui le fait au moment de build l’image docker.
C’est publié sous la version 2.5.1
Bonjour, oui super widget pour les aspirateurs Roborock, il s’affiche parfaitement chez moi pour un Saros 10 R et un S7 Max Ultra :
Même la dernière activité arrive … ils enregistrent vraiment tout
Il ne manque plus qu’à ajouter la sélection des pièces au widget…
Diversité linguistique… j’apprends même le français :
;-)
Désolé, je dois malheureusement attirer votre attention sur mon message :
offen 07:40AM - 11 Oct 26 UTC
Saros 10R:
( Main options: Vacuum, then mop / Vac & Mop / Mop / Vacuum )
Integr… ation:
( Car / Fast / Quiet / Low-noise / Deep cleaning / Vacuuming / Mopping )
<img width="199" height="354" alt="Image" src="https://github.com/user-attachments/assets/78d91998-0c85-4eec-8f77-945a30fad012" />
Test 1:
Cleaning - Quick - Room 13
<img width="203" height="354" alt="Image" src="https://github.com/user-attachments/assets/f1fc5b0f-2439-421e-9908-d91d8379fd5c" />
Result:
Vac&Mop - Room 12:
<img width="720" height="1640" alt="Image" src="https://github.com/user-attachments/assets/fd07d8e2-d713-41b7-938b-2abdd68af299" />
Test 2:
Cleaning - Quiet - Room 11
<img width="197" height="348" alt="Image" src="https://github.com/user-attachments/assets/59fedb8c-6e83-4aae-a029-40ae2e81fc73" />
Result:
Vac&Mop - Room 11
<img width="720" height="1640" alt="Image" src="https://github.com/user-attachments/assets/d2459529-c4bd-43e4-bf13-c15499510f5f" />
Test 4:
Cleaning - Vacuuming - Room 10
<img width="196" height="328" alt="Image" src="https://github.com/user-attachments/assets/3e104527-0077-4631-a790-dd67705074a8" />
Result:
Vac&Mop - Room 11
<img width="720" height="1640" alt="Image" src="https://github.com/user-attachments/assets/b473fc66-a7d7-467f-8427-2a49fd9b0d40" />
Translation is inconsistent: German - French - English:
<img width="194" height="346" alt="Image" src="https://github.com/user-attachments/assets/72a8d1d6-30b9-47e8-844c-1381ba5f20b7" />
Il semble que, pour certains modèles plus récents de Roborock, les associations entre les fonctions et entre les pièces soient différentes…
Je ne veux vraiment pas arrêter, ralentir ou interrompre d’une autre manière l’élan actuel des développements d’intégrations.
Mais le développement fondamental de Claude sans avoir les objets réels sous la main ou l’accès correspondant aux appareils de test semble pourtant problématique.
Voici l’exemple de Roborock:
– Un fouillis de traductions
– L’association des pièces est plutôt laissée au hasard. Parfois, l’intégration prend le dernier réglage, parfois une pièce complètement différente et parfois ça marche vraiment.
– Les sous-fonctions ne sont pas réglables, en particulier sur les modèles plus récents. Voici un S7 Max Ultra avec ses sous-fonctions :
Aspiration
L’intégration ne propose pas que la puissance d’aspiration, le nombre de nettoyages ou la distance puisse être associé à l’aspiration.
Aspiration & Lavage
Ici aussi, les sous-fonctions ne sont pas proposées, donc la puissance d’aspiration, l’intensité de lavage, le nombre de nettoyages ou la distance
Lavage
– L’intégration ne propose pas que je puisse regrouper les pièces, donc je ne peux pas dire : S’il vous plaît, nettoyer la pièce 10 et 12. Je suis obligé de nettoyer d’abord la pièce 10 puis de répéter le processus avec la pièce 12.
Résultat final:
L’intégration semble avoir été développée très rapidement sans tests suffisants. Le widget ne réagit pas non plus de manière stable. Parfois le widget fonctionne, parfois non. État incohérent.
Désolé, désolé, mais l’intégration ne devrait pas être publiée à l’état actuel de développement.
guim31
Octobre 11, 2026, 8:31
39
Même si je partage ton ressenti en partie je ne pense pas que la conclusion que tu donnes soit la bonne.
En effet, j’ai un Roborock Saros 20x donc je peux tester et constater qu’il y a des manques.
Le souci est plutôt qu’il faut trouver un arbitrage efficace entre 2 situations :
soit on attend qu’un développeur possède le matériel et publie une intégration (sachant qu’en plus il ne peut pas posséder tout le matériel d’une même marque / protocole)
soit on se lance et on espère des retours utilisateurs (qui n’ont pas besoin d’être des développeurs).
Je pense sincèrement qu’il n’y a pas de débat.
Après on pourrait toujours savoir si on considère une intégration comme « beta » qui a besoin de testeurs ou « stable »… Mais même là, la limite est floue.
Ce n’est que mon avis bien sûr, et je trouve surtout que ton retour est précieux pour faire évoluer rapidement l’intégration !
@guim31 : Ne me faites pas dire ce que je n’ai pas dit, je suis le dernier à vouloir ou à pouvoir influencer qui que ce soit ici.
Ma référence aux appareils de test concerne les propres indications du développeur :
La couche appareil (transports MQTT et TCP locaux, commandes RPC) est couverte par des tests unitaires et des tests de bout en bout contre des faux, mais n’a jamais été testée sur un vrai robot sur un compte Roborock . En revanche, la chaîne d’authentification est vérifiée de bout en bout contre le cloud en direct : découverte de la région, sendEmailCode, loginWithCode, l’identifiant de domicile, et les données de domicile signées Hawk.
Trouvé :
GitHub - callemand/gladys-roborock: Roborock robot vacuum integration for Gladys Assistant (Xiaomi Home account, local miIO with cloud fallback) · GitHub
J’ai remarqué que mes aspirateurs présentent de grandes différences avec les modèles plus anciens et cette combinaison de ses propres indications et de mes tests m’a conduit à mon post.
Si j’ai marché sur les pieds de quelqu’un (expression allemande ), alors je m’excuse.
Cordialement
Tom