Skip to content

Commit 2b1e079

Browse files
gmarcosbgmarcosb
committed
Generated using:
./alchemy zap --attribute="in-progress" --sdkRoot=[] --specRoot=[] 'TLSCertificateManagement.adoc' With manual edits adding description
1 parent aba2383 commit 2b1e079

File tree

6 files changed

+150
-4
lines changed

6 files changed

+150
-4
lines changed

‎.github/workflows/tests.yaml

+1
Original file line numberDiff line numberDiff line change
@@ -195,6 +195,7 @@ jobs:
195195
src/app/zap-templates/zcl/data-model/chip/time-format-localization-cluster.xml \
196196
src/app/zap-templates/zcl/data-model/chip/time-synchronization-cluster.xml \
197197
src/app/zap-templates/zcl/data-model/chip/timer-cluster.xml \
198+
src/app/zap-templates/zcl/data-model/chip/tls-certificate-management-cluster.xml \
198199
src/app/zap-templates/zcl/data-model/chip/user-label-cluster.xml \
199200
src/app/zap-templates/zcl/data-model/chip/unit-localization-cluster.xml \
200201
src/app/zap-templates/zcl/data-model/chip/wake-on-lan-cluster.xml \

‎scripts/rules.matterlint

+1
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,7 @@ load "../src/app/zap-templates/zcl/data-model/chip/thread-network-directory-clus
103103
load "../src/app/zap-templates/zcl/data-model/chip/time-format-localization-cluster.xml";
104104
load "../src/app/zap-templates/zcl/data-model/chip/time-synchronization-cluster.xml";
105105
load "../src/app/zap-templates/zcl/data-model/chip/timer-cluster.xml";
106+
load "../src/app/zap-templates/zcl/data-model/chip/tls-certificate-management-cluster.xml";
106107
load "../src/app/zap-templates/zcl/data-model/chip/unit-localization-cluster.xml";
107108
load "../src/app/zap-templates/zcl/data-model/chip/user-label-cluster.xml";
108109
load "../src/app/zap-templates/zcl/data-model/chip/wake-on-lan-cluster.xml";

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

