From b19b31ea5ee190799714575c92ca257b96a853fd Mon Sep 17 00:00:00 2001
From: Michael Ingraham <34340210+meingraham@users.noreply.github.com>
Date: Wed, 6 Nov 2019 17:41:20 -0500
Subject: [PATCH] Zigbee
---
Commands.md | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/Commands.md b/Commands.md
index aad3952c..9099750e 100644
--- a/Commands.md
+++ b/Commands.md
@@ -18,6 +18,7 @@
- [Displays](#displays)
- [Stepper Motors](#stepper-motors)
- [Blinds, Shutters and Roller Shades](#blinds-shutters-and-roller-shades)
+- [Zigbee](#zigbee)
Tasmota provides three powerful man machine interfaces:
**MQTT**, **web** and **serial**.
@@ -556,3 +557,13 @@ ShutterSetClose\|Set the shutter closed position.
ShutterSetHalfway\| `0..100` *(default = `50`)*
Define shutter half open position (in percent)
ShutterStop\|Disengage the relays to stop the shutter
See also| [`SetOption80`](#SetOption80) - Enable shutter support
+
+### [Zigbee](Zigbee)
+ยป v7.0.0.3
+
+Command|Parameters
+-|-
+ZigbeePermitJoin|Enables or disables pairing of new devices, see below.
`ZigbeePermitjoin 1` enables pairing for 60 seconds
`ZigbeePermitJoin 99` enables pairing until next boot
`ZigbeePermitJoin 0` disables pairing
+ZigbeeReset|Does a factory reset and reconfiguration of the CC2530. Warning: you will need to re-pair all Zigbee devices
Ex: `ZigbeeReset 1`
+ZigbeeStatus|Shows data collected from connected Zigbee devices, see examples below.
`ZigbeeStatus` shows the list of all Zigbee devices seen on the network until last boot, with their short address and friendly name.
`ZigbeeStatus 1` adds Manufacturer ID and Model ID of each devices
`ZigbeeStatus 2` adds list of endpoints of each device and the clusterIds supported in each endpoint.
Ex: ```{"ZigbeeStatus":{"Status":1,"Message":"CC2530 booted","RestartReason":"Watchdog","MajorRel":2,"MinorRel":6}}```
`Status` contains a numeric code about the status message- `0`: initialization complete, **Z2T is running normally**
- `1`: booting
- `2`: resetting CC2530 configuration
- `3`: starting Zigbee coordinator
- `20`: disabling Permit Join
- `21`: allowing Permit Join for 60 seconds
- `22`: allowing Permit Join until next boot
- `30`: Zigbee device connects or reconnects
- `31`: Received Node Descriptor information for a Zigbee device
- `32`: Received the list of active endpoints for a Zigbee device
- `33`: Received the simple Descriptor with active ZCL clusters for a Zigbee device
- `50`: reporting CC2530 firmware version
- `51`: reporting CC2530 device information and associated devices
- `98`: error, unsupported CC2530 firmware
- `99`: general error, **Z2T was unable to start**
`Message` (optional) a human-readable messageother fields depending on the message (e.g., Status=`50` or Status=`51`)
+ZigbeeZCLSend|Send a raw ZCL message to a Zigbee device. This is a low-level command, and requires to manually build the ZCL parameters. Most common usage will be provided as high-level functions.