MQTT - Versionsgeschichte

Beta-User: /* Installation in FHEM */

2025-03-24T14:33:45Z

Installation in FHEM

← Nächstältere Version		Version vom 24. März 2025, 16:33 Uhr
Zeile 37:		Zeile 37:
	Datei:00 mqtt pm.png\|Datenaustausch mit MQTT-Geräten, wenn das Modul ''MQTT'' (00_MQTT.pm) iVm. ''mosquitto'' als externem MQTT-Serverdienst verwendet wird		Datei:00 mqtt pm.png\|Datenaustausch mit MQTT-Geräten, wenn das Modul ''MQTT'' (00_MQTT.pm) iVm. ''mosquitto'' als externem MQTT-Serverdienst verwendet wird
	</gallery>		</gallery>
	{{Hinweis\|Neueinsteigern in das MQTT-Protokoll wird '''dringend empfohlen''', '''''MQTT2_SERVER''''', oder - sofern unbedingt ein externer Server zum Einsatz ~~werden~~ soll - ''MQTT2_CLIENT'' zu verwenden.}}		{{Hinweis\|Neueinsteigern in das MQTT-Protokoll wird '''dringend empfohlen''', '''''MQTT2_SERVER''''', oder - sofern unbedingt ein externer Server zum Einsatz kommen soll - ''MQTT2_CLIENT'' zu verwenden.}}


Zeile 153:		Zeile 153:
	==== RAW-Events am IO-Gerät (MQTT2.*) ====		==== RAW-Events am IO-Gerät (MQTT2.*) ====
	Bei beiden MQTT2-IO-Modulen (MQTT2_SERVER und MQTT2_CLIENT) kann per [[Regulärer Ausdruck\|regulärem Ausdruck]] festgelegt werden, welche Nachrichten ein Event erzeugen sollen, auf das dann wieder z.B. mit einem [[notify]] reagiert werden kann, z.B. um beliebige Schaltaktionen auszulösen.		Bei beiden MQTT2-IO-Modulen (MQTT2_SERVER und MQTT2_CLIENT) kann per [[Regulärer Ausdruck\|regulärem Ausdruck]] festgelegt werden, welche Nachrichten ein Event erzeugen sollen, auf das dann wieder z.B. mit einem [[notify]] reagiert werden kann, z.B. um beliebige Schaltaktionen auszulösen.


	== MQTT-Clients (Beispiele) ==		== MQTT-Clients (Beispiele) ==

Ph1959de: Tippfehler

2024-02-20T14:40:46Z

Tippfehler

← Nächstältere Version		Version vom 20. Februar 2024, 16:40 Uhr
Zeile 6:		Zeile 6:
	define m2s MQTT2_SERVER 1883 global		define m2s MQTT2_SERVER 1883 global

	Am MQTT-Endgerät den FHEM-Server angeben wie in der ~~Dukumentation~~ des Endgeräts angegeben, danach das Endgerät neu starten.		Am MQTT-Endgerät den FHEM-Server angeben wie in der Dokumentation des Endgeräts angegeben, danach das Endgerät neu starten.
	Das Endgerät is dann im Raum ''MQTT2_DEVICE'' zu finden.		Das Endgerät ist dann im Raum ''MQTT2_DEVICE'' zu finden.

	Schau mal in attrTemplate des neu angelegten MQTT2_DEVICE, ob was passendes für Dich dabei ist.		Schau mal in attrTemplate des neu angelegten MQTT2_DEVICE, ob was passendes für Dich dabei ist.

	Für die meisten ggf. hierzu auftretenden Fragen sollten Hinweise in den [[MQTT2-Module - Praxisbeispiele\|Praxisbeispielen zu den MQTT2-Modulen]] enthalten sein.		Für die meisten ggf. hierzu auftretenden Fragen sollten Hinweise in den [[MQTT2-Module - Praxisbeispiele\|Praxisbeispielen zu den MQTT2-Modulen]] enthalten sein.


	== Eine sehr kurze Einführung in MQTT ==		== Eine sehr kurze Einführung in MQTT ==
