Merge pull request #22 from SiliconLabs/release-3.0.0

24Q4-GA Release changes
SiliconLabs · Dec 16, 2024 · ae7ff65 · ae7ff65
2 parents 790fc8e + f2e30be
commit ae7ff65
Show file tree

Hide file tree

Showing 158 changed files with 30,082 additions and 18,787 deletions.
diff --git a/Matter.framework/Headers/MTRAccessGrant.h b/Matter.framework/Headers/MTRAccessGrant.h
@@ -25,7 +25,7 @@ NS_ASSUME_NONNULL_BEGIN
  * Control cluster.
  */
 NS_SWIFT_SENDABLE
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @interface MTRAccessGrant : NSObject <NSCopying>
 
 - (instancetype)init NS_UNAVAILABLE;

diff --git a/Matter.framework/Headers/MTRBackwardsCompatShims.h b/Matter.framework/Headers/MTRBackwardsCompatShims.h
diff --git a/Matter.framework/Headers/MTRBaseClusters.h b/Matter.framework/Headers/MTRBaseClusters.h
diff --git a/Matter.framework/Headers/MTRBaseDevice.h b/Matter.framework/Headers/MTRBaseDevice.h
@@ -164,8 +164,9 @@ typedef NS_ENUM(uint8_t, MTRTransportType) {
  *
  * nil is used to represent wildcards.
  */
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0))
-@interface MTRAttributeRequestPath : NSObject <NSCopying>
+@interface MTRAttributeRequestPath : NSObject <NSCopying, NSSecureCoding>
 @property (nonatomic, readonly, copy, nullable) NSNumber * endpoint MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0));
 @property (nonatomic, readonly, copy, nullable) NSNumber * cluster MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0));
 @property (nonatomic, readonly, copy, nullable)
@@ -182,8 +183,9 @@ MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0))
  *
  * nil is used to represent wildcards.
  */
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0))
-@interface MTREventRequestPath : NSObject <NSCopying>
+@interface MTREventRequestPath : NSObject <NSCopying, NSSecureCoding>
 @property (nonatomic, readonly, copy, nullable) NSNumber * endpoint MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0));
 @property (nonatomic, readonly, copy, nullable) NSNumber * cluster MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0));
 @property (nonatomic, readonly, copy, nullable) NSNumber * event MTR_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0), tvos(17.0));
@@ -564,14 +566,15 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
                   timeout:(NSTimeInterval)timeout
                     queue:(dispatch_queue_t)queue
                completion:(void (^)(NSURL * _Nullable url, NSError * _Nullable error))completion
-    MTR_NEWLY_AVAILABLE;
+    MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @end
 
 /**
  * A path indicating a specific cluster on a device (i.e. without any
  * wildcards).
  */
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4))
 @interface MTRClusterPath : NSObject <NSCopying, NSSecureCoding>
 
@@ -588,6 +591,7 @@ MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4))
  * A path indicating a specific attribute on a device (i.e. without any
  * wildcards).
  */
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
 @interface MTRAttributePath : MTRClusterPath <NSSecureCoding>
 
@@ -604,6 +608,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * (i.e. without any wildcards).  There can be multiple instances of actual
  * events for a given event path.
  */
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
 @interface MTREventPath : MTRClusterPath
 
@@ -618,6 +623,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * A path indicating a specific command on a device (i.e. without any
  * wildcards).
  */
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
 @interface MTRCommandPath : MTRClusterPath
 
@@ -628,6 +634,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
                                     commandID:(NSNumber *)commandID MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4));
 @end
 
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
 @interface MTRAttributeReport : NSObject
 
@@ -640,7 +647,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * * The attribute is nullable and the value of the attribute is null.
  *
  * If value is not nil, the actual type of value will depend on the
- * schema-defined (typically defiend in the Matter specification) type of the
+ * schema-defined (typically defined in the Matter specification) type of the
  * attribute as follows:
  *
  * * list: NSArray of whatever type the list entries are.
@@ -697,6 +704,7 @@ typedef NS_ENUM(NSUInteger, MTREventPriority) {
     MTREventPriorityCritical = 2
 } MTR_AVAILABLE(ios(16.5), macos(13.4), watchos(9.5), tvos(16.5));
 
+NS_SWIFT_SENDABLE
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
 @interface MTREventReport : NSObject
 

diff --git a/Matter.framework/Headers/MTRCluster.h b/Matter.framework/Headers/MTRCluster.h
@@ -73,7 +73,7 @@ MTR_AVAILABLE(ios(17.4), macos(14.4), watchos(10.4), tvos(17.4))
  *    treated as if a default-initialized object was passed in.
  */
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
-@interface MTRWriteParams : NSObject <NSCopying>
+@interface MTRWriteParams : NSObject <NSCopying, NSSecureCoding>
 
 /**
  * Controls whether the write is a timed write.
@@ -109,7 +109,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  *    treated as if a default-initialized object was passed in.
  */
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
-@interface MTRReadParams : NSObject <NSCopying>
+@interface MTRReadParams : NSObject <NSCopying, NSSecureCoding>
 
 /**
  * Whether the read/subscribe is fabric-filtered. The default is YES.
@@ -132,6 +132,17 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  */
 @property (nonatomic, copy, nullable) NSNumber * minEventNumber MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4));
 
+/**
+ * Controls whether attributes without known schema (e.g. vendor-specific
+ * attributes) should be assumed to be reportable normally via subscriptions.
+ * The default is YES.
+ *
+ * This setting is only relevant to some consumers of MTRReadParams.  One of
+ * those consumers is readAttributeWithEndpointID:clusterID:attributeID:params:
+ * on MTRDevice.
+ */
+@property (nonatomic, assign, getter=shouldAssumeUnknownAttributesReportable) BOOL assumeUnknownAttributesReportable MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
+
 @end
 
 /**
@@ -141,7 +152,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  *    treated as if a default-initialized object was passed in.
  */
 MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
-@interface MTRSubscribeParams : MTRReadParams
+@interface MTRSubscribeParams : MTRReadParams <NSCopying, NSSecureCoding>
 
 /**
  * Whether the subscribe should replace already-existing