matterbridge 3.1.1-dev-20250629-f14b886 → 3.1.1-dev-20250629-cfe9124
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README-DEV.md +3 -1
- package/README-DOCKER.md +3 -1
- package/README-NGINX.md +30 -22
- package/README-PODMAN.md +3 -1
- package/README-SERVICE.md +8 -2
- package/dist/batteryStorage.js +24 -0
- package/dist/devices/export.js +2 -0
- package/dist/index.js +2 -0
- package/dist/matterbridgeBehaviors.js +15 -0
- package/dist/matterbridgeEndpoint.js +26 -3
- package/dist/solarPower.js +20 -0
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -10,8 +10,16 @@ If you like this project and find it useful, please consider giving it a star on
|
|
|
10
10
|
|
|
11
11
|
## [3.1.1] - 2025-07-??
|
|
12
12
|
|
|
13
|
+
### Breaking Changes
|
|
14
|
+
|
|
15
|
+
- [devices]: The single devices (i.e. Rvc, Evse etc...) are only exported from matterbridge/devices. Please update your imports to use the new export path. Refer to the [documentation](README-DEV.md) for details on imports.
|
|
16
|
+
|
|
13
17
|
### Added
|
|
14
18
|
|
|
19
|
+
- [SolarPower]: Added SolarPower class and Jest test. Thanks Ludovic BOUÉ.
|
|
20
|
+
- [BatteryStorage]: Added BatteryStorage class and Jest test. Thanks Ludovic BOUÉ.
|
|
21
|
+
- [DeviceEnergyManagement]: Added MatterbridgeDeviceEnergyManagementServer with power adjustment methods.
|
|
22
|
+
|
|
15
23
|
### Changed
|
|
16
24
|
|
|
17
25
|
- [package]: Updated dependencies.
|
package/README-DEV.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge
|
|
1
|
+
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge development
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/matterbridge)
|
|
4
4
|
[](https://www.npmjs.com/package/matterbridge)
|
|
5
5
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
6
6
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
7
7
|
|
|
8
|
+
|
|
9
|
+
[](https://codecov.io/gh/Luligu/matterbridge)
|
|
8
10
|
|
|
9
11
|
[](https://www.npmjs.com/package/matter-history)
|
|
10
12
|
[](https://www.npmjs.com/package/node-ansi-logger)
|
package/README-DOCKER.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge
|
|
1
|
+
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge docker configuration
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/matterbridge)
|
|
4
4
|
[](https://www.npmjs.com/package/matterbridge)
|
|
5
5
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
6
6
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
7
7
|
|
|
8
|
+
|
|
9
|
+
[](https://codecov.io/gh/Luligu/matterbridge)
|
|
8
10
|
|
|
9
11
|
[](https://www.npmjs.com/package/matter-history)
|
|
10
12
|
[](https://www.npmjs.com/package/node-ansi-logger)
|
package/README-NGINX.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge
|
|
1
|
+
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge NGINX configuration
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/matterbridge)
|
|
4
4
|
[](https://www.npmjs.com/package/matterbridge)
|
|
5
5
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
6
6
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
7
7
|
|
|
8
|
+
|
|
9
|
+
[](https://codecov.io/gh/Luligu/matterbridge)
|
|
8
10
|
|
|
9
11
|
[](https://www.npmjs.com/package/matter-history)
|
|
10
12
|
[](https://www.npmjs.com/package/node-ansi-logger)
|
|
@@ -31,7 +33,7 @@ server {
|
|
|
31
33
|
server_name _;
|
|
32
34
|
|
|
33
35
|
location / {
|
|
34
|
-
# Redirect to Matterbridge frontend
|
|
36
|
+
# Redirect to Matterbridge frontend from http:/server_name:80
|
|
35
37
|
proxy_pass http://localhost:8283/;
|
|
36
38
|
proxy_set_header Host $host;
|
|
37
39
|
proxy_set_header X-Real-IP $remote_addr;
|
|
@@ -48,13 +50,13 @@ server {
|
|
|
48
50
|
|
|
49
51
|
Add matterbridge to enabled sites
|
|
50
52
|
|
|
51
|
-
```
|
|
53
|
+
```bash
|
|
52
54
|
sudo ln -s /etc/nginx/sites-available/matterbridge /etc/nginx/sites-enabled/
|
|
53
55
|
```
|
|
54
56
|
|
|
55
57
|
### Create a basic nginx configuration file that redirect to http://yourhost:8283/matterbridge
|
|
56
58
|
|
|
57
|
-
```
|
|
59
|
+
```bash
|
|
58
60
|
sudo nano /etc/nginx/sites-available/matterbridge
|
|
59
61
|
```
|
|
60
62
|
|
|
@@ -67,7 +69,7 @@ server {
|
|
|
67
69
|
server_name _;
|
|
68
70
|
|
|
69
71
|
location /matterbridge/ {
|
|
70
|
-
# Redirect to Matterbridge frontend
|
|
72
|
+
# Redirect to Matterbridge frontend from http:/server_name/matterbridge:80
|
|
71
73
|
proxy_pass http://localhost:8283/;
|
|
72
74
|
proxy_set_header Host $host;
|
|
73
75
|
proxy_set_header X-Real-IP $remote_addr;
|
|
@@ -84,13 +86,20 @@ server {
|
|
|
84
86
|
|
|
85
87
|
Add matterbridge to enabled sites
|
|
86
88
|
|
|
87
|
-
```
|
|
89
|
+
```bash
|
|
88
90
|
sudo ln -s /etc/nginx/sites-available/matterbridge /etc/nginx/sites-enabled/
|
|
89
91
|
```
|
|
90
92
|
|
|
91
|
-
|
|
93
|
+
Restart nginx and test the configuration
|
|
92
94
|
|
|
95
|
+
```bash
|
|
96
|
+
sudo systemctl restart nginx
|
|
97
|
+
sudo nginx -t
|
|
93
98
|
```
|
|
99
|
+
|
|
100
|
+
### Create an advanced nginx configuration file that redirect to http://yourhost:8283 with ssl
|
|
101
|
+
|
|
102
|
+
```bash
|
|
94
103
|
sudo nano /etc/nginx/sites-available/matterbridge
|
|
95
104
|
```
|
|
96
105
|
|
|
@@ -125,7 +134,7 @@ server {
|
|
|
125
134
|
ssl_prefer_server_ciphers on;
|
|
126
135
|
|
|
127
136
|
location / {
|
|
128
|
-
# Redirect to Matterbridge frontend
|
|
137
|
+
# Redirect to Matterbridge frontend from https:/server_name:443
|
|
129
138
|
proxy_pass http://localhost:8283/;
|
|
130
139
|
proxy_set_header Host $host;
|
|
131
140
|
proxy_set_header X-Real-IP $remote_addr;
|
|
@@ -142,13 +151,20 @@ server {
|
|
|
142
151
|
|
|
143
152
|
Add matterbridge to enabled sites
|
|
144
153
|
|
|
145
|
-
```
|
|
154
|
+
```bash
|
|
146
155
|
sudo ln -s /etc/nginx/sites-available/matterbridge /etc/nginx/sites-enabled/
|
|
147
156
|
```
|
|
148
157
|
|
|
149
|
-
|
|
158
|
+
Restart nginx and test the configuration
|
|
150
159
|
|
|
160
|
+
```bash
|
|
161
|
+
sudo systemctl restart nginx
|
|
162
|
+
sudo nginx -t
|
|
151
163
|
```
|
|
164
|
+
|
|
165
|
+
### Create an advanced nginx configuration file that redirect to http://yourhost/matterbridge with ssl
|
|
166
|
+
|
|
167
|
+
```bash
|
|
152
168
|
sudo nano /etc/nginx/sites-available/matterbridge
|
|
153
169
|
```
|
|
154
170
|
|
|
@@ -190,7 +206,7 @@ server {
|
|
|
190
206
|
}
|
|
191
207
|
|
|
192
208
|
location /matterbridge/ {
|
|
193
|
-
# Redirect to Matterbridge frontend
|
|
209
|
+
# Redirect to Matterbridge frontend from https:/server_name/matterbridge:443
|
|
194
210
|
proxy_pass http://localhost:8283/;
|
|
195
211
|
proxy_set_header Host $host;
|
|
196
212
|
proxy_set_header X-Real-IP $remote_addr;
|
|
@@ -207,21 +223,13 @@ server {
|
|
|
207
223
|
|
|
208
224
|
Add matterbridge to enabled sites
|
|
209
225
|
|
|
210
|
-
```
|
|
226
|
+
```bash
|
|
211
227
|
sudo ln -s /etc/nginx/sites-available/matterbridge /etc/nginx/sites-enabled/
|
|
212
228
|
```
|
|
213
229
|
|
|
214
|
-
|
|
230
|
+
Restart nginx and test the configuration
|
|
215
231
|
|
|
216
|
-
```
|
|
232
|
+
```bash
|
|
217
233
|
sudo systemctl restart nginx
|
|
218
234
|
sudo nginx -t
|
|
219
235
|
```
|
|
220
|
-
|
|
221
|
-
### Use matterbridge with nginx
|
|
222
|
-
|
|
223
|
-
http://ubuntu/matterbridge/
|
|
224
|
-
|
|
225
|
-
or
|
|
226
|
-
|
|
227
|
-
https://ubuntu/matterbridge/
|
package/README-PODMAN.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge
|
|
1
|
+
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge Podman configuration
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/matterbridge)
|
|
4
4
|
[](https://www.npmjs.com/package/matterbridge)
|
|
5
5
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
6
6
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
7
7
|
|
|
8
|
+
|
|
9
|
+
[](https://codecov.io/gh/Luligu/matterbridge)
|
|
8
10
|
|
|
9
11
|
[](https://www.npmjs.com/package/matter-history)
|
|
10
12
|
[](https://www.npmjs.com/package/node-ansi-logger)
|
package/README-SERVICE.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge
|
|
1
|
+
# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px"> Matterbridge systemd configuration
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/matterbridge)
|
|
4
4
|
[](https://www.npmjs.com/package/matterbridge)
|
|
5
5
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
6
6
|
[](https://hub.docker.com/r/luligu/matterbridge)
|
|
7
7
|
|
|
8
|
+
|
|
9
|
+
[](https://codecov.io/gh/Luligu/matterbridge)
|
|
8
10
|
|
|
9
11
|
[](https://www.npmjs.com/package/matter-history)
|
|
10
12
|
[](https://www.npmjs.com/package/node-ansi-logger)
|
|
@@ -16,6 +18,10 @@
|
|
|
16
18
|
|
|
17
19
|
## Run matterbridge as a daemon with systemctl (Linux only)
|
|
18
20
|
|
|
21
|
+
The easiest way to add systemctl is to use [Matterbridge service cli for linux](https://github.com/Luligu/mb-service-linux).
|
|
22
|
+
|
|
23
|
+
If your setup is too complex or you prefer to do it manually follow this method. You can still use mb-service to manage systemd after.
|
|
24
|
+
|
|
19
25
|
### First create the Matterbridge directories
|
|
20
26
|
|
|
21
27
|
This will create the required directories if they don't exist
|
|
@@ -75,7 +81,7 @@ If you use the matterbridge-bthome plugin add this:
|
|
|
75
81
|
AmbientCapabilities=CAP_NET_BIND_SERVICE CAP_NET_RAW CAP_NET_ADMIN
|
|
76
82
|
```
|
|
77
83
|
|
|
78
|
-
If you modify
|
|
84
|
+
If you modify matterbridge.service after, then run:
|
|
79
85
|
|
|
80
86
|
```bash
|
|
81
87
|
sudo systemctl daemon-reload
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { PowerSourceTag } from '@matter/main';
|
|
2
|
+
import { DeviceEnergyManagement } from '@matter/main/clusters/device-energy-management';
|
|
3
|
+
import { PowerSource } from '@matter/main/clusters/power-source';
|
|
4
|
+
import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
|
|
5
|
+
import { deviceEnergyManagement, electricalSensor, batteryStorage, powerSource } from './matterbridgeDeviceTypes.js';
|
|
6
|
+
export class BatteryStorage extends MatterbridgeEndpoint {
|
|
7
|
+
constructor(name, serial, batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, voltage = null, current = null, power = null, energyImported = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
|
|
8
|
+
super([batteryStorage, powerSource, electricalSensor, deviceEnergyManagement], {
|
|
9
|
+
tagList: [
|
|
10
|
+
{ mfgCode: null, namespaceId: PowerSourceTag.Battery.namespaceId, tag: PowerSourceTag.Battery.tag, label: null },
|
|
11
|
+
{ mfgCode: null, namespaceId: PowerSourceTag.Grid.namespaceId, tag: PowerSourceTag.Grid.tag, label: null },
|
|
12
|
+
],
|
|
13
|
+
id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}`,
|
|
14
|
+
}, true);
|
|
15
|
+
this.createDefaultIdentifyClusterServer()
|
|
16
|
+
.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Solar Power')
|
|
17
|
+
.createDefaultPowerSourceWiredBatteryClusterServer(batPercentRemaining, batChargeLevel)
|
|
18
|
+
.createDefaultPowerTopologyClusterServer()
|
|
19
|
+
.createDefaultElectricalPowerMeasurementClusterServer(voltage, current, power)
|
|
20
|
+
.createDefaultElectricalEnergyMeasurementClusterServer(energyImported, energyExported)
|
|
21
|
+
.createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.BatteryStorage, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
|
|
22
|
+
.addRequiredClusterServers();
|
|
23
|
+
}
|
|
24
|
+
}
|
package/dist/devices/export.js
CHANGED
package/dist/index.js
CHANGED
|
@@ -15,6 +15,8 @@ export * from './roboticVacuumCleaner.js';
|
|
|
15
15
|
export * from './laundryWasher.js';
|
|
16
16
|
export * from './waterHeater.js';
|
|
17
17
|
export * from './evse.js';
|
|
18
|
+
export * from './solarPower.js';
|
|
19
|
+
export * from './batteryStorage.js';
|
|
18
20
|
const log = new AnsiLogger({ logName: 'Main', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
|
|
19
21
|
async function main() {
|
|
20
22
|
log.debug('***Matterbridge.loadInstance() called');
|
|
@@ -24,6 +24,7 @@ import { SmokeCoAlarmServer } from '@matter/main/behaviors/smoke-co-alarm';
|
|
|
24
24
|
import { SwitchServer } from '@matter/main/behaviors/switch';
|
|
25
25
|
import { OperationalStateServer } from '@matter/main/behaviors/operational-state';
|
|
26
26
|
import { ServiceAreaServer } from '@matter/main/behaviors/service-area';
|
|
27
|
+
import { DeviceEnergyManagementServer } from '@matter/main/behaviors/device-energy-management';
|
|
27
28
|
import { DeviceEnergyManagementModeServer } from '@matter/main/behaviors/device-energy-management-mode';
|
|
28
29
|
export class MatterbridgeServer extends Behavior {
|
|
29
30
|
static id = 'matterbridge';
|
|
@@ -392,6 +393,20 @@ export class MatterbridgeModeSelectServer extends ModeSelectServer {
|
|
|
392
393
|
super.changeToMode(request);
|
|
393
394
|
}
|
|
394
395
|
}
|
|
396
|
+
export class MatterbridgeDeviceEnergyManagementServer extends DeviceEnergyManagementServer {
|
|
397
|
+
powerAdjustRequest(request) {
|
|
398
|
+
const device = this.endpoint.stateOf(MatterbridgeServer);
|
|
399
|
+
device.log.info(`Adjusting power to ${request.power} duration ${request.duration} cause ${request.cause} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
|
|
400
|
+
device.commandHandler.executeHandler('powerAdjustRequest', { request, cluster: DeviceEnergyManagementServer.id, attributes: this.state, endpoint: this.endpoint });
|
|
401
|
+
device.log.debug(`MatterbridgeDeviceEnergyManagementServer powerAdjustRequest called with power ${request.power} duration ${request.duration} cause ${request.cause}`);
|
|
402
|
+
}
|
|
403
|
+
cancelPowerAdjustRequest() {
|
|
404
|
+
const device = this.endpoint.stateOf(MatterbridgeServer);
|
|
405
|
+
device.log.info(`Cancelling power adjustment (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
|
|
406
|
+
device.commandHandler.executeHandler('cancelPowerAdjustRequest', { cluster: DeviceEnergyManagementServer.id, attributes: this.state, endpoint: this.endpoint });
|
|
407
|
+
device.log.debug(`MatterbridgeDeviceEnergyManagementServer cancelPowerAdjustRequest called`);
|
|
408
|
+
}
|
|
409
|
+
}
|
|
395
410
|
export class MatterbridgeDeviceEnergyManagementModeServer extends DeviceEnergyManagementModeServer {
|
|
396
411
|
changeToMode(request) {
|
|
397
412
|
const device = this.endpoint.stateOf(MatterbridgeServer);
|
|
@@ -59,11 +59,10 @@ import { ResourceMonitoring } from '@matter/main/clusters/resource-monitoring';
|
|
|
59
59
|
import { HepaFilterMonitoringServer } from '@matter/main/behaviors/hepa-filter-monitoring';
|
|
60
60
|
import { ActivatedCarbonFilterMonitoringServer } from '@matter/main/behaviors/activated-carbon-filter-monitoring';
|
|
61
61
|
import { ThermostatUserInterfaceConfigurationServer } from '@matter/main/behaviors/thermostat-user-interface-configuration';
|
|
62
|
-
import { DeviceEnergyManagementServer } from '@matter/main/behaviors/device-energy-management';
|
|
63
62
|
import { AnsiLogger, CYAN, YELLOW, db, debugStringify, hk, or, zb } from './logger/export.js';
|
|
64
63
|
import { bridgedNode } from './matterbridgeDeviceTypes.js';
|
|
65
64
|
import { isValidNumber, isValidObject, isValidString } from './utils/export.js';
|
|
66
|
-
import { MatterbridgeServer, MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeLiftTiltWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeSwitchServer, MatterbridgeOperationalStateServer, MatterbridgeDeviceEnergyManagementModeServer, } from './matterbridgeBehaviors.js';
|
|
65
|
+
import { MatterbridgeServer, MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeLiftTiltWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeSwitchServer, MatterbridgeOperationalStateServer, MatterbridgeDeviceEnergyManagementModeServer, MatterbridgeDeviceEnergyManagementServer, } from './matterbridgeBehaviors.js';
|
|
67
66
|
import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequiredClusterServers, addUserLabel, createUniqueId, getBehavior, getBehaviourTypesFromClusterClientIds, getBehaviourTypesFromClusterServerIds, getDefaultOperationalStateClusterServer, getDefaultFlowMeasurementClusterServer, getDefaultIlluminanceMeasurementClusterServer, getDefaultPressureMeasurementClusterServer, getDefaultRelativeHumidityMeasurementClusterServer, getDefaultTemperatureMeasurementClusterServer, getDefaultOccupancySensingClusterServer, lowercaseFirstLetter, updateAttribute, getClusterId, getAttributeId, setAttribute, getAttribute, checkNotLatinCharacters, generateUniqueId, subscribeAttribute, invokeBehaviorCommand, triggerEvent, } from './matterbridgeEndpointHelpers.js';
|
|
68
67
|
export class MatterbridgeEndpoint extends Endpoint {
|
|
69
68
|
static bridgeMode = '';
|
|
@@ -418,6 +417,29 @@ export class MatterbridgeEndpoint extends Endpoint {
|
|
|
418
417
|
});
|
|
419
418
|
return this;
|
|
420
419
|
}
|
|
420
|
+
createDefaultPowerSourceWiredBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok) {
|
|
421
|
+
this.behaviors.require(PowerSourceServer.with(PowerSource.Feature.Battery, PowerSource.Feature.Rechargeable), {
|
|
422
|
+
status: PowerSource.PowerSourceStatus.Active,
|
|
423
|
+
order: 0,
|
|
424
|
+
description: 'Primary battery',
|
|
425
|
+
endpointList: [],
|
|
426
|
+
batVoltage: null,
|
|
427
|
+
batPercentRemaining: Math.min(Math.max(batPercentRemaining * 2, 0), 200),
|
|
428
|
+
batTimeRemaining: null,
|
|
429
|
+
batChargeLevel,
|
|
430
|
+
batReplacementNeeded: false,
|
|
431
|
+
batReplaceability: PowerSource.BatReplaceability.Unspecified,
|
|
432
|
+
batPresent: true,
|
|
433
|
+
activeBatFaults: [],
|
|
434
|
+
batChargeState: PowerSource.BatChargeState.IsNotCharging,
|
|
435
|
+
batTimeToFullCharge: null,
|
|
436
|
+
batFunctionalWhileCharging: true,
|
|
437
|
+
batChargingCurrent: null,
|
|
438
|
+
batCapacity: 1,
|
|
439
|
+
activeBatChargeFaults: [],
|
|
440
|
+
});
|
|
441
|
+
return this;
|
|
442
|
+
}
|
|
421
443
|
createDefaultPowerSourceReplaceableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500, batReplacementDescription = 'Battery type', batQuantity = 1) {
|
|
422
444
|
this.behaviors.require(PowerSourceServer.with(PowerSource.Feature.Battery, PowerSource.Feature.Replaceable), {
|
|
423
445
|
status: PowerSource.PowerSourceStatus.Active,
|
|
@@ -1066,8 +1088,9 @@ export class MatterbridgeEndpoint extends Endpoint {
|
|
|
1066
1088
|
return this;
|
|
1067
1089
|
}
|
|
1068
1090
|
createDefaultDeviceEnergyManagementClusterServer(esaType = DeviceEnergyManagement.EsaType.Other, esaCanGenerate = false, esaState = DeviceEnergyManagement.EsaState.Online, absMinPower = 0, absMaxPower = 0) {
|
|
1069
|
-
this.behaviors.require(
|
|
1091
|
+
this.behaviors.require(MatterbridgeDeviceEnergyManagementServer.with(DeviceEnergyManagement.Feature.PowerForecastReporting, DeviceEnergyManagement.Feature.PowerAdjustment), {
|
|
1070
1092
|
forecast: null,
|
|
1093
|
+
powerAdjustmentCapability: null,
|
|
1071
1094
|
esaType,
|
|
1072
1095
|
esaCanGenerate,
|
|
1073
1096
|
esaState,
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { PowerSourceTag } from '@matter/main';
|
|
2
|
+
import { DeviceEnergyManagement } from '@matter/main/clusters/device-energy-management';
|
|
3
|
+
import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
|
|
4
|
+
import { deviceEnergyManagement, electricalSensor, solarPower, powerSource } from './matterbridgeDeviceTypes.js';
|
|
5
|
+
export class SolarPower extends MatterbridgeEndpoint {
|
|
6
|
+
constructor(name, serial, voltage = null, current = null, power = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
|
|
7
|
+
super([solarPower, powerSource, electricalSensor, deviceEnergyManagement], {
|
|
8
|
+
tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Solar.namespaceId, tag: PowerSourceTag.Solar.tag, label: null }],
|
|
9
|
+
id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}`,
|
|
10
|
+
}, true);
|
|
11
|
+
this.createDefaultIdentifyClusterServer()
|
|
12
|
+
.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Solar Power')
|
|
13
|
+
.createDefaultPowerSourceWiredClusterServer()
|
|
14
|
+
.createDefaultPowerTopologyClusterServer()
|
|
15
|
+
.createDefaultElectricalPowerMeasurementClusterServer(voltage, current, power)
|
|
16
|
+
.createDefaultElectricalEnergyMeasurementClusterServer(0, energyExported)
|
|
17
|
+
.createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.SolarPv, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
|
|
18
|
+
.addRequiredClusterServers();
|
|
19
|
+
}
|
|
20
|
+
}
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "matterbridge",
|
|
3
|
-
"version": "3.1.1-dev-20250629-
|
|
3
|
+
"version": "3.1.1-dev-20250629-cfe9124",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "matterbridge",
|
|
9
|
-
"version": "3.1.1-dev-20250629-
|
|
9
|
+
"version": "3.1.1-dev-20250629-cfe9124",
|
|
10
10
|
"license": "Apache-2.0",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"@matter/main": "0.15.0",
|
package/package.json
CHANGED