MQTT GENERIC BRIDGE - Versionsgeschichte

Beta-User: Klarstellung bzgl. ClientID und mosquitto_pub

2022-11-30T16:54:09Z

Klarstellung bzgl. ClientID und mosquitto_pub

← Nächstältere Version		Version vom 30. November 2022, 18:54 Uhr
Zeile 114:		Zeile 114:

	===Geräte steuern===		===Geräte steuern===
	{{Randnotiz\|RNTyp=y\|RNText=Kommt als MQTT-Server MQTT2_SERVER zum Einsatz, ist zwingend eine ''ClientID'' mit anzugeben, andernfalls werden die so generierten Messages eventuell nicht ausgewertet!}}Um Geräte über die MQTT-Schnittstelle bedienen zu können, wird zum einen eine Software benötigt, mit der man entsprechende publish-Anweisungen generieren kann. Dies kann z.B. das bereits genannte ''mosquitto_pub'' sein.		{{Randnotiz\|RNTyp=y\|RNText=Kommt als MQTT-Server MQTT2_SERVER zum Einsatz, ist beim publishen via ''mosquitto_pub'' zwingend eine ''ClientID'' mit anzugeben, andernfalls werden die so generierten Messages eventuell nicht ausgewertet!}}Um Geräte über die MQTT-Schnittstelle bedienen zu können, wird zum einen eine Software benötigt, mit der man entsprechende publish-Anweisungen generieren kann. Dies kann z.B. das bereits genannte ''mosquitto_pub'' sein.
	====mqttSubscribe====		====mqttSubscribe====
	Spiegelbildlich zum o.g. ''mqttPublish''-Attribut wird über das jeweilige ''mqttSubscribe''-Attribut festgelegt, welche Topics für das FHEM-Gerät ausgewertet werden sollen und welchen Readings diese zugeordnet sind.		Spiegelbildlich zum o.g. ''mqttPublish''-Attribut wird über das jeweilige ''mqttSubscribe''-Attribut festgelegt, welche Topics für das FHEM-Gerät ausgewertet werden sollen und welchen Readings diese zugeordnet sind.

DasQ: Fehlenden Buchstaben ergänzt, bei "Geräte mit mehreren Settern" fehlte ein G in "entgegennehmen"

2022-10-13T12:03:23Z

Fehlenden Buchstaben ergänzt, bei "Geräte mit mehreren Settern" fehlte ein G in "entgegennehmen"

← Nächstältere Version		Version vom 13. Oktober 2022, 14:03 Uhr
Zeile 130:		Zeile 130:
	Das Prinzip dürfte jetzt klarer sein, also versuchen wir es direkt mit unserer farbigen Leuchte:		Das Prinzip dürfte jetzt klarer sein, also versuchen wir es direkt mit unserer farbigen Leuchte:
	attr myRGBLight mqttSubscribe state:stopic={"$base/$device"} pct\|rgb:stopic={"$base/$device/$name"}		attr myRGBLight mqttSubscribe state:stopic={"$base/$device"} pct\|rgb:stopic={"$base/$device/$name"}
	Und schon sollte diese über ''msoquitto_pub'' bzw. MQTT schalt- und dimmbar sein und Farbänderungen ~~entegennehmen~~ - und natürlich den zugehörigen Status zurückmelden.		Und schon sollte diese über ''msoquitto_pub'' bzw. MQTT schalt- und dimmbar sein und Farbänderungen entgegennehmen - und natürlich den zugehörigen Status zurückmelden.

	====mqttAlias====		====mqttAlias====

Choenig: Add code block

2022-09-12T15:46:59Z

Add code block

