Merge pull request #127 from Luligu/dev

Release 1.5.5

CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 If you like this project and find it useful, please consider giving it a star on GitHub at https://github.com/Luligu/matterbridge and sponsoring it.
 
+### Home Assistant Community Add-ons
+
+The Home Assistant Community Add-ons and plugins are not verified to work with Matterbridge. I strongly advise against using them. If you do use them and encounter an issue (which is likely because some do not meet the Matterbridge guidelines), please do not open an issue in the Matterbridge repository.
+
+## [1.5.5] - 2024-09-09
+
+### Changed
+
+- [matterbridge]: Changed startMatterInterval from 30 to 60 seconds.
+- [package]: Update matter-node.js to 0.10.1.
+- [package]: Update matter-history to 1.1.11.
+- [package]: Update dependencies.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="./yellow-button.png" alt="Buy me a coffee" width="120">
+</a>
+
 ## [1.5.4] - 2024-09-05
 
 ### Changed

README-DEV.md

@@ -38,14 +38,21 @@ Matterbridge exports from:
 - NodeStorage classes.
 
 # **********
-A plugin will never ever install and import from matter-node.js or matter.js directly cause this leads to a second instance of matter.js that causes instability and unpredictable errors like "The only instance is Enpoint". 
+A plugin must never install or import from `matter-node.js` or `matter.js` directly, as this leads to a second instance of `matter.js`, causing instability and unpredictable errors such as "The only instance is Endpoint". Additionally, when Matterbridge updates the `matter.js` version, it should be consistent across all plugins.
 # **********
-A plugin will never ever install matterbridge (not dependencies and not devDependencies). Matterbridge must be linked to the plugin.
+A plugin must never install Matterbridge (neither as dependencies nor as devDependencies). Matterbridge must be linked to the plugin:
+```json
+"scripts": {
+    '''
+    "install": "node link-matterbridge-script.js",
+    '''
+}    
+```
 # **********
 
 In the next releases I will remove the duplicated exports so please update your plugins.
 
-I will also add some error messages when a plugin has wrong imports.
+I added some error messages when a plugin has wrong imports or configurations and the plugin will be disabled to prevent instability and crashes.
 
 ## Guidelines on the migration to matter.js V8
 

README.md

@@ -132,6 +132,10 @@ Config editor:
 
 [Advanced configurations](https://github.com/Luligu/matterbridge/blob/main/README-DOCKER.md)
 
+### Home Assistant Community Add-ons
+
+The Home Assistant Community Add-ons and plugins are not verified to work with Matterbridge. I strongly advise against using them. If you do use them and encounter an issue (which is likely because some do not meet the Matterbridge guidelines), please do not open an issue in the Matterbridge repository.
+
 ## Development
 
 [Development](https://github.com/Luligu/matterbridge/blob/main/README-DEV.md)
@@ -201,14 +205,29 @@ An Accessory platform plugin only exposes one device.
 
 This an example of a dynamic platform plugin.
 
-It exposes a switch with onOff, a light with onOff-levelControl-colorControl, an outlet with onOff and a WindoweCovering device.
+It exposes:
+- a switch with onOff cluster
+- a light with onOff
+- a light with onOff and levelControl (dimmer)
+- a light with onOff, levelControl and colorControl (with XY, HS and CT) clusters
+- a light with onOff, levelControl and colorControl (with HS only) clusters
+- a light with onOff, levelControl and colorControl (with XY only) clusters
+- a light with onOff, levelControl and colorControl (with CT only) clusters
+- an outlet (plug) with onOff cluster
+- a cover with windowCovering cluster
+- a lock with doorLock cluster
+- a thermo 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 fan with FanControl cluster
+- a rainSensor device
+- a waterFreezeDetector device
+- a waterLeakDetector device
+- a smokeCoAlarm device
 
 All these virtual devices continuously change state and position. The plugin also shows how to use all the command handlers (you can control all the devices).
 
 A Dynamic platform plugin exposes as many devices as you need (the limit for the Home app is 150 accessories for bridge).
 
-Matterbridge can run as many plugins as you want.
-
 [See the plugin homepage here](https://github.com/Luligu/matterbridge-example-dynamic-platform)
 
 ### Example plugins to show the usage of history in matter
@@ -231,7 +250,6 @@ The Eve app only shows the history when the plugins run like an AccessoryPlatfor
 
 Just open the frontend on the link provided in the log, select a plugin and click install.
 
-
 ## How to install and add a plugin manually from a terminal (from npm)
 
 To install i.e. https://github.com/Luligu/matterbridge-zigbee2mqtt
@@ -314,15 +332,18 @@ All issues have been solved from the version 17.5 of the HomePod/AppleTV. Now th
 
 So far is the only controller supporting some Matter 1.2 and 1.3 device type:
 
-- air quality sensor (Matter 1.2)
-
-Also supports (probably only like BooleanState cluster):
+- airQualitySensor code 0x002c (Matter 1.2)
+- waterFreezeDetector code 0x0041 (Matter 1.3 with only BooleanState cluster)
+- waterLeakDetector code 0x0043 (Matter 1.3 with only BooleanState cluster)
+- rainSensor code 0x0044 (Matter 1.3 with only BooleanState cluster)
+- deviceEnergyManagement code 0x050d (Matter 1.3 with only DeviceEnergyManagementMode cluster)
 
-- waterFreezeDetector (Matter 1.3)
-- waterLeakDetector (Matter 1.3)
-- rainSensor (Matter 1.3)
+Electrical measurements:
+- electrical measurements from EveHistoryCluster (used in Matterbridge plugins)
+- electricalSensor code 0x0510 with clusters: ElectricalPowerMeasurement and ElectricalEnergyMeasurement (still in dev but fully working!)
 
-HA also support electrical measurements from EveHistoryCluster (used in Matterbridge plugins)
+Other supported cluster:
+- ModeSelect
 
 ## Home Assistant issues (Matter Server for HA is still in Beta)