Luligu/matterbridge 3.5.0

Release 3.5.0

on GitHub

[3.5.0] - 2026-01-20

Breaking Changes

• [matter]: This release brings the upgrade to matter 1.4.2 and matter.js 0.16.x. It may cause the controllers to see a new device.
• [childbridge]: Fixed nodeLabel from deviceName in childbridge mode. It may cause the controllers to see a new device.
• [modeserver]: Fixed nodeLabel from deviceName for server node devices. It may cause the controllers to see a new device.
• [matterbridge]: On restart (typically on the Home Assistant addon), when the plugin is not found and is reinstalled, it is now reinstalled from the latest dev if it was on the dev branch.
• [docker]: Removed the arch linux/arm/v7 from all docker images.

Changed device types in Matter 1.4.2

• [all]: Added ScenesManagement Cluster that is no more provisional.
• [onOffMountedSwitch]: Updated onOffOutlet and onOffMountedSwitch: when using the mounted device types add as well the outlet device types on the same endpoint as subset device type.
• [dimmableMountedSwitch]: Updated dimmableOutlet and dimmableMountedSwitch: when using the mounted device types add as well the outlet device types on the same endpoint as subset device type.
• [coverDevice]: Updated coverDevice rev. 4 and removed Scene Management cluster.
• [roboticVacuumCleaner]: Updated roboticVacuumCleaner rev. 4: OperationCompletion event for RVC Operational State cluster is now mandatory (TODO: check behavior).
• [laundryWasher]: Updated laundryWasher rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [laundryDryer]: Updated laundryDryer rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [dishwasher]: Updated dishwasher rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [refrigerator]: Updated refrigerator: Temperature Controlled Cabinet with Cooler condition.
• [microwaveOven]: Updated microwaveOven rev. 2: OperationCompletion event for Operational State cluster is now mandatory (TODO: check behavior).
• [cookSurface]: Updated cookSurface rev. 2: TemperatureLevel is the only valid temperature control mode.
• [temperatureControlledCabinetCooler]: Updated temperatureControlledCabinetCooler rev. 5: TemperatureNumber is the only valid temperature control mode.
• [temperatureControlledCabinetHeater]: Updated temperatureControlledCabinetHeater rev. 5: TemperatureNumber is the only valid temperature control mode and OperationCompletion event for Oven Cavity Operational State cluster is now mandatory (TODO: check behavior).

Changed clusters in Matter 1.4.2

• [BridgedDeviceBasicInformation]: Revision 5 - ConfigurationVersion attribute added as P O.
• [DoorLock]: Revision 9 - Removed AlarmMask attribute.
• [ElectricalPowerMeasurement]: Revision 2 - Changed reactive and apparent power fields to use new data types. Revision 3 - Changed range of apparent current field to allow negative apparent current.
• [FanControl]: Revision 5 - Clarified attribute usage, added conformance column.
• [Thermostat]: Revision 9 - Removed AlarmMask attribute and AlarmCodeBitmap Type.
• [Identify]: Revision 6 - Added Q quality for IdentifyTime attribute.
• [WindowCovering]: Revision 6 - Marked AbsolutePosition feature and associated elements provisional.
• [RvcCleanMode]: Revision 4 - Added VacuumThenMop cleaning mode.
• [RvcOperationalState]: Revision 4 - Added several operational states and errors.
• [ServiceArea]: Revision 2 - Renamed InitialTimeEstimate to EstimatedTime.

Added

• [jest]: Added cache inside the repo in .cache/jest.
• [frontend]: Enhanced logging for HTTP/HTTPS server binding in Frontend class.
• [matterbridge]: Excluded specific network interfaces when looking for the first external interface.
• [thermostat]: Conformance to new matter.js internal attributes externalMeasuredIndoorTemperature and externallyMeasuredOccupancy (not in Matter 1.4.2 specs).
• [scenes]: Added SceneManagement cluster when required.
• [server]: Added start and stop devices server mode in plugin restart.
• [server]: Added start and stop devices server mode in plugin enable and disable.
• [matter.js]: Bump to matter.j v. 0.16.0.
• [matter.js]: Bump to matter.j v. 0.16.1.
• [matter.js]: Bump to matter.j v. 0.16.2.
• [matter.js]: Bump to matter.j v. 0.16.3.
• [matter.js]: Bump to matter.j v. 0.16.4.
• [matter.js]: Bump to matter.j v. 0.16.5.
• [frontend]: Added the --bind parameter to bind the frontend to a specific address. Defaults to all addresses.

Changed

• [package]: Updated dependencies.
• [eslint]: Moved cache in .cache/.eslintcache.
• [prettier]: Moved cache in .cache/.prettiercache.
• [DevContainer]: Refactor DevContainer to use bridge mode and matterbridge docker network.
• [frontend]: Bumped frontend version to v. 3.4.2.

Fixed

• [evse]: Fixed the EnergyEvse.chargingEnabledUntil attribute that was wrongly set in the disable command (spec 9.3.8.4).
• [package]: Fixed the devDependencies that slipped in for a bug in 3.4.7.