MQTT DEVICE - Versionsgeschichte

Beta-User: Internen Link korrigiert, MQTT2_CLIENT ergänzt

2018-11-18T21:13:04Z

Internen Link korrigiert, MQTT2_CLIENT ergänzt

← Nächstältere Version		Version vom 18. November 2018, 23:13 Uhr
Zeile 9:		Zeile 9:

	== Voraussetzungen ==		== Voraussetzungen ==
	Um ''MQTT_DEVICE'' nutzen zu können, muss ein [[MQTT]]-Gerät als [[Interface\|Gateway]] zu einem funktionsfähigen Broker definiert sein.		Um ''MQTT_DEVICE'' nutzen zu können, muss ein [[MQTT (Modul)\|MQTT]]-Gerät als [[Interface\|Gateway]] zu einem funktionsfähigen Broker definiert sein.

	{{Hinweis\|Das hier beschriebene Modul ist nicht identisch zum Modul {{Link2CmdRef\|Anker=MQTT2_DEVICE\|Lang=en\|Label=MQTT2_DEVICE}}, das zur Verwendung mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} konzipiert wurde. Mit letzterem benötigt man keinen externen Broker, sondern FHEM selbst wird dabei zum MQTT-Server.}}		{{Hinweis\|Das hier beschriebene Modul ist nicht identisch zum Modul {{Link2CmdRef\|Anker=MQTT2_DEVICE\|Lang=en\|Label=MQTT2_DEVICE}}, das zur Verwendung mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} oder {{Link2CmdRef\|Anker=MQTT2_CLIENT\|Lang=en\|Label=MQTT2_CLIENT}} konzipiert wurde. Mit letzterem benötigt man keinen externen Broker, sondern FHEM selbst wird dabei zum MQTT-Server.}}

	== Anwendung ==		== Anwendung ==

Beta-User: Kategorie ergänzt

2018-11-17T12:07:41Z

Kategorie ergänzt

← Nächstältere Version		Version vom 17. November 2018, 14:07 Uhr
Zeile 43:		Zeile 43:
	* {{Link2Forum\|Topic=27532\|LinkText=Ankündigung}} der MQTT Module		* {{Link2Forum\|Topic=27532\|LinkText=Ankündigung}} der MQTT Module
	* [[MQTT Einführung]]		* [[MQTT Einführung]]
			[[Kategorie:MQTT]]

Beta-User: Hinweis auf MQTT2 eingebaut

2018-10-05T13:12:10Z

Hinweis auf MQTT2 eingebaut

← Nächstältere Version		Version vom 5. Oktober 2018, 15:12 Uhr
Zeile 10:		Zeile 10:
	== Voraussetzungen ==		== Voraussetzungen ==
	Um ''MQTT_DEVICE'' nutzen zu können, muss ein [[MQTT]]-Gerät als [[Interface\|Gateway]] zu einem funktionsfähigen Broker definiert sein.		Um ''MQTT_DEVICE'' nutzen zu können, muss ein [[MQTT]]-Gerät als [[Interface\|Gateway]] zu einem funktionsfähigen Broker definiert sein.

			{{Hinweis\|Das hier beschriebene Modul ist nicht identisch zum Modul {{Link2CmdRef\|Anker=MQTT2_DEVICE\|Lang=en\|Label=MQTT2_DEVICE}}, das zur Verwendung mit {{Link2CmdRef\|Anker=MQTT2_SERVER\|Lang=en\|Label=MQTT2_SERVER}} konzipiert wurde. Mit letzterem benötigt man keinen externen Broker, sondern FHEM selbst wird dabei zum MQTT-Server.}}

	== Anwendung ==		== Anwendung ==
