You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Shellies are automatically discovered using mDNS.
21
20
- 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.
23
22
- Shelly BLU devices are supported through local devices configured as ble gateway.
24
23
- Discovered shellies are stored in local storage and cached for fast loading on startup.
25
24
- 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.
27
26
- Shellies are controlled locally, eliminating the need for cloud or MQTT (which can both be disabled).
28
27
- Shelly Gen 1 devices are controlled using the CoIoT protocol (see the note below).
29
28
- Shelly Gen 2 and Gen 3 devices are controlled using WebSocket.
@@ -32,19 +31,24 @@ Features:
32
31
- 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)
33
32
- Devices ids can be selected from a list in the config editor or in the Devices panel on the Home page.
34
33
- 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.
36
36
- If the device cover/roller component is not calibrated, a message is displayed.
37
37
- 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.
39
39
40
40
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.
@@ -77,7 +81,9 @@ A shelly device gen. 1 or 2 or 3 or BLU.
77
81
78
82
## How to add a device
79
83
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.
81
87
82
88
Follow these guidelines for specific devices.
83
89
@@ -216,6 +222,7 @@ The devices in the list will not be loaded from the cache. Use the device id (e.
216
222
217
223
You can put there one of more of your devices if they have problem with mdns.
218
224
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.
219
226
You also need to enable the enableConfigDiscover option.
220
227
E.g. "shelly1minig3-543204547478": "192.168.1.221".
Copy file name to clipboardexpand all lines: matterbridge-shelly.schema.json
+1-1
Original file line number
Diff line number
Diff line change
@@ -127,7 +127,7 @@
127
127
}
128
128
},
129
129
"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.",
0 commit comments