matterbridge-example-dynamic-platform 3.0.4-dev-20260905-cd9c2f3 → 3.0.4-dev-20260908-8b4d88b

package/CHANGELOG.md

@@ -35,6 +35,12 @@ If you like this project and find it useful, please consider giving it a star on
 
 - [matterbridge]: Require matterbridge v.3.10.8 with matter v.1.6.0.
 
+### Added
+
+- [platform]: Add `RfidLock` device: a door lock with the User, PinCredential, and RfidCredential (RID) features, testing the `numberOfRfidUsersSupported` parameter of `createUserPinDoorLockClusterServer()` (Matter 1.6.0 § 5.2.4). `SetCredential`, `GetCredentialStatus`, and `ClearCredential` already handle `DoorLock.CredentialType.Rfid` generically in `MatterbridgeDoorLockServer`, so no RFID-specific command handlers were needed for this device.
+- [Oven]/[Refrigerator]: Add a `TemperatureAlarm` example to the demo cabinets.
+- [devcontainer]: Upgrade the `Dev Container` to v.2.1.0, using the Node.js and Bun stack.
+
 ### Changed
 
 - [package]: Upgrade package.

package/README.md

@@ -23,7 +23,7 @@
 
 Matterbridge dynamic platform example plugin is a template to develop your own plugin using the dynamic platform.
 
-It exposes 77 virtual devices:
+It exposes 78 virtual devices:
 
 - a door contact sensor
 - a motion sensor
@@ -51,6 +51,7 @@ It exposes 77 virtual devices:
 - a lock with doorLock cluster
 - a lock with doorLock cluster and User and PinCredential support (userPinLock)
 - a lock with doorLock cluster, User and PinCredential support, and WeekDay, YearDay and Holiday access schedules (scheduleLock)
+- a lock with doorLock cluster, User and PinCredential support, and RfidCredential support (DoorLock.Feature.RfidCredential) via the numberOfRfidUsersSupported attribute (rfidLock)
 - a thermostat auto mode (i.e. with Auto Heat and Cool features) with thermostat cluster and 3 sub endpoints with flowMeasurement cluster, temperatureMeasurement cluster
   and relativeHumidityMeasurement cluster (to show how to create a composed device with sub endpoints)
 - a thermostat with auto mode (i.e. with Auto Heat and Cool features), occupancy and outdoorTemperature

package/dist/module.js

@@ -46,6 +46,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     lock;
     userPinLock;
     scheduleLock;
+    rfidLock;
     thermoAuto;
     thermoAutoOccupancy;
     thermoAutoPresets;
@@ -887,6 +888,25 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.scheduleLock?.subscribeAttribute(DoorLock, 'operatingMode', (value) => {
             this.scheduleLock?.log.info(`Subscribe operatingMode called with: ${getEnumDescription(DoorLock.OperatingMode, value)}`);
         }, this.scheduleLock.log);
+        this.rfidLock = new MatterbridgeEndpoint([doorLock, bridgedNode, powerSource], { id: 'RfidLock' }, this.config.debug)
+            .createDefaultIdentifyClusterServer()
+            .createDefaultBridgedDeviceBasicInformationClusterServer('Lock with RFID', 'LRF00090', 0xfff1, 'Matterbridge', 'Matterbridge Lock')
+            .createUserPinDoorLockClusterServer(DoorLock.LockState.Locked, DoorLock.LockType.DeadBolt, 0, 4, 10, undefined, undefined, undefined, undefined, 10)
+            .createDefaultPowerSourceRechargeableBatteryClusterServer(95)
+            .addRequiredClusterServers();
+        this.rfidLock = await this.addDevice(this.rfidLock);
+        this.rfidLock?.addCommandHandler('Identify.identify', ({ request: { identifyTime } }) => {
+            this.rfidLock?.log.info(`Command identify called identifyTime:${identifyTime}`);
+        });
+        this.rfidLock?.addCommandHandler('DoorLock.lockDoor', () => {
+            this.rfidLock?.log.info('Command lockDoor called');
+        });
+        this.rfidLock?.addCommandHandler('DoorLock.unlockDoor', () => {
+            this.rfidLock?.log.info('Command unlockDoor called');
+        });
+        this.rfidLock?.subscribeAttribute(DoorLock, 'operatingMode', (value) => {
+            this.rfidLock?.log.info(`Subscribe operatingMode called with: ${getEnumDescription(DoorLock.OperatingMode, value)}`);
+        }, this.rfidLock.log);
         this.thermoAuto = new MatterbridgeEndpoint([thermostat, bridgedNode, powerSource], { id: 'Thermostat (AutoMode)' }, this.config.debug)
             .createDefaultIdentifyClusterServer()
             .createDefaultBridgedDeviceBasicInformationClusterServer('Thermostat (Auto)', 'TAU00023', 0xfff1, 'Matterbridge', 'Matterbridge Thermostat')
@@ -1585,14 +1605,17 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             await switch4.addFixedLabel('room', 'Living Room');
             await switch4.addFixedLabel('switch', 'Switch 4');
             await switch4.addFixedLabel('button', 'Button 4');
