Der neue Monatsrückblick für Mai und Juni 2026 ist online!

[reloxx13]

Info
Adapter	anthbot-genie
Version	0.1.13
npm latest	0.1.13
Quelle	npm
GitHub	https://github.com/reloxx13/ioBroker.anthbot-genie
npm	https://www.npmjs.com/package/iobroker.anthbot-genie
Paket	iobroker.anthbot-genie
js-controller	>= 6.0.11
Admin	>= 7.6.20
Node.js	>= 22
Verbindung	Cloud
Status	latest
Hinweis	inoffiziell, nicht mit Anthbot verbunden

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
• 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

[reloxx13]

Hallo zusammen,

anbei ein Blockly-Beispiel für eine automatische Steuerung des Anthbot Genie Mähroboters über den Adapter anthbot-genie.

Das Blockly startet nicht einfach stur nach Uhrzeit, sondern prüft mehrere Bedingungen, bevor ein Zonenmähen ausgelöst wird. Ziel ist, dass der Mähroboter nur dann automatisch fährt, wenn Wetter, Akku und letzter Mähzeitpunkt passen.

Kurzüberblick

Info	Wert
Script	Main.Maehroboter.sharing.xml
Adapter	anthbot-genie
Adapterversion	0.1.0
Wetterquelle	weatherunderground
Benachrichtigung	Telegram
Funktion	automatisches Zonenmähen
Zeitfenster	Montag bis Samstag, 09:00 bis 21:00 Uhr
Prüfung	alle 30 Minuten
Beispiel-Zonen	102,101,100

Was das Blockly macht

Das Script legt zuerst eigene Hilfs-States unter 0_userdata.0.maehroboter.* an:

• lastZoneMow
• lastRain
• lastZoneMowAttempt

Diese States werden genutzt, um zu speichern, wann zuletzt gemäht wurde, wann zuletzt Regen erkannt wurde und wann zuletzt ein Startversuch ausgeführt wurde.

Regenlogik

Das Blockly prüft regelmäßig die Regenwerte aus weatherunderground.1.forecastHourly.

Wenn in der aktuellen Stunde Regen erkannt wird, wird lastRain aktualisiert. Falls der Mähroboter gerade mäht, sendet das Script zusätzlich den Befehl zur Rückkehr zur Ladestation:

anthbot-genie.0.SERIAL_NUMBER.commands.docking.startReturn = true

Zusätzlich wird eine Telegram-Nachricht gesendet, dass Regen erkannt wurde und der Mähroboter zur Ladestation fährt.

Bedingungen für automatisches Zonenmähen

Das automatische Zonenmähen wird nur gestartet, wenn alle Bedingungen erfüllt sind:

• Adapter ist verbunden
• Mähroboter ist online
• aktuell kein Regen
• in den nächsten konfigurierten Forecast-Stunden kein Regen
• Luftfeuchtigkeit ist maximal 85 %
• letzte Zonenmahd ist mindestens 72 Stunden her oder wurde noch nie gespeichert
• aktuelle Uhrzeit liegt vor bzw. bei 21:00
• nach erkanntem Regen ist die vom Mähroboter gemeldete Wartezeit abgelaufen
• Akku ist mindestens 90 %
• letzter Startversuch ist mindestens 6 Stunden her oder wurde noch nie gespeichert

Wenn diese Bedingungen erfüllt sind, schreibt das Blockly die gewünschten Zonen in:

anthbot-genie.0.SERIAL_NUMBER.commands.mowing.startZone

Im Beispiel werden die Zonen so gestartet:

102,101,100

Danach sendet das Script eine Telegram-Nachricht und aktualisiert lastZoneMowAttempt sowie lastZoneMow.

Wartungshinweise

Zusätzlich überwacht das Blockly die Lebensdauerwerte für:

• Klingen
• Kameras
• Ladeport

Wenn einer dieser Werte auf 5 % oder weniger fällt, wird eine Telegram-Nachricht mit dem aktuellen Restwert gesendet.

Erkennung manueller Starts

Zusätzlich überwacht das Blockly den Status:

anthbot-genie.0.SERIAL_NUMBER.metrics.status.mower