← Nächstältere Version		Version vom 12. September 2022, 17:46 Uhr
Zeile 152:		Zeile 152:
	===expression===		===expression===

	attr ZWave_THERMOSTAT_20 mqttGB1Alias reportedState=actuator		attr ZWave_THERMOSTAT_20 mqttGB1Alias reportedState=actuator
	attr ZWave_THERMOSTAT_20 mqttGB1Publish desired-temp\|temperature\|reportedState:topic={"$base/$device/$name"} temperature:expression={$value=~m,(-?\d+(\.\d+)?),?::round($1,1):undef} reportedState:expression={$value=~m,dim.(\d+),?$1:undef}		attr ZWave_THERMOSTAT_20 mqttGB1Publish desired-temp\|temperature\|reportedState:topic={"$base/$device/$name"} temperature:expression={$value=~m,(-?\d+(\.\d+)?),?::round($1,1):undef} reportedState:expression={$value=~m,dim.(\d+),?$1:undef}
	attr ZWave_THERMOSTAT_20 mqttGB1Subscribe desired-temp:stopic={"$base/$device/$name"}		attr ZWave_THERMOSTAT_20 mqttGB1Subscribe desired-temp:stopic={"$base/$device/$name"}

	===JSON===		===JSON===

Krueuw: /* Einführung */

2022-05-31T14:59:38Z

Einführung

← Nächstältere Version		Version vom 31. Mai 2022, 16:59 Uhr
Zeile 11:		Zeile 11:
	==Einführung==		==Einführung==

	Das Modul ''MQTT_GENERIC_BRIDGE'' stellt eine zentrale Schnittstelle zum MQTT-Protokoll für beliebig viele andere FHEM-Geräte bereit. Es wird für eine FHEM-Installation jeweils nur ein erreichbarer MQTT-Server sowie eine Instanz der ''MQTT_GENERIC_BRIDGE'' benötigt ~~(es~~ ist aber möglich, mehrere ~~Parallen~~ .		Das Modul ''MQTT_GENERIC_BRIDGE'' stellt eine zentrale Schnittstelle zum MQTT-Protokoll für beliebig viele andere FHEM-Geräte bereit. Es wird für eine FHEM-Installation jeweils nur ein erreichbarer MQTT-Server sowie eine Instanz der ''MQTT_GENERIC_BRIDGE'' benötigt. Es ist aber auch möglich, mehrere Server parallel zu betreiben.

	Dieses Modul kann seit November 2018 mit allen drei IO-Modul-Varianten zusammen eingesetzt werden, also sowohl mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} bzw. [[MQTT2_CLIENT]] oder [[MQTT (Modul)\|MQTT]](00_MQTT.pm), und seit Rev. 23514 (Jan. 2021) wird für ''MQTT_GENERIC_BRIDGE'' iVm. den MQTT2-IO-Modulen keine zusätzliche Software mehr benötigt.		Dieses Modul kann seit November 2018 mit allen drei IO-Modul-Varianten zusammen eingesetzt werden, also sowohl mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} bzw. [[MQTT2_CLIENT]] oder [[MQTT (Modul)\|MQTT]](00_MQTT.pm), und seit Rev. 23514 (Jan. 2021) wird für ''MQTT_GENERIC_BRIDGE'' iVm. den MQTT2-IO-Modulen keine zusätzliche Software mehr benötigt.

Ph1959de: Text-Highlighting (kursiv) geändert auf "vermutete Absicht"

2021-08-16T15:33:51Z

Text-Highlighting (kursiv) geändert auf "vermutete Absicht"

