Hallo zusammen,

Version 0.1.13 meines ioBroker Adapters für Anthbot Genie Mähroboter ist jetzt im ioBroker latest Repository verfügbar.

Der Adapter ist ein inoffizieller Cloud-Adapter für Anthbot Genie. Er meldet sich an der Anthbot Cloud an, sucht die verfügbaren Geräte, ermittelt Region und IoT-Endpunkte und fragt regelmäßig Statusdaten des Mähroboters ab. Zusätzlich stellt er schreibbare States für Einstellungen, Mähbefehle, Docking, Wartung und Zonen bereit. Die State-Struktur bleibt für Genie 600/1000/3000/5000 sowie M5/M9 unter denselben ioBroker-Pfaden stabil.

Funktionen

• Anthbot Cloud Login
• Geräteerkennung
• Region- und IoT-Endpunkt-Ermittlung
• Polling von Mower Property Shadow und Service Shadow
• automatische Erneuerung temporärer IoT-Zugangsdaten nach AWS-IoT-403
• Status-, Metrik-, Diagnose- und Rohdaten-States pro Mähroboter
• Standort-States für GPS- und lokale Positionsdaten
• M5/M9-Mappings für Status, Batterie, Fehler, Netzwerk, RTK, Karte sowie Gesamt-Mähzeit/-fläche
• Steuerbefehle über ioBroker States
• Vollflächenmähen, manuelles Zonenmähen und automatisches Zonenmähen
• Punktmähen, Kantenmähen und Mähen nahe der Ladestation
• Start, Pause, Fortsetzen, Stoppen und Beenden von Mähaufgaben
• Rückkehr zur Ladestation inklusive Pause der Rückfahrt
• Wartungsbefehle wie Roboter finden, Grasablage und Scheibenwartungsmodus
• Verbrauchsmaterial-States für Ladeport, Kameras und Klingen inklusive Reset-Buttons
• Regen-, Hindernis-, Sprachlautstärke- und Mähparameter-Steuerung
• Rohdaten für Property Shadow, Service Shadow, Anthbot Event-Code-Übersetzungen und Flächendefinitionen
• Passwort wird als verschlüsselte native Konfiguration gespeichert

Voraussetzungen

• ioBroker mit js-controller >= 6.0.11
• ioBroker Admin >= 7.6.20
• Node.js >= 22
• Anthbot Account mit mindestens einem verbundenen Anthbot Mähroboter

Angelegte States

Pro erkanntem Mähroboter werden unter anderem folgende Bereiche angelegt:

• info.*
• metrics.*
• diagnostics.*
• location.*
• consumable.*
• controls.*
• commands.*
• zones.*
• raw.*

Aktuelle Punkte in 0.1.13

• verfügbar über das ioBroker latest Repository
• gruppierte State-Struktur unter metrics, diagnostics, consumable, controls, commands, zones und raw
• M5/M9-Payloads für Status, Batterie, Fehler, Netzwerk, RTK, Karte sowie Gesamt-Mähzeit/-fläche werden in die bestehende State-Struktur gemappt
• temporäre IoT-Zugangsdaten werden nach AWS-IoT-403 einmal automatisch erneuert und der fehlgeschlagene Shadow-Read bzw. Command-Publish wird erneut versucht
• Diagnosewerte für RTK, Firmware, OTA, Netzwerk, GPS/Position, Karte und Fehler
• Reset-Buttons für Ladeport-, Kamera- und Klingen-Lebensdauer
• neue Befehle: Roboter finden, Grasablage, Scheibenwartungsmodus, Kantenmähen, Mähen nahe der Ladestation und Punktmähen
• Task-Befehle: Mähen pausieren/fortsetzen, Rückfahrt pausieren und Mähen beenden
• Steuerung für Mähen nahe der Ladestation
• Vollflächenmähen mit optionalem Kantenschnitt
• RTK-Antenne-bewegt-Warnung und Befehl zum Zurücksetzen dieser Warnung

