Add ZbListen

Author: s-hadinger

docs/Commands.md

@@ -594,6 +594,7 @@ ZbConfig<a class="cmnd" id="zbconfig"></a>|display the current Zigbee configurat
 ZbConfig<a class="cmnd" id="zbconfig2"> <json\></a>|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.**<BR>`"Channel":<channel>`: Zigbee radio channel (11-26)<BR>`"PanID":<panid>`: identifier of the Zigbee Network<BR>`"ExtPanID":<extpanid>`: unique identifier of the Zigbee Network (ExtPanID features are not supported in Z2T but this parameter needs to be set)<BR>`"KeyL":<key_l>,"KeyH":<key_h>`: 128 bits encryption key, split into 2 64 bits values (Low and High)<BR>`"TXRadio":<txradio>`: radion power in dBm (1-20) only for ZBBridge<BR>All parameters are optional and only the ones specified are changed. The command always displays the complete configuration after the change<BR>Example of command: ```ZbConfig {"Channel":22,"PanID":"0x1A69","ExtPanID":"0xDDCCCCCCCCCCCCCC","KeyL":"0xFF0D0B0907050301","KeyH":"0xED0C0A0806040200"}```<BR>The following command creates a highly secure Network key based on a hardware random generator:<BR>```ZbConfig {"KeyL":"","KeyH":""}```
 ZbForget<a class="cmnd" id="zbforget"></a>|Used for devices that are unused but still visible in `ZbStatus`<BR>`<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<a class="cmnd" id="zblight"></a>|Sets or reads the light type to be emulated in Zigbee Hue Emulation with Alexa.<BR>`<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)<BR>`<device>,-1` removes the device from Philips Hue emulation<BR>`<device>` displays the current status of the Light (Zigbee2Tasmota tracks all changes to the light)
+ZbListen<x> <group>|(EZSP ZBBridge only)Listens to a multicast group address. By default EZSP will not report group messages unless you subscribe to the group.<BR>`<x>`: slot in the array of group addresses, 1..15<BR>`<group>`: group address to listen to, 0..0xFFFF<BR>At start-up, Z2T automatically listns to groupe 0 in slot 0.<BR>CC2530 does not need this command and always report all group messages.
 ZbName<a class="cmnd" id="zbname"></a>|Sets or reads the Zigbee device friendly name (up to 32 characters).<BR>`<device>,<name>` sets the new friendly name<BR>`<device>,` (empty name) clears the friendly name<BR>`<device>` displays the current friendly name<BR>Also see [`SetOption83 1`](#setoption83) to enable friendly names as JSON keys instead of ShortAddr.
 ZbPermitJoin<a class="cmnd" id="zbpermitjoin"></a>|Sets pairing mode for new device discovery<BR>`0` = disable pairing mode<BR>`1` = enable pairing mode for 60 seconds<BR>`99` = enable pairing until device reboots (CC2530 only)<BR>:rotating_light: Leaving Zigbee network open to join will allow any Zigbee device to connect and retrieve your network encryption key. This can lead to a compromise of your Zigbee network.
 ZbPing<a class="cmnd" id="zbping"></a>|`<device>` = test availability of Zigbee device. If the device is connected and not sleeping, you should receive a `ZbPing` message within the next second.<BR>Example: `ZbPing 0x5ADF` responds with:<br> `{"ZbPing":{"Device":"0x5ADF","IEEEAddr":"0x90FD9FFFFE03B051"}}`