| # 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. |
| # Auto-generated scripts for harness use only, please review before automation. The endpoints and cluster names are currently set to default |
| |
| name: 84.2.1. [TC-DESC-2.1] Descriptor Cluster Attributes [DUT-Server] |
| |
| PICS: |
| - DESC.S |
| |
| config: |
| nodeId: 0x12344321 |
| cluster: "Basic Information" |
| endpoint: 0 |
| |
| tests: |
| - label: "Note" |
| verification: | |
| Mandatory cluster requirements for each device type can be found here. |
| https://github.com/CHIP-Specifications/chip-test-plans/tree/master/tools/device-type-requirements |
| Use the correct json required for the DUT, this file is PIXIT.DESC.DeviceTypeConformanceList. |
| disabled: true |
| |
| - label: "Precondition" |
| verification: | |
| TH and DUT are commissioned |
| disabled: true |
| |
| - label: |
| "Step 1a: TH reads DeviceTypeList and PartsList attributes from DUT |
| for Endpoint 0" |
| PICS: DESC.S.A0000 && DESC.S.A0003 |
| verification: | |
| Send a read request to the DUT using chip-tool to read the partsList attribute in the descriptor cluster on Endpoint 0. |
| Make a note of all the items(Endpoint id’s) in the list. In the below example there are 2 endpoint id's listed [1,2] |
| |
| ./chip-tool descriptor read parts-list 1 0 |
| |
| Verify "PartsList" attribute is not empty (use this list of endpoints in step 1b) on the TH (Chip-tool) and below is the sample log provided for the raspi platform: |
| |
| [1672919206.069327][33426:33428] CHIP:TOO: Endpoint: 0 Cluster: 0x0000_001D Attribute 0x0000_0003 DataVersion: 2847656117 |
| [1672919206.069380][33426:33428] CHIP:TOO: PartsList: 2 entries |
| [1672919206.069398][33426:33428] CHIP:TOO: [1]: 1 |
| [1672919206.069410][33426:33428] CHIP:TOO: [2]: 2 |
| |
| ./chip-tool descriptor read device-type-list 1 0 |
| |
| on TH (Chip-tool) log, Verify that the DeviceTypeList contains one Root Node Device Type and may only contain other Node Device Types (device types with scope=node, it can be any of the following Power Source, OTA Requestor, OTA Provider) next to the Root Node Device Type. (here DeviceType: 17 is power source ) |
| - Revision value is not less than 1 and it should match the Revision of the DeviceType and below is the sample log provided for the raspi platform |
| |
| [1674552598.748946][21129:21131] CHIP:DMG: } |
| [[1692617243.785786][31325:31327] CHIP:TOO: Endpoint: 0 Cluster: 0x0000_001D Attribute 0x0000_0000 DataVersion: 1437984882 |
| [1692617243.785840][31325:31327] CHIP:TOO: DeviceTypeList: 2 entries |
| [1692617243.785862][31325:31327] CHIP:TOO: [1]: { |
| [1692617243.785881][31325:31327] CHIP:TOO: DeviceType: 17 |
| [1692617243.785892][31325:31327] CHIP:TOO: Revision: 1 |
| [1692617243.785901][31325:31327] CHIP:TOO: } |
| [1692617243.785917][31325:31327] CHIP:TOO: [2]: { |
| [1692617243.785926][31325:31327] CHIP:TOO: DeviceType: 22 |
| [1692617243.785936][31325:31327] CHIP:TOO: Revision: 1 |
| [1692617243.785944][31325:31327] CHIP:TOO: } |
| disabled: true |
| |
| - label: |
| "Step 1b: TH reads DeviceTypeList and PartsList attributes from DUT |
| for each Endpoint supported by DUT (except Endpoint 0)." |
| PICS: DESC.S.A0000 && DESC.S.A0003 |
| verification: | |
| For all the Endpoint’s listed from the previous step run the following steps. The device type should correspond to the id value in the device_type.json |
| Chip tool outputs all values in integer, convert to hex before comparing. |
| |
| ./chip-tool descriptor read parts-list 1 1 |
| |
| Verify parts-list response contains 0 entries on the TH (Chip-tool) and below is the sample log provided for the raspi platform: |
| |
| [1660127331.634565][46437:46442] CHIP:TOO: Endpoint: 1 Cluster: 0x0000_001D Attribute 0x0000_0003 DataVersion: 934889243 |
| [1660127331.634631][46437:46442] CHIP:TOO: parts list: 0 entries |
| |
| ./chip-tool descriptor read device-type-list 1 1 |
| |
| On TH (Chip-tool) log, Verify that the DeviceTypeList count is at least one. |
| - If the DeviceTypeList contains more than one Application Device Type, verify that all the Application Device Types are part of the same superset. |
| - Verify the DeviceTypeList does not contain the Root Node Device Type. |
| - Revision value is not less than 1 and it should match the Revision of the DeviceType and below is the sample log provided for the raspi platform |
| |
| [1674552599.264189][21135:21137] CHIP:DMG: } |
| [1692617790.900384][31584:31586] CHIP:TOO: Endpoint: 1 Cluster: 0x0000_001D Attribute 0x0000_0000 DataVersion: 2832593371 |
| [1692617790.900398][31584:31586] CHIP:TOO: DeviceTypeList: 2 entries |
| [1692617790.900410][31584:31586] CHIP:TOO: [1]: { |
| [1692617790.900413][31584:31586] CHIP:TOO: DeviceType: 256 |
| [1692617790.900416][31584:31586] CHIP:TOO: Revision: 1 |
| [1692617790.900419][31584:31586] CHIP:TOO: } |
| [1692617790.900423][31584:31586] CHIP:TOO: [2]: { |
| [1692617790.900425][31584:31586] CHIP:TOO: DeviceType: 17 |
| [1692617790.900428][31584:31586] CHIP:TOO: Revision: 1 |
| [1692617790.900430][31584:31586] CHIP:TOO: } |
| |
| ./chip-tool descriptor read parts-list 1 2 |
| |
| Verify parts-list response contains 0 entries on the TH (Chip-tool) and below is the sample log provided for the raspi platform: |
| |
| [1660127879.565330][46472:46477] CHIP:TOO: Endpoint: 2 Cluster: 0x0000_001D Attribute 0x0000_0003 DataVersion: 1237610137 |
| [1660127879.565473][46472:46477] CHIP:TOO: parts list: 0 entries |
| |
| ./chip-tool descriptor read device-type-list 1 2 |
| |
| On TH (Chip-tool) log, Verify that the DeviceTypeList count is at least one. |
| - If the DeviceTypeList contains more than one Application Device Type, verify that all the Application Device Types are part of the same superset. |
| - Verify the DeviceTypeList does not contain the Root Node Device Type. |
| - Revision value is not less than 1 and it should match the Revision of the DeviceType and below is the sample log provided for the raspi platform |
| |
| [1692618454.794870][31669:31671] CHIP:TOO: Endpoint: 2 Cluster: 0x0000_001D Attribute 0x0000_0000 DataVersion: 1103199808 |
| [1692618454.794946][31669:31671] CHIP:TOO: DeviceTypeList: 2 entries |
| [1692618454.794990][31669:31671] CHIP:TOO: [1]: { |
| [1692618454.795027][31669:31671] CHIP:TOO: DeviceType: 256 |
| [1692618454.795038][31669:31671] CHIP:TOO: Revision: 1 |
| [1692618454.795048][31669:31671] CHIP:TOO: } |
| [1692618454.795063][31669:31671] CHIP:TOO: [2]: { |
| [1692618454.795072][31669:31671] CHIP:TOO: DeviceType: 17 |
| [1692618454.795080][31669:31671] CHIP:TOO: Revision: 1 |
| [1692618454.795089][31669:31671] CHIP:TOO: } |
| disabled: true |
| |
| - label: "Step 2: TH reads 'ServerList' attribute." |
| PICS: DESC.S.A0001 |
| verification: | |
| For all the Endpoint id’s listed in step 1a run the following steps. For all the server list entries listed in the output - Convert them to Hex values. For example 29 is 0x001D. Verify that these are also present in the device_type.json. Every server cluster listed in the JSON should correspond to a number here in the output. |
| |
| The cluster ID's listed in the below log is from the All-Cluster-app. Please run the below command in all the Reference apps (bridge-app, tv-app, microwave-oven-app, Lock-app, Energy-Management-app and Thermostat-app). |
| |
| ./chip-tool descriptor read server-list 1 1 |
| |
| Verify ServerList entries on the TH (Chip-tool) and below is the sample log provided for the raspi platform, |
| |
| [1707996554.409850][20755:20757] CHIP:DMG: } |
| [1707996554.410814][20755:20757] CHIP:TOO: Endpoint: 1 Cluster: 0x0000_001D Attribute 0x0000_0001 DataVersion: 3583190746 |
| [1707996554.410955][20755:20757] CHIP:TOO: ServerList: 71 entries |
| [1707996554.410990][20755:20757] CHIP:TOO: [1]: 3 |
| [1707996554.411002][20755:20757] CHIP:TOO: [2]: 4 |
| [1707996554.411013][20755:20757] CHIP:TOO: [3]: 6 |
| [1707996554.411024][20755:20757] CHIP:TOO: [4]: 7 |
| [1707996554.411034][20755:20757] CHIP:TOO: [5]: 8 |
| [1707996554.411045][20755:20757] CHIP:TOO: [6]: 15 |
| [1707996554.411056][20755:20757] CHIP:TOO: [7]: 29 |
| [1707996554.411067][20755:20757] CHIP:TOO: [8]: 30 |
| [1707996554.411078][20755:20757] CHIP:TOO: [9]: 37 |
| [1707996554.411092][20755:20757] CHIP:TOO: [10]: 47 |
| [1707996554.411103][20755:20757] CHIP:TOO: [11]: 59 |
| [1707996554.411113][20755:20757] CHIP:TOO: [12]: 64 |
| [1707996554.411124][20755:20757] CHIP:TOO: [13]: 65 |
| [1707996554.411135][20755:20757] CHIP:TOO: [14]: 69 |
| [1707996554.411146][20755:20757] CHIP:TOO: [15]: 72 |
| [1707996554.411156][20755:20757] CHIP:TOO: [16]: 73 |
| [1707996554.411167][20755:20757] CHIP:TOO: [17]: 74 |
| [1707996554.411177][20755:20757] CHIP:TOO: [18]: 80 |
| [1707996554.411188][20755:20757] CHIP:TOO: [19]: 81 |
| [1707996554.411199][20755:20757] CHIP:TOO: [20]: 82 |
| [1707996554.411209][20755:20757] CHIP:TOO: [21]: 83 |
| [1707996554.411220][20755:20757] CHIP:TOO: [22]: 84 |
| [1707996554.411231][20755:20757] CHIP:TOO: [23]: 85 |
| [1707996554.411240][20755:20757] CHIP:TOO: [24]: 86 |
| [1707996554.411251][20755:20757] CHIP:TOO: [25]: 87 |
| [1707996554.411261][20755:20757] CHIP:TOO: [26]: 89 |
| [1707996554.411271][20755:20757] CHIP:TOO: [27]: 91 |
| [1707996554.411282][20755:20757] CHIP:TOO: [28]: 92 |
| [1707996554.411293][20755:20757] CHIP:TOO: [29]: 93 |
| [1707996554.411303][20755:20757] CHIP:TOO: [30]: 94 |
| [1707996554.411313][20755:20757] CHIP:TOO: [31]: 96 |
| [1707996554.411323][20755:20757] CHIP:TOO: [32]: 97 |
| [1707996554.411334][20755:20757] CHIP:TOO: [33]: 98 |
| [1707996554.411345][20755:20757] CHIP:TOO: [34]: 113 |
| [1707996554.411355][20755:20757] CHIP:TOO: [35]: 114 |
| [1707996554.411367][20755:20757] CHIP:TOO: [36]: 128 |
| [1707996554.411376][20755:20757] CHIP:TOO: [37]: 129 |
| [1707996554.411387][20755:20757] CHIP:TOO: [38]: 144 |
| [1707996554.411396][20755:20757] CHIP:TOO: [39]: 145 |
| [1707996554.411406][20755:20757] CHIP:TOO: [40]: 152 |
| [1707996554.411417][20755:20757] CHIP:TOO: [41]: 153 |
| [1707996554.411427][20755:20757] CHIP:TOO: [42]: 157 |
| [1707996554.411437][20755:20757] CHIP:TOO: [43]: 159 |
| [1707996554.411449][20755:20757] CHIP:TOO: [44]: 258 |
| [1707996554.411459][20755:20757] CHIP:TOO: [45]: 259 |
| [1707996554.411469][20755:20757] CHIP:TOO: [46]: 512 |
| [1707996554.411480][20755:20757] CHIP:TOO: [47]: 513 |
| [1707996554.411490][20755:20757] CHIP:TOO: [48]: 514 |
| [1707996554.411500][20755:20757] CHIP:TOO: [49]: 516 |
| [1707996554.411511][20755:20757] CHIP:TOO: [50]: 768 |
| [1707996554.411521][20755:20757] CHIP:TOO: [51]: 769 |
| [1707996554.411532][20755:20757] CHIP:TOO: [52]: 1024 |
| [1707996554.411559][20755:20757] CHIP:TOO: [53]: 1026 |
| [1707996554.411562][20755:20757] CHIP:TOO: [54]: 1027 |
| [1707996554.411565][20755:20757] CHIP:TOO: [55]: 1028 |
| [1707996554.411568][20755:20757] CHIP:TOO: [56]: 1029 |
| [1707996554.411571][20755:20757] CHIP:TOO: [57]: 1030 |
| [1707996554.411575][20755:20757] CHIP:TOO: [58]: 1036 |
| [1707996554.411578][20755:20757] CHIP:TOO: [59]: 1037 |
| [1707996554.411581][20755:20757] CHIP:TOO: [60]: 1043 |
| [1707996554.411584][20755:20757] CHIP:TOO: [61]: 1045 |
| [1707996554.411587][20755:20757] CHIP:TOO: [62]: 1066 |
| [1707996554.411589][20755:20757] CHIP:TOO: [63]: 1067 |
| [1707996554.411592][20755:20757] CHIP:TOO: [64]: 1068 |
| [1707996554.411595][20755:20757] CHIP:TOO: [65]: 1069 |
| [1707996554.411598][20755:20757] CHIP:TOO: [66]: 1070 |
| [1707996554.411601][20755:20757] CHIP:TOO: [67]: 1071 |
| [1707996554.411604][20755:20757] CHIP:TOO: [68]: 1283 |
| [1707996554.411607][20755:20757] CHIP:TOO: [69]: 1288 |
| [1707996554.411610][20755:20757] CHIP:TOO: [70]: 2820 |
| [1707996554.411613][20755:20757] CHIP:TOO: [71]: 4294048773 |
| |
| |
| ./chip-tool descriptor read server-list 1 2 |
| |
| Verify ServerList entries on TH (Chip-tool) Log and below is the sample log provided for the raspi platform, Here ServerList entries are 7. |
| |
| [1692618559.962829][31688:31690] CHIP:TOO: Endpoint: 2 Cluster: 0x0000_001D Attribute 0x0000_0001 DataVersion: 1103199808 |
| [1692618559.962884][31688:31690] CHIP:TOO: ServerList: 7 entries |
| [1692618559.962910][31688:31690] CHIP:TOO: [1]: 3 |
| [1692618559.962922][31688:31690] CHIP:TOO: [2]: 4 |
| [1692618559.962933][31688:31690] CHIP:TOO: [3]: 5 |
| [1692618559.962945][31688:31690] CHIP:TOO: [4]: 6 |
| [1692618559.962955][31688:31690] CHIP:TOO: [5]: 29 |
| [1692618559.962966][31688:31690] CHIP:TOO: [6]: 47 |
| [1692618559.962978][31688:31690] CHIP:TOO: [7]: 1030 |
| disabled: true |
| |
| - label: "Step 3: TH reads 'ClientList' attribute" |
| PICS: DESC.S.A0002 |
| verification: | |
| For all the Endpoint id’s listed in step 1a run the following steps. For all the client list entries listed in the output - Convert them to Hex values. For example 29 is 0x001D. Verify that these are also present in the device_type.json. Every server cluster listed in the JSON should correspond to a number here in the output. |
| |
| The cluster ID's listed in the below log is from the All-Cluster-app. Please run the below command in all the Reference apps (bridge-app, tv-app, microwave-oven-app, Lock-app, Energy-Management-app and Thermostat-app). |
| |
| ./chip-tool descriptor read client-list 1 1 |
| |
| Verify client list entries on the TH (Chip-tool) and below is the sample log provided for the raspi platform, Here ClientList entries are 1. |
| |
| [1676367470.160199][9805:9807] CHIP:DMG: } |
| [1676367470.160268][9805:9807] CHIP:TOO: Endpoint: 1 Cluster: 0x0000_001D Attribute 0x0000_0002 DataVersion: 3336430903 |
| [1676367470.160282][9805:9807] CHIP:TOO: ClientList: 1 entries |
| [1676367470.160289][9805:9807] CHIP:TOO: [1]: 6 |
| |
| ./chip-tool descriptor read client-list 1 2 |
| |
| Verify client list entries on the TH (Chip-tool) and below is the sample log provided for the raspi platform, Here ClientList entries are 0. |
| |
| [1660146160.390200][46818:46823] CHIP:TOO: Endpoint: 2 Cluster: 0x0000_001D Attribute 0x0000_0002 DataVersion: 1051414887 |
| [1660146160.390211][46818:46823] CHIP:TOO: ClientList: 0 entries |
| disabled: true |
| |
| - label: "Step 4: TH reads 'PartsList' attribute." |
| PICS: DESC.S.A0003 |
| verification: | |
| ./chip-tool descriptor read parts-list 1 0 |
| |
| Verify PartsList response greater than 0 and Endpoint is in the range of 1 to 65534 on the TH (Chip-tool) and below is the sample log provided for the raspi platform: |
| |
| [1672919326.178697][33468:33470] CHIP:TOO: Endpoint: 0 Cluster: 0x0000_001D Attribute 0x0000_0003 DataVersion: 2847656117 |
| [1672919326.178739][33468:33470] CHIP:TOO: PartsList: 2 entries |
| [1672919326.178765][33468:33470] CHIP:TOO: [1]: 1 |
| [1672919326.178777][33468:33470] CHIP:TOO: [2]: 2 |
| disabled: true |
| |
| - label: "Step 5: TH reads from the DUT the 'TagList' attribute." |
| PICS: DESC.S.A0004 |
| verification: | |
| ./chip-tool descriptor read tag-list 1 0 |
| |
| - Verify that the DUT response contains a TagList and SHALL contain at least one element. |
| - Read each TagStruct from the list and check for the following: |
| - Number of entries in TagList is in the range of 1 to 6 and each entry contains at least a NamespaceID and a Tag property. Confirm that each entry is unique (i.e. no duplicate tags). |
| - If the MfgCode field is not null, confirm that it is the Vendor ID of the manufacturer who has defined a certain namespace and that the NamespaceID field indicates which namespace from the manufacturer is associated with the Tag field. |
| - Confirm that each non-manufacturer specific tag is from a namespace defined in the spec (either from an common namespace or from a namespace for the particular device type). |
| - If a manufacturer specific Tag field is indicated, at least one standardized tag which is not from any manufacturer’s namespace shall be included in the TagList. |
| - Tag field is the ID of a semantic tag within the namespace indicated by the NamespaceID property. |
| |
| [1692959866.253223][12664:12666] CHIP:TOO: Endpoint: 0 Cluster: 0x0000_001D Attribute 0x0000_0004 DataVersion: 2088189574 |
| [1692959866.253237][12664:12666] CHIP:TOO: TagList: 2 entries |
| [1692959866.253248][12664:12666] CHIP:TOO: [1]: { |
| [1692959866.253251][12664:12666] CHIP:TOO: MfgCode: null |
| [1692959866.253255][12664:12666] CHIP:TOO: NamespaceID: 7 |
| [1692959866.253257][12664:12666] CHIP:TOO: Tag: 0 |
| [1692959866.253260][12664:12666] CHIP:TOO: } |
| [1692959866.253265][12664:12666] CHIP:TOO: [2]: { |
| [1692959866.253267][12664:12666] CHIP:TOO: MfgCode: null |
| [1692959866.253270][12664:12666] CHIP:TOO: NamespaceID: 8 |
| [1692959866.253272][12664:12666] CHIP:TOO: Tag: 3 |
| [1692959866.253274][12664:12666] CHIP:TOO: } |
| disabled: true |
| |
| - label: |
| "Step 5: The cluster tests applicable to each Device Type should be |
| executed to make sure all mandatory (and applicable optional) |
| attributes/commands are implemented." |
| verification: | |
| This step is redundant as during certification the appropriate tests are being run |
| disabled: true |
