Mähroboter: Worx Landroid, Kress, Landxcape - Versionsgeschichte

Frober: Bei Voraussetzungen wurde das Datum angepasst. Anpassung der loginUrl durch Positec bei Worx und Kress.

2023-06-01T09:24:40Z

Bei Voraussetzungen wurde das Datum angepasst. Anpassung der loginUrl durch Positec bei Worx und Kress.

← Nächstältere Version		Version vom 1. Juni 2023, 11:24 Uhr
Zeile 7:		Zeile 7:
	* Ein Mähroboter der genannten Hersteller mit Cloudanbindung.		* Ein Mähroboter der genannten Hersteller mit Cloudanbindung.
	* Ein aktuelles FHEM		* Ein aktuelles FHEM
	** Stand ab 21.04.2023 mit		** Stand ab 01.06.2023 mit
	** '''[[MQTT2_CLIENT]]'''		** '''[[MQTT2_CLIENT]]'''
	** '''[[HttpUtils]]''' - Http(s) Hilfsfunktionen		** '''[[HttpUtils]]''' - Http(s) Hilfsfunktionen

Ph1959de: Weitere Verlinkung, zusätzlichen Kategorien; abhängige Seiten (LandroidUtils) angelegt; Formatierung teilweise geändert...

2023-04-25T09:44:09Z

Weitere Verlinkung, zusätzlichen Kategorien; abhängige Seiten (LandroidUtils) angelegt; Formatierung teilweise geändert...

← Nächstältere Version		Version vom 25. April 2023, 11:44 Uhr
Zeile 1:		Zeile 1:
	~~==Voraussetzungen==~~		Die Kontrolle und/oder Steuerung der im Seitentitel genannten Mähroboter ist aus FHEM heraus mit Hilfe der folgenden Anleitung möglich.
	~~Ein Mähroboter~~ der genannten ~~Hersteller~~ mit ~~Cloudanbindung~~.

	~~Ein aktuelles Fhem~~ (~~Stand ab 21~~.04.~~2023, mindestes jedoch~~ [[~~MQTT2_CLIENT]~~]~~, [[HttpUtils~~]~~], LandroidUtils.pm)~~.		Alternativ gibt es (u.U. nur für einen Teil der Mäher) noch das Modul '''[[LANDROID]]'''.

	'''~~<big>Betriebssystem:</big>~~''' Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das ~~'''~~<~~big~~>ssl_alpn_protocol</~~big~~>~~'''~~ unterstützen.		==Voraussetzungen==
			Um diese Anleitung nutzen zu können sind die folgenden Voraussetzungen zu erfüllen:
			* Ein Mähroboter der genannten Hersteller mit Cloudanbindung.
			* Ein aktuelles FHEM
			** Stand ab 21.04.2023 mit
			** '''[[MQTT2_CLIENT]]'''
			** '''[[HttpUtils]]''' - Http(s) Hilfsfunktionen
			** '''[[LandroidUtils]]''' - FHEM Hilfsfunktionen für die genannten Mähroboter
			* Betriebssystem: Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das <code>ssl_alpn_protocol</code> unterstützen.

	==Kurzübersicht==		==Kurzübersicht==
	Die Statusdaten der genannten Mähroboter können mit Hilfe des [[MQTT2_CLIENT]] empfangen und er kann gesteuert werden.		Die Statusdaten der genannten Mähroboter können mit Hilfe des Moduls MQTT2_CLIENT empfangen und der Mähroboter kann gesteuert werden.

	==Define==		==Define==