← Nächstältere Version		Version vom 16. August 2021, 17:33 Uhr
Zeile 125:		Zeile 125:
	mosquitto_pub -h 127.0.0.1 -i fhem-test -t mqttGenericBridge/set/myRelay -m on		mosquitto_pub -h 127.0.0.1 -i fhem-test -t mqttGenericBridge/set/myRelay -m on

	Bei ''mosquitto_sub'' auf der Linux-Konsole sollte jetzt zunächst die Schaltanweisung (Topic mit ''set'-Element) wie auch die Readingänderung am Device vermeldet werden.''		Bei ''mosquitto_sub'' auf der Linux-Konsole sollte jetzt zunächst die Schaltanweisung (Topic mit ''set-Element'') wie auch die Readingänderung am Device vermeldet werden.

	====Geräte mit mehreren Settern====		====Geräte mit mehreren Settern====

F Klee am 16. August 2021 um 14:18 Uhr

2021-08-16T14:18:00Z

← Nächstältere Version		Version vom 16. August 2021, 16:18 Uhr
Zeile 104:		Zeile 104:

	====state====		====state====
	Da das Reading ''state'' in FHEM in der Regel eine Art ~~Haupzustand~~ eines Geräts beschreibt, wird für die weiter unten dargestellten ''attrTemplate'' dieses Reading kein ''$name''-Anteil im Topic versendet. Ein einfaches "ein-aus"-Gerät kann man dieser Vorgabe folgend daher so konfigurieren:		Da das Reading ''state'' in FHEM in der Regel eine Art Hauptzustand eines Geräts beschreibt, wird für die weiter unten dargestellten ''attrTemplate'' dieses Reading kein ''$name''-Anteil im Topic versendet. Ein einfaches "ein-aus"-Gerät kann man dieser Vorgabe folgend daher so konfigurieren:
	attr myRelay mqttPublish state:topic={"$base/$device"}		attr myRelay mqttPublish state:topic={"$base/$device"}

F Klee am 16. August 2021 um 14:11 Uhr

2021-08-16T14:11:48Z

← Nächstältere Version		Version vom 16. August 2021, 16:11 Uhr
Zeile 82:		Zeile 82:
	===Readingwerte publishen===		===Readingwerte publishen===
	====mqttPublish====		====mqttPublish====
	{{Randnotiz\|RNTyp=y\|RNText=Der Name der Attribute kann ~~anweichen~~, falls ein anderes ''MQTT-Präfix'' über das ''Define'' in der ''MQTT_GENERIC_BRIDGE'' gesetzt ist. Hier wird davon ausgegangen, dass dieses nicht geändert wurde.}}Um Reading-Werte von einem Gerät zu versenden, wird das Attribut ''mqttPublish'' verwendet. Im einfachsten Fall wird festgelegt, welche Readings versendet werden sollen, und unter welchem Topic. Für einen beliebigen Temperatursensor könnte dies z.B. so aussehen:		{{Randnotiz\|RNTyp=y\|RNText=Der Name der Attribute kann abweichen, falls ein anderes ''MQTT-Präfix'' über das ''Define'' in der ''MQTT_GENERIC_BRIDGE'' gesetzt ist. Hier wird davon ausgegangen, dass dieses nicht geändert wurde.}}

			Um Reading-Werte von einem Gerät zu versenden, wird das Attribut ''mqttPublish'' verwendet. Im einfachsten Fall wird festgelegt, welche Readings versendet werden sollen, und unter welchem Topic. Für einen beliebigen Temperatursensor könnte dies z.B. so aussehen:
	attr mySensor mqttPublish temperature:topic={"$base/$device/$name"}		attr mySensor mqttPublish temperature:topic={"$base/$device/$name"}
	In der Linux.Konsole, in der ''mosquitto_sub'' läuft, sollte jetzt bei jeder Aktualisierung des Sensor-Werts anzeigen, dass eine entsprechende Message an den MQTT-Server gesendet wurde. Dies geschieht [[Event\|Event-basiert]], so dass sich hier ggf. auch insbesondere Einstellungen im Attribut [[Event-on-change-reading\|event-on-change-reading]] auf die Häufigkeit der Aktualisierung auswirken.		In der Linux.Konsole, in der ''mosquitto_sub'' läuft, sollte jetzt bei jeder Aktualisierung des Sensor-Werts anzeigen, dass eine entsprechende Message an den MQTT-Server gesendet wurde. Dies geschieht [[Event\|Event-basiert]], so dass sich hier ggf. auch insbesondere Einstellungen im Attribut [[Event-on-change-reading\|event-on-change-reading]] auf die Häufigkeit der Aktualisierung auswirken.
Zeile 123:		Zeile 125:
	mosquitto_pub -h 127.0.0.1 -i fhem-test -t mqttGenericBridge/set/myRelay -m on		mosquitto_pub -h 127.0.0.1 -i fhem-test -t mqttGenericBridge/set/myRelay -m on

	Bei ''mosquitto_sub'' auf der Linux-Konsole sollte jetzt zunächst die Schaltanweisung (Topic mit ''set'-Element) wie auch die Readingänderung am Device vermeldet werden.		Bei ''mosquitto_sub'' auf der Linux-Konsole sollte jetzt zunächst die Schaltanweisung (Topic mit ''set'-Element) wie auch die Readingänderung am Device vermeldet werden.''

	====Geräte mit mehreren Settern====		====Geräte mit mehreren Settern====
Zeile 309:		Zeile 311:
	attr <actor-device-name> mqttPublish pct:topic=haus/wohnzimmer/rollo/all/position state:topic=haus/wohnzimmer/rollo/all/state		attr <actor-device-name> mqttPublish pct:topic=haus/wohnzimmer/rollo/all/position state:topic=haus/wohnzimmer/rollo/all/state
	attr <actor-device-name> mqttSubscribe pct:stopic=haus/wohnzimmer/rollo/all/set		attr <actor-device-name> mqttSubscribe pct:stopic=haus/wohnzimmer/rollo/all/set

Beta-User: mqttAlias berichtigt und andere Kleinigkeiten

2021-02-05T10:13:06Z

mqttAlias berichtigt und andere Kleinigkeiten

← Nächstältere Version		Version vom 5. Februar 2021, 12:13 Uhr
Zeile 11:		Zeile 11:
	==Einführung==		==Einführung==

	Das Modul ''MQTT_GENERIC_BRIDGE'' stellt eine zentrale Schnittstelle zum MQTT-Protokoll für beliebig viele andere FHEM-Geräte bereit. Es wird für eine FHEM-Installation jeweils nur ein erreichbarer MQTT-Server sowie eine Instanz der ''MQTT_GENERIC_BRIDGE'' benötigt.		Das Modul ''MQTT_GENERIC_BRIDGE'' stellt eine zentrale Schnittstelle zum MQTT-Protokoll für beliebig viele andere FHEM-Geräte bereit. Es wird für eine FHEM-Installation jeweils nur ein erreichbarer MQTT-Server sowie eine Instanz der ''MQTT_GENERIC_BRIDGE'' benötigt (es ist aber möglich, mehrere Parallen .

	Dieses Modul kann seit November 2018 mit allen drei IO-Modul-Varianten zusammen eingesetzt werden, also sowohl mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} bzw. [[MQTT2_CLIENT]] oder [[MQTT (Modul)\|MQTT]](00_MQTT.pm), und seit Rev. 23514 (Jan. 2021) wird für ''MQTT_GENERIC_BRIDGE'' iVm. den MQTT2-IO-Modulen keine zusätzliche Software mehr benötigt.		Dieses Modul kann seit November 2018 mit allen drei IO-Modul-Varianten zusammen eingesetzt werden, also sowohl mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} bzw. [[MQTT2_CLIENT]] oder [[MQTT (Modul)\|MQTT]](00_MQTT.pm), und seit Rev. 23514 (Jan. 2021) wird für ''MQTT_GENERIC_BRIDGE'' iVm. den MQTT2-IO-Modulen keine zusätzliche Software mehr benötigt.
