Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 9286064

Browse files
committedMar 4, 2025
1 parent 9226e6c commit 9286064

9 files changed

+103
-61
lines changed
 

‎src/app/zap-templates/zcl/data-model/chip/camera-av-settings-user-level-management-cluster.xml

+8-8
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0"?>
22
<!--
3-
Copyright (c) 2024 Project CHIP Authors
3+
Copyright (c) 2024-2025 Project CHIP Authors
44
55
Licensed under the Apache License, Version 2.0 (the "License");
66
you may not use this file except in compliance with the License.
@@ -16,9 +16,9 @@ limitations under the License.
1616
-->
1717
<!--
1818
XML generated by Alchemy; DO NOT EDIT.
19-
Source: src\app_clusters\CameraAVSettingsUserLevelManagement.adoc
20-
Parameters:
21-
Git: 1.4-444-g6d595e737
19+
Source: src/app_clusters/CameraAVSettingsUserLevelManagement.adoc
20+
Parameters: in-progress
21+
Git: 0.7-summer-2025-1-ge4654a5ef
2222
-->
2323
<configurator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../zcl.xsd">
2424
<domain name="Cameras"/>
@@ -33,7 +33,7 @@ Git: 1.4-444-g6d595e737
3333
<cluster code="0x0552"/>
3434
<item fieldId="0" name="Pan" type="int16s" optional="true" default="0" min="-180" max="180"/>
3535
<item fieldId="1" name="Tilt" type="int16s" optional="true" default="0" min="-180" max="180"/>
36-
<item fieldId="2" name="Zoom" type="int8u" optional="true" default="1" min="1"/>
36+
<item fieldId="2" name="Zoom" type="int8u" optional="true" default="1" min="1" max="100"/>
3737
</struct>
3838

3939
<cluster apiMaturity="provisional">
@@ -128,9 +128,9 @@ Git: 1.4-444-g6d595e737
128128
</attribute>
129129
<command code="0x00" source="client" name="MPTZSetPosition" optional="true">
130130
<description>This command SHALL set the values for the pan, tilt, and zoom in the mechanical PTZ.</description>
131-
<arg id="0" name="Pan" type="int16s" optional="true"/>
132-
<arg id="1" name="Tilt" type="int16s" optional="true"/>
133-
<arg id="2" name="Zoom" type="int8u" optional="true" min="1" max="1"/>
131+
<arg id="0" name="Pan" type="int16s" optional="true" min="-180" max="180"/>
132+
<arg id="1" name="Tilt" type="int16s" optional="true" min="-180" max="180"/>
133+
<arg id="2" name="Zoom" type="int8u" optional="true" min="1" max="100"/>
134134
<mandatoryConform>
135135
<orTerm>
136136
<feature name="MPAN"/>

‎src/app/zap-templates/zcl/data-model/chip/chime-cluster.xml

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0"?>
22
<!--
3-
Copyright (c) 2024 Project CHIP Authors
3+
Copyright (c) 2024-2025 Project CHIP Authors
44
55
Licensed under the Apache License, Version 2.0 (the "License");
66
you may not use this file except in compliance with the License.
@@ -18,18 +18,18 @@ limitations under the License.
1818
XML generated by Alchemy; DO NOT EDIT.
1919
Source: src/app_clusters/Chime.adoc
2020
Parameters: in-progress
21-
Git: 0.9-fall2024-301-g4e2f0c1c4
21+
Git: 0.7-summer-2025-1-ge4654a5ef
2222
-->
2323
<configurator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../zcl.xsd">
2424
<domain name="General"/>
2525
<struct name="ChimeSoundStruct" apiMaturity="provisional">
2626
<cluster code="0x0556"/>
2727
<item fieldId="0" name="ChimeID" type="int8u"/>
28-
<item fieldId="1" name="Name" type="char_string" length="48"/>
28+
<item fieldId="1" name="Name" type="char_string" length="48" minLength="1"/>
2929
</struct>
3030

