matter-python-client 1.4.1a10.dev20261006__tar.gz → 1.5.0__tar.gz

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matter-python-client
-Version: 1.4.1a10.dev20261006
+Version: 1.5.0
 Summary: Python Client for the OHF Matter Server
 Author-email: Open Home Foundation <hello@openhomefoundation.io>
 License-Expression: Apache-2.0
@@ -110,6 +110,68 @@ Beyond the `python-matter-server` API, the client exposes commands the Matter.js
   then streams the bytes to `POST /ota-upload/<upload_id>`. Raises `OtaUploadError` (code 101) for a
   corrupt image, an expired/spent id, or disabled OTA support.
 - `get_icd_state`, `register_icd`, `unregister_icd`, `resync_icd` — ICD Check-In registration
+- `read`, `subscribe`, `unsubscribe`, `enable_auto_subscription`, `disable_auto_subscription` — Matter
+  read and subscribe requests with explicit paths (schema 14+). `read` returns an `InteractionReport`,
+  `subscribe` a `SubscribeResult` (the priming report plus `subscription_id`). A subscription is named by
+  `node_id` and `subscription_id` together. Later reports arrive as `subscription_report` events
+  (`SubscriptionReportData`), an end the caller did not ask for as `subscription_ended`
+  (`SubscriptionEndedData`); both go only to the connection that subscribed and reach `node_filter`
+  subscribers. Pass `listener` to `subscribe` to get every event of that one subscription, including those
+  the server sends right behind the response. The listener gets no further calls once `unsubscribe` is
+  called. When the connection is lost or `disconnect` is called, the listener receives a
+  `subscription_ended` that the client builds itself, because the server ends the subscription without
+  sending one; `node_filter` subscribers do not get it. If a `subscribe` call is cancelled or times out
+  (for example in `asyncio.wait_for`) before it returns, the client ends that subscription with
+  `unsubscribe` and logs a failure of that call. `subscribe`, `unsubscribe` and the two auto
+  subscription methods need a server running with auto subscription disabled.
+- `commission_with_code` and `commission_on_network` take `discovery_timeout_s` (schema 14+)
+- `send_batched_device_commands` — sends `(endpoint_id, command)` pairs to one node in a single InvokeRequest and returns
+  one `BatchedCommandResult` per command (schema 14+)
+- `write_attribute` takes `*` as the endpoint to write all endpoints of the node that have the attribute, and
+  `timed_request_timeout_ms` for a timed write (schema 14+)
+- `parse_onboarding_payload` — decodes a QR code or manual pairing code without contacting a device and returns
+  `QrOnboardingPayloadResult` or `ManualOnboardingPayloadResult` (schema 14+)
+- `camera_get_capabilities`, `camera_start_stream`, `camera_provide_answer`,
+  `camera_provide_ice_candidates`, `camera_stop_stream`, `camera_snapshot`, `camera_release_stream`
+  — the camera API (schema 14+). `camera_get_capabilities`, `camera_start_stream`, `camera_stop_stream`
+  and `camera_snapshot` return dataclasses from `matter_server.common.models`; the other three return
+  `None`.
+  `camera_start_stream`'s `video` / `audio` take `None` (the server decides), a `CameraVideoHints` /
+  `CameraAudioHints` dict, or `False` (no such track). `talkback=True` lets the offer ask the camera to
+  play your audio; without it the server makes the offer's audio sections not send, so a browser-style
+  `sendrecv` audio offer goes to the camera as `recvonly`. `camera_session_ended` and
+  `camera_stream_evicted` events arrive as `CameraSessionEndedData` / `CameraStreamEvictedData`;
+  `webrtc_callback` stays a dict. `camera_session_ended` covers every end of a session opened with
+  `camera_start_stream` that the client did not ask for, the camera's own `End` included; its `cause` says why. Errors 102 to 106 (`CameraStreamIncompatible`, ...) expose their
+  details as attributes, e.g. `err.reason` and `err.bound` on `CameraStreamIncompatible`
+
+  `camera_start_stream(..., client_session_key="...")` names the session with your own key (1 to 128
+  characters, unique among the connection's starting and open sessions). Every `webrtc_callback` and
+  `camera_session_ended` event of the session carries it as `client_session_key`, so a handler can
+  match events even when it runs before the awaited call returns. `camera_provide_ice_candidates(node_id,
+  endpoint_id, None, candidates, client_session_key=...)` and `camera_stop_stream(node_id, endpoint_id,
+  client_session_key=...)` take it in place of the session id, also while `camera_start_stream` is still
+  running: candidates are queued on the server and sent after the start's response, and the stop cancels
+  the start.
+
+  The minimal `camera_start_stream` call is `node_id`, `endpoint_id`, `stream_usage` and your SDP
+  offer: the server reuses or allocates the best stream the camera can serve that still fits what
+  the offer can decode, and adds audio when it can. Pass `video` / `audio` hints only to set hard bounds. A
+  session opened this way is driven with `camera_provide_answer`, `camera_provide_ice_candidates`
+  and `camera_stop_stream` only, not with `send_webrtc_provider_command` or a `send_device_command`
+  `EndSession`: the server tracks the session and its streams, and only the `camera_*` methods keep
+  that record correct. The exception is a re-offer (ICE restart), which goes through
+  `send_webrtc_provider_command`. See `docs/websockets_api.md` for the flow and every option.
+
+```python
+    try:
+        result = await client.camera_start_stream(node_id, 1, "LiveView", sdp=offer)
+    except CameraStreamIncompatible as err:
+        print(err.reason, err.bound)
+    else:
+        # The camera's answer arrives as a webrtc_callback "answer" event for this session.
+        print(result.webrtc_session_id, result.video.codec if result.video else None)
+```
 
 ```python
     version = await client.upload_ota_file("/path/to/firmware.ota")

matter_python_client-1.5.0/README.md

@@ -0,0 +1,162 @@
+# Python Client for the OHF Matter Server
+
+A PyPI package (`matter-python-client`) providing Python bindings for the [OHF Matter Server](https://github.com/matter-js/matterjs-server). This is a drop-in replacement for the client portion of [`python-matter-server`](https://github.com/matter-js/python-matter-server), with custom cluster definitions updated to match the Matter.js server.
+
+## Origin
+
+The client and common modules were copied from [`python-matter-server` v8.1.2](https://github.com/matter-js/python-matter-server) and modified:
+
+- **Source**: `matter_server/client/` and `matter_server/common/` from python-matter-server
+- **Modified**: `matter_server/common/custom_clusters.py` — updated to match the JS server's cluster definitions
+- **Excluded**: `matter_server/server/` (the JS server replaces it), `common/helpers/logger.py` (depends on `coloredlogs`, a server-only dependency)
+
+### Custom Cluster Changes
+
+| Cluster | Change |
+|---------|--------|
+| EveCluster | +8 attributes (getConfig, setConfig, loggingMetadata, loggingData, lastEventTime, statusFault, childLock, rloc16), wattAccumulatedControlPoint type fixed |
+| HeimanCluster | Attribute IDs shortened to match JS server |
+| NeoCluster | Types changed from float32 to uint |
+| Polling | Removed (JS server handles polling natively) |
+
+## Package
+
+- **PyPI name**: `matter-python-client`
+- **Python module**: `matter_server` (same import path as `python-matter-server`)
+- **Python**: >= 3.12
+- **Dependencies**: `aiohttp`, `orjson`, `home-assistant-chip-clusters`
+
+## npm Scripts (from monorepo root)
+
+```bash
+# First-time setup: create venv and install with test dependencies
+npm run python:install
+
+# Run unit + mock server tests (fast, ~1s)
+npm run python:test
+
+# Run full integration tests against real Matter.js server + test device (~40s)
+npm run python:test-integration
+
+# Run all Python tests
+npm run python:test-all
+
+# Build the PyPI package (.tar.gz + .whl)
+npm run python:build
+```
+
+## Usage
+
+The package provides the same `matter_server.client` API as `python-matter-server`:
+
+```python
+import aiohttp
+from matter_server.client import MatterClient
+
+async with aiohttp.ClientSession() as session:
+    client = MatterClient("ws://localhost:5580/ws", session)
+    await client.connect()
+
+    init_ready = asyncio.Event()
+    listen_task = asyncio.create_task(client.start_listening(init_ready))
+    await init_ready.wait()
+
+    nodes = client.get_nodes()
+```
+
+To reach a server that listens on a unix socket (`--listen-address /path/to/socket`), pass
+`unix:///path/to/socket` as the server URL. The client then opens its own session on that socket
+for the WebSocket and the OTA upload, and the session passed in stays unused.
+
+### OHF-only extensions
+
+Beyond the `python-matter-server` API, the client exposes commands the Matter.js server adds:
+
+- `get_network_topology(refresh=False)` — the Thread/Wi-Fi network as a graph (schema 13+)
+- `upload_ota_file(image)` — store a local `.ota` firmware image in the server's OTA image store
+  (schema 13+). Takes the raw bytes or a path; reserves an upload id over the WebSocket session,
+  then streams the bytes to `POST /ota-upload/<upload_id>`. Raises `OtaUploadError` (code 101) for a
+  corrupt image, an expired/spent id, or disabled OTA support.
+- `get_icd_state`, `register_icd`, `unregister_icd`, `resync_icd` — ICD Check-In registration
+- `read`, `subscribe`, `unsubscribe`, `enable_auto_subscription`, `disable_auto_subscription` — Matter
+  read and subscribe requests with explicit paths (schema 14+). `read` returns an `InteractionReport`,
+  `subscribe` a `SubscribeResult` (the priming report plus `subscription_id`). A subscription is named by
+  `node_id` and `subscription_id` together. Later reports arrive as `subscription_report` events
+  (`SubscriptionReportData`), an end the caller did not ask for as `subscription_ended`
+  (`SubscriptionEndedData`); both go only to the connection that subscribed and reach `node_filter`
+  subscribers. Pass `listener` to `subscribe` to get every event of that one subscription, including those
+  the server sends right behind the response. The listener gets no further calls once `unsubscribe` is
+  called. When the connection is lost or `disconnect` is called, the listener receives a
+  `subscription_ended` that the client builds itself, because the server ends the subscription without
+  sending one; `node_filter` subscribers do not get it. If a `subscribe` call is cancelled or times out
+  (for example in `asyncio.wait_for`) before it returns, the client ends that subscription with
+  `unsubscribe` and logs a failure of that call. `subscribe`, `unsubscribe` and the two auto
+  subscription methods need a server running with auto subscription disabled.
+- `commission_with_code` and `commission_on_network` take `discovery_timeout_s` (schema 14+)
+- `send_batched_device_commands` — sends `(endpoint_id, command)` pairs to one node in a single InvokeRequest and returns
+  one `BatchedCommandResult` per command (schema 14+)
+- `write_attribute` takes `*` as the endpoint to write all endpoints of the node that have the attribute, and
+  `timed_request_timeout_ms` for a timed write (schema 14+)
+- `parse_onboarding_payload` — decodes a QR code or manual pairing code without contacting a device and returns
+  `QrOnboardingPayloadResult` or `ManualOnboardingPayloadResult` (schema 14+)
+- `camera_get_capabilities`, `camera_start_stream`, `camera_provide_answer`,
+  `camera_provide_ice_candidates`, `camera_stop_stream`, `camera_snapshot`, `camera_release_stream`
+  — the camera API (schema 14+). `camera_get_capabilities`, `camera_start_stream`, `camera_stop_stream`
+  and `camera_snapshot` return dataclasses from `matter_server.common.models`; the other three return
+  `None`.
+  `camera_start_stream`'s `video` / `audio` take `None` (the server decides), a `CameraVideoHints` /
+  `CameraAudioHints` dict, or `False` (no such track). `talkback=True` lets the offer ask the camera to
+  play your audio; without it the server makes the offer's audio sections not send, so a browser-style
+  `sendrecv` audio offer goes to the camera as `recvonly`. `camera_session_ended` and
+  `camera_stream_evicted` events arrive as `CameraSessionEndedData` / `CameraStreamEvictedData`;
+  `webrtc_callback` stays a dict. `camera_session_ended` covers every end of a session opened with
+  `camera_start_stream` that the client did not ask for, the camera's own `End` included; its `cause` says why. Errors 102 to 106 (`CameraStreamIncompatible`, ...) expose their
+  details as attributes, e.g. `err.reason` and `err.bound` on `CameraStreamIncompatible`
+
+  `camera_start_stream(..., client_session_key="...")` names the session with your own key (1 to 128
+  characters, unique among the connection's starting and open sessions). Every `webrtc_callback` and
+  `camera_session_ended` event of the session carries it as `client_session_key`, so a handler can
+  match events even when it runs before the awaited call returns. `camera_provide_ice_candidates(node_id,
+  endpoint_id, None, candidates, client_session_key=...)` and `camera_stop_stream(node_id, endpoint_id,
+  client_session_key=...)` take it in place of the session id, also while `camera_start_stream` is still
+  running: candidates are queued on the server and sent after the start's response, and the stop cancels
+  the start.
+
+  The minimal `camera_start_stream` call is `node_id`, `endpoint_id`, `stream_usage` and your SDP
+  offer: the server reuses or allocates the best stream the camera can serve that still fits what
+  the offer can decode, and adds audio when it can. Pass `video` / `audio` hints only to set hard bounds. A
+  session opened this way is driven with `camera_provide_answer`, `camera_provide_ice_candidates`
+  and `camera_stop_stream` only, not with `send_webrtc_provider_command` or a `send_device_command`
+  `EndSession`: the server tracks the session and its streams, and only the `camera_*` methods keep
+  that record correct. The exception is a re-offer (ICE restart), which goes through
+  `send_webrtc_provider_command`. See `docs/websockets_api.md` for the flow and every option.
+
+```python
+    try:
+        result = await client.camera_start_stream(node_id, 1, "LiveView", sdp=offer)
+    except CameraStreamIncompatible as err:
+        print(err.reason, err.bound)
+    else:
+        # The camera's answer arrives as a webrtc_callback "answer" event for this session.
+        print(result.webrtc_session_id, result.video.codec if result.video else None)
+```
+
+```python
+    version = await client.upload_ota_file("/path/to/firmware.ota")
+    print(version.vid, version.pid, version.software_version)
+```
+
+To use this package instead of `python-matter-server` in the Home Assistant Matter integration, change `manifest.json`:
+
+```diff
+- "requirements": ["python-matter-server==8.1.2"],
++ "requirements": ["matter-python-client==1.0.0"],
+```
+
+## Testing
+
+The test suite has three layers:
+
+- **Import smoke tests** (8 tests) — verify all HA integration imports resolve
+- **Mock server tests** (4 tests) — Python client against JS MockMatterServer subprocess
+- **Integration tests** (63 tests) — Python client against real Matter.js server + test device, mirroring the JS `IntegrationTest.ts`

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/chip/clusters/Objects.py

@@ -97,6 +97,7 @@ __all__ = [
     "HepaFilterMonitoring",
     "IcdManagement",
     "Identify",
+    "IkeaValveCalibrationCluster",
     "IlluminanceMeasurement",
     "InovelliCluster",
     "JointFabricAdministrator",
@@ -166,6 +167,7 @@ __all__ = [
     "TlsClientManagement",
     "TotalVolatileOrganicCompoundsConcentrationMeasurement",
     "UnitLocalization",
+    "UnitTestingCluster",
     "UserLabel",
     "ValveConfigurationAndControl",
     "WagoCluster",

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/chip/clusters/cluster_defs/AmbientContextSensing.py

@@ -12,7 +12,7 @@ from ...tlv import float32, uint
 from ..ClusterObjects import (Cluster, ClusterAttributeDescriptor, ClusterCommand, ClusterEvent, ClusterObject,
                               ClusterObjectDescriptor, ClusterObjectFieldDescriptor)
 from ..Types import Nullable, NullValue
-from .ModeSelect import ModeSelect
+from .Globals import Globals
 
 
 @dataclass
@@ -27,8 +27,8 @@ class AmbientContextSensing(Cluster):
                 ClusterObjectFieldDescriptor(Label="objectIdentified", Tag=0x00000001, Type=typing.Optional[bool]),
                 ClusterObjectFieldDescriptor(Label="audioContextDetected", Tag=0x00000002, Type=typing.Optional[bool]),
                 ClusterObjectFieldDescriptor(Label="ambientContextType", Tag=0x00000003, Type=typing.Optional[typing.List[AmbientContextSensing.Structs.AmbientContextTypeStruct]]),
-                ClusterObjectFieldDescriptor(Label="ambientContextTypeSupported", Tag=0x00000004, Type=typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]]),
-                ClusterObjectFieldDescriptor(Label="objectCountReached", Tag=0x00000005, Type=typing.Optional[bool]),
+                ClusterObjectFieldDescriptor(Label="ambientContextTypeSupported", Tag=0x00000004, Type=typing.Optional[typing.List[Globals.Structs.semtag]]),
+                ClusterObjectFieldDescriptor(Label="objectCountThresholdReached", Tag=0x00000005, Type=typing.Optional[bool]),
                 ClusterObjectFieldDescriptor(Label="objectCountConfig", Tag=0x00000006, Type=typing.Optional[AmbientContextSensing.Structs.ObjectCountConfigStruct]),
                 ClusterObjectFieldDescriptor(Label="objectCount", Tag=0x00000007, Type=typing.Optional[uint]),
                 ClusterObjectFieldDescriptor(Label="simultaneousDetectionLimit", Tag=0x00000008, Type=typing.Optional[uint]),
@@ -46,8 +46,8 @@ class AmbientContextSensing(Cluster):
     objectIdentified: typing.Optional[bool] = None
     audioContextDetected: typing.Optional[bool] = None
     ambientContextType: typing.Optional[typing.List[AmbientContextSensing.Structs.AmbientContextTypeStruct]] = None
-    ambientContextTypeSupported: typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]] = None
-    objectCountReached: typing.Optional[bool] = None
+    ambientContextTypeSupported: typing.Optional[typing.List[Globals.Structs.semtag]] = None
+    objectCountThresholdReached: typing.Optional[bool] = None
     objectCountConfig: typing.Optional[AmbientContextSensing.Structs.ObjectCountConfigStruct] = None
     objectCount: typing.Optional[uint] = None
     simultaneousDetectionLimit: typing.Optional[uint] = None
