Zigbee Commands: различия между версиями

Материал из noname.com.ua
Перейти к навигацииПерейти к поиску
()
 
(не показано 15 промежуточных версий этого же участника)
Строка 2: Строка 2:
 
=Zigbee commands=
 
=Zigbee commands=
 
Это заметки по "умному дому" и командам
 
Это заметки по "умному дому" и командам
  +
* https://tasmota.github.io/docs/Commands/#zigbee
 
 
=commands=
 
=commands=
 
==<code><device></code>==
 
==<code><device></code>==
Строка 93: Строка 93:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code>ZbEnroll</code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 207: Строка 207:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbForget </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 214: Строка 214:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbForget </code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 225: Строка 225:
 
|}
 
|}
   
 
==<code> ZbLight </code>==
 
==<code></code>==
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 233: Строка 232:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbLight </code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 245: Строка 244:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbListen </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 252: Строка 251:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbListen </code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 265: Строка 264:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbLeave </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 272: Строка 271:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbLeave </code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 282: Строка 281:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbLoad </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 289: Строка 288:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbLoad </code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 298: Строка 297:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbLoadDump </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 305: Строка 304:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbLoadDump </code>
 
|
 
|
 
Текст ячейки
 
Текст ячейки
Строка 314: Строка 313:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbInfo </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 338: Строка 337:
 
|}
 
|}
   
  +
<PRE>
==<code></code>==
 
  +
{
  +
"ZbInfo": {
  +
"0xFD6A": {
  +
"Device": "0xFD6A",
  +
"IEEEAddr": "0xA4C1383B5B9AEDF9",
  +
"ModelId": "TS011F",
  +
"Manufacturer": "_TZ3000_2putqrmw",
  +
"Endpoints": [
  +
1,
  +
242
  +
],
  +
"Config": [
  +
"O01",
  +
"P01"
  +
],
  +
"Power": 1,
  +
"RMSVoltage": 219,
  +
"ActivePower": 0,
  +
"Reachable": true,
  +
"LastSeen": 25,
  +
"LastSeenEpoch": 1715873949,
  +
"LinkQuality": 193
  +
}
  +
}
  +
}
  +
</PRE>
  +
 
==<code> ZbMap </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 363: Строка 390:
 
|}
 
|}
   
==<code></code>==
+
==<code> ZbName </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 372: Строка 399:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbName </code>
 
|
 
|
  +
Sets or reads the Zigbee device friendly name (up to 32 characters).
Текст ячейки
 
  +
* <device>,<name> sets the new friendly name
  +
* <device>, (empty name) clears the friendly name
  +
* <device> displays the current friendly name
  +
Also see SetOption83 1 to enable friendly names as JSON keys instead of ShortAddr.
  +
 
|
 
|
  +
<code>zbName 0xFD6A,nous-a1z-testing</code>
 
<PRE>
 
<PRE>
  +
17:11:31.218 CMD: zbName 0xFD6A,nous-a1z-testing
  +
17:11:31.219 SRC: WebConsole from 192.168.22.108
  +
17:11:31.221 CMD: Grp 0, Cmd 'ZBNAME', Idx 1, Len 23, Pld 64874, Data '0xFD6A,nous-a1z-testing'
  +
17:11:31.230 MQT: stat/tasmota_3281FC/RESULT = {"0xFD6A":{"Name":"nous-a1z-testing"}}
  +
17:11:33.275 ZIG: Zigbee Devices Data saved in File System (65 bytes)
 
</PRE>
 
</PRE>
  +
после чего мне бридж показывает "красивое" имя
 
|}
 
|}
   
==<code> </code>==
+
==<code>ZbNameKey SetOption83 </code>==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Файлы
 
|+ Файлы
Строка 388: Строка 427:
 
|-
 
|-
 
|
 
|
<code> </code>
+
<code> ZbNameKey SetOption83</code>
 
|
 
|
  +
ZbNameKey
Текст ячейки
 
  +
SetOption83 Uses Zigbee device friendly name instead of 16 bits short addresses as JSON key when reporting values and commands
  +
0 = JSON key as short address
  +
1 = JSON key as friendly name
  +
See ZbName <device>,<name>
 
|
 
|
 
<PRE>
 
<PRE>

Текущая версия на 13:54, 18 мая 2024

Zigbee commands

Это заметки по "умному дому" и командам

commands

<device>

Как работает эта мне пока не ясно

Файлы
Команда Описание Пример использования

<device>