Einige Befehle können je nach Modell, Firmware, aktuellem Mäherzustand und vorhandenen Karten-/Kantendaten nicht verfügbar sein oder vom Mäher abgelehnt werden.

Manuelles Zonenmähen

Die bekannten manuellen Zonen werden unter folgendem State als JSON-Array abgelegt:

<instance>.<serial>.zones.manual.list

Zum Starten einer oder mehrerer Zonen kann in diesen State geschrieben werden:

<instance>.<serial>.commands.mowing.startZone

Akzeptierte Werte:

• einzelne Zone per ID: 3
• einzelne Zone per Name: Front yard
• mehrere Zonen kommasepariert: 3,5,Back yard
• mehrere Zonen als JSON-Array: [3,5,"Back yard"]

Automatische Zonen liegen unter <instance>.<serial>.zones.autoList und werden mit <instance>.<serial>.commands.mowing.startAutoZone gestartet.

Punktmähen

Punktmähen wird über folgenden State gestartet:

<instance>.<serial>.commands.mowing.startPoint

Akzeptierte Werte:

• Koordinaten als Text: 123,456
• Koordinaten als JSON-Objekt: {"x":123,"y":456}

Nach erfolgreicher Ausführung wird der State wieder geleert.

Wobei Rückmeldungen hilfreich sind

• Login mit Anthbot Account
• Erkennung eines oder mehrerer Mähroboter
• Aktualisierung von Status, Metriken, Diagnosewerten und Verbindungsstatus
• M5/M9-Mappings für Status, Netzwerk, RTK, Kartenstatus und Gesamt-Mähwerte
• Start, Pause, Fortsetzen, Stoppen und Beenden von Mähaufgaben
• Rückkehr zur Ladestation sowie Pause der Rückfahrt
• manuelles und automatisches Zonenmähen, falls Zonen in der Anthbot App vorhanden sind
• Punktmähen, Kantenmähen und Mähen nahe der Ladestation, falls vom Gerät unterstützt
• Reset der Verbrauchsmaterial-Werte nur dann, wenn der jeweilige Lebensdauerwert bei oder unter 5 Prozent liegt ( limitiert von Anthbot )
• Verhalten bei falschen Zugangsdaten, Cloud-Verbindungsproblemen oder AWS-IoT-403

Rückmeldungen bitte mit Adapterversion, ioBroker/js-controller Version, Node.js Version und relevanten Logauszügen posten. Bitte keine Zugangsdaten, Tokens, Seriennummern oder andere persönliche Daten veröffentlichen.

Hinweis: Der Adapter ist inoffiziell und nicht mit Anthbot verbunden oder von Anthbot unterstützt.

Transparenzhinweis

Bei der Erstellung dieses Adapters wurde KI unterstützend eingesetzt, insbesondere bei Code-Entwurf, Strukturierung, Dokumentation und Prüfung. Die fachliche Verantwortung, Tests und Veröffentlichung liegen beim Entwickler.

Installation

Über ioBroker Admin

1. Adapteransicht öffnen.
2. Falls das latest Repository noch nicht aktiv ist: in ioBroker Admin unter Einstellungen -> Repositorys latest auswählen/aktivieren und die Adapterliste aktualisieren.
3. Im latest Repository nach anthbot-genie suchen und den Adapter installieren.
4. Nach der Installation eine Instanz des Adapters anlegen.
5. In der Adapterkonfiguration Anthbot Benutzername, Passwort und Landesvorwahl eintragen.
6. Instanz starten und Log sowie States prüfen.

Über CLI

Installation der aktuellen Version über npm:

iobroker repo set latest
iobroker update
iobroker add anthbot-genie

oder exakt:

iobroker add anthbot-genie@0.1.13

Falls die Instanz nach der Installation noch nicht automatisch angelegt wurde:

iobroker add anthbot-genie --enabled