+142
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,142 @@
1+
<?xml version="1.0"?>
2+
<!--
3+
Copyright (c) 2024 Project CHIP Authors
4+
5+
Licensed under the Apache License, Version 2.0 (the "License");
6+
you may not use this file except in compliance with the License.
7+
You may obtain a copy of the License at
8+
9+
http://www.apache.org/licenses/LICENSE-2.0
10+
11+
Unless required by applicable law or agreed to in writing, software
12+
distributed under the License is distributed on an "AS IS" BASIS,
13+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14+
See the License for the specific language governing permissions and
15+
limitations under the License.
16+
-->
17+
<!--
18+
XML generated by Alchemy; DO NOT EDIT.
19+
Source: src/tls/TLSCertificateManagement.adoc
20+
Parameters: in-progress
21+
Git: 1.4-282-gad46b0990
22+
-->
23+
<configurator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../zcl.xsd">
24+
<domain name="General"/>
25+
<struct name="TLSCertStruct" apiMaturity="provisional">
26+
<cluster code="0x0801"/>
27+
<item fieldId="0" name="CAID" type="int16u"/>
28+
<item fieldId="1" name="Certificate" type="long_octet_string" length="3000"/>
29+
</struct>
30+
31+
<struct name="TLSClientCertificateDetailStruct" apiMaturity="provisional">
32+
<cluster code="0x0801"/>
33+
<item fieldId="0" name="CCDID" type="int16u"/>
34+
<item fieldId="1" name="ClientCertificate" type="long_octet_string" length="3000"/>
35+
<item fieldId="2" name="IntermediateCerts" array="true" type="octet_string"/>
36+
</struct>
37+
38+
<cluster>
39+
<domain name="General"/>
40+
<name>TLS Certificate Management</name>
41+
<code>0x0801</code>
42+
<define>TLS_CERTIFICATE_MANAGEMENT_CLUSTER</define>
43+
<description>This Cluster is used to manage TLS Client Certificates and to provision
44+
TLS endpoints with enough information to facilitate subsequent connection.</description>
45+
<client init="false" tick="false">true</client>
46+
<server init="false" tick="false">true</server>
47+
<globalAttribute code="0xFFFD" side="either" value="1"/>
48+
<attribute code="0x0000" side="server" define="MAX_ROOT_CERTIFICATES" type="int8u">MaxRootCertificates</attribute>
49+
<attribute code="0x0001" side="server" define="CURRENT_ROOT_CERTIFICATES" type="int8u">CurrentRootCertificates</attribute>
50+
<attribute code="0x0002" side="server" define="MAX_CLIENT_CERTIFICATES" type="int8u">MaxClientCertificates</attribute>
51+
<attribute code="0x0003" side="server" define="CURRENT_CLIENT_CERTIFICATES" type="int8u">CurrentClientCertificates</attribute>
52+
<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>
54+
<access op="invoke" privilege="administer"/>
55+
<arg id="0" name="Certificate" type="long_octet_string" length="3000"/>
56+
<arg id="1" name="CAID" type="int16u" optional="true" isNullable="true"/>
57+
</command>
58+
59+
<command code="0x01" source="server" name="ProvisionRootCertificateResponse" optional="false" disableDefaultResponse="true">
60+
<description>This command SHALL be generated in response to a ProvisionRootCertificate command.</description>
61+
<arg id="0" name="CAID" type="int16u"/>
62+
</command>
63+
64+
<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>
66+
<arg id="0" name="CAID" type="int16u" optional="true" isNullable="true"/>
67+
</command>
68+
69+
<command code="0x03" source="server" name="FindRootCertificateResponse" optional="false" disableDefaultResponse="true">
70+
<description>This command SHALL be generated in response to a FindRootCertificate command.</description>
71+
<arg id="0" name="CertificateDetails" array="true" type="TLSCertStruct"/>
72+
</command>
73+
74+
<command code="0x04" source="client" name="LookupRootCertificate" optional="false" response="LookupRootCertificateResponse">
75+
<description>This command SHALL return the CAID for the passed in fingerprint.</description>
76+
<arg id="0" name="Fingerprint" type="octet_string" length="64"/>
77+
</command>
78+
79+
<command code="0x05" source="server" name="LookupRootCertificateResponse" optional="false" disableDefaultResponse="true">
80+
<description>This command SHALL be generated in response to a LookupRootCertificate command.</description>
81+
<arg id="0" name="CAID" type="int16u"/>
82+
</command>
83+
84+
<command code="0x06" source="client" name="RemoveRootCertificate" optional="false">
85+
<description>This command SHALL be generated to request the server removes the certificate provisioned to the provided Certificate Authority ID.</description>
86+
<access op="invoke" privilege="administer"/>
87+
<arg id="0" name="CAID" type="int16u"/>
88+
</command>
89+
90+
<command code="0x07" source="client" name="TLSClientCSR" optional="false" response="TLSClientCSRResponse">
91+
<description>This command SHALL be generated to request the Node generates a Certificate Signing Request.</description>
92+
<access op="invoke" privilege="administer"/>
93+
<arg id="1" name="Nonce" type="octet_string"/>
94+
</command>
95+
96+
<command code="0x08" source="server" name="TLSClientCSRResponse" optional="false" disableDefaultResponse="true">
97+
<description>This command SHALL be generated in response to a TLSClientCSR command.</description>
98+
<arg id="0" name="CCDID" type="int16u"/>
99+
<arg id="1" name="CSR" type="octet_string"/>
100+
<arg id="2" name="Nonce" type="octet_string"/>
101+
</command>
102+
103+
<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>
105+
<access op="invoke" privilege="administer"/>
106+
<arg id="0" name="CCDID" type="int16u"/>
107+
<arg id="1" name="ClientCertificateDetails" type="TLSClientCertificateDetailStruct"/>
108+
</command>
109+
110+
<command code="0x0A" source="server" name="ProvisionClientCertificateResponse" optional="false" disableDefaultResponse="true">
111+
<description>This command SHALL be generated in response to a ProvisionClientCertificate command.</description>
112+
<arg id="0" name="CCDID" type="int16u"/>
113+
</command>
114+
115+
<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"/>
118+
</command>
119+
120+
<command code="0x0C" source="server" name="FindClientCertificateResponse" optional="false" disableDefaultResponse="true">
121+
<description>This command SHALL be generated in response to a FindClientCertificate command.</description>
122+
<arg id="0" name="CertificateDetails" array="true" type="TLSClientCertificateDetailStruct"/>
123+
</command>
124+
125+
<command code="0x0D" source="client" name="LookupClientCertificate" optional="false" response="LookupClientCertificateResponse">
126+
<description>This command SHALL return the CCDID for the passed in Fingerprint.</description>
127+
<arg id="0" name="Fingerprint" type="octet_string" length="64"/>
128+
</command>
129+
130+
<command code="0x0E" source="server" name="LookupClientCertificateResponse" optional="false" disableDefaultResponse="true">
131+
<description>This command SHALL be generated in response to a LookupClientCertificate command.</description>
132+
<arg id="0" name="CCDID" type="int16u"/>
133+
</command>
134+
135+
<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>
137+
<access op="invoke" privilege="administer"/>
138+
<arg id="0" name="CCDID" type="int16u"/>
139+
</command>
140+
141+
</cluster>
142+
</configurator>

