Skip to content

Commit 0fcad83

Browse files
authored
Merge pull request #135 from Luligu/dev
Release 2.0.4
2 parents a540d87 + af43cb8 commit 0fcad83

File tree

152 files changed

+9761
-4718
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

152 files changed

+9761
-4718
lines changed

.npmignore

-1
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,6 @@ screenshot
165165
matterbridge-shelly
166166
jest-shelly
167167
TODO.md
168-
yellow-button.png
169168
temp
170169
rock-s0
171170
CODEOWNERS

CHANGELOG.md

+81-52
Large diffs are not rendered by default.

README.md

+16-9
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge shelly plugin &nbsp;&nbsp; <img src="https://github.com/Luligu/matterbridge/blob/main/screenshot/Shelly.png" alt="Shelly logo" width="200" />
1+
# <img src="matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge shelly plugin &nbsp;&nbsp; <img src="Shelly.svg" alt="Shelly logo" width="200" />
22

33
[![npm version](https://img.shields.io/npm/v/matterbridge-shelly.svg)](https://www.npmjs.com/package/matterbridge-shelly)
44
[![npm downloads](https://img.shields.io/npm/dt/matterbridge-shelly.svg)](https://www.npmjs.com/package/matterbridge-shelly)
@@ -7,7 +7,6 @@
77
![Node.js CI](https://github.com/Luligu/matterbridge-shelly/actions/workflows/build-matterbridge-plugin.yml/badge.svg)
88

99
[![power by](https://img.shields.io/badge/powered%20by-matterbridge-blue)](https://www.npmjs.com/package/matterbridge)
10-
[![power by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)
1110
[![power by](https://img.shields.io/badge/powered%20by-node--ansi--logger-blue)](https://www.npmjs.com/package/node-ansi-logger)
1211
[![power by](https://img.shields.io/badge/powered%20by-node--persist--manager-blue)](https://www.npmjs.com/package/node-persist-manager)
1312

@@ -19,11 +18,11 @@ Features:
1918

2019
- Shellies are automatically discovered using mDNS.
2120
- Shelly wifi battery-powered devices are supported.
22-
- Shelly wifi battery-powered devices with sleep_mode are supported.
21+
- Shelly wifi battery-powered devices with sleep_mode are supported. If they don't report in the last 24h, they are considered offline.
2322
- Shelly BLU devices are supported through local devices configured as ble gateway.
2423
- Discovered shellies are stored in local storage and cached for fast loading on startup.
2524
- The components exposed are Light (with brightness and RGB color), Switch, Relay, Roller, Cover, PowerMeter, Temperature, Humidity, Illuminance, Thermostat, Button and Input.
26-
- PowerMeters expose the electrical measurements with the electricalSensor device type (suppoerted by Home Assistant and partially by SmartThings), waiting for the controllers to upgrade to the Matter 1.3 specs.
25+
- PowerMeters expose the electrical measurements with the electricalSensor device type (suppoerted by Home Assistant and partially by SmartThings), waiting for the other controllers to upgrade to the Matter 1.3 specs.
2726
- Shellies are controlled locally, eliminating the need for cloud or MQTT (which can both be disabled).
2827
- Shelly Gen 1 devices are controlled using the CoIoT protocol (see the note below).
2928
- Shelly Gen 2 and Gen 3 devices are controlled using WebSocket.
@@ -32,19 +31,24 @@ Features:
3231
- Device components can be blacklisted globally or on a per-device basis. Refer to the [COMPONENTS.md documentation.](https://github.com/Luligu/matterbridge-shelly/blob/main/COMPONENTS.md)
3332
- Devices ids can be selected from a list in the config editor or in the Devices panel on the Home page.
3433
- If the device has a firmware update available, a message is displayed.
35-
- If the device's CoIoT protocol is not correctly configured, a message is displayed.
34+
- If the device's CoIoT protocol is not correctly configured for the gen 1 devices, a message is displayed.
35+
- If the device's Outbound websocket settings is not correctly configured for the gen 2+ battery powered devices, a message is displayed.
3636
- If the device cover/roller component is not calibrated, a message is displayed.
3737
- If a device changes its ip address on the network, a message is displayed and the new address is stored.
38-
- A 10-minute timer checks if the device has reported within that time frame, and fetch un update.
38+
- A 1 hour timer checks if the device has reported within that time frame, fetch un update and save the cache file.
3939

4040
If you like this project and find it useful, please consider giving it a star on GitHub at https://github.com/Luligu/matterbridge-shelly and sponsoring it.
4141

42-
## Sponsor
42+
<a href="https://www.buymeacoffee.com/luligugithub">
43+
<img src="bmc-button.svg" alt="Buy me a coffee" width="120">
44+
</a>
45+
46+
## Sponsors
4347

4448
This project is proudly sponsored by:
4549

4650
<a href="https://www.shelly.com/en">
47-
<img src="https://github.com/Luligu/matterbridge/blob/main/screenshot/Shelly.png" alt="Shelly logo" width="100" />
51+
<img src="Shelly.svg" alt="Shelly logo" width="100" />
4852
</a>
4953

5054
[Shelly Group](https://corporate.shelly.com/about-shelly-group/)
@@ -77,7 +81,9 @@ A shelly device gen. 1 or 2 or 3 or BLU.
7781

7882
## How to add a device
7983

80-
Verify that enableMdnsDiscover and enableStorageDiscover are selected in the plugin configuration. Restart matterbridge (the mdns discovery is active for the first 10 minutes) and the devices will be discovered.
84+
Verify that enableMdnsDiscover and enableStorageDiscover are selected in the plugin configuration. Restart matterbridge in case these options were not flagged and the devices will be discovered.
85+
86+
When all the devices have been discovered and stored, I suggest to unselect enableMdnsDiscover.
8187

8288
Follow these guidelines for specific devices.
8389

@@ -216,6 +222,7 @@ The devices in the list will not be loaded from the cache. Use the device id (e.
216222

217223
You can put there one of more of your devices if they have problem with mdns.
218224
Don't use it unless is needed cause the IP address you add here is static.
225+
Don't use it for battery powered device that go in sleepmode.
219226
You also need to enable the enableConfigDiscover option.
220227
E.g. "shelly1minig3-543204547478": "192.168.1.221".
221228

Shelly.svg

+1
Loading

bmc-button.svg

+22
Loading

matterbridge-shelly.schema.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@
127127
}
128128
},
129129
"enableMdnsDiscover": {
130-
"description": "Enable the mdns discovery for shelly devices",
130+
"description": "Enable the mdns discovery for shelly devices. Once all the devices are loaded and stored, it is possible to disable this setting to reduce the network traffic.",
131131
"type": "boolean",
132132
"default": true
133133
},

matterbridge.svg

+50
Loading

0 commit comments

Comments
 (0)