Zeile 37:		Zeile 39:
	*[[Sonoff#FHEM Anbindung]]		*[[Sonoff#FHEM Anbindung]]
	* [[Sonoff#Sonoff Th10/16]]		* [[Sonoff#Sonoff Th10/16]]
	* {{Link2Forum\|Topic=~~74754~~\|LinkText=Einbindung von Milight-Leuchtmitteln}} über eine Eigenbau-Bridge		* {{Link2Forum\|Topic=86932\|LinkText=Einbindung von Milight-Leuchtmitteln}} über eine Eigenbau-Bridge
	== Links ==		== Links ==
	* {{Link2Forum\|Topic=27532\|LinkText=Ankündigung}} der MQTT Module		* {{Link2Forum\|Topic=27532\|LinkText=Ankündigung}} der MQTT Module
	* [[MQTT Einführung]]		* [[MQTT Einführung]]

Hexenmeister am 24. September 2018 um 20:20 Uhr

2018-09-24T20:20:46Z

← Nächstältere Version		Version vom 24. September 2018, 22:20 Uhr
Zeile 27:		Zeile 27:
	Legt man ein neues Device an, dessen Topics man noch nicht genau kennt, kann man das Attribut MQTT_DEVICE 'autoSubscribeReadings' setzen. Z.B. ein		Legt man ein neues Device an, dessen Topics man noch nicht genau kennt, kann man das Attribut MQTT_DEVICE 'autoSubscribeReadings' setzen. Z.B. ein

	<code>attr <name> autoSubscribeReadings wohnzimmer/+'</code> sorgt dafür, dass für alle empfangenen Messages automatisch das jeweils passende 'subscribeReading_xxx'-Attribut erstellt und das zugehörige Reading auch gleich geupdated wird.		<code>attr <name> autoSubscribeReadings wohnzimmer/+</code> sorgt dafür, dass für alle empfangenen Messages automatisch das jeweils passende 'subscribeReading_xxx'-Attribut erstellt und das zugehörige Reading auch gleich geupdated wird.
	Sind nach einer gewissen Zeit alle Readings angelegt, kann das Attribut wieder gelöscht werden.		Sind nach einer gewissen Zeit alle Readings angelegt, kann das Attribut wieder gelöscht werden.

Hexenmeister: Maintainerwechsel

2018-08-25T18:36:42Z

Maintainerwechsel

← Nächstältere Version		Version vom 25. August 2018, 20:36 Uhr
Zeile 5:		Zeile 5:
	\|ModForumArea=MQTT		\|ModForumArea=MQTT
	\|ModTechName=10_MQTT_DEVICE.pm		\|ModTechName=10_MQTT_DEVICE.pm
	\|ModOwner=~~eisler~~ ({{Link2FU\|~~2214~~\|Forum}}) }}		\|ModOwner=hexenmeister ({{Link2FU\|4065\|Forum}}) }}
	Das Modul {{Link2CmdRef\|Anker=MQTT_DEVICE\|Lang=en\|Label=MQTT_DEVICE}} ermöglicht es, Geräte einzubinden, die über eine MQTT-Schnittstelle verfügen.		Das Modul {{Link2CmdRef\|Anker=MQTT_DEVICE\|Lang=en\|Label=MQTT_DEVICE}} ermöglicht es, Geräte einzubinden, die über eine MQTT-Schnittstelle verfügen.

Drhirn: /* Define */

2018-04-25T13:26:48Z

Define

← Nächstältere Version		Version vom 25. April 2018, 15:26 Uhr
Zeile 14:		Zeile 14:
	=== Define ===		=== Define ===

	Die Syntax für das Anlegen eines MQTT-Devices ist der {{Link2CmdRef\|Anker=MQTT_DEVICEdefine}} zu entnehmen.		Die Syntax für das Anlegen eines MQTT-Devices ist der {{Link2CmdRef\|Anker=MQTT_DEVICEdefine\|Label=CommandRef}} zu entnehmen.

	=== Attribute ===		=== Attribute ===

Beta-User: Baustelle abgenaut

2018-03-31T06:32:58Z

Baustelle abgenaut

