iobroker.zigbee 2.0.5 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -3
- package/admin/admin.js +420 -115
- package/admin/index_m.html +285 -229
- package/admin/tab_m.html +108 -91
- package/docs/de/img/Bild30.png +0 -0
- package/docs/de/img/Bild38.png +0 -0
- package/docs/de/img/Info.png +0 -0
- package/docs/de/img/Zigbee_config_de.jpg +0 -0
- package/docs/de/img/battery.png +0 -0
- package/docs/de/img/debug.png +0 -0
- package/docs/de/img/delete.png +0 -0
- package/docs/de/img/disconnected.png +0 -0
- package/docs/de/img/edit_grp.png +0 -0
- package/docs/de/img/edit_image.png +0 -0
- package/docs/de/img/grp_nok.png +0 -0
- package/docs/de/img/grp_ok.png +0 -0
- package/docs/de/img/on_off.png +0 -0
- package/docs/de/img/reconfigure.png +0 -0
- package/docs/de/readme.md +52 -43
- package/docs/en/img/Zigbee_config_en.png +0 -0
- package/docs/en/img/Zigbee_pairing_en.png +0 -0
- package/docs/en/readme.md +66 -66
- package/io-package.json +32 -31
- package/lib/DeviceDebug.js +2 -1
- package/lib/commands.js +203 -40
- package/lib/devices.js +2 -2
- package/lib/exposes.js +8 -30
- package/lib/groups.js +1 -1
- package/lib/localConfig.js +33 -10
- package/lib/networkmap.js +2 -1
- package/lib/seriallist.js +9 -2
- package/lib/statescontroller.js +185 -91
- package/lib/utils.js +41 -11
- package/lib/zbDeviceConfigure.js +10 -3
- package/lib/zigbeecontroller.js +121 -94
- package/main.js +135 -73
- package/package.json +8 -8
- package/docs/en/img/Bild23.png +0 -0
- package/docs/en/img/Bild25.png +0 -0
- package/docs/en/img/Bild26.png +0 -0
- package/docs/en/img/Bild4.png +0 -0
- package/docs/en/img/Bild9.png +0 -0
package/admin/tab_m.html
CHANGED
|
@@ -663,10 +663,14 @@
|
|
|
663
663
|
<img src="zigbee.png" class="zlogo left" height="64px"/>
|
|
664
664
|
<p>
|
|
665
665
|
<h5 class="translate">Zigbee adapter</h5>
|
|
666
|
-
</p>
|
|
667
|
-
|
|
668
|
-
|
|
666
|
+
</p></div>
|
|
667
|
+
<ul id="nav-mobile" class="right">
|
|
668
|
+
<li>
|
|
669
|
+
<a id="ErrorNotificationBtn" class="btn-floating waves-effect waves-light black tooltipped center-align hoverable translateT hide" title="Zigbee not running">
|
|
670
|
+
<i class="material-icons large icon-red">error</i></a>
|
|
671
|
+
</li>
|
|
669
672
|
<li>
|
|
673
|
+
<li>
|
|
670
674
|
<a id="state_cleanup_btn" class="btn-floating waves-effect waves-light red tooltipped center-align hoverable translateT hide" title="State Cleanup">
|
|
671
675
|
<i class="material-icons large icon-blue">delete_sweep</i></a>
|
|
672
676
|
</li>
|
|
@@ -931,113 +935,126 @@
|
|
|
931
935
|
</div>
|
|
932
936
|
</div>
|
|
933
937
|
</div>
|
|
934
|
-
<div class="
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
<p class="translate device_with_endpoint">Main Endpoint</p>
|
|
938
|
-
</div>
|
|
939
|
-
</div>
|
|
940
|
-
<div class="col1">
|
|
941
|
-
<div class="input-field groups">
|
|
942
|
-
<select id="d_groups_ep0" class="materialSelect" multiple>
|
|
943
|
-
<option value="1">select</option>
|
|
944
|
-
</select>
|
|
945
|
-
<label for="d_groups_ep0" class="translate">Groups</label>
|
|
946
|
-
</div>
|
|
947
|
-
</div>
|
|
948
|
-
</div>
|
|
949
|
-
<div class="row epid1">
|
|
950
|
-
<div class="col epid">
|
|
951
|
-
<div class=endpointid>
|
|
952
|
-
<p class="translate device_with_endpoint">Sub Endpoint 1</p>
|
|
953
|
-
</div>
|
|
954
|
-
</div>
|
|
955
|
-
<div class="col">
|
|
956
|
-
<div class="input-field groups">
|
|
957
|
-
<select id="d_groups_ep1" class="materialSelect" multiple>
|
|
958
|
-
<option value="1">select</option>
|
|
959
|
-
</select>
|
|
960
|
-
<label for="d_groups_ep1" class="translate">Groups</label>
|
|
961
|
-
</div>
|
|
962
|
-
</div>
|
|
963
|
-
</div>
|
|
964
|
-
<div class="row epid2">
|
|
965
|
-
<div class="col epid">
|
|
966
|
-
<div class=endpointid>
|
|
967
|
-
<p class="translate device_with_endpoint">Sub Endpoint 2</p>
|
|
968
|
-
</div>
|
|
969
|
-
</div>
|
|
970
|
-
<div class="col">
|
|
971
|
-
<div class="input-field groups">
|
|
972
|
-
<select id="d_groups_ep2" class="materialSelect" multiple>
|
|
973
|
-
<option value="1">select</option>
|
|
974
|
-
</select>
|
|
975
|
-
<label for="d_groups_ep2" class="translate">Groups</label>
|
|
976
|
-
</div>
|
|
977
|
-
</div>
|
|
978
|
-
</div>
|
|
979
|
-
<div class="row epid3">
|
|
980
|
-
<div class="col epid">
|
|
981
|
-
<div class=endpointid>
|
|
982
|
-
<p class="translate device_with_endpoint">Sub Endpoint 3</p>
|
|
983
|
-
</div>
|
|
984
|
-
</div>
|
|
985
|
-
<div class="col">
|
|
986
|
-
<div class="input-field groups">
|
|
987
|
-
<select id="d_groups_ep3" class="materialSelect" multiple>
|
|
988
|
-
<option value="1">select</option>
|
|
989
|
-
</select>
|
|
990
|
-
<label for="d_groups_ep3" class="translate">Groups</label>
|
|
991
|
-
</div>
|
|
992
|
-
</div>
|
|
938
|
+
<div class="groups_available">
|
|
939
|
+
<div class="row">
|
|
940
|
+
<h6>Groups</h6>
|
|
993
941
|
</div>
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
942
|
+
<div class="row epid0">
|
|
943
|
+
<div class="col">
|
|
944
|
+
<div class=endpointid>
|
|
945
|
+
<p class="translate device_with_endpoint">Main Endpoint</p>
|
|
946
|
+
</div>
|
|
947
|
+
</div>
|
|
948
|
+
<div class="col1">
|
|
949
|
+
<div class="input-field groups">
|
|
950
|
+
<select id="d_groups_ep0" class="materialSelect" multiple>
|
|
951
|
+
<option value="1">select</option>
|
|
952
|
+
</select>
|
|
953
|
+
<label for="d_groups_ep0" class="translate">Groups</label>
|
|
954
|
+
</div>
|
|
998
955
|
</div>
|
|
999
956
|
</div>
|
|
1000
|
-
<div class="
|
|
1001
|
-
<div class="
|
|
1002
|
-
<
|
|
1003
|
-
<
|
|
1004
|
-
</
|
|
1005
|
-
|
|
957
|
+
<div class="row epid1">
|
|
958
|
+
<div class="col epid">
|
|
959
|
+
<div class=endpointid>
|
|
960
|
+
<p class="translate device_with_endpoint">Sub Endpoint 1</p>
|
|
961
|
+
</div>
|
|
962
|
+
</div>
|
|
963
|
+
<div class="col">
|
|
964
|
+
<div class="input-field groups">
|
|
965
|
+
<select id="d_groups_ep1" class="materialSelect" multiple>
|
|
966
|
+
<option value="1">select</option>
|
|
967
|
+
</select>
|
|
968
|
+
<label for="d_groups_ep1" class="translate">Groups</label>
|
|
969
|
+
</div>
|
|
1006
970
|
</div>
|
|
1007
971
|
</div>
|
|
1008
|
-
|
|
1009
|
-
|
|
972
|
+
<div class="row epid2">
|
|
973
|
+
<div class="col epid">
|
|
974
|
+
<div class=endpointid>
|
|
975
|
+
<p class="translate device_with_endpoint">Sub Endpoint 2</p>
|
|
976
|
+
</div>
|
|
977
|
+
</div>
|
|
978
|
+
<div class="col">
|
|
979
|
+
<div class="input-field groups">
|
|
980
|
+
<select id="d_groups_ep2" class="materialSelect" multiple>
|
|
981
|
+
<option value="1">select</option>
|
|
982
|
+
</select>
|
|
983
|
+
<label for="d_groups_ep2" class="translate">Groups</label>
|
|
984
|
+
</div>
|
|
985
|
+
</div>
|
|
986
|
+
</div>
|
|
987
|
+
<div class="row epid3">
|
|
988
|
+
<div class="col epid">
|
|
989
|
+
<div class=endpointid>
|
|
990
|
+
<p class="translate device_with_endpoint">Sub Endpoint 3</p>
|
|
991
|
+
</div>
|
|
992
|
+
</div>
|
|
993
|
+
<div class="col">
|
|
994
|
+
<div class="input-field groups">
|
|
995
|
+
<select id="d_groups_ep3" class="materialSelect" multiple>
|
|
996
|
+
<option value="1">select</option>
|
|
997
|
+
</select>
|
|
998
|
+
<label for="d_groups_ep3" class="translate">Groups</label>
|
|
999
|
+
</div>
|
|
1000
|
+
</div>
|
|
1001
|
+
</div>
|
|
1002
|
+
<div class="row epid4">
|
|
1003
|
+
<div class="col epid">
|
|
1004
|
+
<div class=endpointid>
|
|
1005
|
+
<p class="translate device_with_endpoint">Sub Endpoint 4</p>
|
|
1006
|
+
</div>
|
|
1007
|
+
</div>
|
|
1008
|
+
<div class="col">
|
|
1009
|
+
<div class="input-field groups">
|
|
1010
|
+
<select id="d_groups_ep4" class="materialSelect" multiple>
|
|
1011
|
+
<option value="1">select</option>
|
|
1012
|
+
</select>
|
|
1013
|
+
<label for="d_groups_ep4" class="translate">Groups</label>
|
|
1014
|
+
</div>
|
|
1015
|
+
</div>
|
|
1016
|
+
</div>
|
|
1017
|
+
<div class="row epid5">
|
|
1018
|
+
<div class="col epid">
|
|
1019
|
+
<div class=endpointid>
|
|
1020
|
+
<p class="translate device_with_endpoint">Sub Endpoint 5</p>
|
|
1021
|
+
</div>
|
|
1022
|
+
</div>
|
|
1023
|
+
<div class="col">
|
|
1024
|
+
<div class="input-field groups">
|
|
1025
|
+
<select id="d_groups_ep5" class="materialSelect" multiple>
|
|
1026
|
+
<option value="1">select</option>
|
|
1027
|
+
</select>
|
|
1028
|
+
<label for="d_groups_ep5" class="translate">Groups</label>
|
|
1029
|
+
</div>
|
|
1030
|
+
</div>
|
|
1031
|
+
</div>
|
|
1032
|
+
<div class="row epid6">
|
|
1010
1033
|
<div class="col epid">
|
|
1011
1034
|
<div class=endpointid>
|
|
1012
|
-
<p class="translate device_with_endpoint">Sub Endpoint
|
|
1035
|
+
<p class="translate device_with_endpoint">Sub Endpoint 6</p>
|
|
1013
1036
|
</div>
|
|
1014
1037
|
</div>
|
|
1015
1038
|
<div class="col">
|
|
1016
1039
|
<div class="input-field groups">
|
|
1017
|
-
<select id="
|
|
1040
|
+
<select id="d_groups_ep6" class="materialSelect" multiple>
|
|
1018
1041
|
<option value="1">select</option>
|
|
1019
1042
|
</select>
|
|
1020
|
-
<label for="
|
|
1043
|
+
<label for="d_groups_ep6" class="translate">Groups</label>
|
|
1044
|
+
</div>
|
|
1021
1045
|
</div>
|
|
1022
1046
|
</div>
|
|
1023
|
-
</div>
|
|
1024
|
-
<div class="row epid6">
|
|
1025
|
-
<div class="col epid">
|
|
1026
|
-
<div class=endpointid>
|
|
1027
|
-
<p class="translate device_with_endpoint">Sub Endpoint 6</p>
|
|
1028
|
-
</div>
|
|
1029
1047
|
</div>
|
|
1030
|
-
|
|
1031
|
-
|
|
1032
|
-
|
|
1033
|
-
|
|
1034
|
-
|
|
1035
|
-
|
|
1036
|
-
</div>
|
|
1037
|
-
</div>
|
|
1048
|
+
<div class="row">
|
|
1049
|
+
<div class="options_available col1">
|
|
1050
|
+
<h6>Options</h6>
|
|
1051
|
+
<div class="options_grid">
|
|
1052
|
+
</div>
|
|
1053
|
+
</div>
|
|
1038
1054
|
</div>
|
|
1039
1055
|
</div>
|
|
1040
1056
|
<div class="modal-footer">
|
|
1057
|
+
<a name="add_options" class="waves-effect waves-green btn green translate"><i class="material-icons large">add_circle</i></a>
|
|
1041
1058
|
<a name="save" href="#!" class="modal-action modal-close waves-effect waves-green btn green translate">Save</a>
|
|
1042
1059
|
<a href="#!" class="modal-action modal-close waves-effect waves-red btn-flat translate">Cancel</a>
|
|
1043
1060
|
</div>
|
package/docs/de/img/Bild30.png
CHANGED
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/docs/de/readme.md
CHANGED
|
@@ -1,31 +1,21 @@
|
|
|
1
1
|
# ioBroker Adapter für Zigbee-Geräte
|
|
2
|
-
Mit Hilfe eines Koordinators für ZigBee-
|
|
2
|
+
Mit Hilfe eines Koordinators für ZigBee-Netzwerke wird ein eigenes ZigBee-Netz erschaffen, dem ZigBee-Geräte (Lampen, Dimmer, Sensoren, …) beitreten können. Dank der direkten Interaktion mit dem Koordinator erlaubt der ZigBee-Adapter die Steuerung der Geräte ohne jegliche Gateways/Bridges der Hersteller (Xiaomi/Tradfri/Hue). Zusätzliche Informationen zu ZigBee kann man hier [hier nachlesen (Englisch)](https://github.com/Koenkk/zigbee2mqtt/wiki/ZigBee-network).
|
|
3
3
|
|
|
4
4
|
## Die Hardware
|
|
5
|
-
Für den Koordinator (siehe oben) ist eine zusätzliche Hardware erforderlich, welche die Umsetzung zwischen USB und ZigBee-Funksignalen ermöglicht. Es gibt
|
|
5
|
+
Für den Koordinator (siehe oben) ist eine zusätzliche Hardware erforderlich, welche die Umsetzung zwischen USB und ZigBee-Funksignalen ermöglicht. Es gibt 3 Arten von Koordinatoren:
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
- USB
|
|
7
|
+
- Aufsteckmodule für den RaspberryPi (Die Nutzung dieser Module wird **nicht** empfohlen.)<br>
|
|
8
|
+
- Per USB angeschlossene Module, entweder in Form von Entwicklungsboards oder USB-Sticks
|
|
9
9
|
- Netzwerk Koordinatoren
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
10
|
|
|
11
|
+
Eine vollständige Liste der kompatiblen Koordinatoren (auf englisch) ist [hier](https://www.zigbee2mqtt.io/guide/adapters/) zu finden. Wir empfehlen ausschliesslich den Einsatz von als 'recommended' gelisteten Koordinatoren. An gleicher Stelle finden sich auch Anleitungen zum aufspielen der benötigen Firmware.
|
|
15
12
|
|
|
16
|
-
|
|
17
|
-
Bitte schaut zuerst wie die entsprechenden Koordinatoren geflasht werden müssen. Die Firmware ist [hier](https://github.com/Koenkk/Z-Stack-firmware) zu fimden.
|
|
13
|
+
Koordinatoren werden auch mit bereits aufgespielter Firmware verkauft. Dabei gilt: **jeder Koordinator dessen Firmware mit Zigbee2mqtt.io kompatibel ist kann auch mit dem Zigbee Adapter verwendet werden**.
|
|
18
14
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
- Flashen einer passenden Firmware nicht zwingend erforderlich (Ware wird bereits mit geeigneter Firmware ausgeliefert) <br>
|
|
23
|
-
- Unterstützt den neueren ZigBee 3.0 Standard
|
|
15
|
+
Aktuell (Stand März 2025) sind insbesondere "Sonoff ZIGBEE 3.0 USB-STICK CC2652P" (Sowohl in der Variante mit CC2652P als auch mit EZSP Chipsatz) sowie Netzwerk-Koordinatoren mit Cod.m und/oder XTG Firmware beliebt. Auch der Conbee II und Conbee III werden oft eingesetzt. Vom Einsatz der TI Koordinatoren mit CC2530/CC2531 wird dringend abgeraten - diese gelten inzwischen als veraltet.
|
|
24
16
|
|
|
25
17
|
Die mit dem ZigBee-Netz verbundenen Geräte übermitteln dem Koordinator ihren Zustand und benachrichtigen über Ereignisse (Knopfdruck, Bewegungserkennung, Temperaturänderung, …). Diese Infos werden im Adapter unter den jeweiligen ioBroker-Objekten angezeigt und können so in ioBroker weiterverarbeitet werden. Außerdem ist es möglich Kommandos an das ZigBee-Gerät zu senden (Zustandsänderung Steckdosen und Lampen, Farb- und Helligkeitseinstellungen, …).
|
|
26
18
|
|
|
27
|
-
Eine weitergehende Aufstellung der verschiedenen Hardware-optionen für den Koordinator ist m [zigbee2mqtt.io Projekt](https://www.zigbee2mqtt.io/guide/adapters/) zu finden (Dokumentation ausschliesslich auf englisch)
|
|
28
|
-
|
|
29
19
|
## Die Software
|
|
30
20
|
|
|
31
21
|
Die Software wird unterteilt in "Konverter" und "Adapter".
|
|
@@ -36,24 +26,32 @@ Die Software wird unterteilt in "Konverter" und "Adapter".
|
|
|
36
26
|
Der Konverter gliedert sich auf in zwei Teile: <br>
|
|
37
27
|
a) Allgemeine Bereitstellung der Daten aus den ZigBee-Funksignalen. Dieser [Softwareteil](https://github.com/Koenkk/zigbee-herdsman) wird für alle ZigBee-Geräte verwendet. <br>
|
|
38
28
|
b) Gerätespezifische [Aufbereitung](https://github.com/Koenkk/zigbee-herdsman-converters) der Daten auf eine definierte Schnittstelle zum Adapter. <br>
|
|
39
|
-
|
|
29
|
+
|
|
40
30
|
- Adapter <br>
|
|
41
31
|
Dieser Softwareteil ist die Anbindung des Konverters an ioBroker. Der [Adapter](https://github.com/ioBroker/ioBroker.zigbee) beinhaltet die grafische Darstellung zur Verwaltung der ZigBee-Geräte, sowie die Erzeugung der ioBroker-Objekte zur Steuerung der ZigBee-Geräte.
|
|
42
|
-
|
|
32
|
+
|
|
43
33
|
## Installation
|
|
44
34
|
1. Koordinator Hardware am RaspberryPi anstecken.<br>
|
|
45
35
|
2. Über z.B. PuTTY mit RaspberryPi verbinden.<br>
|
|
46
|
-
3.
|
|
47
|
-
sudo rm /opt/iobroker/iobroker-data/zigbee_0/nvbackup.json<br>
|
|
48
|
-
4. Pfad des Koordinators ermitteln. Auf Linux Systemen befindet sich dieser oft im Verzeichnis /dev/serial/by-id. Alternativ dazu werden /dev/ttyUSB*, /dev/ttyAM* (Linux), /dev/tty.usbserial-* (macOS) oder com* (windows) erwartet.<br>
|
|
36
|
+
3. Pfad des Koordinators ermitteln. Auf Linux Systemen befindet sich dieser oft im Verzeichnis /dev/serial/by-id. Alternativ dazu werden /dev/ttyUSB*, /dev/ttyAM* (Linux), /dev/tty.usbserial-* (macOS) oder com* (windows) erwartet.<br>
|
|
49
37
|
Das folgende Beispiel zeigt eine Linux-Installation auf einem Raspberry PI. Der Befehl `ls -la /dev/serial/by-id/` erzeugt die im Bild erkennbare Ausgabe.
|
|
50
38
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
39
|
+
4. ioBroker -> ZigBee-Adapter installieren, hier als Beispiel die Version 1.8.10 <br>  <br> Hiermit werden alle erforderlichen Softwareteile (Konverter und Adapter) installiert.
|
|
40
|
+
5. Konfiguration des Adapters öffnen. Das folgende Bild zeigt das Interface ab der Version 2.1.0.<br><br>
|
|
41
|
+
Der Admin zeigt in dieser Situation an ob das Zigbee-Subsystem gestartet ist (A).
|
|
42
|
+
6. Port zum Koordinator eintragen. (B) Im Fall von USB Koordinatoren ist das der zuvor ermittelte Device-Pfad. Im Fall von über das Netzwerk angesteuerten Koordinatoren muss an Stelle des Gerätepfades die Netzwerkaddresse samt port in der Form tcp://ip:port angegeben werden. Sofern der Adapter selber (nicht das Zigbee-Subsyste) aktiv ist steht eine Liste der verfügbaren seriellen Schnittstellen zur Auswahl zur Verfügung. Bei der Auswahl gilt:
|
|
43
|
+
- Sofern am System mehrere Adapter mit unterschiedlichen USB Geräten zur Kommunikation verwendet werden sollte **unbedingt** ein Port aus dem Verzeichnis /dev/serial/by-id (sofern verfügbar) ausgewählt werden. Damit wird sicher gestellt das bei einem Neustart des Systems die Zuordnung des Adapters zum Koordinator erhalte bleibt
|
|
44
|
+
- Sofern ausschliesslich ein USB Gerät verwendet wird ist die Verwendung des /dev/TTY* Anschlusses zu bevorzugen. Damit kann der Koordinator bei Defekt durch ein baugleiches Gerät ersetzt werden ohne das die Konfiguration angepasst werden muss.
|
|
45
|
+
7. Netzwerk-ID und Pan ID vergeben zur Unterscheidung von anderen ZigBee-Netzwerken in Funkreichweite, z.B. Ab Adapter Version 2.1.0 weden ExtPanID (C) und PanID (D) automatisch mit zufälligen Werten vorbelegt bis die Konfiguration gespeichert wurde.<br>
|
|
46
|
+
8. Geeigneten Zigbee-Kanal (E) auswählen. Dabei ist zu beachten das Zigbee und 2.4GHz WLAN sich das gleiche Frequenzband teilen. Der optimale Kanal hängt also unter anderem auch von den in der Umgebung verwendeten WLan Kanälen ab. Dabei sind die Kanalbezeichnungen von Zigbee und WLan **nicht** identisch. Weiterhin ist es Sinnvoll sich bei der Auswahl auf die Zigbee Light Link Kanäle (11,15,20,25) zu beschränken. Wird ein Kanal ausgewählt der nicht zum ZLL gerhört zeigt das Interface ein gelbes Dreieck mit Ausrufungszeichen über dem eingetragenen Kanal.<br>
|
|
47
|
+
Nachdem der Adapter erfolgreich gestartet wurde kann über die Konfiguration auch ein Scan der Netzwerkkanäle durchgeführt werden.<br>
|
|
48
|
+
**Hinweis:** Ab Adapter Version 2.1.0 ist es Möglich den Kanal zu wechseln ohne das die Konfiguration gelöscht und alle Geräte neu angelernt werden müssen. **Diese Funktion ist als Experimentell zu betrachten** - es kann sein das einzelne Geräte den Kanalwechsel nicht mit machen - diese müssen in der Folge neu angelernt werden.
|
|
49
|
+
9. Prüfen ob das Zigbee-Subsystem startet. Dazu via *Start/Stop* (F) versuchen das Zigbee-Subsystem zu starten. Im Log (Log) kann der Verlauf des Startversuchs beobachtet werden. Das Icon (A) ändert seine Farbe von Schwarz/Rot auf Schwarz/Orange während der Herdsman startet. Wenn der Versuch erfolgreich war erlischt das Icon komplett, ansonsten wird es wieder Rot und die Meldungen im Log geben Hinweise auf die Ursache.<br>
|
|
50
|
+
Über die gleiche Schaltfläche kann der Herdsman auch angehalten werden. Auch dabei wird das Icon in Schwarz/Orange dargestellt. **Wichtig: Das Anhalten kann in einzelfǎllen bis zu 2 Minuten dauern - insbesondere bei der Verwendung von Netzwerk Koordinatoren.** Hier ist Geduld gefragt. Nachdem der Herdsman beendet wurde erscheint das Icon in Schwarz/Rot und die Meldung 'Herdsman stopped!'.
|
|
51
|
+
Je nach Fehlerbild gibt es verschiedene mögliche Ursachen dafür das der Herdsman nicht startet. Sofern es sich dabei 'nur' um eine Zeitüberschreitung (Timeout) handelt ist es durchaus Sinnvoll den Versuch direkt zu widerholen. Bei inkonsistenter Konfiguration werden die relevanten Daten im Log angezeigt. Hier bietet der Adapter zwei Möglichkeiten den Konflikt zu lösen:
|
|
52
|
+
- Lesen der Daten aus dem NVBackup. In diesem Fall wird die Konfiguration des Adapters angepasst.
|
|
53
|
+
- Löschen des NVBackups. In diesem Fall bleibt die Konfiguration im Adapter wie sie ist. Dieses **erzwingt** einen Neuaufbau des Netzwerkes so das in der Folge alle bereits angelernten Geräte zurückgesetzt und neu angelernt werden müssen.<br>
|
|
54
|
+
Die Ausgaben im Log sind auch dazu geeignet bei der Suche nach einer Lösung im [ioBroker Forum](https://forum.iobroker.net) eingesetzt zu werden. Dazu bitte die Meldungen markieren und **als Text** im Forum posten.
|
|
57
55
|
|
|
58
56
|
## Pairing
|
|
59
57
|
Jedes ZigBee-Gerät (Schalter, Lampe, Sensor, …) muss mit dem Koordinator gekoppelt werden (Pairing): <br>
|
|
@@ -61,10 +59,10 @@ Jedes ZigBee-Gerät (Schalter, Lampe, Sensor, …) muss mit dem Koordinator geko
|
|
|
61
59
|
- ZigBee-Gerät:
|
|
62
60
|
Jedes **ZigBee-Gerät** kann nur mit genau 1 ZigBee-Netzwerk verbunden sein. Hat das ZigBee-Gerät noch Pairing-Informationen zu einem fremden Koordinator (z.B. Philips Hue Bridge) gespeichert, dann muss es von diesem ZigBee-Netzwerk zuerst entkoppelt werden. Dieses Entkoppeln vom alten ZigBee-Netzwerk erfolgt vorzugsweise über die Bedienoberfläche des alten ZigBee-Netzwerkes (z.B. Philips Hue App). Alternativ kann man das ZigBee-Gerät auf Werkseinstellungen zurücksetzen. <br>
|
|
63
61
|
Um ein ZigBee-Gerät nun in den Pairing-Mode zu versetzen, gibt es typischerweise folgende Möglichkeiten: <br>
|
|
64
|
-
1. ZigBee-Gerät von einem ZigBee-Netzwerk entkoppeln
|
|
65
|
-
2. Pairing-Button am ZigBee-Gerät drücken (ggf. mehrfach)
|
|
62
|
+
1. ZigBee-Gerät von einem ZigBee-Netzwerk entkoppeln
|
|
63
|
+
2. Pairing-Button am ZigBee-Gerät drücken (ggf. mehrfach)
|
|
66
64
|
3. Versorgungsspannung des ZigBee-Gerätes aus- und dann wieder einschalten (ggf. mehrfach)
|
|
67
|
-
|
|
65
|
+
|
|
68
66
|
Danach ist das ZigBee-Gerät für typischerweise 60 Sekunden im Pairing-Mode. <br>
|
|
69
67
|
Ähnlich wie die Vorgehensweise zum Rücksetzen auf Werkseinstellungen ist auch das Aktivieren des Pairing-Mode abhängig vom jeweiligen Gerätetyp (ggf. Bedienungsanleitung des ZigBee-Gerätes lesen). <br>
|
|
70
68
|
|
|
@@ -100,19 +98,30 @@ Als Ergebnis kommt eine von zwei Möglichkeiten in Frage:
|
|
|
100
98
|
In Beiden Fällen ist es hinreichend den Adapter neu zu starten - die entsprechend angepassten Datenpunkte des Adapters werden angelegt. Sofern dabei Datenpunkte nicht weiter unterstützt werden so werden diese in orange eingefärbt und der Adapter zeigt die Schaltfläche zum löschen der verwaisten Datenpunkte an.
|
|
101
99
|
|
|
102
100
|
## Symbole im ZigBee-Adapter
|
|
103
|
-
|
|
104
|
-
| Bild | Beschreibung
|
|
101
|
+
|
|
102
|
+
| Bild | Beschreibung |
|
|
105
103
|
|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
106
|
-
|  | **State Cleanup** <br> Löschen von
|
|
107
|
-
|  | **State Cleanup** <br> Löschen von unverbundenen ioBroker-Objekten. Diese können welche durch den Vorgang "Ausschliessen" entstehen können. |
|
|
105
|
+
|  | **Show stashed errors** <br> Anzeigen von gesammelten Fehlermeldungen die widerholt auftreten. Dieses Icon ist nur dann sichtbar wenn das System wiederkehrende Fehlermeldungen unterdrückt hat und dient dazu den Benutzer auf deren Existenz hin zu weisen. |
|
|
106
|
+
|  | **Auf Firmware Updates überprüfen** <br> Der Zigbee Adapter ist unterstützt OTA Firmware upgrades, sofern die angeschlossenen Geräte dieses unterstützen. Mit dieser Schaltfläche wird die Überprüfung auf neuere Firmware angestossen - das eigentliche Upgrade miss in der Folge an jedem Gerät einzenl angestossen werden. |
|
|
107
|
+
|  | **Add Group** <br>Die Zigbee-Spezifikation unterstützt das anlegen von Gruppen von Geräten, die gemeinsam über einen Befehl angesteuert werden könne. Während die Spezifikation fast b eliebige Befehle als Gruppenbefehle unterstützt ist die Umsetzung im Zigbee-Adapter auf Leuchtmittel begrenzt - Mit dieser Schaltfläche kann eine neue Gruppe angelegt werden. Das hinzufügen und entfernen von Mitgliedern geschieht über die Geräte |
|
|
108
|
+
|  | **Touchlink zurücksetzen und koppeln** <br> Touchlink ist eine Funktion von des Zigbee Light Link (ZLL), die es physisch nahe beieinander liegenden Geräten ermöglicht miteinander zu kommunizieren, ohne an einen Koordinator angebunden zu sein. Diese Funktion wird nicht von allen Geräten unterstützt. Um ein ZigBee-Gerät über Touchlink auf Werkseinstellungen zurückzusetzen, bringe das Gerät in die Nähe (< 10 cm) des ZigBee-Koordinators und drücke dann das grüne Symbol. **Warnung** durch inkorrekte Umsetzung des Touchlink reset Prozesses kann es passieren das auch Geräte mit grösserem Abstand zurück gesetzt werden. Im Zweifelsfall ist es Angeraten eventuell betroffene Geräte kurzfristig stromlos zu machen. |
|
|
109
|
+
|  | **Pairing mit QR Code** <br>Es gibt Geräte die für das Pairing mit einem Netzwerk einen zusätzlichen Sicherheitscode benötigen. Dieser ist üblicherweise als QR Code auf dem und/oder der Anleitung angebracht. Ein Pairing mit diesen Geräten kann nur erfolgen wenn der entsprechende Code vorher angegeben wurde. **Hinweis** In vielen Anleitungen sind werden QR Codes angegeben die mit der Herstellerspezifischen App gelesen werden sollen um das Gerät an das Hersteller-Gateway anzubinden, obwohl die Geräte keinen Sicherheitscode unterstützen. In diesem Fall gibt der Adapter einen Fehler wenn versucht wird den Code einzugeben. Wenn das passiert macht es Sinn zu versuchen das Gerät 'normal' anzulernen. |
|
|
110
|
+
|  | **Pairing** <br> Anlernvorgang neuer ZigBee-Geräte (Pairing) starten. Durch drücken auf diese Schaltfläche wird das Netzwerk für eine (konfigurierbare) Zeit zwischen 10 und 250 sekunden geöffnet so das neue Geräte in das Netzwerk aufgenommen werden
|
|
111
|
+
## Gerätekacheln
|
|
112
|
+
| Bild | Beschreibung |
|
|
113
|
+
|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
114
|
+
|  | Zeit seit mit diesem ZigBee-Gerät <br> zuletzt ein Datenaustausch stattgefunden hat. |
|
|
115
|
+
|  | Batteriestand <br> sofern das Gerät einen Batteriestand meldet. |
|
|
116
|
+
| <br> | Stärke des ZigBee-Funksignals <br> an diesem ZigBee-Gerät (<10 schlecht, <50 mittel, >50 gut).ZigBee ist ein Funk-Mesh-Netzwerk. Die meisten netzbetriebenen ZigBee-Geräte (z.B. Philips Hue Lampe) können als ZigBee-Router wirken, also als Funkknotenpunkt. ZigBee-Geräte müssen somit nicht zwingend eine direkte Funkverbindung zum Koordinator aufbauen sondern können stattdessen jeden Router im Netzwerk zur Funkverbindung nutzen. Mit jedem ZigBee-Router wird somit die Funkreichweite des Netzwerkes erweitert. Alle ZigBee-Geräte prüfen regelmäßig, ob es eine bessere Funkroute gibt und stellen sich automatisch um. Dieser Vorgang kann jedoch etliche Minuten dauern.<br>Eine manuelle zuordnugn von Geräten zu Routern ist **nicht** möglich.<br> Das rote, durchgestrichene Symbol wird angezeigt wenn ein Gerät als 'nicht verbunden' gewertet wird. |
|
|
117
|
+
|   | Zustand einer Gruppe <br> Ein grüner Kreis signalisiert das eine Gruppe mit Mitgliedern versorgt und Funktionstüchtig ist, das rote X erscheint wenn eine Gruppe leer oder aus anderen Gründen nicht einsetzbar ist. |
|
|
118
|
+
|  | Info <br> Öffnet die Informationsanzeige zum Gerät. Die auf dieser Seite dargestellten Informationen stammen direkt vom Gerät. Sie sind auch für unbekannte Geräte verfügbar. |
|
|
119
|
+
|  | Gerät debuggen <br> Aktiviert / deaktivert die Erzeugung von erweiterten Debug-Meldungen für dieses Gerät. Die Farbe des Icons zeigt den aktuellen Status an: (Schwarz/Weiss: keine Debug Meldungen, Grün Debug Meldungen - deaktivierbar mit dieser Schaltflächce. Orange - Debug Meldungen via Filter unter zigbee.x.info.debugmessages. |
|
|
120
|
+
|  | An/Aus <br> Mit dieser Schaltfläche kann ein Gerät aktiviert / deaktiviert werden. Mit deaktiverten Geräten findet keine Kommunikation statt. |
|
|
121
|
+
|  | Bild / Name zusweisen <br> Mit dieser Schaltfläche ist es Möglich für das Gerät basierend auf dem Gerät oder dem Gerätetyp ein eigenes Bild und / oder einen eigenen Namen vorzugeben. Vorgaben die so gemacht werden bleiben erhalten wenn das Gerät gelöscht wird. |
|
|
122
|
+
|  | Name / Gruppen editieren <br> Über diese Schaltfläche lässt sich der Name eines Gerätes sowie - wenn zutreffent - die Zuordnung des Gerätes zu einer oder mehreren Gruppen anpassen. |
|
|
123
|
+
|  | Gerät löschen <br> Started den Löschvorgang für dieses Gerät. |
|
|
114
124
|
|
|
115
125
|
## Zusätzliche Informationen
|
|
116
|
-
|
|
126
|
+
Der Zigbee Adapter teilt sich die Bibliortheken mit dem [Projekt](https://www.zigbee2mqtt.io/) Zigbee2mqtt. Dieses erlaubt die Steuerung von Zigbee-Geräten über MQTT oder über einen eigenen ioBroker [Adapter](https://github.com/arteck/ioBroker.zigbee2mqtt) Durch die verwendung der gleichen Bibliotheken wird jedes Gerät das unter zigbee2mqtt läuft auch im Zigbee Adapter laufen. Allerdings kann es dabei zu Verzögerungen kommen da wir die Kompatibilität der Bibliotheken mit dem Adapter verifizieren müssen. Durch eröffnen eines *issues* bei Github könnt Ihr diesen Prozess anstossen und/oder beschleunigen. Oft bekommt Ihr da auch Hilfe das Gerät ohne Aktualiserung des Adapters nutzbar zu machen.<br>
|
|
117
127
|
Weitere Themen zu diesem Adapter sind auch im zugehörigen [Wiki](https://github.com/ioBroker/ioBroker.zigbee/wiki) dokumentiert.
|
|
118
|
-
|
|
Binary file
|
|
Binary file
|