diff --git a/Commands.md b/Commands.md index 796cd57c..f58d981d 100644 --- a/Commands.md +++ b/Commands.md @@ -567,6 +567,6 @@ ZigbeePermitJoin|Sets new device pairing mode
`0 ZigbeeProbe|Probe a Zigbee device to get additional information including its IEEEaddress, vendor and model names, endpoints, and supported clusters per endpoint.
`` (e.g., `0x1234`)
A device probe is performed automatically when a new Zigbee device connects.
A probe may be needed after a Tasmota reboot.
Battery powered Zigbee devices can generally not be probed because they are in sleep mode most of the time. ZigbeeRead|Read Zigbee device attributes
`{ "Device":"", "Endpoint":"", "Cluster":"", "Read":[] }`
 `` the short address of the Zigbee device on the network.
 `` the target endpoint on the device ([identifying endpoints](Zigbee-Operation#identifying-target-device-endpoints))
 `` the cluster number of the attributes
 `` requested attributes array

Ex: `ZigbeeRead { "device":"0x69CF", "endpoint":"0x03", "cluster":"0x0006", "read":["0x0000"] }` ZigbeeReset|`1` = perform a factory reset and reconfiguration of the CC2530 chip.
**You will need to re-pair all Zigbee devices** -ZigbeeSend|`{ "Device":"", "Endpoint":"", "Send":{"":} }`
 `` the short address of the Zigbee device on the network.
 `` the target endpoint on the device ([identifying endpoints](Zigbee-Operation#identifying-target-device-endpoints))
 `"":` the actual command and parameters to send (see below)
Note: Use [`ZigbeeZCLSend`](#ZigbeeZCLSend) to send a raw form low-level message

Ex: `ZigbeeSend { "Device":"0x1234", "Endpoint":"0x03", "Send":{"Power":"on"} }` +ZigbeeSend|`{ "Device":"", "Endpoint":"", "Send":{"":} }`
 `` the short address of the Zigbee device on the network.
 `` the target endpoint on the device ([identifying endpoints](Zigbee-Operation#identifying-target-device-endpoints))
 `"":` the command and parameters to send ([Zigbee Device Commands](Zigbee-Operation#supported-zigbee-device-commands))
Note: Use [`ZigbeeZCLSend`](#ZigbeeZCLSend) to send a raw form low-level message

Ex: `ZigbeeSend { "Device":"0x1234", "Endpoint":"0x03", "Send":{"Power":"on"} }` ZigbeeStatus\|Display Zigbee devices seen on the network since boot
`` (optional) = device number (enumerated beginning with 1)
` ` = all devices
This command provides three levels of increasing detail according to ``
`ZigbeeStatus1` Display Short Address, and Friendly Name
`ZigbeeStatus2` Also include Manufacturer ID and Model ID
`ZigbeeStatus3` Also include a list of endpoints and the clusterIds supported by each endpoint
Ex: `ZigbeeStatus3 1` requests all details for device number 1

The information requested may exceed the maximum result size allowed by Tasmota. In this case, the output will be truncated. To get all of the desired information, request results for a specific device individually. ZigbeeZCLSend|:warning: :warning: :warning: **Do not use unless you know _exactly_ what you are doing.** :warning: :warning: :warning:
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.