As <device> in following commands you can use interchangeably: <shortaddr> = short address of the Zigbee device on the network, example: 0x1234 <longaddr> = permanent IEEE address of the Zigbee device (64 bits), example: 0x00158D00041160C5 <index> = number of the device in the internal list (starts at 1), ideal for enumerating devices, example: 3 for third device in the list <name> = friendly name. Only when previously set with ZbName


ZbBindState

Файлы
Команда Описание Пример использования

ZbBindState

Asks the device for its internal binding states

  • <device> the device to query

или

  • <n> the start index for the request, 1 is the default. This is used to scan through all bindings.

ZbBindState 1

16:20:52.118 CMD: ZbBindState 1
16:20:52.121 SRC: WebConsole from 192.168.22.108
16:20:52.122 CMD: Grp 0, Cmd 'ZBBINDSTATE', Idx 1, Len 1, Pld 1, Data '1'
16:20:52.126 ZIG: ZbZNPSent 25336AFD00
16:20:52.133 MQT: stat/tasmota_3281FC/RESULT = {"ZbBindState":"Done"}
16:20:52.159 ZIG: {"ZbZNPReceived":"653300"}
16:20:52.195 ZIG: {"ZbZNPReceived":"45B36AFD00020002F9ED9A5B3B38C1A4010600037884B626004B120001F9ED9A5B3B38C1A401040B037884B626004B120001"}
16:20:52.202 MQT: tele/tasmota_3281FC/RESULT = {"ZbBindState":{"Device":"0xFD6A","Status":0,"StatusMessage":"SUCCESS","Total":2,"Start":1,"Bindings":[{"Cluster":"0x0006","Endpoint":1,"ToDevice":"0x00124B0026B68478","ToEndpoint":1},{"Cluster":"0x0B04","Endpoint":1,"ToDevice":"0x00124B0026B68478","ToEndpoint":1}]}}

zbBindState 0xFD6A

16:26:39.630 CMD: zbBindState 0xFD6A
16:26:39.632 SRC: WebConsole from 192.168.22.108
16:26:39.635 CMD: Grp 0, Cmd 'ZBBINDSTATE', Idx 1, Len 6, Pld 64874, Data '0xFD6A'
16:26:39.638 ZIG: ZbZNPSent 25336AFD00
16:26:39.644 MQT: stat/tasmota_3281FC/RESULT = {"ZbBindState":"Done"}
16:26:39.678 ZIG: {"ZbZNPReceived":"653300"}
16:26:39.724 ZIG: {"ZbZNPReceived":"45C46AFD00"}
16:26:39.775 ZIG: {"ZbZNPReceived":"45B36AFD00020002F9ED9A5B3B38C1A4010600037884B626004B120001F9ED9A5B3B38C1A401040B037884B626004B120001"}
16:26:39.783 MQT: tele/tasmota_3281FC/RESULT = {"ZbBindState":{"Device":"0xFD6A","Status":0,"StatusMessage":"SUCCESS","Total":2,"Start":1,"Bindings":[{"Cluster":"0x0006","Endpoint":1,"ToDevice":"0x00124B0026B68478","ToEndpoint":1},{"Cluster":"0x0B04","Endpoint":1,"ToDevice":"0x00124B0026B68478","ToEndpoint":1}]}}

ZbCIE

Файлы
Команда Описание Пример использования

Текст ячейки

ZbCIE	Configure on the ZigBee device the CIE address using the IEEE address of the ZigBee Bridge. The ZigBee Bridge will act as the CIE device for the ZigBee Network. See IAS Cluster in the ZigBee specification for more information.
Usage: ZbCIE <device>,<endpoint>
<device> is the ZigBee device to configure
<endpoint> is the endpoint in the ZigBee device where the IAS Cluster is.
Example: ZbCIE 1,44

ZbEnroll

Файлы
Команда Описание Пример использования

ZbEnroll

Текст ячейки

	Enroll the the ZigBee device to the ZigBee Bridge for reporting security sensors data, panels, etc. The ZigBee Bridge will act as the CIE device for the ZigBee Network.
Usage: ZbEnroll <device>,<endpoint>
<device> is the ZigBee device to configure
<endpoint> is the endpoint in the ZigBee device where the IAS Cluster is.
Example: ZbEnroll 1,44

ZbConfig

Файлы
Команда Описание Пример использования

Текст ячейки