3131
<cluster apiMaturity="provisional">
32-
<domain name="Cameras"/>
32+
<domain name="Cameras">Cameras</domain>
3333
<name>Chime</name>
3434
<code>0x0556</code>
3535
<define>CHIME_CLUSTER</define>
@@ -38,7 +38,7 @@ Git: 0.9-fall2024-301-g4e2f0c1c4
3838
<server init="false" tick="false">true</server>
3939
<globalAttribute code="0xFFFD" side="either" value="1"/>
4040
<attribute code="0x0000" side="server" define="INSTALLED_CHIME_SOUNDS" type="array" entryType="ChimeSoundStruct" length="255" minLength="1">InstalledChimeSounds</attribute>
41-
<attribute code="0x0001" side="server" define="ACTIVE_CHIME_SOUND_ID" type="int8u" min="0" max="255" default="0" writable="true">ActiveChimeID</attribute>
41+
<attribute code="0x0001" side="server" define="ACTIVE_CHIME_SOUND_ID" type="int8u" min="0" max="255" default="0" writable="true">SelectedChime</attribute>
4242
<attribute code="0x0002" side="server" define="ENABLED" type="boolean" default="1" writable="true">Enabled</attribute>
4343
<command code="0x00" source="client" name="PlayChimeSound" optional="false">
4444
<description/>

‎src/app/zap-templates/zcl/data-model/chip/global-enums.xml

+12-8
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0"?>
22
<!--
3-
Copyright (c) 2024 Project CHIP Authors
3+
Copyright (c) 2024-2025 Project CHIP Authors
44
55
Licensed under the Apache License, Version 2.0 (the "License");
66
you may not use this file except in compliance with the License.
@@ -15,24 +15,29 @@ See the License for the specific language governing permissions and
1515
limitations under the License.
1616
-->
1717
<!--
18+
XML generated by Alchemy; DO NOT EDIT.
19+
Source: src/app_clusters/energy_management.adoc src/app_clusters/meas_and_sense.adoc src/data_model/Data-Model.adoc src/service_device_management/DistributedComplianceLedger.adoc
20+
Parameters: in-progress
21+
Git: 0.7-summer-2025
22+
-->
23+
<!--
1824
TODO: Make these structures global rather than defining them for each cluster.
1925
This depends on the ability to define global structs via XML tags.
2026
see: https://github.com/project-chip/connectedhomeip/issues/29818
2127
-->
22-
<configurator>
28+
<configurator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../zcl.xsd">
2329
<domain name="CHIP"/>
24-
2530
<enum name="AtomicRequestTypeEnum" type="enum8">
2631
<item name="BeginWrite" value="0x00"/>
2732
<item name="CommitWrite" value="0x01"/>
2833
<item name="RollbackWrite" value="0x02"/>
2934
</enum>
3035

3136
<enum name="ThreeLevelAutoEnum" type="enum8">
32-
<item name="Low" value="0x00"/>
33-
<item name="Medium" value="0x01"/>
34-
<item name="High" value="0x02"/>
35-
<item name="Automatic" value="0x03"/>
37+
<item name="Auto" value="0x00"/>
38+
<item name="Low" value="0x01"/>
39+
<item name="Medium" value="0x02"/>
40+
<item name="High" value="0x03"/>
3641
</enum>
3742

3843
<enum name="StreamUsageEnum" type="enum8">
@@ -45,7 +50,6 @@ TODO: Make these structures global rather than defining them for each cluster.
4550
<item name="Analysis" value="0x02"/>
4651
<item name="LiveView" value="0x03"/>
4752
</enum>
48-
4953
<!--
5054
These are test global items (no cluster attached) for testing only.
5155
Their usage is defined for UnitTestCluster only.

‎src/app/zap-templates/zcl/data-model/chip/tls-certificate-management-cluster.xml

+26-10
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ limitations under the License.
1818
XML generated by Alchemy; DO NOT EDIT.
1919
Source: src/tls/TLSCertificateManagement.adoc
2020
Parameters: in-progress
21-
Git: 1.4-534-g3214b3502
21+
Git: 0.7-summer-2025-1-ge4654a5ef
2222
-->
2323
<configurator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../zcl.xsd">
2424
<domain name="General"/>
@@ -36,7 +36,7 @@ Git: 1.4-534-g3214b3502
3636
</struct>
3737

3838
<cluster apiMaturity="provisional">
39-
<domain name="General"/>
39+
<domain name="General">General</domain>
4040
<name>TLS Certificate Management</name>
4141
<code>0x0801</code>
4242
<define>TLS_CERTIFICATE_MANAGEMENT_CLUSTER</define>
@@ -50,91 +50,107 @@ Git: 1.4-534-g3214b3502
5050
<attribute code="0x0002" side="server" define="MAX_CLIENT_CERTIFICATES" type="int8u">MaxClientCertificates</attribute>
5151
<attribute code="0x0003" side="server" define="CURRENT_CLIENT_CERTIFICATES" type="int8u">CurrentClientCertificates</attribute>
5252
<command code="0x00" source="client" name="ProvisionRootCertificate" optional="false" response="ProvisionRootCertificateResponse">
53-
<description>This command SHALL provision the provided certificate for the passed in CAID.</description>
53+
<description>This command SHALL provision a newly provided certificate, or rotate an existing one, based on the contents of the CAID field.</description>
5454
<access op="invoke" privilege="administer"/>
55+
<quality largeMessage="true"/>
5556
<arg id="0" name="Certificate" type="long_octet_string" length="3000"/>
5657
<arg id="1" name="CAID" type="int16u" isNullable="true"/>
5758
</command>
5859

