Adds the RVC Operational State cluster's GoHome command (#31242)

* Added the RvcOpearationalState specific command GoHome to the XML.

* Regenerated files from XMLs.

* Regenerated files from XMLs after merging changes in master.

* Regenerated zap files.

* Added missing license to an all-clusters-app src file.

* Restyled by clang-format

---------

Co-authored-by: Restyled.io <commits@restyled.io>

examples/all-clusters-app/all-clusters-common/all-clusters-app.matter

@@ -3420,6 +3420,8 @@ cluster RvcOperationalState = 97 {
   command Start(): OperationalCommandResponse = 2;
   /** Upon receipt, the device SHALL resume its operation from the point it was at when it received the Pause command, or from the point when it was paused by means outside of this cluster (for example by manual button press). */
   command Resume(): OperationalCommandResponse = 3;
+  /** On receipt of this command, the device SHALL start seeking the charging dock, if possible in the current state of the device. */
+  command GoHome(): OperationalCommandResponse = 128;
 }
 
 /** Attributes and commands for scene configuration and manipulation. */

examples/all-clusters-app/all-clusters-common/src/air-quality-instance.cpp

@@ -1,3 +1,20 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
 #include <air-quality-instance.h>
 
 using namespace chip::app::Clusters;

examples/chef/devices/rootnode_roboticvacuumcleaner_1807ff0c49.matter

@@ -1178,6 +1178,8 @@ cluster RvcOperationalState = 97 {
   command Start(): OperationalCommandResponse = 2;
   /** Upon receipt, the device SHALL resume its operation from the point it was at when it received the Pause command, or from the point when it was paused by means outside of this cluster (for example by manual button press). */
   command Resume(): OperationalCommandResponse = 3;
+  /** On receipt of this command, the device SHALL start seeking the charging dock, if possible in the current state of the device. */
+  command GoHome(): OperationalCommandResponse = 128;
 }
 
 endpoint 0 {

examples/rvc-app/rvc-common/rvc-app.matter

@@ -1101,6 +1101,8 @@ cluster RvcOperationalState = 97 {
   command Start(): OperationalCommandResponse = 2;
   /** Upon receipt, the device SHALL resume its operation from the point it was at when it received the Pause command, or from the point when it was paused by means outside of this cluster (for example by manual button press). */
   command Resume(): OperationalCommandResponse = 3;
+  /** On receipt of this command, the device SHALL start seeking the charging dock, if possible in the current state of the device. */
+  command GoHome(): OperationalCommandResponse = 128;
 }
 
 endpoint 0 {

src/app/zap-templates/zcl/data-model/chip/operational-state-rvc-cluster.xml

@@ -81,6 +81,10 @@ both values from this cluster and from the base cluster.
       <arg name="CommandResponseState" type="ErrorStateStruct"/>
     </command>
 
+    <command source="client" code="0x80" name="GoHome" response="OperationalCommandResponse" optional="true">
+      <description>On receipt of this command, the device SHALL start seeking the charging dock, if possible in the current state of the device.</description>
+    </command>
+
     <event side="server" code="0x00" priority="critical" name="OperationalError" optional="false">
       <description>OperationalError</description>
       <field id="0" name="ErrorState" type="ErrorStateStruct" />

src/controller/data_model/controller-clusters.matter

@@ -3721,6 +3721,8 @@ cluster RvcOperationalState = 97 {
   command Start(): OperationalCommandResponse = 2;
   /** Upon receipt, the device SHALL resume its operation from the point it was at when it received the Pause command, or from the point when it was paused by means outside of this cluster (for example by manual button press). */
   command Resume(): OperationalCommandResponse = 3;
+  /** On receipt of this command, the device SHALL start seeking the charging dock, if possible in the current state of the device. */
+  command GoHome(): OperationalCommandResponse = 128;
 }
 
 /** Attributes and commands for scene configuration and manipulation. */

src/controller/java/generated/java/chip/devicecontroller/ChipClusters.java

@@ -25491,6 +25491,32 @@ public void onResponse(StructType invokeStructValue) {
         }}, commandId, value, timedInvokeTimeoutMs);
     }
 
