[Neue Module] 74_AutomowerConnect, 75_AutomowerConnectDevice, Husqvarnas OpenAPI

[Ellert]

FHEM-Wiki: Modul: AutomowerConnect

Die Module AutomowerConnect und AutomowerConnectDevice sind eine weitere Möglichkeit Mähroboter von Husqvarna in FHEM einzubinden.
 
Es gibt schon einige Module, die den Automower bedienen können:

• Das Robonect Modul kommt nicht in Frage da die Mähfläche nicht mit WLAN abgedekt ist und der Mäher ohnehin ein integriertes Connect Modul hat.
• Mit dem Gardena-Modul wäre es ein Umweg, falls es funktioniert. Ich habe es probiert - hat nicht geklappt. Falls es dennoch funktioniert, lasst es mich wissen, dann spare ich mir die weitere Arbeit.
• Das Modul HusqvarnaAutomower ist o.k., ein paar Sachen haben mich gestört, der Mähplan, Scheinwerfer und Schnitthöhe kann nicht bedient werden, das Passwort liegt offen vor, die Fehlermeldungen fehlten.

AutomowerConnect: Dieses Modul greift auf die offizielle Husqvarna Automower Connect Api zu und bildet das Device (FHEM-Gerät) für einen Automower ab und stellt gleichzeitig einen Host für weitere Automower dar.

AutomowerConnectDevice: Dieses Modul nutz den Host und bildet die Devices (FHEM-Gerät) weiter Automower ab.

Durch das zweistufige Konzept wird der Verkehr zur Husqvarna Cloud reduziert und die Systemlast gesenkt.
Ein kürzeres Abfrageintervall als 600s ist nicht sinnvol da der Automower selbst nur alle 10 Minuten an die Cloud sendet und daher die Daten erst nach 15 Minuten in der Cloud zur Verfügung stehen.
So verstehe ich jedenfalls Husqvarnas Hinweis zum Zugriff über Websocket:

There is a timeout of 10 minutes in the mower to preserve data traffic and save battery that makes the events to be sent every 15 minutes.

Die Module können das, was ich vermisst habe und basieren letztlich auf dem Modul HusqvarnaAutomower und ein paar Dinge kommen vom BOTVAC Modul.

Voraussetzungen

Anmeldung im Husqvarna Developer Portal: https://developer.husqvarnagroup.cloud/docs/get-started

• Dort eine Application anlegen. Der Benutzername und das Passwort der App sollten funktionieren.
• Die Authentifizierungs Api und die Automower Connect Api der Application zuweisen.
• Der erzeugte Application Key und das Application Secret bilden die Zugangsdaten für das AutomowerConnect Modul.

Erster Mäher:

Code: [Auswählen]

define MyMower AutomowerConnect <Application Key>
set MyMower client_secret <Application Secret>
Weitere Mäher

Code: [Auswählen]

define MyAdditionalMower AutomowerConnectDevice MyMower 1

Wesentliche Eigenschaften

• Das Modul kann parallel zu einer anderen Definition des gleichen Mähroboters parallel genutzt und getestet werden.
• Der Pfad des Mähroboters kann dargestellt werden, mit oder ohne Hintergrundbild. Auf die Liveeinbindung von Google Earth habe ich verzichtet, Google weiß schon genug.
• Die Lage der Mähfläche muss angegeben werden (obere linke Ecke und untere rechte Ecke).
• Die Angabe Longitude und Latitude erfolgt in Dezimalgrad, z.B. aus Google Earth.
• Die gewünschte Größe der Anzeigefläche, bzw des Hintergrundbildes muss in Pixel angegeben werden.
• Die Position der Ladestation kann angegben werden als Dezimalgrad.
• Der Verbindungspunkt der Ladestation zum Pfad kann festgelegt werden (links, rechts, oben, unten und mitte).
• Die Grundstücksgrenze und die Mähbereichsgrenze können angegeben werden als Liste in Dezimalgrad (Longitude,Latitude+Linefeed). Die letzte Zeile darf kein Linefeed enthalten.
• Fehlermeldungen des Mähroboters werden angezeigt.
• Der Mähplan kann editiert werden.
• Alle über die API angebotenen Aktionen können ausgeführt werden.
• Scheinwerfer und Schnitthöhe können bedient werden.

Einige Statistische Daten werden angezeigt oder berechnet:

• Geschwindigkeit im letzten Interval
• gefahrene Strecke und übermähte Fläche für den aktuellen Tag, die aktuelle Woche, sowie für den letzten Tag und die letzte Woche.

Im Wirbetrieb wird der Mäherpfad mit beliebig vielen Wegpunkten angezeigt, während der Entwicklung werden nur die letzten 50 Wegpunkte angezeigt.

Weitere Hinweise gibt es in der Commandref.

Wie eine Karte mit Hintergrundbild Grenze, Mähbereich und Pfad des Mähroboter zu erstellen ist, steht jetzt im FHEM-Wiki: Modul: AutomowerConnect

Ich würde mich freuen, wenn sich Tester finden, die einen Automower mit Connect-Modul in der Ladestation betreiben würden, und ihre Erfahrungen teilen.

Ist die Beschreibung wie man eine Karte einbindet ausreichend?

Es ist ein Bild angehängt mit Grenze, Mähbereich und Mäherpfad (sieht aus als schleiche er sich heraus, um die Umgebung zu erkunden)

Edit: Module gelöscht

Die Module werden über das offizielle Update verteilt.

[CoolTux]

Hallo Ellert,

Es gibt zum speichern von Passwörtern in Modulen das offizielle Core Modul Passwords

https://git.cooltux.net/FHEM/mod-Password

Ist für eine einfachere Integration in FHEM Modulen gedacht.



Grüße
Marko

[Ellert]

Das ist sinnvoll, danke für den Hinweis.

[Ellert]

Es gibt jetzt einen Eintrag im FHEM-Wiki: Modul: AutomowerConnect.

[Ellert]

Die Module gibt es ab morgen im Update, das macht das Testen einfacher.

[dinkel75]

Super! Ich hab noch das alte Modul und check dann gleich mal d

[RobertSch]

Vielen lieben Dank für dieses Modul!

Ich habe es bereits eingerichtet, kann allerdings noch kein weiteres Feedback da lassen, da sich unser Mäher derzeit in der Winter-Wartung befindet. Sobald er wieder da ist, werde ich weiter testen.

Beim Anlegen ist mir aber aufgefallen das sich die fhem Instanz aufhängt, nachdem das Gerät definiert wurde. Kam also erst gar nicht dazu den Secret Key einzutragen. Habs dann direkt in die fhem.cfg geschrieben, seitdem läufts ohne Probleme. Connected ist er, zeigt aber wegen der Wartung derzeit einen Fehler an, was aber mit der App überein stimmt.

LG
Robert

[Ellert]

Danke für die Rückmeldung.

Aufhänger habe ich noch nicht beobachtet, schaue ich mir aber nochmal an.

[Team-Menge]

Danke für das neue Modul! Klingt vielversprechend 

Momentan kann ich zwar noch nicht testen, da sich mein Mäher noch im Winterschlaft befindet, aber ich habe es schon einmal installiert.

Dabei musste ich allerdings feststellen, dass meine komplette fhem-Installation (auf RaspBerryPI 3) nach der Installation des Moduls sehr langsam auf alle Eingaben reagiert oder sich sogar komplett aufhängt. Nach deaktivieren des Moduls (nur extern über putty möglich) läuft alles flüssig wie vorher.

Da es beim state "authenticated" anzeigt, gehe ich 'mal davon aus, dass es das "client_secret" eingelesen hat.

[Ellert]

So, der Absturz  beim Define ist behoben und die Fehlerbehandlung ist verbessert, ab jetzt im SVN und morgen im Update.

Der Bug beim Define ist mir leider nicht aufgefallen, weil ich mit einem bereits definierten Gerät gearbeitet habe und das client secret schon gespeichert war.

Ja, die meisten Mähroboter sind jetzt wohl noch im Winterschlaf. Wer auf eine Karte mit dem Weg des Mähers wert legt, könnte in Ruhe alles vorbereiten.

@Team-Menge, das träge Verhalten hängt möglicher Weise mit dem Bug beim Define zusammen, und in dem Zusammenhang wurde auch "authenticated" falsch angezeigt. Ich teste auf einem Pi B da läuft alles flüssig.

Ich rate daher dringend zu einem Update.

Danke an alle die testen, das ist hilfreich.

[dinkel75]

Bei mir auch installiert - läuft.
Aber wie bei den Anderen - Winterruhe