Display the current Zigbee configuration
Example of result: {"ZbConfig":{"Channel":11,"PanID":"0x1A63","ExtPanID":"0xCCCCCCCCCCCCCCCC","KeyL":"0x0F0D0B0907050301","KeyH":"0x0D0C0A0806040200"}}

ZbConfig

Файлы
Команда Описание Пример использования

ZbConfig <json>

Текст ячейки

ZbConfig <json>	change the configuration and restart if any change was applied. Warning: change in configuration causes a reset of the CC2530/ZBBridge and requires devices to be re-paired.
"Channel":<channel>: Zigbee radio channel (11-26)
"PanID":<panid>: identifier of the Zigbee Network
"ExtPanID":<extpanid>: unique identifier of the Zigbee Network (ExtPanID features are not supported in Z2T but this parameter needs to be set)
"KeyL":<key_l>,"KeyH":<key_h>: 128 bits encryption key, split into 2 64 bits values (Low and High)
"TXRadio":<txradio>: radio power in dBm (1-20) only for ZBBridge
All parameters are optional and only the ones specified are changed. The command always displays the complete configuration after the change
Example of command: ZbConfig {"Channel":22,"PanID":"0x1A69","ExtPanID":"0xDDCCCCCCCCCCCCCC","KeyL":"0xFF0D0B0907050301","KeyH":"0xED0C0A0806040200"}
The following command creates a highly secure Network key based on a hardware random generator:
ZbConfig {"KeyL":"","KeyH":""}

ZbDeviceTopic

Файлы
Команда Описание Пример использования

ZbDeviceTopic

Текст ячейки

ZbDeviceTopic
SetOption89	Configure MQTT topic for Zigbee devices (also see SensorRetain)
0 = single tele/%topic%/SENSOR topic (default)
1 = unique device topic based on Zigbee device ShortAddr
Example: tele/Zigbee/5ADF/SENSOR = {"ZbReceived":{"0x5ADF":{"Dimmer":254,"Endpoint":1,"LinkQuality":70}}}

ZbEndpointSuffix

Файлы
Команда Описание Пример использования

ZbEndpointSuffix

Текст ячейки

ZbEndpointSuffix
SetOption101	Add Zigbee source endpoint as suffix to attributes
0 = disable (default)
1 = enable
e.g. Power3 instead of Power if sent from endpoint 3

ZbEndpointTopic

Файлы
Команда Описание Пример использования

ZbEndpointTopic

Текст ячейки

ZbEndpointTopic
SetOption120	Add the Zigbee endpoint as suffix in topic when using SetOption89 1
0 = disable (default)
1 = enable

ZbForget

Файлы
Команда Описание Пример использования

ZbForget

Текст ячейки

ZbForget	Used for devices that are unused but still visible in ZbStatus
<device> = Remove a device from the Tasmota flash memory. It does not un-pair the device nor deleting the device information in the CC2530/ZBBridge.

ZbLight

Файлы
Команда Описание Пример использования

ZbLight

Текст ячейки

ZbLight	Sets or reads the light type to be emulated in Zigbee Hue Emulation with Alexa.
<device>,<light_type> sets the light type using an integer 0..5 corresponding to the number of channels (from one channel (on/off) to 5 channel (RGBCCT) lights)
<device>,-1 removes the device from Philips Hue emulation
<device> displays the current status of the Light (Zigbee2Tasmota tracks all changes to the light)

ZbListen

Файлы
Команда Описание Пример использования

ZbListen

Текст ячейки

ZbListen	(EZSP ZBBridge only)Listens to a multicast group address. By default EZSP will not report group messages unless you subscribe to the group.
<x>: slot in the array of group addresses, 1..15
<group>: group address to listen to, 0..0xFFFF
At start-up, Z2T automatically listens to group 0 in slot 0.
CC2530 does not need this command and always report all group messages

ZbLeave

Файлы
Команда Описание Пример использования

ZbLeave

Текст ячейки

ZbLeave	<device> = request a device to leave the network.
If the device is offline or sleeping, this will have no effect. It is not 100% guaranteed that the device will never connect again

ZbLoad

Файлы
Команда Описание Пример использования

ZbLoad

Текст ячейки

ZbLoad	<file>.zb = load Zigbee definition file

ZbLoadDump

Файлы
Команда Описание Пример использования

ZbLoadDump

Текст ячейки

ZbLoadDump	<file>.zb = dump Zigbee definition file contents to console

ZbInfo

Файлы
Команда Описание Пример использования

ZbInfo <device>

display all information known about a device, equivalent to ZbStatus3 with a simpler JSON output