@@ -90,10 +90,10 @@ class AmbientContextSensing(Cluster):
             def descriptor(cls) -> ClusterObjectDescriptor:
                 return ClusterObjectDescriptor(
                     Fields=[
-                        ClusterObjectFieldDescriptor(Label="ambientContextSensed", Tag=0, Type=typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]]),
+                        ClusterObjectFieldDescriptor(Label="ambientContextSensed", Tag=0, Type=typing.Optional[typing.List[Globals.Structs.semtag]]),
                     ])
 
-            ambientContextSensed: typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]] = None
+            ambientContextSensed: typing.Optional[typing.List[Globals.Structs.semtag]] = None
 
         @dataclass
         class ObjectCountConfigStruct(ClusterObject):
@@ -101,11 +101,11 @@ class AmbientContextSensing(Cluster):
             def descriptor(cls) -> ClusterObjectDescriptor:
                 return ClusterObjectDescriptor(
                     Fields=[
-                        ClusterObjectFieldDescriptor(Label="countingObject", Tag=0, Type=typing.Optional[ModeSelect.Structs.SemanticTagStruct]),
+                        ClusterObjectFieldDescriptor(Label="countingObject", Tag=0, Type=typing.Optional[Globals.Structs.semtag]),
                         ClusterObjectFieldDescriptor(Label="objectCountThreshold", Tag=1, Type=typing.Optional[uint]),
                     ])
 