+    public void goHome(OperationalCommandResponseCallback callback) {
+      goHome(callback, 0);
+    }
+
+    public void goHome(OperationalCommandResponseCallback callback, int timedInvokeTimeoutMs) {
+      final long commandId = 128L;
+
+      ArrayList<StructElement> elements = new ArrayList<>();
+      StructType value = new StructType(elements);
+      invoke(new InvokeCallbackImpl(callback) {
+          @Override
+          public void onResponse(StructType invokeStructValue) {
+          final long commandResponseStateFieldID = 0L;
+          ChipStructs.RvcOperationalStateClusterErrorStateStruct commandResponseState = null;
+          for (StructElement element: invokeStructValue.value()) {
+            if (element.contextTagNum() == commandResponseStateFieldID) {
+              if (element.value(BaseTLVType.class).type() == TLVType.Struct) {
+                StructType castingValue = element.value(StructType.class);
+                commandResponseState = ChipStructs.RvcOperationalStateClusterErrorStateStruct.decodeTlv(castingValue);
+              }
+            }
+          }
+          callback.onSuccess(commandResponseState);
+        }}, commandId, value, timedInvokeTimeoutMs);
+    }
+
     public interface OperationalCommandResponseCallback extends BaseClusterCallback {
       void onSuccess(ChipStructs.RvcOperationalStateClusterErrorStateStruct commandResponseState);
     }

src/controller/java/generated/java/chip/devicecontroller/ClusterIDMapping.java

@@ -8227,7 +8227,8 @@ public enum Command {
             Pause(0L),
             Stop(1L),
             Start(2L),
-            Resume(3L),;
+            Resume(3L),
+            GoHome(128L),;
             private final long id;
             Command(long id) {
                 this.id = id;

src/controller/java/generated/java/chip/devicecontroller/ClusterInfoMapping.java

@@ -22843,6 +22843,18 @@ public Map<String, Map<String, InteractionInfo>> getCommandMap() {
       );
     rvcOperationalStateClusterInteractionInfoMap.put("resume", rvcOperationalStateresumeInteractionInfo);
 
+    Map<String, CommandParameterInfo> rvcOperationalStategoHomeCommandParams = new LinkedHashMap<String, CommandParameterInfo>();
+    InteractionInfo rvcOperationalStategoHomeInteractionInfo = new InteractionInfo(
+      (cluster, callback, commandArguments) -> {
+        ((ChipClusters.RvcOperationalStateCluster) cluster)
+          .goHome((ChipClusters.RvcOperationalStateCluster.OperationalCommandResponseCallback) callback
+            );
+        },
+        () -> new DelegatedRvcOperationalStateClusterOperationalCommandResponseCallback(),
+        rvcOperationalStategoHomeCommandParams
+      );
+    rvcOperationalStateClusterInteractionInfoMap.put("goHome", rvcOperationalStategoHomeInteractionInfo);
+
     commandMap.put("rvcOperationalState", rvcOperationalStateClusterInteractionInfoMap);
 
     Map<String, InteractionInfo> scenesManagementClusterInteractionInfoMap = new LinkedHashMap<>();

src/controller/java/generated/java/matter/controller/cluster/clusters/RvcOperationalStateCluster.kt

@@ -310,6 +310,48 @@ class RvcOperationalStateCluster(
     return OperationalCommandResponse(commandResponseState_decoded)
   }
 
+  suspend fun goHome(timedInvokeTimeout: Duration? = null): OperationalCommandResponse {
+    val commandId: UInt = 128u
+
+    val tlvWriter = TlvWriter()
+    tlvWriter.startStructure(AnonymousTag)
+    tlvWriter.endStructure()
+
+    val request: InvokeRequest =
+      InvokeRequest(
+        CommandPath(endpointId, clusterId = CLUSTER_ID, commandId),
+        tlvPayload = tlvWriter.getEncoded(),
+        timedRequest = timedInvokeTimeout
+      )
+
+    val response: InvokeResponse = controller.invoke(request)
+    logger.log(Level.FINE, "Invoke command succeeded: ${response}")
+
+    val tlvReader = TlvReader(response.payload)
+    tlvReader.enterStructure(AnonymousTag)
+    val TAG_COMMAND_RESPONSE_STATE: Int = 0
+    var commandResponseState_decoded: RvcOperationalStateClusterErrorStateStruct? = null
+
+    while (!tlvReader.isEndOfContainer()) {
+      val tag = tlvReader.peekElement().tag
+
+      if (tag == ContextSpecificTag(TAG_COMMAND_RESPONSE_STATE)) {
+        commandResponseState_decoded =
+          RvcOperationalStateClusterErrorStateStruct.fromTlv(tag, tlvReader)
+      } else {
+        tlvReader.skipElement()
+      }
+    }
+
+    if (commandResponseState_decoded == null) {
+      throw IllegalStateException("commandResponseState not found in TLV")
+    }
+
+    tlvReader.exitContainer()
+
+    return OperationalCommandResponse(commandResponseState_decoded)
+  }
+
   suspend fun readPhaseListAttribute(): PhaseListAttribute {
     val ATTRIBUTE_ID: UInt = 0u