iobroker.zigbee 1.8.10 → 1.8.13

package/docs/flashing_via_arduino_(en).md

@@ -1,110 +1,110 @@
-Flashing firmware via Arduino is implemented using the project https://github.com/wavesoft/CCLib
-**But with minor improvements!!!**
-
-[AndrewLinden](https://github.com/AndrewLinden) described that he was able to flash CC2531 using CCLib [with comments](https://github.com/wavesoft/CCLib/issues/19).
-
-As described [I made a fork of the CCLib library with minor changes](https://github.com/kirovilya/CCLib) for flashing firmware via Arduino:
-* Timeouts of operations
-* After opening the port (I have in Windows 7) Arduino reboots and, accordingly, does not respond to requests - made a 3 seconds pause (found somewhere in internet).
-* The port speed is reduced to 9600, because at another speed leaving communication errors:
-`ERROR: Could not read from the serial port!`
-
-## Checked on Arduino UNO on CC2531-stick
-
-0. Download and unpack the archive with the library https://github.com/kirovilya/CCLib.
-
-1. Flashing Arduino sketch via Arduino IDE
-CCLib\Arduino\CCLib\Examples\CCLib_proxy\CCLib_proxy.ino
-
-2. Install Python 2.7 or later (tested with python 2.7.13), if not installed
-
-3. Install pyserial 3.0.1, if not installed
-`pip install -r CCLib\Python\requirements.txt`
-or
-`pip install pyserial==3.0.1`
-
-4. Connect the contacts as described https://github.com/kirovilya/CCLib#1-prepare-your-arduino-board
-**But in my case, I connected completely without resistors, combined the contacts CC_DD_I and CC_DD_O together and connected to the DD pin of the DEBUG connector!**
-
-![](https://www.waveshare.com/img/devkit/CC-Debugger/CC-Debugger-JTAG-Header.jpg)
-
-I connected only 3 specified contacts and GND. During the firmware, the stick and Arduino must be connected to the USB.
-
-![](https://github.com/kirovilya/files/blob/master/IMG_20180111_193941.jpg)
-![](https://github.com/kirovilya/files/blob/master/IMG_20180111_193923.jpg)
-![](https://github.com/kirovilya/files/blob/master/IMG_20180110_234401.jpg)
-
-5. After that, try to get information about the chip - if it works, then the connection is correct (example for COM9 port - Arduino port):
-
-```
-C:\Projects\CCLib\Python>python cc_info.py -p COM9
-INFO: Found a CC2531 chip on COM9
-
-Chip information:
-      Chip ID : 0xb524
-   Flash size : 256 Kb
-    Page size : 2 Kb
-    SRAM size : 8 Kb
-          USB : Yes
-
-Device information:
- IEEE Address : 00124b0014aa
-           PC : 0000
-
-Debug status:
- [ ] CHIP_ERASE_BUSY
- [ ] PCON_IDLE
- [X] CPU_HALTED
- [ ] PM_ACTIVE
- [ ] HALT_STATUS
- [ ] DEBUG_LOCKED
- [X] OSCILLATOR_STABLE
- [ ] STACK_OVERFLOW
-
-Debug config:
- [ ] SOFT_POWER_MODE
- [ ] TIMERS_OFF
- [X] DMA_PAUSE
- [X] TIMER_SUSPEND
-```
-[Another example of connection on MacOS](https://github.com/wavesoft/CCLib/issues/22#issuecomment-384452424)
-
-6. If everything is successful, then download [modified firmware for flashing via Arduino](https://github.com/kirovilya/files/blob/master/CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex)
-
-7. Start the flashing firmware (it takes a long time, about 2-3 hours):
-
-```
-C:\Projects\ZigBee>python cc_write_flash.py -e -p COM9 --in=CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex
-INFO: Found a CC2531 chip on COM9
-
-Chip information:
-      Chip ID : 0xb524
-   Flash size : 256 Kb
-    Page size : 2 Kb
-    SRAM size : 8 Kb
-          USB : Yes
-Sections in CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex:
-
- Addr.    Size
--------- -------------
- 0x0000   8176 B
- 0x1ff6   10 B
- 0x3fff0   1 B
- 0x2000   239616 B
-
-This is going to ERASE and REPROGRAM the chip. Are you sure? <y/N>:  y
-
-Flashing:
- - Chip erase...
- - Flashing 4 memory blocks...
- -> 0x0000 : 8176 bytes 
-    Progress 100%... OK
- -> 0x1ff6 : 10 bytes 
-    Progress 100%... OK
- -> 0x3fff0 : 1 bytes 
-    Progress 100%... OK
- -> 0x2000 : 239616 bytes 
-    Progress 100%... OK
-
-Completed
-```
+Flashing firmware via Arduino is implemented using the project https://github.com/wavesoft/CCLib
+**But with minor improvements!!!**
+
+[AndrewLinden](https://github.com/AndrewLinden) described that he was able to flash CC2531 using CCLib [with comments](https://github.com/wavesoft/CCLib/issues/19).
+
+As described [I made a fork of the CCLib library with minor changes](https://github.com/kirovilya/CCLib) for flashing firmware via Arduino:
+* Timeouts of operations
+* After opening the port (I have in Windows 7) Arduino reboots and, accordingly, does not respond to requests - made a 3 seconds pause (found somewhere in internet).
+* The port speed is reduced to 9600, because at another speed leaving communication errors:
+`ERROR: Could not read from the serial port!`
+
+## Checked on Arduino UNO on CC2531-stick
+
+0. Download and unpack the archive with the library https://github.com/kirovilya/CCLib.
+
+1. Flashing Arduino sketch via Arduino IDE
+CCLib\Arduino\CCLib\Examples\CCLib_proxy\CCLib_proxy.ino
+
+2. Install Python 2.7 or later (tested with python 2.7.13), if not installed
+
+3. Install pyserial 3.0.1, if not installed
+`pip install -r CCLib\Python\requirements.txt`
+or
+`pip install pyserial==3.0.1`
+
+4. Connect the contacts as described https://github.com/kirovilya/CCLib#1-prepare-your-arduino-board
+**But in my case, I connected completely without resistors, combined the contacts CC_DD_I and CC_DD_O together and connected to the DD pin of the DEBUG connector!**
+
+![](https://www.waveshare.com/img/devkit/CC-Debugger/CC-Debugger-JTAG-Header.jpg)
+
+I connected only 3 specified contacts and GND. During the firmware, the stick and Arduino must be connected to the USB.
+
+![](https://github.com/kirovilya/files/blob/master/IMG_20180111_193941.jpg)
+![](https://github.com/kirovilya/files/blob/master/IMG_20180111_193923.jpg)
+![](https://github.com/kirovilya/files/blob/master/IMG_20180110_234401.jpg)
+
+5. After that, try to get information about the chip - if it works, then the connection is correct (example for COM9 port - Arduino port):
+
+```
+C:\Projects\CCLib\Python>python cc_info.py -p COM9
+INFO: Found a CC2531 chip on COM9
+
+Chip information:
+      Chip ID : 0xb524
+   Flash size : 256 Kb
+    Page size : 2 Kb
+    SRAM size : 8 Kb
+          USB : Yes
+
+Device information:
+ IEEE Address : 00124b0014aa
+           PC : 0000
+
+Debug status:
+ [ ] CHIP_ERASE_BUSY
+ [ ] PCON_IDLE
+ [X] CPU_HALTED
+ [ ] PM_ACTIVE
+ [ ] HALT_STATUS
+ [ ] DEBUG_LOCKED
+ [X] OSCILLATOR_STABLE
+ [ ] STACK_OVERFLOW
+
+Debug config:
+ [ ] SOFT_POWER_MODE
+ [ ] TIMERS_OFF
+ [X] DMA_PAUSE
+ [X] TIMER_SUSPEND
+```
+[Another example of connection on MacOS](https://github.com/wavesoft/CCLib/issues/22#issuecomment-384452424)
+
+6. If everything is successful, then download [modified firmware for flashing via Arduino](https://github.com/kirovilya/files/blob/master/CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex)
+
+7. Start the flashing firmware (it takes a long time, about 2-3 hours):
+
+```
+C:\Projects\ZigBee>python cc_write_flash.py -e -p COM9 --in=CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex
+INFO: Found a CC2531 chip on COM9
+
+Chip information:
+      Chip ID : 0xb524
+   Flash size : 256 Kb
+    Page size : 2 Kb
+    SRAM size : 8 Kb
+          USB : Yes
+Sections in CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex:
+
+ Addr.    Size
+-------- -------------
+ 0x0000   8176 B
+ 0x1ff6   10 B
+ 0x3fff0   1 B
+ 0x2000   239616 B
+
+This is going to ERASE and REPROGRAM the chip. Are you sure? <y/N>:  y
+
+Flashing:
+ - Chip erase...
+ - Flashing 4 memory blocks...
+ -> 0x0000 : 8176 bytes 
+    Progress 100%... OK
+ -> 0x1ff6 : 10 bytes 
+    Progress 100%... OK
+ -> 0x3fff0 : 1 bytes 
+    Progress 100%... OK
+ -> 0x2000 : 239616 bytes 
+    Progress 100%... OK
+
+Completed
+```

package/docs/ru/readme.md

@@ -1,28 +1,28 @@
-# Драйвер ioBroker для работы с Zigbee-устройствами
-При помощи координатора Zigbee-сети на базе Texas Instruments SoC cc253x (и другими) создается собственная сеть, в которую подключаются zigbee-устройства. Взаимодействуя напрямую с координатором сети, драйвер позволяет управлять устройствами без дополнительных шлюзов/бриджей от производителей устройств (Xiaomi/TRADFRI/Hue). Про устройство Zigbee-сети можно прочитать [тут (на английском языке)](https://github.com/Koenkk/zigbee2mqtt/wiki/ZigBee-network). 
-
-## Оборудование
-Для работы необходимо одно из перечисленных устройств, прошитое специальной ZNP-прошивкой: [cc2531, cc2530, cc2530+RF](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-sniffer-devices#zigbee-coordinator)
-
-![](img/CC2531.png)
-![](img/sku_429478_2.png)
-![](img/sku_429601_2.png)
-![](img/CC2591.png)
-Необходимое для прошивки оборудование и процесс подготовки устройства описан [тут (на английском языке)](https://github.com/Koenkk/zigbee2mqtt/wiki/Getting-started) или [тут (на русском языке)](https://github.com/kirovilya/ioBroker.zigbee/wiki/%D0%9F%D1%80%D0%BE%D1%88%D0%B8%D0%B2%D0%BA%D0%B0) 
-
-Подключенные к Zigbee-сети устройства сообщают координатору своё состояние и информируют о событиях (нажатия кнопки, обнаружение движения, изменение температуры). Эти сведения отражаются в виде объектов-состояний ioBroker. Некоторые состояния имеют обратную связь и могут отправлять команды zigbee-устройству при изменении состояния (переключение состояния розетки и лампы, изменение сцены или яркости лампы).
-
-## Работа с драйвером
-Для запуска драйвера необходимо указать имя порта, на котором подключено устройство cc253x.
-Как узнать порт написано [тут (на русском языке)](https://github.com/kirovilya/ioBroker.zigbee/wiki#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B0%D0%B4%D0%B0%D0%BF%D1%82%D0%B5%D1%80%D0%B0)
-
-Для подключения устройств необходимо перевести координатор Zigbee-сети в режим сопряжения, нажав зеленую кнопку. Начнется обратный отсчет времени (60 сек) пока будет доступна возможность подключения устройств.
-Для подключения Zigbee-устройств в большинстве случаев достаточно нажать кнопку сопряжения на самом устройстве. Но существуют особенности для некоторых устройств. Подробнее о сопряжении с устройствами читайте [тут (на английском языке)](https://github.com/Koenkk/zigbee2mqtt/wiki/Pairing-devices) или [тут (на русском языке)](https://github.com/kirovilya/ioBroker.zigbee/wiki#%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5-%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0).
-
-После успешного сопряжения, устройство появится в панели устройств. Если устройство появилось в панели устройств, но имеет тип undefined, то это неизвестное устройство и с ним нельзя будет взаимодействовать. Если устройство есть в списке доступных устройств, но добавилось как undefined, то попробуйте удалить устройство и добавить заново.
-Если не получается подключить устройство, то напиши issue.
-
-## Дополнительные сведения
-Существует [дружественный проект](https://github.com/koenkk/zigbee2mqtt) со схожим функционалом на тех же технологиях, в котором с этими же устройствами можно работать по протоколу MQTT.
-Поэтому, если какие-либо улучшения или поддержка новых zigbee-устройств происходит в проекте Zigbee2MQTT, то можно перенести и добавить этот же функционал в этот драйвер. Если заметили это, то напиши issue - перенесем.
-
+# Драйвер ioBroker для работы с Zigbee-устройствами
+При помощи координатора Zigbee-сети на базе Texas Instruments SoC cc253x (и другими) создается собственная сеть, в которую подключаются zigbee-устройства. Взаимодействуя напрямую с координатором сети, драйвер позволяет управлять устройствами без дополнительных шлюзов/бриджей от производителей устройств (Xiaomi/TRADFRI/Hue). Про устройство Zigbee-сети можно прочитать [тут (на английском языке)](https://github.com/Koenkk/zigbee2mqtt/wiki/ZigBee-network). 
+
+## Оборудование
+Для работы необходимо одно из перечисленных устройств, прошитое специальной ZNP-прошивкой: [cc2531, cc2530, cc2530+RF](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-sniffer-devices#zigbee-coordinator)
+
+![](img/CC2531.png)
+![](img/sku_429478_2.png)
+![](img/sku_429601_2.png)
+![](img/CC2591.png)
+Необходимое для прошивки оборудование и процесс подготовки устройства описан [тут (на английском языке)](https://github.com/Koenkk/zigbee2mqtt/wiki/Getting-started) или [тут (на русском языке)](https://github.com/kirovilya/ioBroker.zigbee/wiki/%D0%9F%D1%80%D0%BE%D1%88%D0%B8%D0%B2%D0%BA%D0%B0) 
+
+Подключенные к Zigbee-сети устройства сообщают координатору своё состояние и информируют о событиях (нажатия кнопки, обнаружение движения, изменение температуры). Эти сведения отражаются в виде объектов-состояний ioBroker. Некоторые состояния имеют обратную связь и могут отправлять команды zigbee-устройству при изменении состояния (переключение состояния розетки и лампы, изменение сцены или яркости лампы).
+
+## Работа с драйвером
+Для запуска драйвера необходимо указать имя порта, на котором подключено устройство cc253x.
+Как узнать порт написано [тут (на русском языке)](https://github.com/kirovilya/ioBroker.zigbee/wiki#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B0%D0%B4%D0%B0%D0%BF%D1%82%D0%B5%D1%80%D0%B0)
+
+Для подключения устройств необходимо перевести координатор Zigbee-сети в режим сопряжения, нажав зеленую кнопку. Начнется обратный отсчет времени (60 сек) пока будет доступна возможность подключения устройств.
+Для подключения Zigbee-устройств в большинстве случаев достаточно нажать кнопку сопряжения на самом устройстве. Но существуют особенности для некоторых устройств. Подробнее о сопряжении с устройствами читайте [тут (на английском языке)](https://github.com/Koenkk/zigbee2mqtt/wiki/Pairing-devices) или [тут (на русском языке)](https://github.com/kirovilya/ioBroker.zigbee/wiki#%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5-%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0).
+
+После успешного сопряжения, устройство появится в панели устройств. Если устройство появилось в панели устройств, но имеет тип undefined, то это неизвестное устройство и с ним нельзя будет взаимодействовать. Если устройство есть в списке доступных устройств, но добавилось как undefined, то попробуйте удалить устройство и добавить заново.
+Если не получается подключить устройство, то напиши issue.
+
+## Дополнительные сведения
+Существует [дружественный проект](https://github.com/koenkk/zigbee2mqtt) со схожим функционалом на тех же технологиях, в котором с этими же устройствами можно работать по протоколу MQTT.
+Поэтому, если какие-либо улучшения или поддержка новых zigbee-устройств происходит в проекте Zigbee2MQTT, то можно перенести и добавить этот же функционал в этот драйвер. Если заметили это, то напиши issue - перенесем.
+

package/io-package.json

@@ -1,8 +1,20 @@
 {
   "common": {
     "name": "zigbee",
-    "version": "1.8.10",
+    "version": "1.8.13",
     "news": {
+      "1.8.13": {
+        "en": "see Readme https://github.com/ioBroker/ioBroker.zigbee/blob/master/README.md",
+        "de": "see Readme https://github.com/ioBroker/ioBroker.zigbee/blob/master/README.md"
+      },
+      "1.8.12": {
+        "en": "new Documentation",
+        "de": "neue Dokumentation"
+      },
+      "1.8.11": {
+        "en": "fix exposes with composite list",
+        "de": "fix exposes with composite list"
+      },
       "1.8.10": {
         "en": "fix group access and any new functions",
         "de": "fix group access and any new functions"
@@ -36,26 +48,6 @@
         "pl": "naprawić",
         "uk": "фіксувати висадки",
         "zh-cn": "fix 暴露"
-      },
-      "1.8.6": {
-        "en": "fix exposes",
-        "de": "fix exposes"
-      },
-      "1.8.5": {
-        "en": "fix for new code",
-        "de": "fix für neuen code",
-        "ru": "исправить для нового кода",
-        "pt": "corrigir para novo código",
-        "nl": "vertaling:",
-        "fr": "correction du nouveau code",
-        "it": "correzione per nuovo codice",
-        "es": "fijar para nuevo código",
-        "pl": "naprawić nowy kod",
-        "uk": "виправити для нового коду",
-        "zh-cn": "f 新的守则的ix"
-      },
-      "1.8.4": {
-        "en": "fix for new code"
       }
     },
     "title": "Zigbee",
@@ -227,6 +219,7 @@
       "_id": "exclude.all",
       "type": "state",
       "common": {
+        "role": "state",
         "name": "all",
         "type": "string",
         "read": true,
@@ -260,6 +253,7 @@
       "_id": "info.pairingMode",
       "type": "state",
       "common": {
+        "role": "indicator",
         "name": "Pairing mode",
         "type": "boolean",
         "read": true,
@@ -272,6 +266,7 @@
       "_id": "info.pairingCountdown",
       "type": "state",
       "common": {
+        "role": "indicator",
         "name": "Pairing countdown",
         "type": "number",
         "read": true,
@@ -284,6 +279,7 @@
       "_id": "info.pairingMessage",
       "type": "state",
       "common": {
+        "role": "indicator",
         "name": "Pairing message",
         "type": "string",
         "read": true,
@@ -296,6 +292,7 @@
       "_id": "info.groups",
       "type": "state",
       "common": {
+        "role": "state",
         "name": "Groups",
         "type": "string",
         "read": true,
@@ -308,6 +305,7 @@
       "_id": "info.undefinedDevices",
       "type": "state",
       "common": {
+        "role": "state",
         "name": "Recorded undefined devices",
         "type": "string",
         "read": true,
@@ -315,6 +313,19 @@
         "def": ""
       },
       "native": {}
+    },
+    {
+      "_id": "info.debugmessages",
+      "type": "state",
+      "common": {
+        "role": "state",
+        "name": "Log changes as warnings for",
+        "type": "string",
+        "read": true,
+        "write": true,
+        "def": ""
+      },
+      "native": {}
     }
   ]
 }