Zeile 17:		Zeile 17:
	Dabei erfolgt an dem zentralen ''MQTT_GENERIC_BRIDGE''-Gerät selbst nur eine Basiskonfiguration, die Standardwerte für alle anzubindenden Geräte bereitstellt, alle übrigen Einstellungen erfolgen durch Attribute an dem jeweiligs anzubindenden Gerät selbst.		Dabei erfolgt an dem zentralen ''MQTT_GENERIC_BRIDGE''-Gerät selbst nur eine Basiskonfiguration, die Standardwerte für alle anzubindenden Geräte bereitstellt, alle übrigen Einstellungen erfolgen durch Attribute an dem jeweiligs anzubindenden Gerät selbst.

	Beispiel: ein Aktor des Typs CUL_HM kann über MQTT-Kommandos an den für ihn passenden Topic an- oder ausgeschaltet werden oder auch einfach nur seinen aktuellen Schaltzustand per MQTT-Protokoll publizieren.		Beispiel: ein Aktor des Typs [[HomeMatic\|CUL_HM]] kann über MQTT-Kommandos an den für ihn passenden Topic an- oder ausgeschaltet werden oder auch einfach nur seinen aktuellen Schaltzustand per MQTT-Protokoll publizieren.

	==Installation==		==Installation==
Zeile 61:		Zeile 61:

	Damit sind die wesentlichen Vorarbeiten abgeschlossen, und die ''MQTT_GENERIC_BRIDGE'' kann bereits dafür genutzt werden, beliebige Reading- oder Attribut-Änderungen von FHEM-Devices über MQTT zu publishen oder entsprechende Anweisungen umzusetzen. Es wird jedoch empfohlen, zunächst noch einige grundlegende Einstellungen vorzunehmen. Hierfür - sowie dann auch für die Konfiguration der weiteren Devices, die an MQTT angebunden werden sollen, steht als Hilfsmittel [[attrTemplate]] zur Verfügung.		Damit sind die wesentlichen Vorarbeiten abgeschlossen, und die ''MQTT_GENERIC_BRIDGE'' kann bereits dafür genutzt werden, beliebige Reading- oder Attribut-Änderungen von FHEM-Devices über MQTT zu publishen oder entsprechende Anweisungen umzusetzen. Es wird jedoch empfohlen, zunächst noch einige grundlegende Einstellungen vorzunehmen. Hierfür - sowie dann auch für die Konfiguration der weiteren Devices, die an MQTT angebunden werden sollen, steht als Hilfsmittel [[attrTemplate]] zur Verfügung.

	~~Hinweis: Eventuell muss erst noch (einmalig) der zugehörige attrTemplate-Satz gelesen werden. Dies erfolgt mittels~~
	~~{AttrTemplate_Initialize()}~~

	===Basisangaben in der MQTT_GENERIC_BRIDGE selbst===		===Basisangaben in der MQTT_GENERIC_BRIDGE selbst===