5960
<command code="0x01" source="server" name="ProvisionRootCertificateResponse" optional="false" disableDefaultResponse="true">
6061
<description>This command SHALL be generated in response to a ProvisionRootCertificate command.</description>
62+
<quality largeMessage="true"/>
6163
<arg id="0" name="CAID" type="int16u"/>
6264
</command>
6365

6466
<command code="0x02" source="client" name="FindRootCertificate" optional="false" response="FindRootCertificateResponse">
65-
<description>This command SHALL return the TLSCertStruct for the passed in CAID.</description>
67+
<description>This command SHALL return the specified TLS root certificate, or all TLS provisioned root certificates, based on the contents of the CAID field.</description>
68+
<quality largeMessage="true"/>
6669
<arg id="0" name="CAID" type="int16u" isNullable="true"/>
6770
</command>
6871

6972
<command code="0x03" source="server" name="FindRootCertificateResponse" optional="false" disableDefaultResponse="true">
7073
<description>This command SHALL be generated in response to a FindRootCertificate command.</description>
71-
<arg id="0" name="CertificateDetails" array="true" type="TLSCertStruct"/>
74+
<quality largeMessage="true"/>
75+
<arg id="0" name="CertificateDetails" array="true" type="TLSCertStruct" minLength="1"/>
7276
</command>
7377

7478
<command code="0x04" source="client" name="LookupRootCertificate" optional="false" response="LookupRootCertificateResponse">
7579
<description>This command SHALL return the CAID for the passed in fingerprint.</description>
80+
<quality largeMessage="true"/>
7681
<arg id="0" name="Fingerprint" type="octet_string" length="64"/>
7782
</command>
7883

7984
<command code="0x05" source="server" name="LookupRootCertificateResponse" optional="false" disableDefaultResponse="true">
8085
<description>This command SHALL be generated in response to a LookupRootCertificate command.</description>
86+
<quality largeMessage="true"/>
8187
<arg id="0" name="CAID" type="int16u"/>
8288
</command>
8389

8490
<command code="0x06" source="client" name="RemoveRootCertificate" optional="false">
8591
<description>This command SHALL be generated to request the server removes the certificate provisioned to the provided Certificate Authority ID.</description>
8692
<access op="invoke" privilege="administer"/>
93+
<quality largeMessage="true"/>
8794
<arg id="0" name="CAID" type="int16u"/>
8895
</command>
8996

9097
<command code="0x07" source="client" name="TLSClientCSR" optional="false" response="TLSClientCSRResponse">
9198
<description>This command SHALL be generated to request the Node generates a Certificate Signing Request.</description>
9299
<access op="invoke" privilege="administer"/>
100+
<quality largeMessage="true"/>
93101
<arg id="1" name="Nonce" type="octet_string"/>
94102
</command>
95103

96104
<command code="0x08" source="server" name="TLSClientCSRResponse" optional="false" disableDefaultResponse="true">
97105
<description>This command SHALL be generated in response to a TLSClientCSR command.</description>
106+
<quality largeMessage="true"/>
98107
<arg id="0" name="CCDID" type="int16u"/>
99108
<arg id="1" name="CSR" type="octet_string"/>
100109
<arg id="2" name="Nonce" type="octet_string"/>
101110
</command>
102111

103112
<command code="0x09" source="client" name="ProvisionClientCertificate" optional="false" response="ProvisionClientCertificateResponse">
104-
<description>This command SHALL be generated to request the Node provisions the provided Client Certificate Details.</description>
113+
<description>This command SHALL be generated to request the Node provisions newly provided Client Certificate Details, or rotate an existing client certificate.</description>
105114
<access op="invoke" privilege="administer"/>
115+
<quality largeMessage="true"/>
106116
<arg id="0" name="CCDID" type="int16u"/>
107117
<arg id="1" name="ClientCertificateDetails" type="TLSClientCertificateDetailStruct"/>
108118
</command>
109119

