mode-select-cluster.xml

<?xml version="1.0"?>
<!--
Copyright (c) 2021 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.
-->
<configurator>
  <domain name="CHIP"/>

  <struct name="SemanticTagStruct">
    <cluster code="0x0050"/>
    <item name="MfgCode" type="vendor_id" optional="false"/>
    <item name="Value"   type="enum16"    optional="false"/>
  </struct>

  <struct name="ModeOptionStruct">
    <cluster code="0x0050"/>
    <item name="Label"        type="char_string"                     length="64" optional="false"/>
    <item name="Mode"         type="int8u"                                       optional="false"/>
    <item name="SemanticTags" type="SemanticTagStruct" array="true"  length="64" optional="false"/>
  </struct>

  <cluster>
    <domain>General</domain>
    <name>Mode Select</name>
    <code>0x0050</code>
    <define>MODE_SELECT_CLUSTER</define>
    <client init="false" tick="false">true</client>
    <server init="false" tick="false">true</server>

    <globalAttribute side="either" code="0xFFFD" value="2"/>

    <features>
      <feature bit="0" code="DEPONOFF" name="OnOff" summary="Dependency with the OnOff cluster">
        <optionalConform/>
      </feature>
    </features>

    <description>Attributes and commands for selecting a mode from a list of supported options.</description>
    <!-- Base data types -->
    <attribute side="server" code="0x0000" name="Description" define="MODE_DESCRIPTION" type="char_string" length="64">
      <mandatoryConform/>
    </attribute>
    <attribute side="server" code="0x0001" name="StandardNamespace" define="STANDARD_NAMESPACE" type="enum16" isNullable="true">
      <mandatoryConform/>
    </attribute>
    <attribute side="server" code="0x0002" name="SupportedModes" define="SUPPORTED_MODES" type="array" entryType="ModeOptionStruct" length="255">
      <mandatoryConform/>
    </attribute>
    <attribute side="server" code="0x0003" name="CurrentMode" define="CURRENT_MODE" type="int8u" reportable="true">
      <mandatoryConform/>
    </attribute>
    <attribute side="server" code="0x0004" name="StartUpMode" define="START_UP_MODE" type="int8u" writable="true" optional="true" isNullable="true">
      <optionalConform/>
    </attribute>
    <attribute side="server" code="0x0005" name="OnMode" define="ON_MODE" type="int8u" writable="true" optional="true" isNullable="true">
      <mandatoryConform>
        <feature name="DEPONOFF"/>
      </mandatoryConform>
    </attribute>
    <!-- Test Commands -->
    <command source="client" code="0x00" name="ChangeToMode" optional="false">
      <description>
        On receipt of this command, if the NewMode field matches the Mode field in an entry of the SupportedModes list, the server SHALL set the CurrentMode attribute to the NewMode value, otherwise, the server SHALL respond with an INVALID_COMMAND status response.
      </description>
      <arg name="NewMode" type="int8u" />
      <mandatoryConform/>
    </command>

  </cluster>


</configurator>