Überblick
Roomba+ ist eine Integration für iRobot Roomba und Braava Roboter, die sich über lokales MQTT mit ihnen verbindet. Sie funktioniert ohne Cloud-Konto, und die iRobot-Cloud-Zugangsdaten sind optional und werden für die Kartensynchronisierung und für Analysen verwendet. Sie fügt Entitäten für Saugroboter, Sensor, Taste, Schalter, Auswahl, Bild, Kalender, Ereignis und To-do-Liste hinzu und deckt Wartung, Einsatzverlauf und Raumkarten ab. Das Reinigen kann angehalten werden, solange erfasste Personen zu Hause sind, automatisch gestartet werden, wenn der Boden schmutziger ist als üblich, oder durch ausgewählte Binärsensoren wie einen Türkontakt blockiert werden. Zu den Aktionen gehören das Reinigen benannter Räume oder Zonen, das Starten einer Abfolge von einem Roboter zum nächsten sowie das Erstellen oder Wiederherstellen von Backups. Roboter, die das neuere V4/Prime-Protokoll verwenden, unterstützen keine lokale Steuerung. Die Einrichtung erfolgt in der Benutzeroberfläche, entweder mit einem iRobot-Konto oder durch Eingabe der Adresse des Roboters.
Zusammenfassung der README und des Codes von johnnyh1975/ha_roomba_plus, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Geräteauslöser Die Geräte können Automationen direkt starten.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Saugroboter
- Schalter
- Sensoren
- Anwesenheit
- Kalender
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Roomba+ hinzufügen
- Roboter auswählenDer einzurichtende Roboter. Empfohlen ist die Einrichtung mit Ihrem iRobot-Konto: Sie funktioniert für jeden Roboter, findet alle Roboter des Kontos und braucht keinen Tastendruck. Ein Roboter mit lokaler Verbindung braucht trotzdem seine Adresse im Netzwerk: Sie wird gesucht und abgefragt, wenn sie nicht gefunden wird. Im Netzwerk gefundene Roboter stehen ebenfalls in der Liste; wählen Sie die manuelle Eingabe, falls Ihrer fehlt.
Manuelle Einrichtung
- IP-AdresseLokale IP-Adresse des Roomba
Passwort eingeben
- PasswortDas lokale Passwort des Roboters. Es wird automatisch gelesen, während du die HOME-Taste hältst; gib es nur ein, wenn das fehlgeschlagen ist.
iRobot Cloud-Zugangsdaten (optional)
- iRobot E-MailDie E-Mail-Adresse zur Anmeldung in der iRobot App.
- iRobot PasswortDein iRobot App-Passwort.
Wird auch bei „Mit deinem iRobot-Konto anmelden“ abgefragt.
Roboter auswählen
- RoboterDer Roboter aus deinem iRobot-Konto, der hinzugefügt werden soll. Jeder Roboter wird ein eigener Eintrag.
Erneut mit der iRobot-Cloud verbinden
- iRobot-E-MailDie E-Mail-Adresse für die Anmeldung in der iRobot-App.
- iRobot-PasswortDein aktuelles iRobot-App-Passwort.
Verbindung ändern
- IP-AdresseDie lokale IP-Adresse des Roomba.
- PasswortDas lokale Passwort des Roboters. Leer lassen, um es aus deinem iRobot-Konto zu übernehmen (Roboter, die mit Konto eingerichtet sind).
Nach der Einrichtung
- Live-Karte aktivierenAktiviert die Live-Reinigungskarte für Roboter mit Positionserkennung (Roomba 900, i, s, j, Braava m).
- Roboter nach seiner Position fragenNur für Roboter, die ihre Position nicht selbst melden. Fragt den Roboter während der Reinigung etwa einmal pro Sekunde, um den Reinigungsweg live zu zeichnen. Aus: Die Karte zeigt stattdessen die letzte abgeschlossene Mission aus der iRobot-Cloud, sofern der Cloud-Zugang eingerichtet ist.
- Weg an den Räumen ausrichtenNur mit der Option darüber. Dreht den Reinigungsweg gegen den Grundriss, bis er auf seinen Räumen liegt. Die Raumerkennung nutzt dieselben gedrehten Positionen, ein falscher Winkel nennt also auch den falschen Raum. Nicht dasselbe wie „Kartenbild drehen“: Das dreht das ganze Bild und verschiebt den Weg nie gegen die Räume. Automatisch beginnt mit der Drehung aus der Karte, die der Roboter gespeichert hat, einschließlich einer Drehung aus der iRobot-App, und wechselt zu dem Winkel, der den Weg des Roboters in die Räume legt, sobald ein Lauf das deutlich gezeigt hat; der schon gezeichnete Weg dreht sich mit. Läuft der Weg trotzdem durch Wände oder neben seinen Räumen, stelle einen Winkel ein: Der schon gezeichnete Weg dreht sich, sobald du speicherst.
- Kartengröße (Pixel)Bildgröße der Karte in Pixel (400–1200). Standard: 600 px.
- Maßstab (mm/Pixel)Millimeter pro Pixel (5–30). Standard 10 entspricht 6 m × 6 m bei 600 Pixel.
- Etage (z. B. Erdgeschoss)Freitext, zum Beispiel Erdgeschoss. Gruppiert Roboter in der Flottenansicht.
- Schmutz mit Sensoren korrelieren (optional)Sensoren wie Luftfeuchte oder Pollen. Nach 30 Missionen meldet Roomba+, ob der Roboter bei hohen Werten mehr Schmutz sammelt. Wird lokal berechnet.
- Raumnamen ins Kartenbild zeichnenSchreibt die Namen der Räume in das Kartenbild.
- Für jeden gespeicherten Favoriten einen Knopf anlegenEine Taste für jeden in der iRobot-App gespeicherten Favoriten. Bei vielen Favoriten sind das viele Tasten.
- Reinigungspläne als Kalender anzeigenZeigt die Reinigungszeitpläne des Roboters als Kalender.
- Reinigungszonen zeichnenUmrandet die Reinigungszonen im Kartenbild.
- Sperrzonen zeichnenUmrandet die Sperrzonen im Kartenbild.
- Wischverbotszonen zeichnenUmrandet die Nicht-Wischen-Zonen im Kartenbild.
- Eigener Sensor je Raum und ZoneLegt für jeden Raum und jede Zone einen eigenen Sensor an.
- Kartenbild drehenDreht jedes Kartenbild als Ganzes im Uhrzeigersinn, Räume und Weg gemeinsam, etwa passend zur iRobot-App. Den Weg gegen die Räume verschiebt es nie, dafür gibt es „Weg an den Räumen ausrichten“. Die Karte hat keine Nordrichtung: Oben ist die Richtung, in die der Roboter beim Verlassen des Docks schaut. Sie hängt davon ab, wie das Dock steht.
- Zonen-IDs (kommagetrennt)Beispiel: 5, 12, 7
- ZonennamenEine Zeile pro Zone: 21=Korridor, 22=Küche, usw.
- iRobot E-MailDie E-Mail-Adresse deines iRobot-App-Kontos. Lass beide Felder leer, um die Cloud-Funktionen abzuschalten.
- iRobot PasswortDas Passwort deines iRobot-App-Kontos.
- SperrsensorenBinärsensoren, die einen Start blockieren, wenn aktiv (z.B. Tür offen, Bewegung erkannt).
- Verhalten bei SperreSofort abbrechen oder Start in Warteschlange stellen, bis Sensoren inaktiv werden.
- Warteschlangen-Timeout (Minuten)Wie lange auf das Inaktivwerden der Sensoren gewartet werden soll, bevor aufgegeben wird.
- Zu bearbeitende ZoneDie Zone, die umbenannt oder ausgeblendet werden soll. Ohne Auswahl absenden, um die Änderungen zu speichern.
- AnzeigenameBenutzerdefinierter Name in Auswahlmenüs. Leer lassen für den Standardnamen.
- Diese Zone ausblendenAusgeblendete Zonen werden aus Auswahlmenüs entfernt und lösen keine Benennungs-Reparaturmeldungen aus.
- Anwesenheitsbasierte Planung aktivierenHält Reinigungszeitpläne an, solange jemand zu Hause ist, und gibt sie frei, sobald alle weg sind.
- Verfolgte PersonenDie Personen, deren Anwesenheit zählt.
- Modus„Freigeben, wenn alle weg sind“ gibt Zeitpläne automatisch frei; „Ereignis auslösen (manuelle Steuerung)“ überlässt die Entscheidung deiner eigenen Automation.
- Verzögerung nach dem Verlassen (Minuten)Wie lange alle weg sein müssen, bevor Zeitpläne freigegeben werden.
- Verzögerung vor Start des zweiten RobotersEine zusätzliche Wartezeit nach der Abwesenheitsverzögerung, bevor die Reinigung tatsächlich beginnt.
- Bedarfsreinigung aktivierenStartet automatisch eine Reinigung, wenn der Boden deutlich schmutziger ist als üblich.
- Auslösemultiplikator (z.B. 1,5 = 50 % über Durchschnitt)Ab wie viel über dem üblichen Schmutzniveau gereinigt wird: 1,5 bedeutet 50 % über dem Durchschnitt.
Texte aus dem Code von johnnyh1975/ha_roomba_plus.
Entitäten
- BinärsensorenBehälter voll, Verbunden, Behälter eingesetzt, Wischroboter-Problem, Wassertank im Roboter, Dock-Fehler, Mop-Deckel offen, Smart Map wird gespeichert, Wartung – Fällig, Start blockiert und 11 weitere
- TastenAktion – Behälter leeren, Aktion – Roboter suchen, Wartung – Filterwechsel bestätigen, Wartung – Bürstenwechsel bestätigen, Wartung – Akkuwechsel bestätigen, Zone reinigen, Letzte Mission wiederholen, Aktuellen Raum überspringen, Zone reinigen (Smart Map), Spot-Reinigung (experimentell) und 20 weitere
- KalenderZeitplan, Wartung
- AnwesenheitPosition
- EreignisseReinigung beendet, Raum fertig, Festgefahren, Wartung
- BilderReinigungspfad, Befahrungs-Heatmap, Raumkarte, Live-Reinigungskarte, Rohe Live-Karte
- AuswahlfelderEinstellung – Reinigungsdurchgänge, Zone auswählen, Smart Map Zone auswählen, Zone auswählen (Cloud), Einweg-Pad Nässe, Wiederverwendbares Pad Nässe, Teppich-Boost, Saugstufe, Karte und 9 weitere
- SensorenWartung – Ladezyklen, Missionen – Gesamtzeit, Missionen – Durchschn. Dauer, Missionen gesamt, Missionen erfolgreich, Missionen abgebrochen, Missionen fehlgeschlagen, Gesamte gereinigte Fläche, Missionen – Letzte und 139 weitere
- SchalterEinstellung – Randreinigung, Einstellung – Mission immer beenden, Einstellung – Zeitplan pausieren, Einstellung – Kindersicherung, Einstellung – Öko-Laden, Einstellung – Sanfter Modus, Einstellung – Teppich-Boost, Kindersicherung, Eco-Laden und 6 weitere
- To-do-ListenWartung
Aktionen
- Raum reinigenStartet die gezielte Reinigung eines oder mehrerer benannter Räume bei Smart-Map-Robotern.Felder: Raumname, Geordnete Reihenfolge
- Filter zurücksetzenZeichnet den aktuellen Zeitpunkt als Austauschzeitpunkt des Filters auf.
- Bürsten zurücksetzenZeichnet den aktuellen Zeitpunkt als Austauschzeitpunkt der Bürsten auf.
- Akku zurücksetzenZeichnet den aktuellen Zeitpunkt als Austauschzeitpunkt des Akkus auf.
- Reinigungspad zurücksetzenZeichnet den aktuellen Zeitpunkt als Austauschzeitpunkt des Pads auf (nur Braava).
- Smart StartStartet eine Reinigung mit Sperrsensor-Prüfungen.
- Sequenzreinigung startenStartet Roboter B, wenn Roboter A seine aktuelle Mission abgeschlossen hat. Der Listener wird einmalig ausgelöst und entfernt sich automatisch.Felder: Auslöse-Roboter, Ziel-Roboter, Abschluss erforderlich, Verzögerung (Minuten)
- Backup erstellenExportiert alle gespeicherten Daten dieses Roboters in eine einzelne ZIP-Datei.
- Backup wiederherstellenStellt alle Daten aus einer Backup-ZIP wieder her. Wirkt sofort, kein Neustart nötig.
- Ruhezeiten setzenSchreibt das Ruhefenster des Haushalts.Felder: Beginn, Ende, Ruhe bis
- Zone reinigenSchickt den Roboter auf Anforderung zu einer oder mehreren Reinigungszonen, per Name (wie in der Zonenauswahl) oder numerischer ID. Für Classic- und Prime-Roboter.Felder: Zonenname, Zonen-ID
- Wartung erledigtMeldet einen Wartungseintrag als erledigt: ein Teil ersetzt oder eine Pflegeaufgabe ausgeführt. Bei einem Prime-Roboter geht das Zurücksetzen an iRobot, so wie die App es sendet.Felder: Eintrag, Handlung
- Wartungserinnerung zurückstellenFür einige Tage keine Erinnerung an einen Wartungseintrag.Felder: Eintrag, Tage
- Gelerntes Wartungsintervall vergessenVergisst das aus deinen eigenen Wechseln gelernte Intervall, für ein Teil oder alle Teile eines Classic-Roboters. Der Zähler des aktuellen Teils bleibt.Felder: Einträge
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Neue Räume erkannt, Roboter-Laufzeitzähler möglicherweise zurückgesetzt, Mögliches Batterie- oder Kontaktproblem, Roboter-erkannte Hindernisse in der Cloud-Karte, Problem mit Dock-Kontaktgesundheit erkannt, Roboter-MQTT-Verbindung während Mission verloren, Smart-Map-Update scheint hängen zu bleiben, Mögliche Layout-Änderung erkannt, Favorit hat mehrere Befehlsschritte, Zwei Roomba-Integrationen installiert
Aus der README
Roomba+ is a Platinum-quality Home Assistant custom integration for iRobot Roomba and Braava robots. It connects directly over local Wi-Fi MQTT — no cloud account required, no polling, no subscription — and exposes far more sensors, intelligence, and controls than the built-in HA integration.
Erscheint in Vulpo
Schnellumschalterkarte, Saugroboter-Karte, Tastenkarte, Auswahl-Karte, Apple Watch, Kontrollzentrum, Saugroboter-Live-Aktivität.Informationen
- Installationen
- 377 teilen Analysedaten
- GitHub-Sterne
- 59
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v4.5.1,
- Kategorie
- Haushaltsgeräte und Reinigung, Reinigung
- Art
- Marketplace-Integration
- Marke
- iRobot
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
roomba_plus- Probleme
- Problem melden