110120
<command code="0x0A" source="server" name="ProvisionClientCertificateResponse" optional="false" disableDefaultResponse="true">
111121
<description>This command SHALL be generated in response to a ProvisionClientCertificate command.</description>
122+
<quality largeMessage="true"/>
112123
<arg id="0" name="CCDID" type="int16u"/>
113124
</command>
114125

115126
<command code="0x0B" source="client" name="FindClientCertificate" optional="false" response="FindClientCertificateResponse">
116-
<description>This command SHALL return the TLSClientCertificateDetailStruct for the passed in CCDID.</description>
117-
<arg id="0" name="CCDID" type="int16u"/>
127+
<description>This command SHALL return the TLSClientCertificateDetailStruct for the passed in CCDID, or all TLS client certificates, based on the contents of the CCDID field.</description>
128+
<quality largeMessage="true"/>
129+
<arg id="0" name="CCDID" type="int16u" isNullable="true"/>
118130
</command>
119131

120132
<command code="0x0C" source="server" name="FindClientCertificateResponse" optional="false" disableDefaultResponse="true">
121133
<description>This command SHALL be generated in response to a FindClientCertificate command.</description>
122-
<arg id="0" name="CertificateDetails" array="true" type="TLSClientCertificateDetailStruct"/>
134+
<quality largeMessage="true"/>
135+
<arg id="0" name="CertificateDetails" array="true" type="TLSClientCertificateDetailStruct" minLength="1"/>
123136
</command>
124137

125138
<command code="0x0D" source="client" name="LookupClientCertificate" optional="false" response="LookupClientCertificateResponse">
126139
<description>This command SHALL return the CCDID for the passed in Fingerprint.</description>
140+
<quality largeMessage="true"/>
127141
<arg id="0" name="Fingerprint" type="octet_string" length="64"/>
128142
</command>
129143

130144
<command code="0x0E" source="server" name="LookupClientCertificateResponse" optional="false" disableDefaultResponse="true">
131145
<description>This command SHALL be generated in response to a LookupClientCertificate command.</description>
146+
<quality largeMessage="true"/>
132147
<arg id="0" name="CCDID" type="int16u"/>
133148
</command>
134149

135150
<command code="0x0F" source="client" name="RemoveClientCertificate" optional="false">
136-
<description>This command SHALL be generated to request the Node removes the certificate provisioned to the provided Client Certificate Details ID.</description>
151+
<description>This command SHALL be used to request the Node removes all stored information for the provided CCDID.</description>
137152
<access op="invoke" privilege="administer"/>
153+
<quality largeMessage="true"/>
138154
<arg id="0" name="CCDID" type="int16u"/>
139155
</command>
140156

‎src/app/zap-templates/zcl/data-model/chip/webrtc-provider-cluster.xml

+13-15
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ limitations under the License.
1818
XML generated by Alchemy; DO NOT EDIT.
1919
Source: src/app_clusters/WebRTC_Provider.adoc
2020
Parameters: in-progress
21-
Git: 0.7-summer-2025-285-g2a2bd1961
21+
Git: 0.7-summer-2025-1-ge4654a5ef
2222
-->
2323
<configurator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../zcl.xsd">
2424
<domain name="Cameras"/>
@@ -54,15 +54,16 @@ Git: 0.7-summer-2025-285-g2a2bd1961
5454
<item fieldId="4" name="CAID" type="int16u" optional="true"/>
5555
</struct>
5656

57-
<struct name="WebRTCSessionStruct" apiMaturity="provisional" isFabricScoped="true">
57+
<struct name="WebRTCSessionStruct" apiMaturity="provisional">
5858
<cluster code="0x0553"/>
5959
<cluster code="0x0554"/>
6060
<item fieldId="1" name="ID" type="int16u"/>
6161
<item fieldId="2" name="PeerNodeID" type="node_id"/>
62-
<item fieldId="3" name="StreamUsage" type="StreamUsageEnum" min="0x00" max="0x03"/>
63-
<item fieldId="4" name="VideoStreamID" type="int16u" isNullable="true"/>
64-
<item fieldId="5" name="AudioStreamID" type="int16u" isNullable="true"/>
65-
<item fieldId="6" name="MetadataOptions" type="WebRTCMetadataOptionsBitmap" default="0x00" min="0x00" max="0x01"/>
62+
<item fieldId="3" name="PeerFabricIndex" type="fabric_idx"/>
63+
<item fieldId="4" name="StreamUsage" type="StreamUsageEnum" min="0x00" max="0x03"/>
64+
<item fieldId="5" name="VideoStreamID" type="int16u" isNullable="true"/>
65+
<item fieldId="6" name="AudioStreamID" type="int16u" isNullable="true"/>
66+
<item fieldId="7" name="MetadataOptions" type="WebRTCMetadataOptionsBitmap" default="0x00" min="0x00" max="0x01"/>
6667
</struct>
6768