‎src/app/zap-templates/zcl/zcl-with-test-extensions.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,7 @@
125125
"time-format-localization-cluster.xml",
126126
"time-synchronization-cluster.xml",
127127
"timer-cluster.xml",
128+
"tls-certificate-management-cluster.xml",
128129
"user-label-cluster.xml",
129130
"unit-localization-cluster.xml",
130131
"valve-configuration-and-control-cluster.xml",
@@ -291,8 +292,7 @@
291292
"ActiveModeThreshold",
292293
"RegisteredClients",
293294
"ICDCounter",
294-
"ClientsSupportedPerFabric",
295-
"MaximumCheckInBackOff"
295+
"ClientsSupportedPerFabric"
296296
],
297297
"Occupancy Sensing": ["HoldTimeLimits", "HoldTime", "FeatureMap"],
298298
"Operational Credentials": [

‎src/app/zap-templates/zcl/zcl.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,7 @@
119119
"time-format-localization-cluster.xml",
120120
"time-synchronization-cluster.xml",
121121
"timer-cluster.xml",
122+
"tls-certificate-management-cluster.xml",
122123
"user-label-cluster.xml",
123124
"unit-localization-cluster.xml",
124125
"valve-configuration-and-control-cluster.xml",
@@ -285,8 +286,7 @@
285286
"ActiveModeThreshold",
286287
"RegisteredClients",
287288
"ICDCounter",
288-
"ClientsSupportedPerFabric",
289-
"MaximumCheckInBackOff"
289+
"ClientsSupportedPerFabric"
290290
],
291291
"Occupancy Sensing": ["HoldTimeLimits", "HoldTime", "FeatureMap"],
292292
"Operational Credentials": [

‎src/app/zap_cluster_list.json

+2
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,7 @@
121121
"TIME_FORMAT_LOCALIZATION_CLUSTER": [],
122122
"TIME_SYNCHRONIZATION_CLUSTER": [],
123123
"TIMER_CLUSTER": [],
124+
"TLS_CERTIFICATE_MANAGEMENT_CLUSTER": [],
124125
"TRUSTED_ROOT_CERTIFICATES_CLUSTER": [],
125126
"UNIT_LOCALIZATION_CLUSTER": [],
126127
"UNIT_TESTING_CLUSTER": [],
@@ -303,6 +304,7 @@
303304
"TIME_FORMAT_LOCALIZATION_CLUSTER": ["time-format-localization-server"],
304305
"TIME_SYNCHRONIZATION_CLUSTER": ["time-synchronization-server"],
305306
"TIMER_CLUSTER": ["timer-server"],
307+
"TLS_CERTIFICATE_MANAGEMENT_CLUSTER": [],
306308
"TVOC_CONCENTRATION_MEASUREMENT_CLUSTER": [
307309
"concentration-measurement-server"
308310
],

0 commit comments

Comments
 (0)