Zeile 30:		Zeile 29:

	== Installation in FHEM ==		== Installation in FHEM ==
	Um ''MQTT'' in FHEM zu nutzen, benötigt man (mindestens) einen MQTT-Server. Es gibt zwei Möglichkeiten: ~~Man~~ kann FHEM-externe Server-Software (oder auch einen oder mehrere im Internet bereitstehende MQTT-Server) verwenden oder man kann die MQTT-Serverkomponente aktivieren, die mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} in FHEM direkt bereitsteht. Hier werden kurz beide Installationswege erläutert, zwingend ist nur einer, da eben mindestens ein MQTT-Serverdienst aktiv sein muß.		Um ''MQTT'' in FHEM zu nutzen, benötigt man (mindestens) einen MQTT-Server. Es gibt zwei Möglichkeiten: man kann FHEM-externe Server-Software (oder auch einen oder mehrere im Internet bereitstehende MQTT-Server) verwenden oder man kann die MQTT-Serverkomponente aktivieren, die mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} in FHEM direkt bereitsteht. Hier werden kurz beide Installationswege erläutert, zwingend ist nur einer, da eben mindestens ein MQTT-Serverdienst aktiv sein muß.

	Die nachfolgenden Schaubilder zeigen schematisch die in FHEM zur Verfügung stehenden Wege der Einbindung von Hard- und/oder Softwarekomponenten, die über das MQTT-Protokoll Daten austauschen.		Die nachfolgenden Schaubilder zeigen schematisch die in FHEM zur Verfügung stehenden Wege der Einbindung von Hard- und/oder Softwarekomponenten, die über das MQTT-Protokoll Daten austauschen.

Ph1959de: "source" Tag auf "syntaxhighlight" umgestellt.

2021-09-30T10:37:02Z

"source" Tag auf "syntaxhighlight" umgestellt.

← Nächstältere Version		Version vom 30. September 2021, 12:37 Uhr
Zeile 55:		Zeile 55:

	Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte. Seit ''stretch'' ist ''Mosquitto'' bereits in der Distribution enthalten und kann - zusammen mit dem client Befehl ''mosquito_sub'', der weiter unten benötigt wird, wie folgt installiert und getestet werden		Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte. Seit ''stretch'' ist ''Mosquitto'' bereits in der Distribution enthalten und kann - zusammen mit dem client Befehl ''mosquito_sub'', der weiter unten benötigt wird, wie folgt installiert und getestet werden
	<~~source~~ lang="bash">		<syntaxhighlight lang="bash">
	sudo apt-get install mosquitto mosquitto-clients		sudo apt-get install mosquitto mosquitto-clients

Zeile 64:		Zeile 64:
	sudo systemctl stop mosquitto		sudo systemctl stop mosquitto
	sudo systemctl start mosquitto		sudo systemctl start mosquitto
	</~~source~~>		</syntaxhighlight>
	Danach ist der RPi mit <nowiki>shutdown restart</nowiki> neu zu starten.		Danach ist der RPi mit <nowiki>shutdown restart</nowiki> neu zu starten.

Zeile 83:		Zeile 83:
	===== MQTT (Modul) =====		===== MQTT (Modul) =====
	Vorab werden für diese Variante weitere Perl-Pakete benötigt:		Vorab werden für diese Variante weitere Perl-Pakete benötigt:
	<~~source~~ lang="bash">		<syntaxhighlight lang="bash">
	# Perl Version ausgeben		# Perl Version ausgeben
	perl -v		perl -v
	# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)		# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)
	sudo cpan install Net::MQTT::Constants		sudo cpan install Net::MQTT::Constants
	</~~source~~>		</syntaxhighlight>
	Dabei wird neben dem ausdrücklich aufgeführten Modul noch ''Module::Pluggable'' und ''Net::MQTT::Message'' (sowie ein weiteres, nicht für FHEM genutztes Paket) installiert.		Dabei wird neben dem ausdrücklich aufgeführten Modul noch ''Module::Pluggable'' und ''Net::MQTT::Message'' (sowie ein weiteres, nicht für FHEM genutztes Paket) installiert.

Beta-User: Hinweis auf MQTT_BRIDGE=>contrib

2021-09-16T04:29:06Z

Hinweis auf MQTT_BRIDGE=>contrib

