matterbridge-example-dynamic-platform 3.0.2-dev-20260808-eeaaae3 → 3.0.2-dev-20260809-1aeac01

package/CHANGELOG.md

@@ -38,8 +38,9 @@ If you like this project and find it useful, please consider giving it a star on
 - [chip]: Add chip-test toolchain agents instruction and chip-test runner.
 - [chip]: Add `chipTests.json`/`chipTests.md` with the generic device basic composition, conformance and default warnings tests, and document known CHIP test suite gaps.
 - [frontend]: Add plugin-frontend agents instructions.
-- [platform]: Add `closureGarageDoor` device.
-- [platform]: Add `closureVenetianBlind` device with Lift and Tilt panels.
+- [platform]: Add `closureGarageDoor` device. Thanks Ludovic BOUÉ.
+- [platform]: Add `closureVenetianBlind` device with Lift and Tilt panels. Thanks Ludovic BOUÉ.
+- [platform]: Add a thermostat auto mode with schedules (Weekdays and Weekend schedules) including 2 sub endpoints with temperature and humidity sensors, using `createDefaultSchedulesThermostatClusterServer()`. Thanks Ludovic BOUÉ.
 
 ### Changed
 

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 72 virtual devices:
+It exposes 73 virtual devices:
 
 - a door contact sensor
 - a motion sensor
@@ -53,6 +53,7 @@ It exposes 72 virtual devices:
   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
 - a thermostat auto mode with presets (Home, Away, Sleep, Wake, Vacation and GoingToSleep modes) including 3 sub endpoints with flow, temperature and humidity sensors
+- a thermostat auto mode with schedules (Weekdays and Weekend schedules) including 2 sub endpoints with temperature and humidity sensors
 - a thermostat heat only with two external temperature sensors (tagged like Indoor and Outdoor)
 - a thermostat cool only
 - a fan with Off High presets

package/dist/module.js

@@ -61,6 +61,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     thermoAuto;
     thermoAutoOccupancy;
     thermoAutoPresets;
+    thermoAutoSchedules;
     thermoHeat;
     thermoCool;
     fanBase;
@@ -1077,6 +1078,83 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.thermoAutoPresets?.subscribeAttribute(Thermostat.id, 'presets', (newValue, oldValue) => {
             this.thermoAutoPresets?.log.info(`Subscribe presets called with: ${debugStringify(newValue)} (old value: ${debugStringify(oldValue)})`);
         }, this.thermoAutoPresets.log);