-            countingObject: typing.Optional[ModeSelect.Structs.SemanticTagStruct] = None
+            countingObject: typing.Optional[Globals.Structs.semtag] = None
             objectCountThreshold: typing.Optional[uint] = None
 
         @dataclass
@@ -116,7 +116,7 @@ class AmbientContextSensing(Cluster):
                     Fields=[
                         ClusterObjectFieldDescriptor(Label="startTimestamp", Tag=0, Type=typing.Optional[uint]),
                         ClusterObjectFieldDescriptor(Label="endTimestamp", Tag=1, Type=typing.Optional[uint]),
-                        ClusterObjectFieldDescriptor(Label="ambientContextType", Tag=2, Type=typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]]),
+                        ClusterObjectFieldDescriptor(Label="ambientContextType", Tag=2, Type=typing.Optional[typing.List[Globals.Structs.semtag]]),
                         ClusterObjectFieldDescriptor(Label="crowdDetected", Tag=3, Type=typing.Optional[bool]),
                         ClusterObjectFieldDescriptor(Label="crowdCount", Tag=4, Type=typing.Optional[uint]),
                         ClusterObjectFieldDescriptor(Label="confidence", Tag=5, Type=typing.Optional[uint]),
@@ -124,7 +124,7 @@ class AmbientContextSensing(Cluster):
 
             startTimestamp: typing.Optional[uint] = None
             endTimestamp: typing.Optional[uint] = None
