Add test scripts for THNETDIR cluster

Base on CHIP-Specifications/chip-test-plans#4322
but contains some additional steps which will be added to the test plan.

Some validations depend on PR #34487 and are commented out.

src/app/tests/suites/certification/PICS.yaml

@@ -10199,3 +10199,11 @@ PICS:
 
     - label: "Does the device implement the ActiveEndpoints attribute?"
       id: PWRTL.S.A0001
+
+    #
+    # Thread Network Directory Cluster
+    #
+    - label:
+          "Does the device implement the Thread Network Directory cluster as a
+          server"
+      id: THNETDIR.S

src/app/tests/suites/certification/Test_TC_THNETDIR_2_1.yaml

@@ -0,0 +1,51 @@
+# Copyright (c) 2024 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.
+
+name: "[TC-THNETDIR-2.1] Simple Attributes check with DUT as Server"
+
+PICS:
+    - THNETDIR.S
+
+config:
+    nodeId: 0x12344321
+    cluster: Thread Network Directory
+    endpoint: 1
+
+tests:
+    - label: "Wait for the commissioned device to be retrieved"
+      cluster: DelayCommands
+      command: WaitForCommissionee
+      arguments:
+          values:
+              - name: nodeId
+                value: nodeId
+
+    - label: "TH reads SupportedFabrics attribute from DUT"
+      command: readAttribute
+      endpoint: 0
+      cluster: Operational Credentials
+      attribute: SupportedFabrics
+      response:
+          saveAs: supportedFabrics
+          constraints:
+              type: int8u
+
+    - label: "TH reads ThreadNetworkTableSize attribute from DUT"
+      command: readAttribute
+      attribute: ThreadNetworkTableSize
+      response:
+          constraints:
+              type: int8u
+              minValue: 10 # assume 5 supported fabrics
+              # python: value >= 2 * supportedFabrics

src/app/tests/suites/certification/Test_TC_THNETDIR_2_2.yaml