Zeile 113:		Zeile 110:
	Und zu guter letzt noch als farbiges (mit Reading ''rgb'') und dimmbares Licht:		Und zu guter letzt noch als farbiges (mit Reading ''rgb'') und dimmbares Licht:
	attr myRGBLight mqttPublish state:topic={"$base/$device"} pct\|rgb:topic={"$base/$device/$name"}		attr myRGBLight mqttPublish state:topic={"$base/$device"} pct\|rgb:topic={"$base/$device/$name"}


	===Geräte steuern===		===Geräte steuern===
Zeile 135:		Zeile 131:

	====mqttAlias====		====mqttAlias====
	~~Bei~~ den Supscriptions besteht ~~derzeit nicht~~ die Möglichkeit, ''mqttAlias'' zu verwenden und die Namen über diesen Weg zu verändern.		Auch bei den Supscriptions besteht die Möglichkeit, ''mqttAlias'' zu verwenden und die Namen über diesen Weg zu verändern. Dies kann insbesondere sinnvoll sein, um in externen Anwendungen dann (dort) dieselben Vorlagen nutzen zu können.

	====topic, stopic und atopic====		====topic, stopic und atopic====
	In obigem Beispiel haben wir in ''mqttSubscribe'' das Schlüsselwort ''stopic'' (die Kurzform von ''set-topic'') verwendet. Dieses bewirkt bei einer entsprechenden MQTT-Nachricht dasselbe wie der FHEM-Befehl <code>set <device> <reading> <value></code>, also <code>set myRGBLight pct 70</code>. Daneben gibt es die weiteren Schlüsselwörter ''topic'' und ''atopic''.		In obigem Beispiel haben wir in ''mqttSubscribe'' das Schlüsselwort ''stopic'' (die Kurzform von ''set-topic'') verwendet. Dieses bewirkt bei einer entsprechenden MQTT-Nachricht dasselbe wie der FHEM-Befehl <code>set <device> <reading> <value></code>, also <code>set myRGBLight pct 70</code>. Daneben gibt es die weiteren Schlüsselwörter ''topic'' und ''atopic''.
	* ''topic'' entspicht einer ''setreading''-Anweisung. Dabei wird dann lediglich der Readingwert aktualisiert, allerdings (falls Hardware gesteuert werden könnte) aber kein Schaltbefehl an die Hardware gesendet. In Installationen ohne MQTT2-Interface kann dies dazu genutzt werden, [[Dummy\|dummy]]-Geräte ähnlich flexibel zu verwenden wie [[MQTT2_DEVICE]].		* ''topic'' (Langform: readings-topic) entspicht einer ''setreading''-Anweisung. Dabei wird dann lediglich der Readingwert aktualisiert, allerdings (falls Hardware gesteuert werden könnte) aber kein Schaltbefehl an die Hardware gesendet. In Installationen ohne MQTT2-Interface kann dies dazu genutzt werden, [[Dummy\|dummy]]-Geräte ähnlich flexibel zu verwenden wie [[MQTT2_DEVICE]].
	* ''atopic'' (Langform: attr-topic) schließlich dient dazu, Attributwerte ändern ~~zu können~~. ''atopic'' kann auch in mqttPublish eingesetzt werden, um Änderungen der Attribut-Werte an den MQTT-Server zu übermitteln.		* ''atopic'' (Langform: attr-topic) schließlich dient dazu, Attributwerte zu ändern. ''atopic'' kann auch in ''mqttPublish'' eingesetzt werden, um Änderungen der Attribut-Werte an den MQTT-Server zu übermitteln.

	===Weitere Optionen===		===Weitere Optionen===
	MQTT_GENERIC_BRIDGE bietet weitere Attribute, die im Zusammenspiel teils sehr umfassende weitere Möglichkeiten ergeben, Geräte an MQTT anzubinden. Einige der Möglichkeiten, insbesondere, über ''expression'' beliebigen Perl-Code zur Auswertung bzw. Strukturierung der Daten zu verwenden, sind in den Grundzügen weiter unten dargestellt.		''MQTT_GENERIC_BRIDGE'' bietet weitere Attribute, die im Zusammenspiel teils sehr umfassende weitere Möglichkeiten ergeben, Geräte an MQTT anzubinden. Einige der Möglichkeiten, insbesondere, über ''expression'' beliebigen Perl-Code zur Auswertung bzw. Strukturierung der Daten zu verwenden, sind in den Grundzügen weiter unten dargestellt.

	==Standardisierung via attrTemplate==		==Standardisierung via attrTemplate==
	Insbesondere zur Anbindung externer Lösungen ist es jedoch häufig ausreichend, die Geräte-Daten in einer etwas strukturierten Weise aufzubereiten. Dies ist das Ziel der für MQTT_GENERIC_BRIDGE entwickelten ''attrTemplate''.		Insbesondere zur Anbindung externer Lösungen ist es jedoch häufig ausreichend, die Geräte-Daten in einer etwas strukturierten Weise aufzubereiten. Dies ist das Ziel der für ''MQTT_GENERIC_BRIDGE'' entwickelten ''attrTemplate''.

	(tbc)		(tbc)