ZbInfo 0xFD6A Пример для "умной" розетки


16:39:34.428 CMD:  ZbInfo 0xFD6A
16:39:34.430 SRC: WebConsole from 192.168.22.108
16:39:34.432 CMD: Grp 0, Cmd 'ZBINFO', Idx 1, Len 6, Pld 64874, Data '0xFD6A'
16:39:34.447 MQT: tele/tasmota_3281FC/SENSOR = {"ZbInfo":{"0xFD6A":{"Device":"0xFD6A","IEEEAddr":"0xA4C1383B5B9AEDF9","ModelId":"TS011F","Manufacturer":"_TZ3000_2putqrmw","Endpoints":[1,242],"Config":["O01","P01"],"Power":1,"RMSVoltage":219,"ActivePower":0,"Reachable":true,"LastSeen":25,"LastSeenEpoch":1715873949,"LinkQuality":193}}}
16:39:34.458 MQT: stat/tasmota_3281FC/RESULT = {"ZbInfo":"Done"}
16:39:45.509 WIF: Checking connection...
{
  "ZbInfo": {
    "0xFD6A": {
      "Device": "0xFD6A",
      "IEEEAddr": "0xA4C1383B5B9AEDF9",
      "ModelId": "TS011F",
      "Manufacturer": "_TZ3000_2putqrmw",
      "Endpoints": [
        1,
        242
      ],
      "Config": [
        "O01",
        "P01"
      ],
      "Power": 1,
      "RMSVoltage": 219,
      "ActivePower": 0,
      "Reachable": true,
      "LastSeen": 25,
      "LastSeenEpoch": 1715873949,
      "LinkQuality": 193
    }
  }
}

ZbMap

Файлы
Команда Описание Пример использования

ZbMap

Asks the device for its view of the Zigbee topology <device> the device to query <n> the start index for the request, 1 is the default. This is used to scan through all values since devices usually return only 3 values per request.

16:43:07.110 CMD: ZbMap 1
16:43:07.112 SRC: WebConsole from 192.168.22.108
16:43:07.114 CMD: Grp 0, Cmd 'ZBMAP', Idx 1, Len 1, Pld 1, Data '1'
16:43:07.117 ZIG: ZbZNPSent 25316AFD00
16:43:07.124 MQT: stat/tasmota_3281FC/RESULT = {"ZbMap":"Done"}
16:43:07.153 ZIG: {"ZbZNPReceived":"653100"}
16:43:07.192 ZIG: {"ZbZNPReceived":"45B16AFD000100010CDC7E32CCCCCCCC7884B626004B12000000040200B0"}
16:43:07.198 MQT: tele/tasmota_3281FC/RESULT = {"ZbMap":{"Device":"0xFD6A","Status":0,"StatusMessage":"SUCCESS","Total":1,"Start":1,"Map":[{"Device":"0x0000","DeviceType":"Coordinator","RxOnWhenIdle":true,"Relationship":"Parent","PermitJoin":null,"Depth":0,"LinkQuality":176}]}}

ZbName

Файлы
Команда Описание Пример использования


ZbName

Sets or reads the Zigbee device friendly name (up to 32 characters).

  • <device>,<name> sets the new friendly name
  • <device>, (empty name) clears the friendly name
  • <device> displays the current friendly name

Also see SetOption83 1 to enable friendly names as JSON keys instead of ShortAddr.

zbName 0xFD6A,nous-a1z-testing

17:11:31.218 CMD: zbName 0xFD6A,nous-a1z-testing
17:11:31.219 SRC: WebConsole from 192.168.22.108
17:11:31.221 CMD: Grp 0, Cmd 'ZBNAME', Idx 1, Len 23, Pld 64874, Data '0xFD6A,nous-a1z-testing'
17:11:31.230 MQT: stat/tasmota_3281FC/RESULT = {"0xFD6A":{"Name":"nous-a1z-testing"}}
17:11:33.275 ZIG: Zigbee Devices Data saved in File System (65 bytes)

после чего мне бридж показывает "красивое" имя

ZbNameKey SetOption83

Файлы
Команда Описание Пример использования

ZbNameKey SetOption83

ZbNameKey SetOption83 Uses Zigbee device friendly name instead of 16 bits short addresses as JSON key when reporting values and commands 0 = JSON key as short address 1 = JSON key as friendly name See ZbName <device>,<name>


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки


Файлы
Команда Описание Пример использования

Текст ячейки