Das Modul bietet die Möglichkeit, mit einem kombatiblen Saugroboter über das lokale Netzwerk zu kommunizieren.
- Funktionsumfang
- Voraussetzungen
- Installation
- Einrichten der Instanzen in IP-Symcon
- Statusvariablen und Profile
- Visualisierung
- PHP-Befehlsreferenz
- Versionshistorie
Das Modules 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 Saugroporter verfügbaren Befehlsumfang kann man im Tuya Developer Portal einsehen.
- IP-Symcon ab Version 7.2
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.
- Ü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
- Unter "Instanz hinzufügen" ist das 'Tuya Saugroboter'-Modul 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. |
| MQTT Topic | Ist der eindeutige Geräte-Pfad, der zum Veröffentlichen und Abonnieren von Nachrichten verwendet wird. HINWEIS: Immer in Kleinbuchstaben angeben! |
Aktionsbereich:
| Aktion | Beschreibung |
|---|---|
| AKTUALISIEREN | Löst eine Nachricht aus, welche versucht alle Status(Geräte)informationen vom Gerät abzurufen. |
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ügbarkeitsstaus (siehe T2M.Status) |
| Betrieb | Boolean | Betriebszustand (AN, AUS) |
| Modus | String | Aktueller Gerätemodus (siehe T2MVC.Mode) |
| Zustand | String | Aktueller Betriebsstatus (siehe T2MVC.Working) |
| Richtungssteuerung | String | Steuerung der Richtungsbewegung (siehe T2MVC.Direction) |
| Batterieladung | Integer | Aktueller Ladezustand (0-100%) |
| Kantenbürste | Integer | Lebensdauer der Seitenbürste (0-100%) |
| Walzenürste | Integer | Lebensdauer der Hauptbürste (0-100%) |
| Filer | Integer | Lebensdauer des Filters (0-100%) |
| Saugstufe | String | Stärke der Saugstufe (siehe T2MVC.Suction) |
| Reinigungsbereich | Integer | Quadratmeter der gereinigten Fläche (0-9999m³) |
| Reinigungszeit | Integer | Verbrauchte Zeit für Reinigung (0-9999min) |
| Reinigiungsgeschwindigkeit | String | Schnelles oder sorgfälltiges Reinigen (siehe T2MVC.Speed) |
| Lautsärke | Integer | Lautsärker der Sprachausgabe des Gerätes (0-100%) |
| Sprache | String | Verwendete Sprache für Amsagen (siehe T2M.Language) |
Folgendes Profil wird angelegt:
| Name | Typ | Beschreibung |
|---|---|---|
| T2M.Status | String | Online (online), Offline (offline) oder Undefinierd (undefined) |
| T2M.Language | String | Englisch, Deutsch, Französisch, Russisch, Spanisch, Italienisch |
| T2MVC.Mode | String | Bereit, Intilligent, Kanten, Spiral, Zickzack, Laden |
| T2MVC.Direction | String | Vorwärts, Links drehen, Rechts drehen, Stop, Exit |
| T2MVC.Working | String | Intilligente Reingung, Kantenreinigung, Punktuelle Reinigung, Wischen und Reinigen, Zum aufladen, Aufladen, Voll aufgeladen, Pausiert, Reinigen, Schlafen |
| T2MVC.Suction | String | Stark, Normal, Leise |
| T2MVC.Speed | String | Gründliches reinigen, Schnell reinigen |
| T2MVC.Area | Integer | 0 bis 9999 Quadratmeter (m³) |
| T2MVC.Time | Integer | 0 bis 9999 Minuten (min) |
Man kann die Instanz bzw. Statusvariablen direkt in die Visualisierung verlinken.
Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.
v2.1.20250926
- FIX: Abruf aller Daten korriegiert (get-states)
- FIX: Fehler bei Verarbeitung des Payloads durch Umstellung auf IPSModuleStrict korriegiert
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 korriegiert
- FIX: Dokumentation für PHP Static Analysis komplett überarbeitet
- FIX: Bibliotheksfunktionen überarbeitet in Vorbereitung auf IPSModuleStrict
v1.0.20250125
- NEU: Initialversion
Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der IP-Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti 😉
Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.
Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International