-            ambientContextType: typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]] = None
+            ambientContextType: typing.Optional[typing.List[Globals.Structs.semtag]] = None
             crowdDetected: typing.Optional[bool] = None
             crowdCount: typing.Optional[uint] = None
             confidence: typing.Optional[uint] = None
@@ -206,12 +206,12 @@ class AmbientContextSensing(Cluster):
 
             @ChipUtility.classproperty
             def attribute_type(cls) -> ClusterObjectFieldDescriptor:
-                return ClusterObjectFieldDescriptor(Type=typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]])
+                return ClusterObjectFieldDescriptor(Type=typing.Optional[typing.List[Globals.Structs.semtag]])
 
-            value: typing.Optional[typing.List[ModeSelect.Structs.SemanticTagStruct]] = None
+            value: typing.Optional[typing.List[Globals.Structs.semtag]] = None
 
         @dataclass
-        class ObjectCountReached(ClusterAttributeDescriptor):
+        class ObjectCountThresholdReached(ClusterAttributeDescriptor):
             @ChipUtility.classproperty
             def cluster_id(cls) -> int:
                 return 0x00000431
@@ -418,12 +418,12 @@ class AmbientContextSensing(Cluster):
                 return ClusterObjectDescriptor(
                     Fields=[
                         ClusterObjectFieldDescriptor(Label="ambientContextDetected", Tag=0, Type=typing.Optional[AmbientContextSensing.Structs.AmbientContextTypeStruct]),
-                        ClusterObjectFieldDescriptor(Label="objectCountReached", Tag=1, Type=typing.Optional[bool]),
+                        ClusterObjectFieldDescriptor(Label="objectCountThresholdReached", Tag=1, Type=typing.Optional[bool]),
                         ClusterObjectFieldDescriptor(Label="objectCount", Tag=2, Type=typing.Optional[uint]),
                     ])
 
             ambientContextDetected: typing.Optional[AmbientContextSensing.Structs.AmbientContextTypeStruct] = None