Beta-User: stopic/atopic/topic ergänzt

2021-01-29T09:13:44Z

stopic/atopic/topic ergänzt

← Nächstältere Version		Version vom 29. Januar 2021, 11:13 Uhr
Zeile 115:		Zeile 115:


	===Geräte ~~ein- und ausschalten~~===		===Geräte steuern===
	{{Randnotiz\|RNTyp=y\|RNText=Kommt als MQTT-Server MQTT2_SERVER zum Einsatz, ist zwingend eine ''ClientID'' mit anzugeben, andernfalls werden die so generierten Messages eventuell nicht ausgewertet!}}Um Geräte über die MQTT-Schnittstelle bedienen zu können, wird zum einen eine Software benötigt, mit der man entsprechende publish-Anweisungen generieren kann. Dies kann z.B. das bereits genannte ''mosquitto_pub'' sein.		{{Randnotiz\|RNTyp=y\|RNText=Kommt als MQTT-Server MQTT2_SERVER zum Einsatz, ist zwingend eine ''ClientID'' mit anzugeben, andernfalls werden die so generierten Messages eventuell nicht ausgewertet!}}Um Geräte über die MQTT-Schnittstelle bedienen zu können, wird zum einen eine Software benötigt, mit der man entsprechende publish-Anweisungen generieren kann. Dies kann z.B. das bereits genannte ''mosquitto_pub'' sein.
	====mqttSubscribe====		====mqttSubscribe====
	Spiegelbildlich zum o.g. ''mqttPublish''-Attribut wird über das jeweilige ''mqttSubscribe''-Attribut festgelegt, welche Topics für das FHEM-Gerät ausgewertet werden sollen und welchen Readings diese zugeordnet sind.		Spiegelbildlich zum o.g. ''mqttPublish''-Attribut wird über das jeweilige ''mqttSubscribe''-Attribut festgelegt, welche Topics für das FHEM-Gerät ausgewertet werden sollen und welchen Readings diese zugeordnet sind.
	Für ein einfaches "ein-aus"-Gerät verwendet man daher denselben Attributwert wie für das ''mqttPublish'':		Für ein einfaches "ein-aus"-Gerät verwendet man daher denselben Attributwert wie für das ''mqttPublish'':
	attr myRelay mqttSubscribe state:~~topic~~={"$base/$device"}		attr myRelay mqttSubscribe state:stopic={"$base/$device"}

	Da wir oben in ''globalDefaults'' für ''sub:$base=mqttGenericBridge/set'' festgelegt haben, muss die Schaltanweisung allerdings an einen anderen Topic erfolgen als die Statusmeldung, die wir wegen des ''mqttPublish''-Attributs erhalten - auf diese Weise können unbeabsichtigte Schleifen unterbunden werden.		Da wir oben in ''globalDefaults'' für ''sub:$base=mqttGenericBridge/set'' festgelegt haben, muss die Schaltanweisung allerdings an einen anderen Topic erfolgen als die Statusmeldung, die wir wegen des ''mqttPublish''-Attributs erhalten - auf diese Weise können unbeabsichtigte Schleifen unterbunden werden.