← Nächstältere Version		Version vom 31. März 2018, 08:32 Uhr
Zeile 1:		Zeile 1:
	~~{{Baustelle}}~~
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Einbinden von Geräten, die über MQTT Daten senden und empfangen		\|ModPurpose=Einbinden von Geräten, die über MQTT Daten senden und empfangen

Beta-User: Erste Fassung

2018-03-28T14:42:11Z

Erste Fassung

Neue Seite

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Einbinden von Geräten, die über MQTT Daten senden und empfangen
|ModType=d
|ModCmdRef=MQTT_DEVICE
|ModForumArea=MQTT
|ModTechName=10_MQTT_DEVICE.pm
|ModOwner=eisler ({{Link2FU|2214|Forum}}) }}
Das Modul {{Link2CmdRef|Anker=MQTT_DEVICE|Lang=en|Label=MQTT_DEVICE}} ermöglicht es, Geräte einzubinden, die über eine MQTT-Schnittstelle verfügen.

== Voraussetzungen ==
Um ''MQTT_DEVICE'' nutzen zu können, muss ein [[MQTT]]-Gerät als [[Interface|Gateway]] zu einem funktionsfähigen Broker definiert sein.

== Anwendung ==
=== Define ===

Die Syntax für das Anlegen eines MQTT-Devices ist der {{Link2CmdRef|Anker=MQTT_DEVICEdefine}} zu entnehmen.

=== Attribute ===

Die eigentlichen Details zur Kommunikation sind - entsprechend der sehr flexiblen Gestaltung des MQTT-Protokolls an sich - nicht direkt im Define festgelegt, sondern werden anschließend über Attribute festgelegt.

Die Verbindung funktioniert bidirektional:

* Mit den Attributen 'publishState' und 'publishReading_<readingname> man kann Änderungen am State bzw. Readings an den Broker übermitteln, der diese dann an die eigentlichen Geräte weitergibt oder dort vorhält. Der Attribut-Wert ist immer das Topic an das die Message geschickt werden soll. Message-Inhalt ist jeweils der neue Wert des Readings bzw. states.
* Mit den Attributen 'subscribeSet' bzw. 'subscribeSet_<setcommand>' kann man MQTT-topics abonnieren, also automatische Benachrichtigungen empfangen, sobald ein Gerät dort Änderungen einträgt. Immer wenn eine Nachricht auf dem abonnierten Topic eintrifft für das betreffende Device 'set <devicename> <setcommand> <messageinhalt> ausgeführt.

Legt man ein neues Device an, dessen Topics man noch nicht genau kennt, kann man das Attribut MQTT_DEVICE 'autoSubscribeReadings' setzen. Z.B. ein

<code>attr <name> autoSubscribeReadings wohnzimmer/+'</code> sorgt dafür, dass für alle empfangenen Messages automatisch das jeweils passende 'subscribeReading_xxx'-Attribut erstellt und das zugehörige Reading auch gleich geupdated wird.
Sind nach einer gewissen Zeit alle Readings angelegt, kann das Attribut wieder gelöscht werden.

== Ergänzende Hinweise ==
Manche MQTT-Geräte senden JSON-Messages, die einzelne oder mehrere Informationen enthalten können, die in FHEM anschließend als einzelne Readings ausgewertet werden sollen. Hierfür wird das Modul {{Link2CmdRef|Anker=expandJSON|Lang=en|Label=expandJSON}} benötigt.

== Anwendungsbeispiele ==
* [[Sonoff#Anbindung FHEM]]
*[[Sonoff#FHEM Anbindung]]
* [[Sonoff#Sonoff Th10/16]]
* {{Link2Forum|Topic=74754|LinkText=Einbindung von Milight-Leuchtmitteln}} über eine Eigenbau-Bridge
== Links ==
* {{Link2Forum|Topic=27532|LinkText=Ankündigung}} der MQTT Module
* [[MQTT Einführung]]