@@ -0,0 +1,199 @@
+# Copyright (c) 2024 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.
+
+name: "[TC-THNETDIR-2.2] Verification for Add/Remove/Get commands"
+
+PICS:
+    - THNETDIR.S
+
+config:
+    nodeId: 0x12344321
+    cluster: Thread Network Directory
+    endpoint: 1
+
+    # Note: TestNetwork* values need to match what's encoded in TestNetworkDataset
+    TestNetworkDataset:
+        type: octet_string
+        defaultValue: "hex:0e080000000000000001000300000f350407fff800020839758ec8144b07fb0708fdf1f1add0797dc00510f366cec7a446bab978d90d27abe38f23030f4f70656e5468726561642d353933380102593804103ca67c969efb0d0c74a4d8ee923b576c0c0402a0f7f8"
+    TestNetworkExtendedPanId:
+        type: octet_string
+        defaultValue: "hex:39758ec8144b07fb"
+    TestNetworkName: "OpenThread-5938"
+    TestNetworkChannel: 15
+    TestNetworkActiveTimestamp: 1
+
+tests:
+    - label: "Wait for the commissioned device to be retrieved"
+      cluster: DelayCommands
+      command: WaitForCommissionee
+      arguments:
+          values:
+              - name: nodeId
+                value: nodeId
+
+    - label: "TH reads ThreadNetworks attribute from DUT"
+      command: readAttribute
+      attribute: ThreadNetworks
+      response:
+          saveAs: initialNetworks
+          constraints:
+              type: list
+
+    - label: "TH reads PreferredExtendedPanID attribute from DUT"
+      command: readAttribute
+      attribute: PreferredExtendedPanID
+      response:
+          constraints:
+              type: octet_string
+              minLength: 8
+              maxLength: 8
+              notValue: TestNetworkExtendedPanId
+
+    - label:
+          "TH writes ExtendedPanID from TestNetwork to PreferredExtendedPanID on
+          DUT"
+      command: writeAttribute
+      attribute: PreferredExtendedPanID
+      arguments:
+          value: TestNetworkExtendedPanId
+      response:
+          error: CONSTRAINT_ERROR # TestNetwork is not in ThreadNetworks
+
+    - label:
+          "TH sends GetOperationalDataset command to DUT with ExtendedPanID of
+          TestNetwork"
+      command: GetOperationalDataset
+      arguments:
+          values:
+              - name: ExtendedPanID
+                value: TestNetworkExtendedPanId
+      response:
+          error: NOT_FOUND
+
+    - label: "TH sends AddNetwork command to DUT without a timed interaction"
+      command: AddNetwork
+      arguments:
+          values:
+              - name: OperationalDataset
+                value: TestNetworkDataset
+      response:
+          error: NEEDS_TIMED_INTERACTION
+
+    - label: "TH sends AddNetwork command to DUT with TestNetwork dataset"
+      command: AddNetwork
+      timedInteractionTimeoutMs: 2000
+      arguments:
+          values:
+              - name: OperationalDataset
+                value: TestNetworkDataset
+
+    - label: "TH reads ThreadNetworks attribute from DUT"
+      command: readAttribute
+      attribute: ThreadNetworks
+      response:
+          constraints:
+              type: list
+              #   python: |
+              #       # Split the list into test (our TestNetwork) and rest (everything else)
+              #       test = next((n for n in value if n['ExtendedPanID'] == TestNetworkExtendedPanId), None)
+              #       rest = [n for n in value if n != test]
+              #       # Check test has the expected values and rest == initialNetworks (ignoring order)
+              #       return (test is not None and
+              #               test['NetworkName'] == TestNetworkName and
+              #               test['Channel'] == TestNetworkChannel and
+              #               test['ActiveTimestamp'] == TestNetworkActiveTimestamp and
+              #               len(value) == len(initialNetworks) + 1 and
+              #               len(rest) == len(initialNetworks) and
+              #               all(n in initialNetworks for n in rest))
+
+    - label:
+          "TH sends GetOperationalDataset command to DUT with ExtendedPanID from
+          TestNetwork"
+      command: GetOperationalDataset
+      arguments:
+          values:
+              - name: ExtendedPanID
+                value: TestNetworkExtendedPanId
+      response:
+          values:
+              - name: OperationalDataset
+                value: TestNetworkDataset
+
+    - label:
+          "TH writes ExtendedPanID from TestNetwork to PreferredExtendedPanID on
+          DUT"
+      command: writeAttribute
+      attribute: PreferredExtendedPanID
+      arguments:
+          value: TestNetworkExtendedPanId
+
+    - label: "TH reads PreferredExtendedPanID attribute from DUT"
+      command: readAttribute
+      attribute: PreferredExtendedPanID
+      response:
+          value: TestNetworkExtendedPanId
+
+    - label: "TH sends RemoveNetwork command to DUT without a timed interaction"
+      command: RemoveNetwork
+      arguments:
+          values:
+              - name: ExtendedPanID
+                value: TestNetworkExtendedPanId
+      response:
+          error: NEEDS_TIMED_INTERACTION
+
+    - label:
+          "TH sends RemoveNetwork command to DUT with ExtendedPanID of
+          TestNetwork while it is the preferred network"
+      command: RemoveNetwork
+      timedInteractionTimeoutMs: 2000
+      arguments:
+          values:
+              - name: ExtendedPanID
+                value: TestNetworkExtendedPanId
+      response:
+          error: CONSTRAINT_ERROR # Preferred network cannot be removed
+
+    - label: "TH writes null to PreferredExtendedPanID on DUT"
+      command: writeAttribute
+      attribute: PreferredExtendedPanID
+      arguments:
+          value: null
+
+    - label: "TH reads PreferredExtendedPanID attribute from DUT"
+      command: readAttribute
+      attribute: PreferredExtendedPanID
+      response:
+          value: null
+
+    - label:
+          "TH sends RemoveNetwork command to DUT with ExtendedPanID of
+          TestNetwork"
+      command: RemoveNetwork
+      timedInteractionTimeoutMs: 2000
+      arguments:
+          values:
+              - name: ExtendedPanID
+                value: TestNetworkExtendedPanId
+
+    - label: "TH reads ThreadNetworks attribute from DUT"
+      command: readAttribute
+      attribute: ThreadNetworks
+      response:
+          constraints:
+              type: list
+              #   python: |
+              #       # value == initialNetworks (ignoring order)
+              #       return (len(value) == len(initialNetworks) and
+              #               all(n in initialNetworks for n in value))