Hack · iRobot Roomba
Le piloter depuis un simple appel REST
rest980 enveloppe dorita980 dans un petit serveur HTTP local, si bien que lancer un nettoyage ou vérifier la batterie n'est plus qu'une requête, depuis Home Assistant, un script, ou un bouton sur un tableau de bord.
Un petit serveur HTTP local qui transforme un lancement de nettoyage, une pause, un retour à la base ou une lecture du niveau de batterie en une simple requête, pour Home Assistant, un script ou un bouton sur un tableau de bord, le robot restant sur ton propre réseau une fois configuré.
Est-ce que ça marche sur le mien
Modèles de iRobot Roomba, pas encore vérifiés pour ce hack en particulier
Ce que ça coûte
rest980 a d'abord besoin du BLID et du mot de passe propres au robot : le
README de dorita980 recommande son assistant cloud pour ça
(get-roomba-password-cloud, lancé en ligne de commande avec l'email et
le mot de passe de ton compte iRobot) et note que l'ancienne méthode,
qui consiste à maintenir le bouton physique du robot en demandant le mot
de passe sur le réseau local, « ne fonctionne plus avec les derniers
firmwares ». Une seule connexion locale au robot est permise à la fois.
Les étapes
- Récupère le BLID et le mot de passe de ton robot avec l'assistant cloud de dorita980, en suivant le README de dorita980 lui-même.
- Installe rest980 depuis npm ou lance son image Docker, comme indiqué dans le README de rest980 lui-même.
- Démarre rest980 avec le BLID, le mot de passe et l'adresse IP du robot, selon le même README.
- Envoie des requêtes HTTP à ses routes locales pour démarrer, arrêter, mettre en pause, faire rentrer à la base ou reprendre un nettoyage, ou pour lire son statut, en suivant la liste des routes du même README.
Risques et retour en arrière
Rien n'est flashé sur le robot : rest980 ne fait que relayer des requêtes par la même connexion locale MQTT/TLS que dorita980 ouvre vers lui, et une seule connexion de ce genre est permise à la fois, donc le pire des cas est une requête qui arrive pendant qu'une autre est déjà connectée. Le README de dorita980 recommande de bloquer complètement l'accès internet du robot, puisqu'il prévient que de nouveaux firmwares livrés par-dessus le réseau peuvent faire cesser de fonctionner dorita980. Le retour en arrière est immédiat : arrête rest980 et pilote le robot depuis l'appli exactement comme avant.
Projets utilisés
Sources
- rest980 README
Guide· koalazak· Lu le 26 oct. 2026
- dorita980 README
Guide· koalazak· Lu le 26 oct. 2026