Mit dieser Instanz werden die Geräte von Zigbee2MQTT in IP-Symcon abgebildet.
| Nummer | Feld | Beschreibung |
|---|---|---|
| 1 | Gateway konfigurieren | Hier kann das zur Instanz zugehörige Gateway direkt aufgerufen und bearbeitet werden. |
| 2 | Gateway ändern | Dient zur Auswahl des zur Instanz zugehörigen Gateways. In der Regel wird dies bei Anlegen der Instanz über den Konfigurator direkt gesetzt. |
| 3 | InstanzID kopieren | Kopiert die Instanz ID in die Zwischenablage. |
| 4 | Instanzobjekt bearbeiten | Hier können Objekt-Name und Baum-Position vorgegeben werden. Unter Visuelle Einstellungen finden sich die Icon-Vergabe, Ob das Objekt angezeigt oder versteckt werden soll und ob das Objekt aktiviert sein soll. Unter weitere Einstellungen kann dem Onjekt eine Beschreibung zugefügt werden. |
| 5 | Ereignisse | Zeigt eine Übersicht, welche Ereignisse mit der Instanz verbunden sind. Über den Button Neu lassen sich neue Ereignisse zu der Instanz einrichten (Ausgelöst, zyklisch oder per Wochenplan). Die zugehörigen Eregnisse können direkt bearbeitet werden.  |
| 6 | Statusvariablen | Hier lassen sich alle der Instanz zugehörigen Variablen bearbeiten  |
| 7 | Debug | Mit die wichtigste Funktion. Hier werden alle Debug-Informationen der Instanz protokolliert. Wichtig, weil hier auch zu sehen ist, ob Werte des MQTT-Expose nicht zugeordnet werden können, oder noch Profile zu den angelegten Variablen fehlen. Zusätzlich werden hier euch weitere Fehler der Kommunikation zwischen Gateway und Instanz ersichtlich. Sollte es Probleme mit einer Instanz geben, können diese nur adäquat bearbeitet werden, wenn der Meldung (unter Issues oder im Forum) ein Debug beigelegt wird. Dazu bitte im Debug-Fenster auf "Download" gehen und die heruntergeladene Datei als *.zip Datei der Meldung beifügen. |
| 8 | MQTT Base Topic | Dieses wird vom Konfigurator bei Anlage der Instanz automatisch auf "zigbee2mqtt gesetzt und sollte auch so belassen werden. Ausnahme: Ihr habt zwei Zigbee Netzwerke bei Euch. Dann dürfen beide nicht das gleiche Topic haben. Bsp.: Netzwerk 1 hat das standard-Topic zigbee2mqtt. Wenn das zweite Netzwerk ebenfalls auf zigbee2mqtt posted, kommt es zu Fehlermeldungen im 1. Netzwerk über Z2M, da dort die betroffenen Instanzen nicht bekannt sind meldet der Z2M-Dienst "Name unknown Device". Wenn also Beide Netzwerke das gleiche Topic nutzen, werden Aktionen von Symcon aus an beide Z2M-Netzwerke gesendet. Abhilfe schafft hier die Trennung der Netze auch auf MQTT-Ebene (z.B. Z2M-OG für das Netzwerk im Obergeschoss und Z2M-EG für das Netzwerk im Erdgeschoss). Dann weiß Symcon, an welches MQTT-Netzwerk die Aktionen gehen sollen. Wichtig: Der Konfigurator erkennt das genutzte Topic nicht selbstständig. Er setzt es IMMER auf zigbee2mqtt. Dann muss es im Nachgang geändert werden. |
| 9 | MQTT Topic | Das Topic, welches die Instanz in Z2M nutzt. Beim Anlernen von Geräten an Z2m erhält jedes Gerät einen "friendly_name". Standard ist hier die IEEE-Adresse. Dies kann im Nachgang aber geändert werden. Dann erkennt der Konfigurator dies und setzt das geänderte Topic automatisch ein. Wichtig: Wird das Topic, oder besser, der friendly_name in Z2M im Nachgang geändert, ändert sich auch das Topic in MQTT. Hier muss in Symcon dann das Topic der Instanz ebenfalls händisch nachgepflegt werden, da es nicht automatisch übernommen wird. Es macht also Sinn, direkt nach dem Anlernen den friendly_name in Z2M anzupassen und dann erst die Instanz in Symcon über den Konfigurator anzulegen. |
| 10 | Geräteinformationen abrufen | Über diesen Button ruft Ihr einmalig alle Informationen zu einer Instanz über MQTT ab. Dies ist manchmal notwendig, wenn das Modul bezüglich der betreffenden Instanz ein Update erhalten hat (z.B. Variablen-, Profilanderungen). Beim Anlegen der Instanz wird dies vom Konfigurator übernommen, da ist es also nicht nötig, im Nachgang nochmal die Geräteinformationen abzuholen. |
Um fehlende Exposes im Modul zu ergänzen, wird folgendes Vorgehen benötigt:
| Schritt | Screenshot | Aktion |
|---|---|---|
| 1 |  |
Das neue Gerät wird über Z2M ins Zigbee-Netzwerk integriert. Danach erscheint es im Konfigurator des Moduls. Beachtet: Teilweise dauert es einen Moment, bis es im Konfigurator auffindbar ist. Dazu bitte zwei mal auf "Aktualisieren" klicken. |
| 2 |  |
Dann das neue Gerät anlegen lassen. |
| 2 | Das Gerät im Objektbaum suchen und mit einem Doppelklick die Eigenschaften-Seite des Gerätes aufrufen | |
| 3 |  |
Das Debug des Gerätes aktivieren |
| 4 |  |
Die Geräteinformationen abrufen |
| 5 | Im Debug-Fenster erhaltet Ihr jetzt folgende Informationen: MQTT Topic, MQTT Paload, mapExposesToVariables:: All Exposes, mapExposesToVariables:: Missed Exposes | |
| 6 | Wenn unter mapExposesToVariables:: Missed Exposes Einträge zu finden sind, dann weiter mit Schritt 7 | |
| 7 |  |
Das Debug herunterladen |
| 8 | Dieses Debug uns zukommen lassen. | |
| 9 | Sonderfall: Profile mit gerätespezifischen Meldungen (Enum). Hier kommt es zu einer Meldung mit einer spezifischen Profil-Erweiterung und sieht dann z. B. folgendermaßen aus: Z2M.buzzer.bdac7927 Hier benötigen wir die letzte Position (also das bdac7927) um das Profil funktionsfähig zu machen. Diese Meldung erscheint NICHT unter dem Punkt: missed Exposes, sondern an anderer Stelle des Debugs. |
RequestAction($VariablenID, $Value);Mit dieser Funktion können alle Aktionen einer Variable ausgelöst werden.
Beispiel:
Variable ID Status: 12345
RequestAction(12345, true); //Einschalten
RequestAction(12345, false); //Ausschalten