+        const schedules_List = [
+            {
+                scheduleHandle: new Uint8Array([0]),
+                systemMode: Thermostat.SystemMode.Auto,
+                name: 'Weekdays',
+                transitions: [
+                    { dayOfWeek: { monday: true, tuesday: true, wednesday: true, thursday: true, friday: true }, transitionTime: 360, heatingSetpoint: 2000, coolingSetpoint: 2400 },
+                    { dayOfWeek: { monday: true, tuesday: true, wednesday: true, thursday: true, friday: true }, transitionTime: 750, heatingSetpoint: 1900, coolingSetpoint: 2500 },
+                    { dayOfWeek: { monday: true, tuesday: true, wednesday: true, thursday: true, friday: true }, transitionTime: 810, heatingSetpoint: 2000, coolingSetpoint: 2400 },
+                    { dayOfWeek: { monday: true, tuesday: true, wednesday: true, thursday: true, friday: true }, transitionTime: 1320, heatingSetpoint: 1800, coolingSetpoint: 2600 },
+                ],
+                builtIn: true,
+            },
+            {
+                scheduleHandle: new Uint8Array([1]),
+                systemMode: Thermostat.SystemMode.Auto,
+                name: 'Weekend',
+                transitions: [
+                    { dayOfWeek: { saturday: true, sunday: true }, transitionTime: 480, heatingSetpoint: 2100, coolingSetpoint: 2300 },
+                    { dayOfWeek: { saturday: true, sunday: true }, transitionTime: 1380, heatingSetpoint: 1900, coolingSetpoint: 2500 },
+                ],
+                builtIn: true,
+            },
+        ];
+        const scheduleTypeDefinitions = [
+            {
+                systemMode: Thermostat.SystemMode.Auto,
+                numberOfSchedules: 10,
+                scheduleTypeFeatures: { supportsSetpoints: true, supportsNames: true },
+            },
+        ];
+        this.thermoAutoSchedules = new MatterbridgeEndpoint([thermostat, bridgedNode, powerSource], { id: 'Thermostat (AutoModeSchedules)' }, this.config.debug)
+            .createDefaultIdentifyClusterServer()
+            .createDefaultBridgedDeviceBasicInformationClusterServer('Thermostat (AutoModeSchedules)', 'TAS00059', 0xfff1, 'Matterbridge', 'Matterbridge Thermostat With Schedules')
+            .createDefaultSchedulesThermostatClusterServer(20, 18, 22, 1, 0, 35, 15, 50, undefined, undefined, undefined, undefined, null, schedules_List, scheduleTypeDefinitions, 10, null)
+            .createDefaultPowerSourceWiredClusterServer()
+            .addRequiredClusterServers();
+        if (this.thermoAutoSchedules) {
+            this.thermoAutoSchedules
+                .addChildDeviceType('Temperature', temperatureSensor)
+                .createDefaultTemperatureMeasurementClusterServer(21 * 100)
+                .addRequiredClusterServers();
+            this.thermoAutoSchedules
+                .addChildDeviceType('Humidity', humiditySensor)
+                .createDefaultRelativeHumidityMeasurementClusterServer(50 * 100)
+                .addRequiredClusterServers();
+            this.thermoAutoSchedules = await this.addDevice(this.thermoAutoSchedules);
+        }
+        this.thermoAutoSchedules?.addCommandHandler('identify', ({ request: { identifyTime } }) => {
+            this.thermoAutoSchedules?.log.info(`Command identify called identifyTime ${identifyTime}`);
+        });
+        this.thermoAutoSchedules?.addCommandHandler('triggerEffect', ({ request: { effectIdentifier, effectVariant } }) => {
+            this.thermoAutoSchedules?.log.info(`Command identify called effectIdentifier ${effectIdentifier} effectVariant ${effectVariant}`);
+        });
+        this.thermoAutoSchedules?.addCommandHandler('setpointRaiseLower', ({ request: { mode, amount } }) => {
+            const lookupSetpointAdjustMode = ['Heat', 'Cool', 'Both'];
+            this.thermoAutoSchedules?.log.info(`Command setpointRaiseLower called with mode: ${lookupSetpointAdjustMode[mode]} amount: ${amount / 10}`);
+        });
+        this.thermoAutoSchedules?.addCommandHandler('setActiveScheduleRequest', ({ request: { scheduleHandle } }) => {
+            this.thermoAutoSchedules?.log.info(`Command setActiveScheduleRequest called with scheduleHandle: ${scheduleHandle ? `0x${Buffer.from(scheduleHandle).toString('hex')}` : 'null'}`);
+        });
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat, 'systemMode', (newValue, oldValue) => {
+            const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
+            this.thermoAutoSchedules?.log.info(`Subscribe systemMode called with: ${lookupSystemMode[newValue]} (old value: ${lookupSystemMode[oldValue]})`);
+        }, this.thermoAutoSchedules.log);
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'occupiedHeatingSetpoint', (newValue, oldValue) => {
+            this.thermoAutoSchedules?.log.info(`Subscribe occupiedHeatingSetpoint called with: ${newValue / 100} (old value: ${oldValue / 100})`);
+        }, this.thermoAutoSchedules.log);
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'occupiedCoolingSetpoint', (newValue, oldValue) => {
+            this.thermoAutoSchedules?.log.info(`Subscribe occupiedCoolingSetpoint called with: ${newValue / 100} (old value: ${oldValue / 100})`);
+        }, this.thermoAutoSchedules.log);
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'activeScheduleHandle', (newValue, oldValue) => {
+            this.thermoAutoSchedules?.log.info(`Subscribe activeScheduleHandle called with: ${newValue ? `0x${Buffer.from(newValue).toString('hex')}` : 'null'} (old value: ${oldValue ? `0x${Buffer.from(oldValue).toString('hex')}` : 'null'})`);
+        }, this.thermoAutoSchedules.log);
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'schedules', (newValue, oldValue) => {
+            this.thermoAutoSchedules?.log.info(`Subscribe schedules called with: ${debugStringify(newValue)} (old value: ${debugStringify(oldValue)})`);
+        }, this.thermoAutoSchedules.log);
         this.thermoHeat = new MatterbridgeEndpoint([thermostat, bridgedNode, powerSource], { id: 'Thermostat (Heat)' }, this.config.debug)
             .createDefaultIdentifyClusterServer()
             .createDefaultBridgedDeviceBasicInformationClusterServer('Thermostat (Heat)', 'THE00024', 0xfff1, 'Matterbridge', 'Matterbridge Thermostat')

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.2-dev-20260808-eeaaae3",
+  "version": "3.0.2-dev-20260809-1aeac01",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.2-dev-20260808-eeaaae3",
+      "version": "3.0.2-dev-20260809-1aeac01",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.3.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.2-dev-20260808-eeaaae3",
+  "version": "3.0.2-dev-20260809-1aeac01",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",