Implement Thread Network Directory server (project-chip#34343)

* Update Thread Network Directory cluster definition

- Use octstr[8] for ExtendedPanID fields
- Add ActiveTimestamp to ThreadNetworkStruct
- Remove NetworkChanged event

PreferredExtendedPanID is nullable, so the uint64 representation is not
suitable because the value 0xFFF... is disallowed as a null marker. Change all
related attributes / fields to octstr[8] to be consistent.

Also add the cluster to the relevant meta-data files.

See CHIP-Specifications/connectedhomeip-spec#10019

* zap_regen_all

* Implement Thread Network Directory server

Also add it to the network-manager example app.

* Apply suggestions from code review

Co-authored-by: Boris Zbarsky <bzbarsky@apple.com>
Co-authored-by: Kiel Oleson <kielo@apple.com>

* Apply suggestions from code review

Co-authored-by: Boris Zbarsky <bzbarsky@apple.com>

* Remove stale zap generated files

* Address review comments

Remove DefaultInstance() and weak cluster init function and instead provide a
DefaultThreadNetworkDirectoryServer sub-class that's easy to instantiate with
the default storage implementation.

Roll back in-memory state on persistent storage failure and add tests for this.

Add documentation about ByteSpan lifetimes in OperationalDataset class.

Add comments to MTRDemuxingStorage.mm

* Use emberAf...ClusterInitCallback (not ...Server)

* Address review comments

* Avoid conversion warning

---------

Co-authored-by: Boris Zbarsky <bzbarsky@apple.com>
Co-authored-by: Kiel Oleson <kielo@apple.com>

Author: 3 people

examples/network-manager-app/linux/main.cpp

@@ -16,10 +16,14 @@
  */
 
 #include <AppMain.h>
+#include <app/clusters/thread-network-directory-server/thread-network-directory-server.h>
 #include <app/clusters/wifi-network-management-server/wifi-network-management-server.h>
 #include <lib/core/CHIPSafeCasts.h>
+#include <lib/support/CodeUtils.h>
 #include <lib/support/Span.h>
 
+#include <optional>
+
 using namespace chip;
 using namespace chip::app;
 using namespace chip::app::Clusters;
@@ -32,6 +36,13 @@ ByteSpan ByteSpanFromCharSpan(CharSpan span)
     return ByteSpan(Uint8::from_const_char(span.data()), span.size());
 }
 
+std::optional<DefaultThreadNetworkDirectoryServer> gThreadNetworkDirectoryServer;
+void emberAfThreadNetworkDirectoryClusterInitCallback(chip::EndpointId endpoint)
+{
+    VerifyOrDie(!gThreadNetworkDirectoryServer);
+    gThreadNetworkDirectoryServer.emplace(endpoint).Init();
+}
+
 int main(int argc, char * argv[])
 {
     if (ChipLinuxAppInit(argc, argv) != 0)

examples/network-manager-app/network-manager-common/network-manager-app.matter

@@ -1195,6 +1195,51 @@ cluster WiFiNetworkManagement = 1105 {
   command access(invoke: administer) NetworkPassphraseRequest(): NetworkPassphraseResponse = 0;
 }
 
+/** Manages the names and credentials of Thread networks visible to the user. */
+cluster ThreadNetworkDirectory = 1107 {
+  revision 1;
+
+  struct ThreadNetworkStruct {
+    octet_string<8> extendedPanID = 0;
+    char_string<16> networkName = 1;
+    int16u channel = 2;
+    int64u activeTimestamp = 3;
+  }
+
+  attribute access(read: manage, write: manage) nullable octet_string<8> preferredExtendedPanID = 0;
+  readonly attribute access(read: operate) ThreadNetworkStruct threadNetworks[] = 1;
+  readonly attribute int8u threadNetworkTableSize = 2;
+  readonly attribute command_id generatedCommandList[] = 65528;
+  readonly attribute command_id acceptedCommandList[] = 65529;
+  readonly attribute event_id eventList[] = 65530;
+  readonly attribute attrib_id attributeList[] = 65531;
+  readonly attribute bitmap32 featureMap = 65532;
+  readonly attribute int16u clusterRevision = 65533;
+
+  request struct AddNetworkRequest {
+    octet_string<254> operationalDataset = 0;
+  }
+
+  request struct RemoveNetworkRequest {
+    octet_string<8> extendedPanID = 0;
+  }
+
+  request struct GetOperationalDatasetRequest {
+    octet_string<8> extendedPanID = 0;
+  }
+
+  response struct OperationalDatasetResponse = 3 {
+    octet_string<254> operationalDataset = 0;
+  }
+
+  /** Adds an entry to the ThreadNetworks list. */
+  timed command access(invoke: manage) AddNetwork(AddNetworkRequest): DefaultSuccess = 0;
+  /** Removes an entry from the ThreadNetworks list. */
+  timed command access(invoke: manage) RemoveNetwork(RemoveNetworkRequest): DefaultSuccess = 1;
+  /** Retrieves a Thread Operational Dataset from the ThreadNetworks list. */
+  timed command GetOperationalDataset(GetOperationalDatasetRequest): OperationalDatasetResponse = 2;
+}
+
 endpoint 0 {
   device type ma_rootdevice = 22, version 1;
 
@@ -1473,6 +1518,23 @@ endpoint 1 {
     handle command NetworkPassphraseRequest;
     handle command NetworkPassphraseResponse;
   }
+
+  server cluster ThreadNetworkDirectory {
+    callback attribute preferredExtendedPanID;
+    callback attribute threadNetworks;
+    callback attribute threadNetworkTableSize;
+    callback attribute generatedCommandList;
+    callback attribute acceptedCommandList;
+    callback attribute eventList;
+    callback attribute attributeList;
+    ram      attribute featureMap default = 0;
+    ram      attribute clusterRevision default = 1;
+
+    handle command AddNetwork;
+    handle command RemoveNetwork;
+    handle command GetOperationalDataset;
+    handle command OperationalDatasetResponse;
+  }
 }