Zeile 131:		Zeile 131:
	====Geräte mit mehreren Settern====		====Geräte mit mehreren Settern====
	Das Prinzip dürfte jetzt klarer sein, also versuchen wir es direkt mit unserer farbigen Leuchte:		Das Prinzip dürfte jetzt klarer sein, also versuchen wir es direkt mit unserer farbigen Leuchte:
	attr myRGBLight mqttSubscribe state:~~topic~~={"$base/$device"} pct\|rgb:~~topic~~={"$base/$device/$name"}		attr myRGBLight mqttSubscribe state:stopic={"$base/$device"} pct\|rgb:stopic={"$base/$device/$name"}
	Und schon sollte diese über ''msoquitto_pub'' bzw. MQTT schalt- und dimmbar sein und Farbänderungen entegennehmen - und natürlich den zugehörigen Status zurückmelden.		Und schon sollte diese über ''msoquitto_pub'' bzw. MQTT schalt- und dimmbar sein und Farbänderungen entegennehmen - und natürlich den zugehörigen Status zurückmelden.

	====mqttAlias====		====mqttAlias====
	Bei den Supscriptions besteht derzeit nicht die Möglichkeit, ''mqttAlias'' zu verwenden und die Namen über diesen Weg zu verändern.		Bei den Supscriptions besteht derzeit nicht die Möglichkeit, ''mqttAlias'' zu verwenden und die Namen über diesen Weg zu verändern.

			====topic, stopic und atopic====
			In obigem Beispiel haben wir in ''mqttSubscribe'' das Schlüsselwort ''stopic'' (die Kurzform von ''set-topic'') verwendet. Dieses bewirkt bei einer entsprechenden MQTT-Nachricht dasselbe wie der FHEM-Befehl <code>set <device> <reading> <value></code>, also <code>set myRGBLight pct 70</code>. Daneben gibt es die weiteren Schlüsselwörter ''topic'' und ''atopic''.
			* ''topic'' entspicht einer ''setreading''-Anweisung. Dabei wird dann lediglich der Readingwert aktualisiert, allerdings (falls Hardware gesteuert werden könnte) aber kein Schaltbefehl an die Hardware gesendet. In Installationen ohne MQTT2-Interface kann dies dazu genutzt werden, [[Dummy\|dummy]]-Geräte ähnlich flexibel zu verwenden wie [[MQTT2_DEVICE]].
			* ''atopic'' (Langform: attr-topic) schließlich dient dazu, Attributwerte ändern zu können. ''atopic'' kann auch in mqttPublish eingesetzt werden, um Änderungen der Attribut-Werte an den MQTT-Server zu übermitteln.

	===Weitere Optionen===		===Weitere Optionen===