Wenn der Status auf mowing wechselt, werden lastZoneMowAttempt und lastZoneMow ebenfalls aktualisiert. Dadurch erkennt das Script auch Starts, die nicht durch dieses Blockly ausgelöst wurden, und verhindert unnötige doppelte Starts.

Anpassungen vor der Nutzung

Vor dem Import müssen mindestens diese Werte angepasst werden:

• Seriennummer im Objektpfad des Mähroboters
• gewünschte Zonen-IDs für commands.mowing.startZone
• Wetter-Objektpfade von weatherunderground
• Telegram-Instanz und Benutzer
• gewünschtes Zeitfenster
• Grenzwerte für Luftfeuchtigkeit, Akku und Wartezeiten

In der geteilten XML-Datei sind die Seriennummer als SERIAL_NUMBER und der Telegram-Benutzer als USER ersetzt. Diese Platzhalter müssen nach dem Import angepasst werden.

Hinweis

Das Blockly ist nur ein Beispiel und sollte nach dem Import zuerst mit den eigenen Objektpfaden und Logausgaben geprüft werden. Besonders die Zonen-IDs müssen zur eigenen Anthbot-Konfiguration passen.

Main.Maehroboter.sharing.xml

[mcm1957]

iobroker url https://github.com/reloxx13/ioBroker.anthbot-genie

Da der Adapter auf npm verfügbar ist, sollte vorzugsweise von npm installiert werden.

Von direkten Installation von GitHub - insbesondere auf produktiven Systemen - wird explizit abgeraten.

DANKE für deine Arbeit.
Wenn der Adapter für User funktioniert lass ihn in die Repositories aufnehmen:

https://github.com/ioBroker/ioBroker.repositories#requirements-for-adapter-to-get-added-to-the-latest-repository

https://github.com/ioBroker/ioBroker.repositories#add-a-new-adapter-to-the-latest-repository-web-frontend

[reloxx13]

Hallo zusammen,

Aktueller Stand vom Adapter:

• aktuelle Version: 0.1.13
• Installation über npm verfügbar
• Node.js Voraussetzung ist jetzt >= 22
• die State-Struktur ist inzwischen deutlich ausgebaut und bleibt für Genie sowie M5/M9 unter denselben ioBroker-Pfaden stabil
• enthalten sind u.a. Status-, Diagnose-, Standort-, Verbrauchsmaterial-, Zonen-, Control- und Command-States
• M5/M9-spezifische Payloads für Status, Netzwerk, RTK, Kartenstatus sowie Gesamt-Mähzeit/-fläche werden inzwischen ebenfalls in die bestehende State-Struktur gemappt
• bei AWS-IoT-403 werden temporäre IoT-Credentials einmal automatisch erneuert und der fehlgeschlagene Shadow-Read bzw. Command-Publish erneut versucht

Ich habe den Adapter in den letzten Tagen nochmals aufgeteilt, bereinigt und die Checks erweitert, damit die internen Module und Tests sauber mitgeprüft werden. Funktional sollten dabei keine State-IDs oder Command-Payloads geändert worden sein.

Die Aufnahme ins ioBroker latest-Repository ist bereits angestoßen und wartet aktuell auf Review.

Besonders hilfreich wären aktuell noch Rückmeldungen und Bestätigungen von Nutzerinnen und Nutzern mit M5 oder M9, dass die neuen Payload-Mappings dort im Alltag sauber funktionieren.

Falls jemand den aktuellen Stand testet, sind besonders diese Punkte interessant:

• Login und Geräteerkennung
• Shadow-/Status-Updates über längere Laufzeit
• Zonenmähen manuell und automatisch
• Punktmähen
• Near-Charger-Mowing
• Verhalten nach Verbindungs- oder 403-Fehlern

Rückmeldungen wie immer gern mit Adapterversion, js-controller-Version, Node.js-Version und passenden Logauszügen.

[mcm1957]

Der Adapter wurde ins LATEST Repository aufgenommen
Bitte ein neues Topic im Testerbereich anlegen und dieses Topic hier schließen.

[reloxx13]

Neues Topic angelegt https://forum.iobroker.net/topic/84983/test-adapter-anthbot-genie-v0.1.x-github-latest