Zeile 17:		Zeile 24:
	</syntaxhighlight>		</syntaxhighlight>

	~~Nach dem Anlegen des [[MQTT2_CLIENT]] ist ein <code>set <name> connect</code> erforderlich. Nach wenigen Sekunden sollte der Client auf "opened" stehen.~~		'''Erläuterungen zum DEF/DEFMOD:'''
			;xx
			:kann als Platzhalter stehen bleiben, die Url wird über LandroidUtils.pm ermittelt
	'''~~Erläuterung~~:'''		;username und password
			:die Zugangsdaten vom Benutzerkonto des Mähers (bei Worx Landroid z.B. https://account.worxlandroid.com).
	~~'''xx'''~~ kann als Platzhalter stehen bleiben, die Url wird über LandroidUtils.pm ermittelt.		Im Attribut ''connectFn'':
			;1
	~~'''~~username~~'''~~ und ~~'''~~password~~''' sind~~ die Zugangsdaten ~~von~~ Benutzerkonto des Mähers (bei Worx Landroid z.B. https://account.worxlandroid.com).		:autocreate aktiv, damit wird ein '''[[MQTT2_DEVICE]]''' mit den Mäherdaten aus der API angelegt. Werden die Daten nicht benötigt, kann autocreate mit '''0''' deaktiviert werden.
			:Damit autocreate funktioniert, muss zusätzlich das "globale" [[autocreate]] in Fhem aktiv sein.
	~~<code>connectFn {use LandroidUtils~~;~~;Landroid_connect($NAME,"worx",~~1~~)}</code>~~		;"worx"
			:ID spezifiziert den Hersteller des Mähers (siehe nachfolgende Tabelle).
	~~'''1''' =~~ autocreate aktiv, damit wird ein [[MQTT2_DEVICE]] mit den ~~Mowerdaten~~ aus der API angelegt. Werden die Daten nicht benötigt, kann autocreate mit '''0''' deaktiviert werden.

	Damit autocreate funktioniert muss zusätzlich das "globale" [[~~Autocreate~~]] in Fhem aktiv sein.

	~~'''~~"worx"~~''' (=~~ ID~~) bezieht sich auf~~ den Hersteller des Mähers.

	{\| class="wikitable"		{\| class="wikitable"
	\|+~~Achtung: case sensitive!~~		\|+ Übersicht über Hersteller und IDs
	\|-		\|-
	!ID!!Hersteller		!ID!!Hersteller
Zeile 44:		Zeile 45:
	\|-		\|-
	\|landxcape\|\|LandXcape Robotics		\|landxcape\|\|LandXcape Robotics
			\|-
			\| colspan="2" \| ''Achtung: die IDs sind case sensitive, müssen also exakt wie angegeben benutzt werden!''
			\|-
	\|}		\|}

	==Client==		==Client==
	Nach dem Anlegen des [[MQTT2_CLIENT]] ist ein <code>set <name> connect</code> erforderlich. Nach wenigen Sekunden sollte der Client auf "opened" stehen. Benötigte Attribute usw. werden automatisch über die LandroidUtils.pm angelegt.		Nach dem Anlegen des MQTT2_CLIENT ist ein
			:<code>set <name> connect</code>
			erforderlich. Nach wenigen Sekunden sollte der Client auf "opened" stehen. Benötigte Attribute usw. werden automatisch über die LandroidUtils.pm angelegt.

	Folgende Attribute können bei Bedarf angepasst werden:		Folgende Attribute können bei Bedarf angepasst werden:
			;nextOpenDelay
			:gibt vor, in wie vielen Sekunden nach einem Verbindungsabbruch der Client einen neuen Anmeldeversuch startet
			;maxFailedConnects
			:gibt die maximale Anzahl an Anmeldeversuchen nach einem Verbindungsabbruch an

	~~'''nextOpenDelay''' = gibt vor, in wie vielen Sekunden nach einem Verbindungsabbruch der Client einen neuen Anmeldeversuch startet~~		Beide Attribute sollten mit Bedacht geändert werden; zu kurze Intervalle und zu viele Versuche können eine Sperre am Server auslösen. Als Standard ist hier nextOpenDelay mit 180s und maxFailedConnects mit 20 angegeben (d.h. nach einen Verbindungsabbruch sollte der Client nach 20 x 180s = 60 Min wieder "opened" sein. Ist dies nicht der Fall, muss ein manuelles
			:<code>set <name> connect</code>
	~~'''maxFailedConnects''' = gibt die max. Anzahl an Anmeldeversuche nach einem Verbindungsabbruch an~~		oder ein Neustart ausgeführt werden.

	Beide Attribute sollten mit Bedacht geändert werden, zu kurze und zu viele Versuche können eine Sperre ~~vom~~ Server auslösen. Als Standard ist hier nextOpenDelay mit 180s und maxFailedConnects mit 20 angegeben (d.h. nach einen Verbindungsabbruch sollte der Client nach 20 x 180s = 60 Min wieder "opened" sein. Ist dies nicht der Fall, muss ein manuelles <code>set <name> connect</code> oder ein Neustart ausgeführt werden.

	==Device==		==Device==
	Für das neu angelegte [[MQTT2_DEVICE]] kann ein [[AttrTemplate]] angewendet werden:		Für das neu angelegte MQTT2_DEVICE kann ein [[AttrTemplate]] angewendet werden:
			:<code>set <NAME> attrTemplate worx_landroid</code>
	<code>set <NAME> attrTemplate worx_landroid</code>		Damit werden teilweise die Daten in "lesbare" Readings übersetzt und es wird eine '''[[setList]]''' zum Steuern des Mähers angelegt.

	Damit werden teilweise die Daten in "lesbare" Readings übersetzt und eine ~~setlist~~ zum Steuern des Mähers angelegt.

	==Anmerkung==		==Anmerkung==
Zeile 69:		Zeile 74:

	==Links==		==Links==
	{{Link2Forum\|Topic=111959\|Message= \|LinkText=MQTT2 für Worx Landroid Mähroboter (Forum) }}		* {{Link2Forum\|Topic=111959\|Message= \|LinkText=MQTT2 für Worx Landroid Mähroboter (Forum)}}
			* Eine Alternative zur Anbindung von Mährobotern stellt das Modul '''[[LANDROID]]''' dar
	[[~~MQTT2 CLIENT\|MQTT2 CLIENT (Wiki)~~]]

	[[Kategorie:Gerätemodul]]		[[Kategorie:Gerätemodul]]
			[[Kategorie:Mähroboter]]
	[[Kategorie:Other Components]]		[[Kategorie:Other Components]]
	[[Kategorie:MQTT]]		[[Kategorie:MQTT]]

Frober am 24. April 2023 um 17:09 Uhr

2023-04-24T17:09:25Z

← Nächstältere Version		Version vom 24. April 2023, 19:09 Uhr
Zeile 2:		Zeile 2:
	Ein Mähroboter der genannten Hersteller mit Cloudanbindung.		Ein Mähroboter der genannten Hersteller mit Cloudanbindung.

	Ein aktuelles Fhem (Stand ab 21.04.2023, mindestes jedoch [[MQTT2_CLIENT]], [[HttpUtils]], LandroidUtils).		Ein aktuelles Fhem (Stand ab 21.04.2023, mindestes jedoch [[MQTT2_CLIENT]], [[HttpUtils]], LandroidUtils.pm).

	'''<big>Betriebssystem:</big>''' Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das '''<big>ssl_alpn_protocol</big>''' unterstützen.		'''<big>Betriebssystem:</big>''' Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das '''<big>ssl_alpn_protocol</big>''' unterstützen.
Zeile 24:		Zeile 24:
	'''xx''' kann als Platzhalter stehen bleiben, die Url wird über LandroidUtils.pm ermittelt.		'''xx''' kann als Platzhalter stehen bleiben, die Url wird über LandroidUtils.pm ermittelt.

	'''username''' und '''password''' sind die Zugangsdaten von Benutzerkonto des Mähers. (bei Worx Landroid z.B. https://account.worxlandroid.com)		'''username''' und '''password''' sind die Zugangsdaten von Benutzerkonto des Mähers (bei Worx Landroid z.B. https://account.worxlandroid.com).

	<code>connectFn {use LandroidUtils;;Landroid_connect($NAME,"worx",1)}</code>		<code>connectFn {use LandroidUtils;;Landroid_connect($NAME,"worx",1)}</code>
Zeile 69:		Zeile 69:

	==Links==		==Links==
	{{Link2Forum~~\|Area=~~ \|Topic=111959 \|Message= \|LinkText=MQTT2 für Worx Landroid Mähroboter }}		{{Link2Forum\|Topic=111959\|Message= \|LinkText=MQTT2 für Worx Landroid Mähroboter (Forum) }}

	~~[[MQTT2_CLIENT]]~~

			[[MQTT2 CLIENT\|MQTT2 CLIENT (Wiki)]]

	[[Kategorie:Gerätemodul]]		[[Kategorie:Gerätemodul]]
	[[Kategorie:Other Components]]		[[Kategorie:Other Components]]
	[[Kategorie:MQTT]]		[[Kategorie:MQTT]]

Frober: Kategorie ergänzt

2023-04-24T16:54:42Z

Kategorie ergänzt

← Nächstältere Version		Version vom 24. April 2023, 18:54 Uhr
Zeile 72:		Zeile 72:

	[[MQTT2_CLIENT]]		[[MQTT2_CLIENT]]


			[[Kategorie:Gerätemodul]]
			[[Kategorie:Other Components]]
			[[Kategorie:MQTT]]

Frober: 1. finale Version

2023-04-24T16:26:41Z

1. finale Version

← Nächstältere Version		Version vom 24. April 2023, 18:26 Uhr
Zeile 1:		Zeile 1:
	~~{{Baustelle}}~~

	==Voraussetzungen==		==Voraussetzungen==
	Ein Mähroboter der genannten Hersteller mit Cloudanbindung.		Ein Mähroboter der genannten Hersteller mit Cloudanbindung.
Zeile 18:		Zeile 16:
	set MQTT_Worx password secret		set MQTT_Worx password secret
	</syntaxhighlight>		</syntaxhighlight>

			Nach dem Anlegen des [[MQTT2_CLIENT]] ist ein <code>set <name> connect</code> erforderlich. Nach wenigen Sekunden sollte der Client auf "opened" stehen.


	'''Erläuterung:'''		'''Erläuterung:'''
Zeile 46:		Zeile 47:

	==Client==		==Client==
	Nach dem Anlegen des [[MQTT2_CLIENT]] ist ein <code>set <name> connect</code> erforderlich. Nach wenigen Sekunden sollte ~~die~~ Client auf "opened" stehen. Benötigte Attribute usw. werden automatisch über die LandroidUtils angelegt.		Nach dem Anlegen des [[MQTT2_CLIENT]] ist ein <code>set <name> connect</code> erforderlich. Nach wenigen Sekunden sollte der Client auf "opened" stehen. Benötigte Attribute usw. werden automatisch über die LandroidUtils.pm angelegt.


Zeile 55:		Zeile 56:
	'''maxFailedConnects''' = gibt die max. Anzahl an Anmeldeversuche nach einem Verbindungsabbruch an		'''maxFailedConnects''' = gibt die max. Anzahl an Anmeldeversuche nach einem Verbindungsabbruch an

	Beide ~~Attr.~~ sollten mit Bedacht geändert werden, zu kurze und zu viele Versuche können eine Sperre vom Server auslösen. Als Standard ist hier nextOpenDelay mit 180s und maxFailedConnects mit 20 angegeben (d.h. nach einen Verbindungsabbruch sollte der Client nach 20 x 180s = 60 Min wieder "opened" sein. Ist dies nicht der Fall, muss ein manuelles <code>set <name> connect</code> oder ein Neustart ausgeführt werden.		Beide Attribute sollten mit Bedacht geändert werden, zu kurze und zu viele Versuche können eine Sperre vom Server auslösen. Als Standard ist hier nextOpenDelay mit 180s und maxFailedConnects mit 20 angegeben (d.h. nach einen Verbindungsabbruch sollte der Client nach 20 x 180s = 60 Min wieder "opened" sein. Ist dies nicht der Fall, muss ein manuelles <code>set <name> connect</code> oder ein Neustart ausgeführt werden.

	==Device==		==Device==
Zeile 62:		Zeile 63:
	<code>set <NAME> attrTemplate worx_landroid</code>		<code>set <NAME> attrTemplate worx_landroid</code>

	Damit werden teilweise die Daten in "lesbare Readings" übersetzt und eine setlist zum Steuern des Mähers angelegt.		Damit werden teilweise die Daten in "lesbare" Readings übersetzt und eine setlist zum Steuern des Mähers angelegt.

	==~~Funktion~~==		==Anmerkung==
	Die Anmeldung am MQTT-Server wurde im Herbst 2022 auf Bearer Token umgestellt. Der Token ist aktuell eine Stunde gültig, danach beendet der Server die Verbindung. Automatisch wird mittels LandroidUtils ein neuer Token angefordert und die Verbindung wieder geöffnet.		Die Anmeldung am MQTT-Server wurde im Herbst 2022 auf Bearer Token umgestellt. Der Token ist aktuell eine Stunde gültig, danach beendet der Server die Verbindung. Automatisch wird mittels LandroidUtils.pm ein neuer Token angefordert und die Verbindung wieder geöffnet.

	==Links==		==Links==

Ph1959de: syntaxhighlight korrigiert

2023-04-24T16:10:32Z

syntaxhighlight korrigiert

← Nächstältere Version		Version vom 24. April 2023, 18:10 Uhr
Zeile 12:		Zeile 12:

	==Define==		==Define==
	<syntaxhighlight>		<syntaxhighlight lang="perl">
	defmod MQTT_Worx MQTT2_CLIENT xx		defmod MQTT_Worx MQTT2_CLIENT xx
	attr MQTT_Worx connectFn {use LandroidUtils;;Landroid_connect($NAME,"worx",1)}		attr MQTT_Worx connectFn {use LandroidUtils;;Landroid_connect($NAME,"worx",1)}

Frober: Die Seite wurde neu angelegt: „{{Baustelle}} ==Voraussetzungen== Ein Mähroboter der genannten Hersteller mit Cloudanbindung. Ein aktuelles Fhem (Stand ab 21.04.2023, mindestes jedoch MQTT2_CLIENT, HttpUtils, LandroidUtils). '''Betriebssystem:''' Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das '''ssl_alpn_protocol''' unterstützen. ==Kurzübersicht== Die Statusdaten der genannten Mähroboter können mit Hilfe…“

2023-04-24T15:59:06Z

Die Seite wurde neu angelegt: „{{Baustelle}} ==Voraussetzungen== Ein Mähroboter der genannten Hersteller mit Cloudanbindung. Ein aktuelles Fhem (Stand ab 21.04.2023, mindestes jedoch MQTT2_CLIENT, HttpUtils, LandroidUtils). '''<big>Betriebssystem:</big>''' Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das '''<big>ssl_alpn_protocol</big>''' unterstützen. ==Kurzübersicht== Die Statusdaten der genannten Mähroboter können mit Hilfe…“

Neue Seite

{{Baustelle}}

==Voraussetzungen==
Ein Mähroboter der genannten Hersteller mit Cloudanbindung.

Ein aktuelles Fhem (Stand ab 21.04.2023, mindestes jedoch [[MQTT2_CLIENT]], [[HttpUtils]], LandroidUtils).

'''<big>Betriebssystem:</big>''' Debian/Raspbian ab Version Stretch, bei anderen Betriebssystemen muss die SSL-Version das '''<big>ssl_alpn_protocol</big>''' unterstützen.

==Kurzübersicht==
Die Statusdaten der genannten Mähroboter können mit Hilfe des [[MQTT2_CLIENT]] empfangen und er kann gesteuert werden.

==Define==
<syntaxhighlight>
defmod MQTT_Worx MQTT2_CLIENT xx
attr MQTT_Worx connectFn {use LandroidUtils;;Landroid_connect($NAME,"worx",1)}
attr MQTT_Worx username ab@c.de
set MQTT_Worx password secret
</syntaxhighlight>

'''Erläuterung:'''

'''xx''' kann als Platzhalter stehen bleiben, die Url wird über LandroidUtils.pm ermittelt.

'''username''' und '''password''' sind die Zugangsdaten von Benutzerkonto des Mähers. (bei Worx Landroid z.B. https://account.worxlandroid.com)

<code>connectFn {use LandroidUtils;;Landroid_connect($NAME,"worx",1)}</code>

'''1''' = autocreate aktiv, damit wird ein [[MQTT2_DEVICE]] mit den Mowerdaten aus der API angelegt. Werden die Daten nicht benötigt, kann autocreate mit '''0''' deaktiviert werden.

Damit autocreate funktioniert muss zusätzlich das "globale" [[Autocreate]] in Fhem aktiv sein.

'''"worx"''' (= ID) bezieht sich auf den Hersteller des Mähers.

{| class="wikitable"
|+Achtung: case sensitive!
|-
!ID!!Hersteller
|-
|worx||Worx Landroid
|-
|kress||Kress
|-
|landxcape||LandXcape Robotics
|}

==Client==
Nach dem Anlegen des [[MQTT2_CLIENT]] ist ein <code>set <name> connect</code> erforderlich. Nach wenigen Sekunden sollte die Client auf "opened" stehen. Benötigte Attribute usw. werden automatisch über die LandroidUtils angelegt.

Folgende Attribute können bei Bedarf angepasst werden:

'''nextOpenDelay''' = gibt vor, in wie vielen Sekunden nach einem Verbindungsabbruch der Client einen neuen Anmeldeversuch startet

'''maxFailedConnects''' = gibt die max. Anzahl an Anmeldeversuche nach einem Verbindungsabbruch an

Beide Attr. sollten mit Bedacht geändert werden, zu kurze und zu viele Versuche können eine Sperre vom Server auslösen. Als Standard ist hier nextOpenDelay mit 180s und maxFailedConnects mit 20 angegeben (d.h. nach einen Verbindungsabbruch sollte der Client nach 20 x 180s = 60 Min wieder "opened" sein. Ist dies nicht der Fall, muss ein manuelles <code>set <name> connect</code> oder ein Neustart ausgeführt werden.

==Device==
Für das neu angelegte [[MQTT2_DEVICE]] kann ein [[AttrTemplate]] angewendet werden:

<code>set <NAME> attrTemplate worx_landroid</code>

Damit werden teilweise die Daten in "lesbare Readings" übersetzt und eine setlist zum Steuern des Mähers angelegt.

==Funktion==
Die Anmeldung am MQTT-Server wurde im Herbst 2022 auf Bearer Token umgestellt. Der Token ist aktuell eine Stunde gültig, danach beendet der Server die Verbindung. Automatisch wird mittels LandroidUtils ein neuer Token angefordert und die Verbindung wieder geöffnet.

==Links==
{{Link2Forum|Area= |Topic=111959 |Message= |LinkText=MQTT2 für Worx Landroid Mähroboter }}

[[MQTT2_CLIENT]]