← Nächstältere Version		Version vom 16. September 2021, 06:29 Uhr
Zeile 44:		Zeile 44:
	Die mit dem Modul {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} bereitstehende Serverkomponente kann z.B. wie folgt aktiviert werden:		Die mit dem Modul {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} bereitstehende Serverkomponente kann z.B. wie folgt aktiviert werden:
	defmod myBroker MQTT2_SERVER 1883 global		defmod myBroker MQTT2_SERVER 1883 global
	Dieses [[Gerät]] übernimmt dann die Kommunikation mit den externen Clients (und wird von diesen behandelt, wie jeder andere MQTT-Server auch<ref>Bitte beachten Sie, dass (Stand: Janar 2021) ''MQTT2_SERVER'' nicht alle features des MQTT-Protokolls unterstützt.</ref>) und verteilt die eingehenden Nachrichten als IO-Device<ref>im Sinne des [[DevelopmentModuleIntro#Zweistufiges Modell für Module\|2-stufigen Modulkonzepts]]</ref> für die Client-Module [[MQTT2_DEVICE]]<ref>Die Zahl 2 in den Modulnamen verweist nur darauf, dass es sich um eine neuere Modulfamilie handelt; die Kommunikation mit den externen Komponenten unterscheidet sich nicht zu den älteren Modulen, die vor dem Jahr 2018 genutzt werden konnten.</ref> und ~~{{Link2CmdRef\|Anker=~~MQTT_GENERIC_BRIDGE~~\|Lang=de\|Label=MQTT_GENERIC_BRIDGE}}~~.		Dieses [[Gerät]] übernimmt dann die Kommunikation mit den externen Clients (und wird von diesen behandelt, wie jeder andere MQTT-Server auch<ref>Bitte beachten Sie, dass (Stand: Janar 2021) ''MQTT2_SERVER'' nicht alle features des MQTT-Protokolls unterstützt.</ref>) und verteilt die eingehenden Nachrichten als IO-Device<ref>im Sinne des [[DevelopmentModuleIntro#Zweistufiges Modell für Module\|2-stufigen Modulkonzepts]]</ref> für die Client-Module [[MQTT2_DEVICE]]<ref>Die Zahl 2 in den Modulnamen verweist nur darauf, dass es sich um eine neuere Modulfamilie handelt; die Kommunikation mit den externen Komponenten unterscheidet sich nicht zu den älteren Modulen, die vor dem Jahr 2018 genutzt werden konnten.</ref> und [[MQTT_GENERIC_BRIDGE]].
	Ein weiterer Vorteil dieser Lösung besteht darin, dass man ein ''MQTT2_SERVER''-Device mit Hilfe von [[allowed]] absichern kann, was auch SSL-verschlüsselte Kommunikation ermöglicht. '''Hinweis:''' In diesem Fall muss User bzw. Passwort auch in den entsprechenden Geräten eingetragen werden.		Ein weiterer Vorteil dieser Lösung besteht darin, dass man ein ''MQTT2_SERVER''-Device mit Hilfe von [[allowed]] absichern kann, was auch SSL-verschlüsselte Kommunikation ermöglicht. '''Hinweis:''' In diesem Fall muss User bzw. Passwort auch in den entsprechenden Geräten eingetragen werden.

Zeile 79:		Zeile 79:
	{{Hinweis\|Wenn Sie beabsichtigen, MQTT2_CLIENT zu verwenden, sollten Sie zuerst die [[MQTT2-Module - Praxisbeispiele\|Praxisbeispiele zu den MQTT2-Modulen]] lesen, und dabei die Hinweise im Artikel [[MQTT2_CLIENT]] beachten.}}		{{Hinweis\|Wenn Sie beabsichtigen, MQTT2_CLIENT zu verwenden, sollten Sie zuerst die [[MQTT2-Module - Praxisbeispiele\|Praxisbeispiele zu den MQTT2-Modulen]] lesen, und dabei die Hinweise im Artikel [[MQTT2_CLIENT]] beachten.}}

	Ein MQTT2_CLIENT-Device kann ebenfals mit Hilfe von [[allowed]] abgesichert werden, um z.B. SSL-verschlüsselte Kommunikation zu ermöglichem. Client-Module zu diesem IO-Typ sind wiederum [[MQTT2_DEVICE]] und ~~{{Link2CmdRef\|Anker=~~MQTT_GENERIC_BRIDGE~~\|Lang=de\|Label=MQTT_GENERIC_BRIDGE}}~~.		Ein MQTT2_CLIENT-Device kann ebenfals mit Hilfe von [[allowed]] abgesichert werden, um z.B. SSL-verschlüsselte Kommunikation zu ermöglichem. Client-Module zu diesem IO-Typ sind wiederum [[MQTT2_DEVICE]] und [[MQTT_GENERIC_BRIDGE]].

	===== MQTT (Modul) =====		===== MQTT (Modul) =====
Zeile 94:		Zeile 94:
	{{Randnotiz\|RNTyp=g\|RNText=Sofern der Broker mit FHEM über localhost kommuniziert, kann als IP 127.0.0.1 verwendet werden.}}		{{Randnotiz\|RNTyp=g\|RNText=Sofern der Broker mit FHEM über localhost kommuniziert, kann als IP 127.0.0.1 verwendet werden.}}
	define myBroker MQTT 10.0.0.5:1883 ## bitte EIGENE IP-Adresse eintragen		define myBroker MQTT 10.0.0.5:1883 ## bitte EIGENE IP-Adresse eintragen
	{{Randnotiz\|RNTyp=g\|RNText=Außerhalb der offiziellen Quellen sind auch einige ältere Varianten des Moduls MQTT_DEVICE verfügbar, die jeweils spezielle Anforderungen (z.B. für Zigbee2mqtt) separat abbilden. Diese werden hier nicht gesondert behandelt, da solche Sonderfälle heute generischer und einfacher durch den Einsatz von MQTT2_DEVICE abzubilden sind.}}Client-Device-Module zum Modul [[MQTT (Modul)\|MQTT]] sind [[MQTT_DEVICE]], ~~{{Link2CmdRef\|Anker=~~MQTT_BRIDGE~~\|Lang=de\|Label=MQTT_BRIDGE}}~~ (veraltet!) und ~~{{Link2CmdRef\|Anker=MQTT_GENERIC_BRIDGE\|Lang=de\|Label=~~MQTT_GENERIC_BRIDGE}}. Da ''MQTT_DEVICE'' payload im JSON-Format (im Unterschied zu MQTT2_DEVICE) nicht selbst verarbeiten kann wird hier zusätzlich das Modul {{Link2CmdRef\|Anker=expandJSON\|Lang=de\|Label=expandJSON}} benötigt, um den {{Link2Forum\|Topic=66761\|LinkText=JSON String auszuwerten}}.		{{Randnotiz\|RNTyp=g\|RNText=Außerhalb der offiziellen Quellen sind auch einige ältere Varianten des Moduls MQTT_DEVICE verfügbar, die jeweils spezielle Anforderungen (z.B. für Zigbee2mqtt) separat abbilden. Diese werden hier nicht gesondert behandelt, da solche Sonderfälle heute generischer und einfacher durch den Einsatz von MQTT2_DEVICE abzubilden sind.}}Client-Device-Module zum Modul [[MQTT (Modul)\|MQTT]] sind [[MQTT_DEVICE]], ''MQTT_BRIDGE'' (veraltet!) und [[MQTT_GENERIC_BRIDGE]]. Da ''MQTT_DEVICE'' payload im JSON-Format (im Unterschied zu MQTT2_DEVICE) nicht selbst verarbeiten kann wird hier zusätzlich das Modul {{Link2CmdRef\|Anker=expandJSON\|Lang=de\|Label=expandJSON}} benötigt, um den {{Link2Forum\|Topic=66761\|LinkText=JSON String auszuwerten}}.

	===== Auswahl =====		===== Auswahl =====
Zeile 140:		Zeile 140:

	==== MQTT_BRIDGE ====		==== MQTT_BRIDGE ====
	Dieses Modul kann nur zusammen mit einem IO-Gerät des Typs [[MQTT (Modul)\|MQTT]] verwendet werden. Dabei wird pro weiterzuleitendem anderen FHEM-Gerät eine eigene Instanz dieses Moduls verwendet. '''Auf den Einsatz dieser Option sollte in neuen Installationen zugunsten von ''MQTT_GENERIC_BRIDGE'' verzichtet werden!'''		Dieses früher in FHEM enthaltene Modul kann nur zusammen mit einem IO-Gerät des Typs [[MQTT (Modul)\|MQTT]] verwendet werden. Dabei wird pro weiterzuleitendem anderen FHEM-Gerät eine eigene Instanz dieses Moduls verwendet. '''Auf den Einsatz dieser Option sollte in neuen Installationen zugunsten von ''MQTT_GENERIC_BRIDGE'' verzichtet werden!'''
			{{Hinweis\|''MQTT_BRIGE'' wird seit FHEM-Version 6.1 nicht mehr direkt als Modul mit installiert. Es ist bei Bedarf in ''contrib'' zu finden.}}

	==== Per publish-Befehl am IO-Gerät ====		==== Per publish-Befehl am IO-Gerät ====

Beta-User: formatierung

2021-09-13T18:33:07Z

formatierung

← Nächstältere Version		Version vom 13. September 2021, 20:33 Uhr
Zeile 54:		Zeile 54:
	Eine gern verwendete MQTT-Server-Software ist [http://mosquitto.org Mosquitto]. Sie kann ohne weiteres auf dem Raspberry Pi, der bereits eine FHEM-Installation besitzt, installiert werden und wird keine größere CPU- oder Netzwerklast verursachen.		Eine gern verwendete MQTT-Server-Software ist [http://mosquitto.org Mosquitto]. Sie kann ohne weiteres auf dem Raspberry Pi, der bereits eine FHEM-Installation besitzt, installiert werden und wird keine größere CPU- oder Netzwerklast verursachen.

	Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte. Seit ''stretch'' ist ''Mosquitto'' bereits in der Distribution enthalten und kann - zusammen mit dem client Befehl ''mosquito_sub'', der weiter unten benötigt wird, wie folgt installiert und getestet werden~~<ref>Die für den Betrieb mit FHEM erforderlichen Perl-Module sind teilweise (noch) nicht in den Paketquellen verfügbar.~~ <source lang="bash">		Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte. Seit ''stretch'' ist ''Mosquitto'' bereits in der Distribution enthalten und kann - zusammen mit dem client Befehl ''mosquito_sub'', der weiter unten benötigt wird, wie folgt installiert und getestet werden
			<source lang="bash">
	sudo apt-get install mosquitto mosquitto-clients		sudo apt-get install mosquitto mosquitto-clients

Zeile 106:		Zeile 107:
	Ein externer Broker hat daher vor allem dann Vorteile, wenn die MQTT Daten überwiegend für was anderes (nicht FHEM) verwendet werden, oder MQTT zweckentfremdet wird (wie z.Bsp. für Musikübertragung). Nutzt man das MQTT-Protokoll dagegen vorwiegend innerhalb von FHEM, ist eher der Einsatz von ''MQTT2_SERVER'' in Betracht zu ziehen. Dieser soll Anfängern die Anbindung von MQTT Geräten in FHEM einfacher machen. Wer später merkt, dass er doch einen externen Broker benötigt, kann dann immer noch auf ''MQTT2_CLIENT'' in Verbindung mit einem anderen Broker wechseln.		Ein externer Broker hat daher vor allem dann Vorteile, wenn die MQTT Daten überwiegend für was anderes (nicht FHEM) verwendet werden, oder MQTT zweckentfremdet wird (wie z.Bsp. für Musikübertragung). Nutzt man das MQTT-Protokoll dagegen vorwiegend innerhalb von FHEM, ist eher der Einsatz von ''MQTT2_SERVER'' in Betracht zu ziehen. Dieser soll Anfängern die Anbindung von MQTT Geräten in FHEM einfacher machen. Wer später merkt, dass er doch einen externen Broker benötigt, kann dann immer noch auf ''MQTT2_CLIENT'' in Verbindung mit einem anderen Broker wechseln.
	Dagegen ist der Weg von ''MQTT_DEVICE'' zu ''MQTT2_DEVICE'' mit erheblich mehr Aufwand verbunden.		Dagegen ist der Weg von ''MQTT_DEVICE'' zu ''MQTT2_DEVICE'' mit erheblich mehr Aufwand verbunden.


	=== Kommunikation zu sonstigen FHEM-Geräten über MQTT ===		=== Kommunikation zu sonstigen FHEM-Geräten über MQTT ===

Beta-User: Hinweise auf Module von cpan aktualisiert, ältere Linux-Distributionen entfernt; Forum #122816

2021-09-13T18:24:21Z

Hinweise auf Module von cpan aktualisiert, ältere Linux-Distributionen entfernt; Forum #122816

← Nächstältere Version		Version vom 13. September 2021, 20:24 Uhr
Zeile 54:		Zeile 54:
	Eine gern verwendete MQTT-Server-Software ist [http://mosquitto.org Mosquitto]. Sie kann ohne weiteres auf dem Raspberry Pi, der bereits eine FHEM-Installation besitzt, installiert werden und wird keine größere CPU- oder Netzwerklast verursachen.		Eine gern verwendete MQTT-Server-Software ist [http://mosquitto.org Mosquitto]. Sie kann ohne weiteres auf dem Raspberry Pi, der bereits eine FHEM-Installation besitzt, installiert werden und wird keine größere CPU- oder Netzwerklast verursachen.

	~~Eine Anleitung zur Installation findet sich beispielsweise in diesem [http://blog.wenzlaff.de/?p=6487 Blogeintrag].~~ Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte. ~~Bei~~ ''stretch'' ist ''Mosquitto'' bereits in der Distribution enthalten und kann - zusammen mit dem client Befehl ''mosquito_sub'', der weiter unten benötigt wird, wie folgt installiert und getestet werden<ref>Die für den Betrieb mit FHEM erforderlichen Perl-Module sind teilweise (noch) nicht in den Paketquellen verfügbar. Sie können dennoch statt mit cpan auch als Debian-Paket mit Hilfe von ''dh-make-perl'' installiert werden, wobei vorab das in den Paketquellen bereits vorhandene ''libmodule-pluggable-perl'' installiert werden sollte:<br>		Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte. Seit ''stretch'' ist ''Mosquitto'' bereits in der Distribution enthalten und kann - zusammen mit dem client Befehl ''mosquito_sub'', der weiter unten benötigt wird, wie folgt installiert und getestet werden<ref>Die für den Betrieb mit FHEM erforderlichen Perl-Module sind teilweise (noch) nicht in den Paketquellen verfügbar. <source lang="bash">
	~~<code>sudo apt-get install dh-make-perl<br>~~
	~~dh-make-perl --install --cpan Net::MQTT::simple<br>~~
	~~dh-make-perl --install --cpan Net::MQTT::Constants<br>~~
	~~sudo dpkg -i libnet-mqtt-simple-perl*.deb<br>~~
	~~sudo dpkg -i libnet-mqtt-perl*.deb</code></ref>:~~
	~~{{Randnotiz\|RNTyp=g\|RNText=Für ältere Distributionen (hier am Beispiel von ''jessie'') muß ggf. aus einer zusätzlichen Paketquelle installiert werden:~~
	~~wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key~~
	~~sudo apt-key add mosquitto-repo.gpg.key~~
	~~cd /etc/apt/sources.list.d/~~
	~~sudo wget http://repo.mosquitto.org/debian/mosquitto-jessie.list~~
	~~sudo apt-get update~~
	~~Danach kann die eigentliche Installation durchgeführt werden wie links für ''stretch'' beschrieben.}}~~<source lang="bash">
	sudo apt-get install mosquitto mosquitto-clients		sudo apt-get install mosquitto mosquitto-clients

Zeile 98:		Zeile 86:
	perl -v		perl -v
	# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)		# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)
	~~sudo cpan install Net::MQTT::Simple~~
	sudo cpan install Net::MQTT::Constants		sudo cpan install Net::MQTT::Constants
	</source>		</source>
			Dabei wird neben dem ausdrücklich aufgeführten Modul noch ''Module::Pluggable'' und ''Net::MQTT::Message'' (sowie ein weiteres, nicht für FHEM genutztes Paket) installiert.

	Ein IO-Device des Typs MQTT wird z.B. angelegt mit		Ein IO-Device des Typs MQTT wird z.B. angelegt mit
	{{Randnotiz\|RNTyp=g\|RNText=Sofern der Broker mit FHEM über localhost kommuniziert, kann als IP 127.0.0.1 verwendet werden.}}		{{Randnotiz\|RNTyp=g\|RNText=Sofern der Broker mit FHEM über localhost kommuniziert, kann als IP 127.0.0.1 verwendet werden.}}
	define myBroker MQTT 10.0.0.5:1883 ## bitte EIGENE IP-Adresse eintragen		define myBroker MQTT 10.0.0.5:1883 ## bitte EIGENE IP-Adresse eintragen
	{{Randnotiz\|RNTyp=g\|RNText=Außerhalb der offiziellen Quellen sind auch einige ältere Varianten des Moduls MQTT_DEVICE verfügbar, die jeweils spezielle Anforderungen (z.B. für Zigbee2mqtt) separat abbilden. Diese werden hier nicht gesondert behandelt, da solche Sonderfälle heute generischer und einfacher durch den Einsatz von MQTT2_DEVICE abzubilden sind.}}Client-Device-Module zum Modul [[MQTT (Modul)\|MQTT]] sind [[MQTT_DEVICE]], {{Link2CmdRef\|Anker=MQTT_BRIDGE\|Lang=de\|Label=MQTT_BRIDGE}} (veraltet) und {{Link2CmdRef\|Anker=MQTT_GENERIC_BRIDGE\|Lang=de\|Label=MQTT_GENERIC_BRIDGE}}. Da ''MQTT_DEVICE'' payload im JSON-Format (im Unterschied zu MQTT2_DEVICE) nicht selbst verarbeiten kann wird hier zusätzlich das Modul {{Link2CmdRef\|Anker=expandJSON\|Lang=de\|Label=expandJSON}} benötigt, um den {{Link2Forum\|Topic=66761\|LinkText=JSON String auszuwerten}}.		{{Randnotiz\|RNTyp=g\|RNText=Außerhalb der offiziellen Quellen sind auch einige ältere Varianten des Moduls MQTT_DEVICE verfügbar, die jeweils spezielle Anforderungen (z.B. für Zigbee2mqtt) separat abbilden. Diese werden hier nicht gesondert behandelt, da solche Sonderfälle heute generischer und einfacher durch den Einsatz von MQTT2_DEVICE abzubilden sind.}}Client-Device-Module zum Modul [[MQTT (Modul)\|MQTT]] sind [[MQTT_DEVICE]], {{Link2CmdRef\|Anker=MQTT_BRIDGE\|Lang=de\|Label=MQTT_BRIDGE}} (veraltet!) und {{Link2CmdRef\|Anker=MQTT_GENERIC_BRIDGE\|Lang=de\|Label=MQTT_GENERIC_BRIDGE}}. Da ''MQTT_DEVICE'' payload im JSON-Format (im Unterschied zu MQTT2_DEVICE) nicht selbst verarbeiten kann wird hier zusätzlich das Modul {{Link2CmdRef\|Anker=expandJSON\|Lang=de\|Label=expandJSON}} benötigt, um den {{Link2Forum\|Topic=66761\|LinkText=JSON String auszuwerten}}.

	===== Auswahl =====		===== Auswahl =====

Beta-User: Schnellstart für Ungeduldige eingefügt

2021-01-21T10:04:33Z

Schnellstart für Ungeduldige eingefügt

← Nächstältere Version		Version vom 21. Januar 2021, 12:04 Uhr
Zeile 2:		Zeile 2:

	MQTT wurde entwickelt, um möglichst effizient, sicher und mit wenig Datenlast zu kommunizieren. MQTT ist nachrichtenorientiert, daher muss ein Client nicht beständig beim Server anfragen, ob neue Daten vorliegen. Heute findet sich MQTT vor allem im Bereich des ''Internet of Things'' (IoT). MQTT kann leicht mit FHEM verbunden werden, ohne dass dabei größerer CPU- oder Datenverbrauch entsteht.		MQTT wurde entwickelt, um möglichst effizient, sicher und mit wenig Datenlast zu kommunizieren. MQTT ist nachrichtenorientiert, daher muss ein Client nicht beständig beim Server anfragen, ob neue Daten vorliegen. Heute findet sich MQTT vor allem im Bereich des ''Internet of Things'' (IoT). MQTT kann leicht mit FHEM verbunden werden, ohne dass dabei größerer CPU- oder Datenverbrauch entsteht.

			== Schnellstart für Ungeduldige ==
			define m2s MQTT2_SERVER 1883 global

			Am MQTT-Endgerät den FHEM-Server angeben wie in der Dukumentation des Endgeräts angegeben, danach das Endgerät neu starten.
			Das Endgerät is dann im Raum ''MQTT2_DEVICE'' zu finden.

			Schau mal in attrTemplate des neu angelegten MQTT2_DEVICE, ob was passendes für Dich dabei ist.

			Für die meisten ggf. hierzu auftretenden Fragen sollten Hinweise in den [[MQTT2-Module - Praxisbeispiele\|Praxisbeispielen zu den MQTT2-Modulen]] enthalten sein.


	== Eine sehr kurze Einführung in MQTT ==		== Eine sehr kurze Einführung in MQTT ==
Zeile 59:		Zeile 70:

	# MQTT Server Test		# MQTT Server Test
	sudo ~~service~~ mosquitto ~~status~~		sudo systemctl status mosquitto

	# Start / Stop des Servers		# Start / Stop des Servers
	sudo ~~service~~ mosquitto ~~stop~~		sudo systemctl stop mosquitto
	sudo ~~service~~ mosquitto ~~start~~		sudo systemctl start mosquitto
	</source>		</source>
	Danach ist der RPi mit <nowiki>shutdown restart</nowiki> neu zu starten.		Danach ist der RPi mit <nowiki>shutdown restart</nowiki> neu zu starten.

Beta-User: clientOrder und Empfehlungen iR. M2-Modulen eingefügt

2021-01-21T08:55:07Z

clientOrder und Empfehlungen iR. M2-Modulen eingefügt

Änderungen zeigen

Beta-User: /* MQTT_GENERIC_BRIDGE und autocreate bei MQTT2-IO-Modulen */

2021-01-13T14:20:30Z

MQTT_GENERIC_BRIDGE und autocreate bei MQTT2-IO-Modulen

← Nächstältere Version		Version vom 13. Januar 2021, 16:20 Uhr
Zeile 113:		Zeile 113:
	Dabei sollte man jedoch beachten, dass eingehende MQTT-Nachrichten von den MQTT2-IO Modulen (''MQTT2_SERVER'' oder ''MQTT2_CLIENT'') nur dann an die ''MQTT_GENERIC_BRIDGE'' zur weiteren Auswertung übergeben werden, wenn		Dabei sollte man jedoch beachten, dass eingehende MQTT-Nachrichten von den MQTT2-IO Modulen (''MQTT2_SERVER'' oder ''MQTT2_CLIENT'') nur dann an die ''MQTT_GENERIC_BRIDGE'' zur weiteren Auswertung übergeben werden, wenn

	zum einen '''kein passender readingList-Eintrag''' an irgendeinem MQTT2_DEVICE exisitert '''und''		zum einen '''kein passender readingList-Eintrag''' an irgendeinem MQTT2_DEVICE exisitert '''und'''

	entweder		entweder

Beta-User: MGB + autocreate bei MQTT2-IO-Modulen betr. rL-Hinweis ergänzt

2021-01-13T14:19:54Z

MGB + autocreate bei MQTT2-IO-Modulen betr. rL-Hinweis ergänzt

← Nächstältere Version		Version vom 13. Januar 2021, 16:19 Uhr
Zeile 111:		Zeile 111:

	===== MQTT_GENERIC_BRIDGE und autocreate bei MQTT2-IO-Modulen =====		===== MQTT_GENERIC_BRIDGE und autocreate bei MQTT2-IO-Modulen =====
	Dabei sollte man jedoch beachten, dass eingehende MQTT-Nachrichten von den MQTT2-IO Modulen (''MQTT2_SERVER'' oder ''MQTT2_CLIENT'') nur dann an die ''MQTT_GENERIC_BRIDGE'' zur weiteren Auswertung übergeben werden, wenn entweder		Dabei sollte man jedoch beachten, dass eingehende MQTT-Nachrichten von den MQTT2-IO Modulen (''MQTT2_SERVER'' oder ''MQTT2_CLIENT'') nur dann an die ''MQTT_GENERIC_BRIDGE'' zur weiteren Auswertung übergeben werden, wenn

			zum einen '''kein passender readingList-Eintrag''' an irgendeinem MQTT2_DEVICE exisitert '''und''

			entweder

	- die ''autocreate''-Funktion des betreffenden IOs ausgeschaltet wird und bleibt, oder		- die ''autocreate''-Funktion des betreffenden IOs ausgeschaltet wird und bleibt, oder
Zeile 124:		Zeile 128:
	define M_G_B_bridgeRegex_device MQTT2_DEVICE fhem2		define M_G_B_bridgeRegex_device MQTT2_DEVICE fhem2
	attr M_G_B_bridgeRegex_device bridgeRegexp [\b]fhem/.:. ""		attr M_G_B_bridgeRegex_device bridgeRegexp [\b]fhem/.:. ""


	===== Anwendungsbeispiele =====		===== Anwendungsbeispiele =====