Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 1.0.2 im Kanal Beta. Im Kanal Stable liegt noch die Version 1.0. Dort können Funktionen fehlen, die hier beschrieben sind.
Steuert Mammotion-Mähroboter (LUBA und YUKA) über die offizielle Mammotion Open API und zeigt ihren Zustand in IP-Symcon an.
Inhaltsverzeichnis
Screenshots
1. Voraussetzungen
- mindestens IPS Version 9.0
- Ein Mammotion-Konto mit mindestens einem Mäher, der in der Mammotion-App eingerichtet ist (Karte und Aufgaben werden dort angelegt).
- Entwickler-Zugangsdaten (Client-ID und Client-Secret) von developer.mammotion.com. Die Zugangsdaten werden mit dem Mammotion-Konto erzeugt, das Secret wird nur beim Anlegen angezeigt.
- Die Mammotion Open API unterstützt laut Hersteller nur Mäher-Modelle, die 2025 erschienen sind.
- Live-Aktualisierung (Push) gibt es nur für das Modell LUBA 3 AWD.
2. Funktionsumfang
- Zustand, Akku, Ladestatus, Firmware und Netzwerk der Mäher anzeigen
- Mähen starten, pausieren, fortsetzen, stoppen und zur Ladestation schicken
- Aufgaben aus der Mammotion-App starten
- Arbeitsparameter (Betriebsart, Bahnmuster, Schnitthöhe, Hindernisvermeidung und weitere) anzeigen
- Fehlermeldungen des Mähers abrufen
- RTK-Referenzstationen mit Online-Zustand und Firmware anzeigen
- Live-Aktualisierung über die Cloud (nur LUBA 3 AWD)
- Kachel für die Kachel-Visualisierung mit Produktbild
- Den lokalen Zugang eines Mähers in der Mammotion-Cloud freischalten und abfragen
Die einzelnen Funktionen stehen bei den Instanzen unter “Enthaltene Module” und in der README des jeweiligen Moduls.
3. Enthaltene Module
- MammotionCloud
- Verbindung zur Mammotion Open API: holt und erneuert das Token und führt alle Anfragen aus.
- Hat als Verbindung einen Virtual IO, für die Live-Aktualisierung (nur LUBA 3 AWD) einen SSE-Client, den sie selbst einschaltet.
- MammotionConfigurator
- Listet die Mäher des Kontos und legt die Geräteinstanzen an.
- Legt RTK-Stationen als eigene Instanzen an und führt sie getrennt von den Mähern.
- MammotionMower
- Ein Mäher: Zustand, Steuerung, Aufgaben, Arbeitsparameter und Fehlermeldungen.
- Kachel für die Kachel-Visualisierung mit lokal abgelegtem Produktbild, Zustand, Akku, Aufgabenauswahl und Steuerung.
- MammotionRtk
- Eine RTK-Referenzstation: Modell, Firmware, Online-Zustand und Fehlermeldungen.
- Kachel für die Kachel-Visualisierung mit lokal abgelegtem Produktbild.
4. Installation
Die Installation erfolgt über den IP-Symcon Module Store.
5. Konfiguration in IP-Symcon
- Eine Instanz “MammotionCloud” anlegen.
- Client-ID und Client-Secret eintragen, übernehmen und “Verbindung testen” drücken.
- Eine Instanz “MammotionConfigurator” anlegen und über sie die gewünschten Mäher anlegen.
- Beim Anlegen der MammotionCloud schlägt Symcon eine Verbindung vor: den Virtual IO anlegen lassen (Standard, schon aktiv). Nur für die Live-Aktualisierung des LUBA 3 AWD die Schnittstelle der Cloud auf einen SSE-Client ändern und beim Mäher “Abfrage und Live-Aktualisierung” einstellen. Die Cloud richtet den SSE-Client dann selbst ein.
6. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
7. Lizenz
Changelog
Alle Versionen dieses Moduls, die neueste oben.
Version 1.0.2
- Fix: "Lädt" gilt, solange die Cloud einen Ladestatus über 0 meldet, auch bei vollem Akku am Dock (Yuka Mini 600, LUBA 2).
Version 1.0.1
- Neu: Das Debug-Fenster des Mähers zeigt bei jeder Abfrage Zustand, Ladestatus und Akku.
- Fix: Der Zustand "TaskPaused" (Yuka Mini 600) wird als "Pausiert" angezeigt.
- Fix: Mäher und RTK-Station lassen sich wieder anlegen, wenn die Kachel-Konstanten in der Symcon-Umgebung fehlen (Fehler "Undefined constant INSTANCEVISUALIZATIONTYPEHTML").
- Fix: Beim Anlegen von Konfigurator und Mäher erscheint keine Warnung zu ConnectParent mehr, und Mäher lassen sich über den Konfigurator anlegen.
- Fix: Meldet die Cloud einen unbekannten Zustand, steht der Wert im Debug-Fenster der Instanz.
- Fix: Lehnt die Cloud "Mähen starten" ab (zum Beispiel beim Yuka Mini 600), weist die Warnung jetzt darauf hin, stattdessen eine Aufgabe zu starten.
Version 1.0
- Neu: Erste Version: Mammotion-Mäher über die offizielle Open API in Symcon.
- Neu: Mähen starten, pausieren, fortsetzen, stoppen und zur Ladestation schicken, außerdem Aufgaben aus der Mammotion-App starten.
- Neu: Zustand, Akku, Ladestatus, Firmware und Netzwerk der Mäher als Variablen.
- Neu: Arbeitsparameter und Fehlermeldungen der Mäher abrufen.
- Neu: RTK-Referenzstationen als eigene Instanz mit Online-Zustand und Firmware.
- Neu: Live-Aktualisierung für LUBA 3 AWD.
- Neu: Konfigurator legt die Mäher des Kontos an.
- Neu: Mäher und RTK-Stationen haben eine Kachel für die Kachel-Visualisierung mit lokal abgelegtem Produktbild; bei Mähern mit Bedienung.
- Neu: Der lokale Zugang eines Mähers lässt sich in der Mammotion-Cloud freischalten und abfragen.