closure cluster grouped commands implementation (project-chip#72825)

* closure control and dimension changes

* adding groupcast to closure example

* adding groupcast gn arg for closure

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* enable access feature in closure example

* remvong access feature

* PR comments

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: sabollim-silabs

examples/closure-app/closure-common/closure-app.matter

@@ -1969,6 +1969,116 @@ cluster IcdManagement = 70 {
   command StayActiveRequest(StayActiveRequestRequest): StayActiveResponse = 3;
 }
 
+/** The Groupcast cluster manages the content of the node-wide multicast Group membership that is part of the underlying interaction layer. */
+provisional cluster Groupcast = 101 {
+  revision 1;
+
+  enum GroupcastTestResultEnum : enum8 {
+    kSuccess = 0;
+    kGeneralError = 1;
+    kMessageReplay = 2;
+    kFailedAuth = 3;
+    kNoAvailableKey = 4;
+    kSendFailure = 5;
+  }
+
+  enum GroupcastTestingEnum : enum8 {
+    kDisableTesting = 0;
+    kEnableListenerTesting = 1;
+    kEnableSenderTesting = 2;
+  }
+
+  enum MulticastAddrPolicyEnum : enum8 {
+    kIanaAddr = 0;
+    kPerGroup = 1;
+  }
+
+  bitmap Feature : bitmap32 {
+    kListener = 0x1;
+    kSender = 0x2;
+    kPerGroup = 0x4;
+  }
+
+  fabric_scoped struct MembershipStruct {
+    group_id groupID = 0;
+    optional endpoint_no endpoints[] = 1;
+    fabric_sensitive int16u keySetID = 2;
+    optional boolean hasAuxiliaryACL = 3;
+    MulticastAddrPolicyEnum mcastAddrPolicy = 4;
+    fabric_idx fabricIndex = 254;
+  }
+
+  provisional fabric_sensitive info event access(read: administer) GroupcastTesting = 0 {
+    optional octet_string sourceIpAddress = 0;
+    optional octet_string destinationIpAddress = 1;
+    optional group_id groupID = 2;
+    optional endpoint_no endpointID = 3;
+    optional cluster_id clusterID = 4;
+    optional int32u elementID = 5;
+    optional boolean accessAllowed = 6;
+    GroupcastTestResultEnum groupcastTestResult = 7;
+    fabric_idx fabricIndex = 254;
+  }
+
+  provisional readonly attribute MembershipStruct membership[] = 0;
+  provisional readonly attribute int16u maxMembershipCount = 1;
+  provisional readonly attribute int16u maxMcastAddrCount = 2;
+  provisional readonly attribute int16u usedMcastAddrCount = 3;
+  provisional readonly attribute fabric_idx fabricUnderTest = 4;
+  readonly attribute command_id generatedCommandList[] = 65528;
+  readonly attribute command_id acceptedCommandList[] = 65529;
+  readonly attribute attrib_id attributeList[] = 65531;
+  readonly attribute bitmap32 featureMap = 65532;
+  readonly attribute int16u clusterRevision = 65533;
+
+  request struct JoinGroupRequest {
+    group_id groupID = 0;
+    endpoint_no endpoints[] = 1;
+    int16u keySetID = 2;
+    optional octet_string<16> key = 3;
+    optional boolean useAuxiliaryACL = 4;
+    optional boolean replaceEndpoints = 5;
+    optional MulticastAddrPolicyEnum mcastAddrPolicy = 6;
+  }
+
+  request struct LeaveGroupRequest {
+    group_id groupID = 0;
+    optional endpoint_no endpoints[] = 1;
+  }
+
+  response struct LeaveGroupResponse = 2 {
+    group_id groupID = 0;
+    endpoint_no endpoints[] = 1;
+  }
+
+  request struct UpdateGroupKeyRequest {
+    group_id groupID = 0;
+    int16u keySetID = 1;
+    optional octet_string<16> key = 2;
+  }
+
+  request struct ConfigureAuxiliaryACLRequest {
+    group_id groupID = 0;
+    boolean useAuxiliaryACL = 1;
+  }
+
+  request struct GroupcastTestingRequest {
+    GroupcastTestingEnum testOperation = 0;
+    optional int16u durationSeconds = 1;
+  }
+
+  /** This command SHALL be used to instruct the server to join a multicast group. */
+  fabric command access(invoke: manage) JoinGroup(JoinGroupRequest): DefaultSuccess = 0;
+  /** This command SHALL allow a maintainer to request that the server withdraws itself or specific endpoints from a specific group or from all groups of this client's fabric. */
+  fabric command access(invoke: manage) LeaveGroup(LeaveGroupRequest): LeaveGroupResponse = 1;
+  /** This command SHALL allow a fabric administrator to update the OperationalGroupKey associated with the existing group identified by GroupID, which is already joined. */
+  fabric command access(invoke: manage) UpdateGroupKey(UpdateGroupKeyRequest): DefaultSuccess = 3;
+  /** This command SHALL allow an Administrator to enable or disable the generation of AuxiliaryACL entries in the Access Control Cluster based on the groups joined (see Groupcast Auxiliary ACL Handling). */
+  fabric command access(invoke: administer) ConfigureAuxiliaryACL(ConfigureAuxiliaryACLRequest): DefaultSuccess = 4;
+  /** This command SHALL allow an Administrator to configure test modes that allow validation of Groupcast communication. */
+  fabric command access(invoke: administer) GroupcastTesting(GroupcastTestingRequest): DefaultSuccess = 5;
+}
+
 /** This cluster provides an interface for controlling a Closure. */
 cluster ClosureControl = 260 {
   revision 2;
@@ -2566,6 +2676,26 @@ endpoint 0 {
     callback attribute featureMap;
     callback attribute clusterRevision;
   }
+
+  server cluster Groupcast {
+    emits event GroupcastTesting;
+    callback attribute membership;
+    callback attribute maxMembershipCount;
+    callback attribute maxMcastAddrCount;
+    callback attribute usedMcastAddrCount;
+    callback attribute fabricUnderTest;
+    callback attribute generatedCommandList;
+    callback attribute acceptedCommandList;
+    callback attribute attributeList;
+    ram      attribute featureMap default = 1;
+    callback attribute clusterRevision default = 1;
+
+    handle command JoinGroup;
+    handle command LeaveGroup;
+    handle command UpdateGroupKey;
+    handle command ConfigureAuxiliaryACL;
+    handle command GroupcastTesting;
+  }
 }
 endpoint 1 {
   device type ma_closure = 560, version 1;
@@ -2654,6 +2784,8 @@ endpoint 2 {
 
     handle command SetTarget;
     handle command Step;
+    handle command GroupedSetTarget;
+    handle command GroupedStep;
   }
 }
 endpoint 3 {
@@ -2692,6 +2824,8 @@ endpoint 3 {
 
     handle command SetTarget;
     handle command Step;
+    handle command GroupedSetTarget;
+    handle command GroupedStep;
   }
 }