-            objectCountReached: typing.Optional[bool] = None
+            objectCountThresholdReached: typing.Optional[bool] = None
             objectCount: typing.Optional[uint] = None
 
         @dataclass
@@ -440,7 +440,9 @@ class AmbientContextSensing(Cluster):
             def descriptor(cls) -> ClusterObjectDescriptor:
                 return ClusterObjectDescriptor(
                     Fields=[
-                        ClusterObjectFieldDescriptor(Label="eventStartTime", Tag=0, Type=typing.Optional[uint]),
+                        ClusterObjectFieldDescriptor(Label="eventStartTimePos", Tag=0, Type=typing.Optional[uint]),
+                        ClusterObjectFieldDescriptor(Label="eventStartTimeSys", Tag=1, Type=typing.Optional[uint]),
                     ])
 
-            eventStartTime: typing.Optional[uint] = None
+            eventStartTimePos: typing.Optional[uint] = None
+            eventStartTimeSys: typing.Optional[uint] = None

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/chip/clusters/cluster_defs/Globals.py

@@ -198,7 +198,6 @@ class Globals:
             kUnsupportedWrite = 0x88
             kResourceExhausted = 0x89
             kNotFound = 0x8B
-            kUnreportableAttribute = 0x8C
             kInvalidDataType = 0x8D
             kUnsupportedRead = 0x8F
             kDataVersionMismatch = 0x92
