Add group membership command

[glentakahashi]

From docs at http://www.zigbee.org/wp-content/uploads/2014/11/docs-07-5123-04-zigbee-cluster-library-specification.pdf section 3.6.2.3.3.2, sending the getMembership command with groupcount = 0 and grouplist = [] returns all the groups a device is a part of.

This worked against the Sengled element classic E11-G13 lights I had in my network, but I don't have any other devices to test against.

Example of using the command:

zigbee2mqtt:info 2019-2-10 04:43:26 Zigbee publish to device '0xb0ce18140316d859', genGroups - getMembership - {"groupcount":0,"grouplist":[]} - null - null
zigbee2mqtt:info 2019-2-10 04:43:27 0xb0ce18140316d859 is in groups [1] and its remaining group capacity is unknown
zigbee2mqtt:info 2019-2-10 04:43:37 Zigbee publish to device '0xb0ce18140316d859', genGroups - add - {"groupid":"2","groupname":""} - null - null
zigbee2mqtt:info 2019-2-10 04:43:37 Successfully add 0xb0ce18140316d859 to office_lights
zigbee2mqtt:info 2019-2-10 04:43:45 Zigbee publish to device '0xb0ce18140316d859', genGroups - getMembership - {"groupcount":0,"grouplist":[]} - null - null
zigbee2mqtt:info 2019-2-10 04:43:45 0xb0ce18140316d859 is in groups [1,2] and its remaining group capacity is unknown
zigbee2mqtt:info 2019-2-10 04:43:54 Zigbee publish to device '0xb0ce18140316d859', genGroups - remove - {"groupid":"2"} - null - null
zigbee2mqtt:info 2019-2-10 04:43:54 Successfully remove 0xb0ce18140316d859 to office_lights
zigbee2mqtt:info 2019-2-10 04:43:57 Zigbee publish to device '0xb0ce18140316d859', genGroups - getMembership - {"groupcount":0,"grouplist":[]} - null - null
zigbee2mqtt:info 2019-2-10 04:43:57 0xb0ce18140316d859 is in groups [1] and its remaining group capacity is unknown

n.b. reading https://www.nxp.com/docs/en/user-guide/JN-UG-3077.pdf says that 255 means group capacity is unknown, 254 means that there is space for at least 1 more group but how many more is unknown.

u8Capacity is the capacity of the device’s Group table to receive more groups -
that is, the number of groups that may be added (special values: 0xFE means
at least one more group may be added, a higher value means that the table’s
remaining capacity is unknown)

[Koenkk]

Great, I would like to request one minor change. Could you also post the results to the following MQTT topic? zigbee2mqtt/bridge/group/[friendly_name]?

[glentakahashi]

To clarify, that’s the friendly name of the device? And the payload would contain capacity and group list?

…

On Sun, Feb 10, 2019 at 13:43 Koen Kanters ***@***.***> wrote: Great, I would like to request one minor change. Could you also post the results to the following MQTT topic? zigbee2mqtt/bridge/group/[friendly_name]? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#1056 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AA-bL4CJTpO37i9X6F2wPGs-ve8oS6SUks5vMGhqgaJpZM4ay4SM> .

[Koenkk]

After thinking more about this, I think this makes more sense:

To request:
topic: zigbee2mqtt/bridge/device/[DEVICE_FRIENDLY_NAME]/get_group_membership
payload: `` (emtpy)

The results are then send to zigbee2mqtt/[DEVICE_FRIENDLY_NAME] (just use the publishDeviceState with cache: false.

[glentakahashi]

Perfect, I’ll update me PR accordingly

…

On Sun, Feb 10, 2019 at 14:50 Koen Kanters ***@***.***> wrote: After thinking more about this, I think this makes more sense: To request: topic: zigbee2mqtt/bridge/device/[DEVICE_FRIENDLY_NAME]/get_group_membership payload: `` (emtpy) The results are then send to zigbee2mqtt/[DEVICE_FRIENDLY_NAME] (just use the publishDeviceState with cache: false. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#1056 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AA-bLwMgRBeVj5fNvIRduf3_q8O3pO_Nks5vMHgSgaJpZM4ay4SM> .

[glentakahashi]

@Koenkk updated! Let me know if that's what you want published to the MQTT topic.

[Koenkk]

Perfect!