6869
<cluster apiMaturity="provisional">
@@ -74,11 +75,8 @@ Git: 0.7-summer-2025-285-g2a2bd1961
7475
<client init="false" tick="false">true</client>
7576
<server init="false" tick="false">true</server>
7677
<globalAttribute code="0xFFFD" side="either" value="1"/>
77-
<attribute code="0x0000" side="server" define="CURRENT_SESSIONS" type="array" entryType="WebRTCSessionStruct">
78-
<description>CurrentSessions</description>
79-
<access op="read" privilege="manage"/>
80-
</attribute>
81-
<command code="0x01" source="client" name="SolicitOffer" isFabricScoped="true" optional="false" response="SolicitOfferResponse">
78+
<attribute code="0x0000" side="server" define="CURRENT_SESSIONS" type="array" entryType="WebRTCSessionStruct">CurrentSessions</attribute>
79+
<command code="0x01" source="client" name="SolicitOffer" optional="false" response="SolicitOfferResponse">
8280
<description>Requests that the Provider initiates a new session with the Offer / Answer flow in a way that allows for options to be passed and work with devices needing the standby flow.</description>
8381
<quality largeMessage="true"/>
8482
<arg id="1" name="StreamUsage" type="StreamUsageEnum" min="0x00" max="0x03"/>
@@ -98,7 +96,7 @@ Git: 0.7-summer-2025-285-g2a2bd1961
9896
<arg id="4" name="AudioStreamID" type="int16u" optional="true" isNullable="true"/>
9997
</command>
10098

101-
<command code="0x03" source="client" name="ProvideOffer" isFabricScoped="true" optional="false" response="ProvideOfferResponse">
99+
<command code="0x03" source="client" name="ProvideOffer" optional="false" response="ProvideOfferResponse">
102100
<description>This command allows an SDP Offer to be set and start a new session.</description>
103101
<quality largeMessage="true"/>
104102
<arg id="1" name="WebRTCSessionID" type="int16u" isNullable="true"/>
@@ -119,21 +117,21 @@ Git: 0.7-summer-2025-285-g2a2bd1961
119117
<arg id="3" name="AudioStreamID" type="int16u" optional="true" isNullable="true"/>
120118
</command>
121119

122-
<command code="0x05" source="client" name="ProvideAnswer" isFabricScoped="true" optional="false">
120+
<command code="0x05" source="client" name="ProvideAnswer" optional="false">
123121
<description>This command SHALL be initiated from a Node in response to an Offer that was previously received from a remote peer.</description>
124122
<quality largeMessage="true"/>
125123
<arg id="1" name="WebRTCSessionID" type="int16u"/>
126124
<arg id="2" name="SDP" type="char_string"/>
127125
</command>
128126

129-
<command code="0x06" source="client" name="ProvideICECandidates" isFabricScoped="true" optional="false">
127+
<command code="0x06" source="client" name="ProvideICECandidates" optional="false">
130128
<description>This command allows for string based https://rfc-editor.org/rfc/rfc8839#section-5.1 generated after the initial Offer / Answer exchange, via a JSEP https://datatracker.ietf.org/doc/html/rfc9429#section-4.1.20 event, a DOM https://www.w3.org/TR/webrtc/#dom-rtcpeerconnectioniceevent event, or other WebRTC compliant implementations, to be added to a session during the gathering phase.</description>
131129
<quality largeMessage="true"/>
132130
<arg id="1" name="WebRTCSessionID" type="int16u"/>
133131
<arg id="2" name="ICECandidates" array="true" type="char_string" minLength="1"/>
134132
</command>
135133

136-
<command code="0x07" source="client" name="EndSession" isFabricScoped="true" optional="false">
134+
<command code="0x07" source="client" name="EndSession" optional="false">
137135
<description>This command instructs the stream provider to end the WebRTC session.</description>
138136
<quality largeMessage="true"/>
139137
<arg id="1" name="WebRTCSessionID" type="int16u"/>

0 commit comments

Comments
 (0)
Please sign in to comment.