+            await switch4.addFixedLabel('ha_entitylabel', 'DIY');
             await switch5.addFixedLabel('name', 'Switch 5');
             await switch5.addFixedLabel('room', 'Living Room');
             await switch5.addFixedLabel('switch', 'Switch 5');
             await switch5.addFixedLabel('button', 'Button 5');
+            await switch5.addFixedLabel('ha_entitylabel', 'DIY');
             await switch6.addFixedLabel('name', 'Switch 6');
             await switch6.addFixedLabel('room', 'Living Room');
             await switch6.addFixedLabel('switch', 'Switch 6');
             await switch6.addFixedLabel('button', 'Button 6');
+            await switch6.addFixedLabel('ha_entitylabel', 'DIY');
         }
         this.latchingSwitch = new MatterbridgeEndpoint([genericSwitch, bridgedNode, powerSource], { id: 'Latching switch' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Latching switch', 'LAS00042', 0xfff1, 'Matterbridge', 'Matterbridge LatchingSwitch')
@@ -1736,7 +1759,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.microwaveOven = new MicrowaveOven('Microwave Oven', 'MWO00053');
         this.microwaveOven = await this.addDevice(this.microwaveOven);
         this.oven = new Oven('Oven', 'OVN00054');
-        this.oven.addCabinet('Upper Cabinet', {
+        const ovenUpperCabinet = this.oven.addCabinet('Upper Cabinet', {
             tagList: [{ mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label }],
             currentMode: 2,
             supportedModes: [
@@ -1760,7 +1783,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             currentPhase: 2,
             phaseList: ['pre-heating', 'pre-heated', 'cooling down'],
         });
-        this.oven.addCabinet('Lower Cabinet', {
+        ovenUpperCabinet.createDefaultTemperatureAlarmClusterServer(280_00);
+        const ovenLowerCabinet = this.oven.addCabinet('Lower Cabinet', {
             tagList: [{ mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label }],
             currentMode: 3,
             supportedModes: [
@@ -1777,6 +1801,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             currentPhase: 1,
             phaseList: ['pre-heating', 'pre-heated', 'cooling down'],
         });
+        ovenLowerCabinet.createDefaultTemperatureAlarmClusterServer(280_00);
         this.oven = await this.addDevice(this.oven);
         this.cooktop = new Cooktop('Cooktop', 'CKT00055');
         this.cooktop.addSurface('Surface Top Left', {
@@ -1805,7 +1830,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         });
         this.cooktop = await this.addDevice(this.cooktop);
         const refrigerator = new Refrigerator('Refrigerator', 'REF00056');
-        refrigerator.addCabinet('Refrigerator Top', {
+        const refrigeratorTopCabinet = refrigerator.addCabinet('Refrigerator Top', {
             tagList: [
                 { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: 'Refrigerator Top' },
                 { mfgCode: null, namespaceId: RefrigeratorTag.Refrigerator.namespaceId, tag: RefrigeratorTag.Refrigerator.tag, label: RefrigeratorTag.Refrigerator.label },
@@ -1816,17 +1841,19 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             step: 1 * 100,
             currentTemperature: 1200,
         });
-        refrigerator.addCabinet('Freezer Bottom', {
+        refrigeratorTopCabinet.createDefaultTemperatureAlarmClusterServer(20_00, 5_00);
+        const freezerBottomCabinet = refrigerator.addCabinet('Freezer Bottom', {
             tagList: [
                 { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: 'Freezer Bottom' },
                 { mfgCode: null, namespaceId: RefrigeratorTag.Freezer.namespaceId, tag: RefrigeratorTag.Freezer.tag, label: RefrigeratorTag.Freezer.label },
             ],
             targetTemperature: -18 * 100,
-            minTemperature: -30 * 100,
+            minTemperature: -25 * 100,
             maxTemperature: -10 * 100,
             step: 1 * 100,
             currentTemperature: -1800,
         });
+        freezerBottomCabinet.createDefaultTemperatureAlarmClusterServer(-5_00, -30_00);
         this.refrigerator = await this.addDevice(refrigerator);
         this.airConditioner = new AirConditioner('Air Conditioner', 'ACO00027', {
             localTemperature: 20,
@@ -2367,6 +2394,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         }
         await this.scheduleLock?.setAttribute(DoorLock.id, 'lockState', DoorLock.LockState.Locked, this.scheduleLock.log);
         this.scheduleLock?.log.info('Set schedule lock initial lockState to Locked');
+        await this.rfidLock?.setAttribute(DoorLock.id, 'lockState', DoorLock.LockState.Locked, this.rfidLock.log);
+        this.rfidLock?.log.info('Set rfid lock initial lockState to Locked');
         await this.thermoAuto?.setAttribute(Thermostat.id, 'localTemperature', 16 * 100, this.thermoAuto.log);
         await this.thermoAuto?.setAttribute(Thermostat.id, 'systemMode', Thermostat.SystemMode.Auto, this.thermoAuto.log);
         if (this.thermoAuto?.hasAttributeServer(Thermostat.id, 'thermostatRunningState')) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.4-dev-20260905-cd9c2f3",
+  "version": "3.0.4-dev-20260908-8b4d88b",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.4-dev-20260905-cd9c2f3",
+      "version": "3.0.4-dev-20260908-8b4d88b",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.3.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.4-dev-20260905-cd9c2f3",
+  "version": "3.0.4-dev-20260908-8b4d88b",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",