Saugroboter
Das Modul bietet die Möglichkeit, mit einem kompatiblen Saugroboter über das lokale Netzwerk zu kommunizieren.
1. Funktionsumfang
Das Modul kommuniziert via MQTT mit dem Saugroboter und bietet neben dem Auslesen aller Geräteinformationen auch das
Steuern des Roboters über die Statusvariablen.
Eine genaue Beschreibung der für den Saugroboter verfügbaren Befehlsumfang kann man im Tuya Developer Portal
einsehen.
2. Voraussetzungen
- Symcon ab Version 8.1
- tuya2mqtt ab Version 1.5.0 (für Bridge-Status und den Abruf aller Werte beim Start)
Notwendige Voraussetzung ist eine funktionsfähige und laufende Installation von Tuya2Mqtt
. Dessen Installation, Konfiguration und der Betrieb ist hier beschrieben: README
.
Dort findet man ebenfalls die unterstützten Tuya Geräte.
Getestet mit meinem Saugroboter P20 von AIRROBO.
3. Installation
- Über den Modul Store die Bibliothek LocalTuya installieren.
- Alternativ über das Modul Control folgende URL hinzufügen.
https://github.com/Wilkware/LocalTuyaodergit://github.com/Wilkware/LocalTuya.git
4. Einrichtung
- Unter ‘Instanz hinzufügen’ ist das Saugroboter-Modul (Alias: Tuya Saugroboter) unter dem Hersteller ‘(Geräte)’ aufgeführt.
Konfigurationsseite:
Einstellungsbereich:
📳 Geräteinformationen …
| Name | Beschreibung |
|---|---|
| MQTT Base Topic | Ist das grundlegende Themenpräfix, unter dem alle spezifischen Subtopics für Nachrichten in einem MQTT-System organisiert werden. Standardmäßig ist der Präfix auf ’tuya2mqtt’ vorbelegt. Er muss dem topic aus der config.json von tuya2mqtt entsprechen, darf mehrstufig sein (z. B. ‘home/tuya’) und ein abschließender / wird ignoriert. |
| MQTT Topic | Ist der eindeutige Geräte-Pfad, der zum Veröffentlichen und Abonnieren von Nachrichten verwendet wird. HINWEIS: tuya2mqtt bildet den Pfad aus dem Gerätenamen in Kleinbuchstaben, Leerzeichen sowie die Zeichen +, # und / werden durch _ ersetzt (z. B. ‘Wohnzimmer Lampe’ → ‘wohnzimmer_lampe’). Ohne Namen wird die Geräte-ID verwendet. |
Aktionsbereich:
| Aktion | Beschreibung |
|---|---|
| AKTUALISIEREN | Löst eine Nachricht aus, welche versucht alle Status(Geräte)informationen vom Gerät abzurufen. |
Da tuya2mqtt Werte nur noch bei Änderungen veröffentlicht, fordert das Modul beim Systemstart und nach dem Übernehmen der Konfiguration automatisch alle aktuellen Werte an (get-states).
5. Statusvariablen
Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann hilfreich sein, z.B. wenn entsprechender Befehl/Status nicht vom Roboter unterstützt wird.
| Name | Typ | Beschreibung |
|---|---|---|
| Status | String | Verfügbarkeitsstatus des Gerätes |
| Betrieb | Boolean | Betriebszustand ein- bzw. ausschalten |
| Modus | String | Aktueller Gerätemodus |
| Zustand | String | Aktueller Betriebsstatus |
| Richtungssteuerung | String | Steuerung der Richtungsbewegung |
| Batterieladung | Integer | Aktueller Ladezustand |
| Kantenbürste | Integer | Lebensdauer der Seitenbürste |
| Walzenbürste | Integer | Lebensdauer der Hauptbürste |
| Filter | Integer | Lebensdauer des Filters |
| Saugstufe | String | Stärke der Saugstufe |
| Reinigungsbereich | Integer | Gereinigte Fläche |
| Reinigungszeit | Integer | Verbrauchte Zeit für Reinigung |
| Reinigungsgeschwindigkeit | String | Schnelles oder sorgfältiges Reinigen |
| Lautstärke | Integer | Lautstärke der Sprachausgabe des Gerätes |
| Sprache | String | Verwendete Sprache für Ansagen |
Hinweis: Der Status wird zusätzlich über den Bridge-Status von tuya2mqtt (<Base Topic>/bridge/status) abgesichert: Meldet die Bridge ‘offline’ (z. B. per MQTT Last Will nach einem Absturz), wird der Status auf ‘offline’ gesetzt.
6. Darstellungen
Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.
| Variable | Darstellung | Werte |
|---|---|---|
| Status | Wertanzeige | Online (online), Offline (offline), Undefiniert (undefine) |
| Betrieb | Schalter | An / Aus |
| Modus | Aufzählung | Bereit, Intelligent, Kanten, Spiral, Zickzack, Laden |
| Zustand | Wertanzeige | Bereit, Intelligente Reinigung, Kantenreinigung, Punktuelle Reinigung, Wischen und Reinigen, Zum Aufladen, Aufladen, Voll aufgeladen, Pausiert, Reinigen, Schlafen |
| Richtungssteuerung | Aufzählung | Vorwärts, Links drehen, Rechts drehen, Stop, Exit |
| Batterieladung | Wertanzeige | 0 – 100 % |
| Kantenbürste | Wertanzeige | 0 – 100 % |
| Walzenbürste | Wertanzeige | 0 – 100 % |
| Filter | Wertanzeige | 0 – 100 % |
| Saugstufe | Aufzählung | Stark, Normal, Leise |
| Reinigungsbereich | Wertanzeige | 0 – 9999 m² |
| Reinigungszeit | Wertanzeige | 0 – 9999 min |
| Reinigungsgeschwindigkeit | Aufzählung | Gründlich, Schnell |
| Lautstärke | Schieberegler | 0 – 100 % (Schrittweite 1) |
| Sprache | Aufzählung | Englisch, Deutsch, Französisch, Russisch, Spanisch, Italienisch |
7. Visualisierung
Man kann die Instanz bzw. Statusvariablen direkt in die Visualisierung verlinken.
8. Befehlsreferenz
Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.
9. Versionshistorie
v2.3.20261002
- NEU: Profile durch Darstellungen ersetzt
- NEU: Bridge-Status von tuya2mqtt wird ausgewertet (Status ‘offline’ bei Absturz der Bridge)
- NEU: Automatischer Abruf aller Werte beim Systemstart und nach Übernahme der Konfiguration (get-states)
- NEU: Mehrstufiges Base Topic möglich, abschließender
/wird ignoriert - FIX: Empfangsfilter präzisiert (nur Geräte-Topics und Bridge-Status)
- FIX: Übersetzungen und Dokumentation überarbeitet, Schreibfehler korrigiert
v2.2.20260319
- FIX: Kompatibilität für IPS größer 8.2 hergestellt
v2.1.20250926
- FIX: Abruf aller Daten korrigiert (get-states)
- FIX: Fehler bei Verarbeitung des Payloads durch Umstellung auf IPSModuleStrict korrigiert
v2.0.20250916
- NEU: Projektumstrukturierung hin zu einer globalen CI/CD-Pipeline
- NEU: Kompatibilität auf IPS 8.1 hoch gesetzt
- NEU: Umstellung auf IPSModuleStrict
- FIX: Bibliotheksfunktionen angeglichen
v1.1.20250802
- NEU: Konfigurationsformular überarbeitet
- NEU: Continuous Integration mit Check Style, Static Code Analysis und Unit Tests eingeführt
- NEU: Debugging Funktionen komplett überarbeitet
- FIX: Mqtt Topic test korrigiert
- FIX: Dokumentation für PHP Static Analysis komplett überarbeitet
- FIX: Bibliotheksfunktionen überarbeitet in Vorbereitung auf IPSModuleStrict
v1.0.20250125
- NEU: Initialversion
Entwickler
Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)
Spenden
Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.
Lizenz
Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International