@@ -207,7 +206,6 @@ class Globals:
             kBusy = 0x9C
             kAccessRestricted = 0x9D
             kUnsupportedCluster = 0xC3
-            kNoUpstreamSubscription = 0xC5
             kNeedsTimedInteraction = 0xC6
             kUnsupportedEvent = 0xC7
             kPathsExhausted = 0xC8

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/chip/clusters/cluster_defs/Groupcast.py

@@ -22,11 +22,11 @@ class Groupcast(Cluster):
     def descriptor(cls) -> ClusterObjectDescriptor:
         return ClusterObjectDescriptor(
             Fields=[
-                ClusterObjectFieldDescriptor(Label="membership", Tag=0x00000000, Type=typing.Optional[typing.List[Groupcast.Structs.MembershipStruct]]),
-                ClusterObjectFieldDescriptor(Label="maxMembershipCount", Tag=0x00000001, Type=typing.Optional[uint]),
-                ClusterObjectFieldDescriptor(Label="maxMcastAddrCount", Tag=0x00000002, Type=typing.Optional[uint]),
-                ClusterObjectFieldDescriptor(Label="usedMcastAddrCount", Tag=0x00000003, Type=typing.Optional[uint]),
-                ClusterObjectFieldDescriptor(Label="fabricUnderTest", Tag=0x00000004, Type=typing.Optional[uint]),
+                ClusterObjectFieldDescriptor(Label="membership", Tag=0x00000000, Type=typing.List[Groupcast.Structs.MembershipStruct]),
+                ClusterObjectFieldDescriptor(Label="maxMembershipCount", Tag=0x00000001, Type=uint),
+                ClusterObjectFieldDescriptor(Label="maxMcastAddrCount", Tag=0x00000002, Type=uint),
+                ClusterObjectFieldDescriptor(Label="usedMcastAddrCount", Tag=0x00000003, Type=uint),
+                ClusterObjectFieldDescriptor(Label="fabricUnderTest", Tag=0x00000004, Type=uint),
                 ClusterObjectFieldDescriptor(Label="generatedCommandList", Tag=0x0000FFF8, Type=typing.List[uint]),
                 ClusterObjectFieldDescriptor(Label="acceptedCommandList", Tag=0x0000FFF9, Type=typing.List[uint]),
                 ClusterObjectFieldDescriptor(Label="attributeList", Tag=0x0000FFFB, Type=typing.List[uint]),
@@ -34,11 +34,11 @@ class Groupcast(Cluster):
                 ClusterObjectFieldDescriptor(Label="clusterRevision", Tag=0x0000FFFD, Type=uint),
             ])
 
