Das Plugin MQTT-Manager ermöglicht es Ihnen, Jeedom mit einem bestehenden MQTT-Broker zu verbinden oder einen lokal oder unter Docker mithilfe des Plugins zu installieren Docker-Verwaltung.
Dieses Plugin ist in der Lage, mehrere Funktionen zu kombinieren :
Als Basis für andere Plugins für alles rund um MQTT dienen.
Dienen Sie im “eigenständigen” Modus, indem Sie Aktions-/Infobefehle zum Senden/Empfangen von Nachrichten auf MQTT erstellen.
Steuern Sie Jeedom von einem anderen MQTT-Gerät aus (Geknotet zum Beispiel). Das Plugin kann sowohl Befehle steuern als auch alle Jeedom-Ereignisse auf MQTT erneut übertragen.
Nach der Installation und Aktivierung des Plugins sollte die Installation von Abhängigkeiten beginnen, es sei denn, die automatische Verwaltung wurde zuvor deaktiviert. In diesem Fall müssen Sie auf die Schaltfläche klicken Beleben um diese Installationsphase einzuleiten.
Um mit der Konfiguration des Plugins zu beginnen, muss aus den drei möglichen Optionen der Verbindungsmodus zum Broker ausgewählt werden :
Lokaler Makler : Der Mosquitto-Broker wird direkt auf dem Rechner installiert, der Jeedom hostet (Standardmodus).
Lokaler Docker-Broker : Der Mosquitto-Broker wird mithilfe des offiziellen Plugins automatisch in einem Docker-Container installiert und konfiguriert Docker-Verwaltung.
INFORMATION
In diesem Modus kann die Installation mehrere Minuten dauern.
Remote-Broker : Im Falle der Nutzung eines bereits bestehenden Brokers reicht es aus, dessen Adresse einzutragen (Beispiel : ``mqtt://192.168.1.10:1883‘).
Sobald der Mosquitto-Broker installiert ist (im Bedarfsfall), Sie können mit der Konfiguration fortfahren :
Authentifizierung: Sie können Benutzer / Passwort für die Verbindung angeben :
Im lokalen Modus können Sie einen `Benutzernamen eingeben:password’ pro Zeile, jedes Paar von Identifikatoren hat gültigen Zugriff auf den Broker. Wenn es keine Kennung gibt, erstellt Jeedom automatisch eine.
Im Standalone-Modus reicht es aus, in der ersten Zeile die Kennung des Paares ` anzugeben:Passwort für Jeedom (Beispiel : Wenn der Benutzername „jeedom“ und das Passwort „mqtt“ lautet, müssen Sie „jeedom“ eingeben:mqtt`).
WICHTIG
Im lokalen Modus ist die Authentifizierung obligatorisch. Nach dem Hinzufügen muss Jeedom neu gestartet werden, damit dies wirksam wird.
Jeedom-Wurzelthema : Stammsubjekt, um einen Befehl an Jeedom zu senden oder an den es Ereignisse zurückgibt. Achtung, es ist nur möglich, maximal 1 oder 2 Ebenen zu setzen.
Übertragen Sie alle Ereignisse : Aktivieren Sie das Kontrollkästchen, um alle Jeedom-Befehlsereignisse auf MQTT zu senden.
Beitragsvorlage : Formatierung der Veröffentlichung von Jeedom-Events * (mögliche Tags : #value#`, `#humanName#`, `#unit#`, `#name#`, `#type#`, `#subtype#)*.
Abonnenten-Plugins : Liste der Plug-ins, die das MQTT-Manager-Plug-in abonniert haben, in der Form „plugin(topic)“.
Es ist möglich, MQTT-Equipment direkt im Plugin zu erstellen.
Sie müssen das Wurzelthema des Geräts angeben („Testen“ zum Beispiel), Achten Sie darauf, dass das Stammthema je nach Befehlstyp nicht mehr als zwei Ebenen haben kann (exe „Ebene1/Ebene2“) :
Wenn Sie beispielsweise „toto/1“ eingeben, werden alle Nachrichten zum Thema „test/toto/1“ automatisch auf den betreffenden Befehl geschrieben. Das System kann Felder vom Typ json verwalten, in diesem Fall müssen Sie
toto/1/key1odertoto/1/key1/key2eingeben, um eine Ebene nach unten zu gehen.
Wenn Sie beispielsweise „toto/2“ mit der Nachricht „plop“ eingeben, wird bei jedem Klick auf den Befehl die Nachricht „plop“ an das Thema „test/toto/2“ gesendet.
INFORMATION
In Befehlen vom Aktionstyp können Sie die Tags ` verwenden#slider#
,#color#,#message#oder#select#, die beim Ausführen des Befehls automatisch durch ihren Wert ersetzt werden *(nach seiner Unterart)*. Wenn die Nachricht andererseits vom Typ „json“ ist, müssen Sie ihr das Präfix „json“ hinzufügen::`.
WICHTIG
Das
jeedom-Topic ist reserviert (dies kann in der Konfiguration geändert werden), daher sollte nichts anderes als Befehle zum Ansteuern von jeedom darauf gesendet werden
Es ist möglich, Jeedom über MQTT zu steuern. Hier sind die verschiedenen möglichen Themen unter der Annahme, dass das Hauptthema „jeedom“ ist (anzupassen, wenn Sie die Standardkonfiguration geändert haben) :
jeedom / cmd / set /#cmd_id# : ermöglicht es Ihnen, den Befehl mit der ID auszuführen#cmd_id#. Sie können die Parameter in der Nachricht beispielsweise je nach Untertyp des Befehls als json`-Felder übergeben:
{Schieberegler : 50}.{Titel : "Hallo "Nachricht : "Hallo, wie geht es dir ?"}`.{Farbe : "#96c927"}`.{wählen : 1}.{Wert : "Kuckuck", Datum/Uhrzeit : "2021-12-12 10:30:00" }.jeedom / cmd / get /#cmd_id# : Fordern Sie den Wert des Befehls mit der ID an#cmd_id#. Jeedom gibt jeedom/cmd/value/ zurück#cmd_id#`mit dem Befehlswert in der Nachricht.
jeedom / cmd / event /#cmd_id# : Ereignis auf Befehl mit der ID #cmd_id# mit einer json`-Nachricht, die verschiedene Informationen enthält, einschließlich des Werts des Befehls.2 mögliche Optionen zum Deinstallieren des Mosquitto-Brokers, der lokal auf dem Computer vorhanden ist :
Broker unter Docker : Verwenden Sie zuerst den Befehl Löschen mqtt2_mosquitto Ausrüstung aus dem Plugin Docker-Verwaltung (Plugins > Programmierung > Docker-Verwaltung). Anschließend können Sie diese gesamte Ausstattung löschen.
Lokaler Makler : Sie müssen dann die rote Taste verwenden Moskito deinstallieren von der allgemeinen Konfigurationsseite des Plugins.
Das Plugin kann verschiedene Modultypen automatisch erkennen. Dazu müssen Sie nur die automatische Erkennung auf der Hauptseite des Plugins autorisieren und den Dämon neu starten.
WICHTIG
Für Module vom Typ Tasmota ist es absolut notwendig, dass die vollständige Topic-Konfiguration
%topic%/%prefix%/ist
Auf dem Quell-Jeedom (demjenigen, der die Informationen sendet) müssen Sie zur Plugin-Konfiguration gehen und auf der Ebene von „Mqtt local tranmission“ auf „MQTT-Informationen“ klicken und dann kopieren, was im angezeigten Fenster angezeigt wird. Auf dem Ziel-Jeedom (dem Empfänger) müssen Sie auf der Ebene „Mqtt-Lokalübertragung“ auf „Empfangen“ klicken und die zuvor kopierten Informationen einfügen.
Dank des Plugins ist es möglich, Befehle zwischen zwei Jeedom zu übertragen (dieses System soll Jeelink ersetzen). Hier erfahren Sie, wie Sie es konfigurieren :
Dann müssen Sie nur noch in der Plugin-Konfiguration zum Jeedom zurückkehren und „Erkennung senden“ ausführen”
WICHTIG
Bei dieser Konfiguration wird davon ausgegangen, dass die Jeedoms mit derselben Brocker-Mücke verbunden sind. Wenn Sie dies nicht können, müssen Sie eine der beiden Mücken so konfigurieren, dass sie die Werte der gewünschten Themen an eine andere Mücke sendet (siehe nächstes Kapitel) oder den Assist-Modus verwenden, der alles für Sie erledigt
WICHTIG
Wenn Sie den Wert des Felds „Veröffentlichungsvorlage“ (standardmäßig leer) ändern, erstellt die automatische Erkennung nicht die richtigen Bestellungen. In diesem Fall müssen Sie die Konfiguration anpassen
WICHTIG
Wenn Sie den lokalen Übertragungsassistenten verwendet haben, müssen Sie diesen Teil nicht befolgen, Jeedom hat bereits alles für Sie erledigt
Es ist möglich, Themen zwischen mehreren Moskitos zu verknüpfen. Hier ist die Konfiguration zum Hinzufügen in Moskitos. Die Konfiguration muss nur an einem der Brocker-Mücken vorgenommen werden :
connection #NOM_CONNEXION#
address #REMOTE_ADDRESS#:#REMOTE_PORT#
topic # both 0 #LOCAL_TOPIC#/ #REMOTE_TOPIC#/
cleansession true
notifications false
remote_clientid #REMOTE_CLIENT_ID#
remote_username #REMOTE_USERNAME#
remote_password #REMOTE_PASSWORD#
local_username #LOCAL_USERNAME#
local_password #LOCAL_PASSWORD#
start_type automatic
Beispiel: Sie möchten Geräte von jeedom_2 an jeedom_1 senden, indem Sie haben :
Hier ist die Konfiguration, die in jeedom_2 (Mosquito-Parameter) hinzugefügt werden muss) :
connection jeedom_1
address 192.168.1.45:1883
topic # both 0 jeedom_2/ jeedom_2/
cleansession true
notifications false
remote_clientid jeedom_2
remote_username jeedom
remote_password password_1
local_username jeedom
local_password password_2
start_type automatic
NOTIZ
#NOM_CONNEXION#: kann alles sein, was du willst, und es spielt keine Rolle. Sie können zum Beispiel „name_jeedom_source-name_jeedom_target“ ausführen#REMOTE_CLIENT_ID#: spielt auch keine Rolle, Sie müssen nur eine eindeutige Zeichenfolge einfügen#LOCAL_TOPIC#: Der Name des lokalen Themas lautet häufig „Jeedom-Stammthema“ des lokalen Jeedoms#REMOTE_TOPIC#: Der Name des lokalen Themas ist häufig das „Jeedom-Stammthema“ des entfernten Jeedoms
WICHTIG
In jeedom sind die Identifikatoren („Benutzername“ und „Passwort“) auf der Plugin-Konfigurationsseite unter „Authentifizierung“ in der Form „Benutzername“ verfügbar:
password
WICHTIG
Sie sollten dies nur tun, wenn sich Ihre Jeedoms nicht in denselben lokalen Netzwerken befinden. Wenn Sie dies mit zwei Jeedom in denselben lokalen Netzwerken tun, werden Sie Probleme mit der Leistung, Zuverlässigkeit und Verlusten im Falle eines Internetausfalls (oder einer Wartung der Jeedom-Cloud) haben). Zusammenfassend lässt sich sagen, dass diese Konfiguration als letztes Mittel verwendet werden sollte
Um Jeedom über das Internet zu verknüpfen, gibt es mehrere Möglichkeiten: Sie können eine Mücke mit einem Cloud-Host bereitstellen oder eine Ihrer Mücken im Internet öffnen (achten Sie auf die Sicherheit, im Falle eines Problems kann Jeedom nicht haftbar gemacht werden)). Oder nutzen Sie den Cloud-Dienst Jeedom (der einzige Fall, der in dieser Dokumentation behandelt wird)).
WICHTIG
Der Jeedom-Cloud-Dienst steht Benutzern nicht zur Verfügung. Wir müssen jedoch zunächst sicherstellen, dass alle Last- und Zuverlässigkeitstests in Ordnung sind
Um den Jeedom-Cloud-Dienst zu nutzen, ist es ganz einfach: Gehen Sie auf dem Quell-Jeedom (demjenigen, der die Informationen sendet) einfach zur Plugin-Konfiguration und klicken Sie auf der Ebene „Jeedom-Cloud“ auf „Senden“. Dann müssen Sie dies tun Hinweis „Jeedom-Cloud-ID”. Gehen Sie dann zum Ziel-Jeedom (demjenigen, der die Informationen empfängt) und klicken Sie in der Plugin-Konfiguration auf „Empfangen“ und geben Sie die „Cloud-ID“ der Quelle an (im vorherigen Schritt wiederhergestellt)).
Das ist alles, Sie müssen lediglich die zu übertragenden Geräte auf dem Quell-Jeedom überprüfen und dann in der Quell-Jeedom-Plugin-Konfiguration auf „Erkennung senden“ klicken.
WICHTIG
Der Jeedom-Cloud-Service funktioniert nur mit Jeedom, die mit demselben Marktkonto verknüpft sind. Es ist nicht möglich, Informationen zwischen Jeedom auf verschiedenen Marktkonten zu übertragen
Nach einem Update der Systempakete (apt) oder einem unbeaufsichtigten Upgrade funktioniert nichts mehr
Durch das Aktualisieren des Mosquito-Pakets wird die Servicedatei auf die Standardeinstellungen zurückgesetzt, sodass Mosquito nicht mehr auf die richtige Konfigurationsdatei verweist. Um dies zu beheben, ist es sehr einfach, die Installation von Mosquito auf der Plugin-Konfigurationsseite neu zu starten.