(FHEM) 00 MQTT.pm - Versionsgeschichte

Chris T. Ludwig: /* Anwendungen */

2022-08-10T09:00:25Z

Anwendungen

← Nächstältere Version		Version vom 10. August 2022, 11:00 Uhr
Zeile 182:		Zeile 182:

	=Anwendungen=		=Anwendungen=
			Eine sinnvolle Anwendung habe ich noch keine. Nach dem Anlegen des Devices kann man Nachrichten mit set verschicken. Ich habe bisher diesen Devicetyp nur zum Testen benutzt.

Chris T. Ludwig: /* Gruppe 2: Verhalten des FHEM-DEVICES */

2022-08-10T08:58:27Z

Gruppe 2: Verhalten des FHEM-DEVICES

← Nächstältere Version		Version vom 10. August 2022, 10:58 Uhr
Zeile 168:		Zeile 168:
	attr <name> '''on-timeout''' {Perl-expression}		attr <name> '''on-timeout''' {Perl-expression}

	Im Prinzip sind alle drei Attribute gleich. Bei 'on-connect' und 'on-disconnect' wird eine Nachricht (<message>) an den angegebenen Topic gesendet. Die Perl-expression darf hier weggelassen werden. Bei diesen beiden Attributen ist dieser Publish sozusagen das "Gegenteil" des [[#Last Will\|Last Will]] Wird die Perl-expression uebergeben wird diese nach einem connect oder disconnect zuerst ausgewertet und die Nachricht erst im Falle eines (Rueckgabe-)wertes von true, 1 oder undef, gesendet.		Im Prinzip sind alle drei Attribute gleich. Bei 'on-connect' und 'on-disconnect' wird eine Nachricht (<message>) an den angegebenen Topic gesendet. Die Perl-expression darf hier weggelassen werden. Bei diesen beiden Attributen ist dieser Publish sozusagen das "Gegenteil" des [[#Last Will\|Last Will]] Wird die Perl-expression uebergeben wird diese nach einem connect oder disconnect zuerst ausgewertet und die Nachricht erst im Falle eines (Rueckgabe-)wertes von true, 1 oder undef, gesendet. Die folgenden Variablen werden bei der Auswertung an den Ausdruck übergeben: $hash, $name, $qos, $retain, $topic, $message.

	Bei 'on-timeout' die Perl-expression wegzulassen ist dagegen sinnlos. Welcher timeout hier gemeint sein koennte muss ich noch herausfinden		Bei 'on-timeout' die Perl-expression wegzulassen ist dagegen sinnlos. Welcher timeout hier gemeint sein koennte muss ich noch herausfinden.

			Beispiele:
			attr mqtt on-connect /topic/status connected
			attr mqtt on-connect {Log3("abc",1,"on-connect")} /fhem/status connected

			Ein sinnvoller Einsatz der Perl-Expression ist mir noch nicht eingefallen.

	===Gruppe 3: Bedeutung TODO===		===Gruppe 3: Bedeutung TODO===

Chris T. Ludwig: /* Gruppe 1: MQTT spezifisch */

2022-08-10T08:36:05Z

Gruppe 1: MQTT spezifisch

← Nächstältere Version		Version vom 10. August 2022, 10:36 Uhr
Zeile 147:		Zeile 147:

	attr <name> last-will [qos:?] [retain:?] <topic> <message> [[MQTT#Last Will\|siehe meine Erlaeuterung dazu]]		attr <name> last-will [qos:?] [retain:?] <topic> <message> [[MQTT#Last Will\|siehe meine Erlaeuterung dazu]]

			Ich habe grosze Zweifel, dass hier die beiden Attribute richtig implementiert sind. Stellt man zum Beispiel keep-alive auf 1 (Sekunde) dann wird der Client auf dem Server nicht nach 1 Sekunde disconnectet, sondern der das connection-reading laeuft im Sekundentakt. ???

	===Gruppe 2: Verhalten des FHEM-DEVICES===		===Gruppe 2: Verhalten des FHEM-DEVICES===
	attr <name> '''client-id''' client id		attr <name> '''client-id''' client id

Chris T. Ludwig: /* Erlaeuterungen */

2022-08-10T07:43:11Z

Erlaeuterungen

← Nächstältere Version		Version vom 10. August 2022, 09:43 Uhr
Zeile 37:		Zeile 37:

	=Erlaeuterungen=		=Erlaeuterungen=


			=Hindernisse/Hinweise==
			==#1==
	Clients: MQTT_DEVICE und MQTT_BRIDGE		Clients: MQTT_DEVICE und MQTT_BRIDGE

Chris T. Ludwig: /* 00_MQTT.pm */

2022-08-09T14:46:36Z

00_MQTT.pm

← Nächstältere Version		Version vom 9. August 2022, 16:46 Uhr
Zeile 8:		Zeile 8:

	Nebenbemerkung: Genau wie in der Netzwerktechnik gehen scheinbar hier die Begriffe Gateway und Bridge munter durcheinander. Ein Gateway liegt im ISO/OSI und im TCP/IP auf verschiedenen Schichten!		Nebenbemerkung: Genau wie in der Netzwerktechnik gehen scheinbar hier die Begriffe Gateway und Bridge munter durcheinander. Ein Gateway liegt im ISO/OSI und im TCP/IP auf verschiedenen Schichten!
			Weiterhin scheint es mit diesem Modul Probleme zu geben wenn der Broker nicht auf dem gleichen Server liegt, also die ip nicht localhost oder 127.0.0.1 ist. Aber selbst da gibt es Probleme.
			Solange ich keine triftigen Grund kenne werde ich auf den Einsatz dieses Moduls verzichten.

	Es muss für jedes MQTT-Gateway ein Server (Broker) eingerichtet und erreichbar sein.		Es muss für jedes MQTT-Gateway ein Server (Broker) eingerichtet und erreichbar sein.

Chris T. Ludwig: /* Erlaeuterungen */

2022-08-09T06:56:39Z

Erlaeuterungen

← Nächstältere Version		Version vom 9. August 2022, 08:56 Uhr
Zeile 68:		Zeile 68:

	Nach dem Installieren war die Definition des Beispiels (s. u.) erfolgreich.		Nach dem Installieren war die Definition des Beispiels (s. u.) erfolgreich.

			Das MQTT-modul macht nach einem Reconnect einen Retransmit aller noch nicht bestätigten (acknowledged bzw. completet) Messages.

	=Beispiele=		=Beispiele=

Chris T. Ludwig: /* Gruppe 2: Verhalten des FHEM-DEVICES */

2022-08-08T12:00:26Z

Gruppe 2: Verhalten des FHEM-DEVICES

← Nächstältere Version		Version vom 8. August 2022, 14:00 Uhr
Zeile 141:		Zeile 141:

	===Gruppe 2: Verhalten des FHEM-DEVICES===		===Gruppe 2: Verhalten des FHEM-DEVICES===
	attr <name> client-id client id		attr <name> '''client-id''' client id

	Mit diesem Attribut kan die Client ID mit der sich das FHEM-DEVICE am MQTT-Server anmeldet geaendert werden. Wenn das Attribut nicht gesetzt ist wird die FUUID als Client ID genommen.		Mit diesem Attribut kan die Client ID mit der sich das FHEM-DEVICE am MQTT-Server anmeldet geaendert werden. Wenn das Attribut nicht gesetzt ist wird die FUUID als Client ID genommen.
Zeile 152:		Zeile 152:
	</pre>		</pre>

	on-connect		attr <name> '''on-connect''' {Perl-expression} <topic> <message>

	on-disconnect		attr <name> '''on-disconnect''' {Perl-expression} <topic> <message>

	on-timeout		attr <name> '''on-timeout''' {Perl-expression}

			Im Prinzip sind alle drei Attribute gleich. Bei 'on-connect' und 'on-disconnect' wird eine Nachricht (<message>) an den angegebenen Topic gesendet. Die Perl-expression darf hier weggelassen werden. Bei diesen beiden Attributen ist dieser Publish sozusagen das "Gegenteil" des [[#Last Will\|Last Will]] Wird die Perl-expression uebergeben wird diese nach einem connect oder disconnect zuerst ausgewertet und die Nachricht erst im Falle eines (Rueckgabe-)wertes von true, 1 oder undef, gesendet.

			Bei 'on-timeout' die Perl-expression wegzulassen ist dagegen sinnlos. Welcher timeout hier gemeint sein koennte muss ich noch herausfinden

	===Gruppe 3: Bedeutung TODO===		===Gruppe 3: Bedeutung TODO===

Chris T. Ludwig: /* Attribute */

2022-08-08T11:35:26Z

Attribute

← Nächstältere Version		Version vom 8. August 2022, 13:35 Uhr
Zeile 140:		Zeile 140:
	attr <name> last-will [qos:?] [retain:?] <topic> <message> [[MQTT#Last Will\|siehe meine Erlaeuterung dazu]]		attr <name> last-will [qos:?] [retain:?] <topic> <message> [[MQTT#Last Will\|siehe meine Erlaeuterung dazu]]

			===Gruppe 2: Verhalten des FHEM-DEVICES===
	attr <name> client-id client id		attr <name> client-id client id

Zeile 151:		Zeile 152:
	</pre>		</pre>

	~~===Gruppe 2: Verhalten des FHEM-DEVICES===~~		on-connect
	on-connect
	on-disconnect		on-disconnect
	on-timeout
			on-timeout

	===Gruppe 3: Bedeutung TODO===		===Gruppe 3: Bedeutung TODO===
	privacy 0\|1		privacy 0\|1

	=Anwendungen=		=Anwendungen=

Chris T. Ludwig: /* Gruppe 1: MQTT spezifisch */

2022-08-08T11:34:05Z

Gruppe 1: MQTT spezifisch

← Nächstältere Version		Version vom 8. August 2022, 13:34 Uhr
Zeile 136:		Zeile 136:

	===Gruppe 1: MQTT spezifisch===		===Gruppe 1: MQTT spezifisch===
	keep-alive		keep-alive [[MQTT#Ping Request/Response\|siehe meine Erlaeuterung dazu]]

	attr <name> last-will [qos:?] [retain:?] <topic> <message>		attr <name> last-will [qos:?] [retain:?] <topic> <message> [[MQTT#Last Will\|siehe meine Erlaeuterung dazu]]

	attr <name> client-id client id		attr <name> client-id client id

Chris T. Ludwig: /* Beispiele */

2022-08-08T11:16:48Z

Beispiele

← Nächstältere Version		Version vom 8. August 2022, 13:16 Uhr
Zeile 127:		Zeile 127:
	qos meint Quality of Service und retain meint das die Nachricht aufbewahrt werden soll.		qos meint Quality of Service und retain meint das die Nachricht aufbewahrt werden soll.
	qos kann die Werte [0,1,2] annehmen. QOS ist im Publish Fixed Header in 2 Bit codiert. Eine vierte Stufe (3) ist denkbar aber im MQTT-Standard nicht implementiert. Das Retain ist ein 1-Bit Flag im Header.		qos kann die Werte [0,1,2] annehmen. QOS ist im Publish Fixed Header in 2 Bit codiert. Eine vierte Stufe (3) ist denkbar aber im MQTT-Standard nicht implementiert. Das Retain ist ein 1-Bit Flag im Header.
			Um eine Nachricht die mit retain:1 verschickt wurde wieder zu loeschen ist eine Nachricht wieder mit retain:1, dem gleiche Topic und dem NULL_String zu senden.

			set <MQTT> publish retain:1 <topic> <"" oder ''>


	==Attribute==		==Attribute==