-    membership: typing.Optional[typing.List[Groupcast.Structs.MembershipStruct]] = None
-    maxMembershipCount: typing.Optional[uint] = None
-    maxMcastAddrCount: typing.Optional[uint] = None
-    usedMcastAddrCount: typing.Optional[uint] = None
-    fabricUnderTest: typing.Optional[uint] = None
+    membership: typing.List[Groupcast.Structs.MembershipStruct] = field(default_factory=lambda: [])
+    maxMembershipCount: uint = 0
+    maxMcastAddrCount: uint = 0
+    usedMcastAddrCount: uint = 0
+    fabricUnderTest: uint = 0
     generatedCommandList: typing.List[uint] = field(default_factory=lambda: [])
     acceptedCommandList: typing.List[uint] = field(default_factory=lambda: [])
     attributeList: typing.List[uint] = field(default_factory=lambda: [])
@@ -240,9 +240,9 @@ class Groupcast(Cluster):
 
             @ChipUtility.classproperty
             def attribute_type(cls) -> ClusterObjectFieldDescriptor:
-                return ClusterObjectFieldDescriptor(Type=typing.Optional[typing.List[Groupcast.Structs.MembershipStruct]])
+                return ClusterObjectFieldDescriptor(Type=typing.List[Groupcast.Structs.MembershipStruct])
 
-            value: typing.Optional[typing.List[Groupcast.Structs.MembershipStruct]] = None
+            value: typing.List[Groupcast.Structs.MembershipStruct] = field(default_factory=lambda: [])
 
         @dataclass
         class MaxMembershipCount(ClusterAttributeDescriptor):
@@ -256,9 +256,9 @@ class Groupcast(Cluster):
 
             @ChipUtility.classproperty
             def attribute_type(cls) -> ClusterObjectFieldDescriptor:
-                return ClusterObjectFieldDescriptor(Type=typing.Optional[uint])
+                return ClusterObjectFieldDescriptor(Type=uint)
 
-            value: typing.Optional[uint] = None
+            value: uint = 0
 
         @dataclass
         class MaxMcastAddrCount(ClusterAttributeDescriptor):
@@ -272,9 +272,9 @@ class Groupcast(Cluster):
 
             @ChipUtility.classproperty
             def attribute_type(cls) -> ClusterObjectFieldDescriptor:
-                return ClusterObjectFieldDescriptor(Type=typing.Optional[uint])
+                return ClusterObjectFieldDescriptor(Type=uint)
 
-            value: typing.Optional[uint] = None
+            value: uint = 0
 
         @dataclass
         class UsedMcastAddrCount(ClusterAttributeDescriptor):
@@ -288,9 +288,9 @@ class Groupcast(Cluster):
 
             @ChipUtility.classproperty
             def attribute_type(cls) -> ClusterObjectFieldDescriptor:
-                return ClusterObjectFieldDescriptor(Type=typing.Optional[uint])
+                return ClusterObjectFieldDescriptor(Type=uint)
 
-            value: typing.Optional[uint] = None
+            value: uint = 0
 
         @dataclass
         class FabricUnderTest(ClusterAttributeDescriptor):
@@ -304,9 +304,9 @@ class Groupcast(Cluster):
 
             @ChipUtility.classproperty
             def attribute_type(cls) -> ClusterObjectFieldDescriptor:
-                return ClusterObjectFieldDescriptor(Type=typing.Optional[uint])
+                return ClusterObjectFieldDescriptor(Type=uint)
 
-            value: typing.Optional[uint] = None
+            value: uint = 0
 
         @dataclass
         class GeneratedCommandList(ClusterAttributeDescriptor):

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/chip/clusters/cluster_defs/HeimanCluster.py

@@ -29,6 +29,7 @@ class HeimanCluster(Cluster):
                 ClusterObjectFieldDescriptor(Label="sirenActive", Tag=0x00000014, Type=typing.Optional[uint]),
                 ClusterObjectFieldDescriptor(Label="alarmMute", Tag=0x00000015, Type=typing.Optional[uint]),
                 ClusterObjectFieldDescriptor(Label="lowPowerMode", Tag=0x00000016, Type=typing.Optional[uint]),