Beta-User: insbes. mqttAlias in Subscription korrigiert

2021-01-28T18:31:29Z

insbes. mqttAlias in Subscription korrigiert

← Nächstältere Version		Version vom 28. Januar 2021, 20:31 Uhr
Zeile 80:		Zeile 80:
	Den Verkehr auf der Linux-Konsole kann man mit		Den Verkehr auf der Linux-Konsole kann man mit
	mosquitto_sub -h 127.0.0.1 -i fhem-test -v -t mqttGenericBridge/# -t system/#		mosquitto_sub -h 127.0.0.1 -i fhem-test -v -t mqttGenericBridge/# -t system/#
	verfolgen, gegebenenfalls sind Username und Passwort zu ergänzen, falls die Einstellungen am Server dies erfordern (siehe manpage zu mosquitto_sub).		verfolgen, gegebenenfalls sind Username und Passwort zu ergänzen, falls die Einstellungen am Server dies erfordern (siehe ''manpage'' zu ''mosquitto_sub'').


Zeile 135:		Zeile 135:

	====mqttAlias====		====mqttAlias====
	~~Auch bei~~ den Supscriptions besteht die Möglichkeit, ''mqttAlias'' zu verwenden und die Namen über diesen Weg zu verändern~~, über die bereits aus ''globalDefaults'' bekannten ''modifier'' ''sub:'' und ''pub:'' erforderlichenfalls sogar für beide Wege unterschiedlich~~.		Bei den Supscriptions besteht derzeit nicht die Möglichkeit, ''mqttAlias'' zu verwenden und die Namen über diesen Weg zu verändern.

	===Weitere Optionen===		===Weitere Optionen===
	====expression====		MQTT_GENERIC_BRIDGE bietet weitere Attribute, die im Zusammenspiel teils sehr umfassende weitere Möglichkeiten ergeben, Geräte an MQTT anzubinden. Einige der Möglichkeiten, insbesondere, über ''expression'' beliebigen Perl-Code zur Auswertung bzw. Strukturierung der Daten zu verwenden, sind in den Grundzügen weiter unten dargestellt.

			==Standardisierung via attrTemplate==
			Insbesondere zur Anbindung externer Lösungen ist es jedoch häufig ausreichend, die Geräte-Daten in einer etwas strukturierten Weise aufzubereiten. Dies ist das Ziel der für MQTT_GENERIC_BRIDGE entwickelten ''attrTemplate''.

			(tbc)

			==Konfigurationsmöglichkeiten für Fortgeschrittene==

			===expression===

	attr ZWave_THERMOSTAT_20 mqttGB1Alias reportedState=actuator		attr ZWave_THERMOSTAT_20 mqttGB1Alias reportedState=actuator
Zeile 144:		Zeile 153:
	attr ZWave_THERMOSTAT_20 mqttGB1Subscribe desired-temp:stopic={"$base/$device/$name"}		attr ZWave_THERMOSTAT_20 mqttGB1Subscribe desired-temp:stopic={"$base/$device/$name"}

	json2nameValue()		===JSON===
			json2nameValue() und toJSON() via expression

	====publishes an mehrere Topics====		===publishes an mehrere Topics===
	"das Ausrufezeichen"		"das Ausrufezeichen"

	~~==Standardisierung via attrTemplate==~~

	~~==Konfigurationsmöglichkeiten für Fortgeschrittene==~~

	(Noch nachzubearbeiten, aus dem Thread Anwendungsfälle und Beispiele für MQTT_GENERIC_BRIDGE - https://forum.fhem.de/index.php/topic,91642.msg841367.html#msg841367)		(Noch nachzubearbeiten, aus dem Thread Anwendungsfälle und Beispiele für MQTT_GENERIC_BRIDGE - https://forum.fhem.de/index.php/topic,91642.msg841367.html#msg841367)
Zeile 185:		Zeile 193:

	eine Änderung eines Attributes per MQTT senen		eine Änderung eines Attributes per MQTT senen
	~~Code: [Auswählen]~~		attr <device-name> mqttPublish <attribut-name>:atopic=<topic>

	attr <device-name> mqttPublish <attribut-name>:atopic=<topic>