+                ClusterObjectFieldDescriptor(Label="indicatorEnable", Tag=0x00001004, Type=typing.Optional[uint]),
                 ClusterObjectFieldDescriptor(Label="generatedCommandList", Tag=0x0000FFF8, Type=typing.List[uint]),
                 ClusterObjectFieldDescriptor(Label="acceptedCommandList", Tag=0x0000FFF9, Type=typing.List[uint]),
                 ClusterObjectFieldDescriptor(Label="attributeList", Tag=0x0000FFFB, Type=typing.List[uint]),
@@ -43,6 +44,7 @@ class HeimanCluster(Cluster):
     sirenActive: typing.Optional[uint] = None
     alarmMute: typing.Optional[uint] = None
     lowPowerMode: typing.Optional[uint] = None
+    indicatorEnable: typing.Optional[uint] = None
     generatedCommandList: typing.List[uint] = field(default_factory=lambda: [])
     acceptedCommandList: typing.List[uint] = field(default_factory=lambda: [])
     attributeList: typing.List[uint] = field(default_factory=lambda: [])
@@ -61,10 +63,30 @@ class HeimanCluster(Cluster):
             def descriptor(cls) -> ClusterObjectDescriptor:
                 return ClusterObjectDescriptor(
                     Fields=[
-                        ClusterObjectFieldDescriptor(Label="mutingTime", Tag=0, Type=typing.Optional[uint]),
+                        ClusterObjectFieldDescriptor(Label="mutingTime", Tag=0, Type=uint),
                     ])
 
-            mutingTime: typing.Optional[uint] = None
+            mutingTime: uint = 0
+
+        @dataclass
+        class SirenActivate(ClusterCommand):
+            cluster_id: typing.ClassVar[int] = 0x120BFC01
+            command_id: typing.ClassVar[int] = 0x00000001
+            is_client: typing.ClassVar[bool] = True
+            response_type: typing.ClassVar[typing.Optional[str]] = None
+
+            @ChipUtility.classproperty
+            def descriptor(cls) -> ClusterObjectDescriptor:
+                return ClusterObjectDescriptor(
+                    Fields=[
+                        ClusterObjectFieldDescriptor(Label="sirenType", Tag=0, Type=uint),
+                        ClusterObjectFieldDescriptor(Label="volume", Tag=1, Type=uint),
+                        ClusterObjectFieldDescriptor(Label="duration", Tag=2, Type=uint),
+                    ])
+
+            sirenType: uint = 0
+            volume: uint = 0
+            duration: uint = 0
 
     class Attributes:
         @dataclass
@@ -179,6 +201,22 @@ class HeimanCluster(Cluster):
 
             value: typing.Optional[uint] = None
 
+        @dataclass
+        class IndicatorEnable(ClusterAttributeDescriptor):
+            @ChipUtility.classproperty
+            def cluster_id(cls) -> int:
+                return 0x120BFC01
+
+            @ChipUtility.classproperty
+            def attribute_id(cls) -> int:
+                return 0x00001004
+
+            @ChipUtility.classproperty
+            def attribute_type(cls) -> ClusterObjectFieldDescriptor:
+                return ClusterObjectFieldDescriptor(Type=typing.Optional[uint])
+
+            value: typing.Optional[uint] = None
+
         @dataclass
         class GeneratedCommandList(ClusterAttributeDescriptor):
             @ChipUtility.classproperty

{matter_python_client-1.4.1a10.dev20261006 → matter_python_client-1.5.0}/chip/clusters/cluster_defs/IcdManagement.py

@@ -109,14 +109,14 @@ class IcdManagement(Cluster):
                     Fields=[
                         ClusterObjectFieldDescriptor(Label="checkInNodeID", Tag=1, Type=uint),
                         ClusterObjectFieldDescriptor(Label="monitoredSubject", Tag=2, Type=uint),
-                        ClusterObjectFieldDescriptor(Label="key", Tag=3, Type=typing.Optional[uint]),
+                        ClusterObjectFieldDescriptor(Label="key", Tag=3, Type=typing.Optional[bytes]),
                         ClusterObjectFieldDescriptor(Label="clientType", Tag=4, Type=IcdManagement.Enums.ClientTypeEnum),
                         ClusterObjectFieldDescriptor(Label="fabricIndex", Tag=254, Type=uint),
                     ])
 
             checkInNodeID: uint = 0
             monitoredSubject: uint = 0
-            key: typing.Optional[uint] = None
+            key: typing.Optional[bytes] = None
             clientType: IcdManagement.Enums.ClientTypeEnum = 0
             fabricIndex: uint = 0