Important: If you are using multiple central units with the same myDevolo account, please follow the special install instructions described below.
Optional parameters
Name of parameter
Default value
Notes
ruleWhitelist
['MyRule1', 'MyRule2']
specify the rules which you want to use in Apple Home by their exact names in mydevolo. By default no rule is exported.
sceneWhitelist
['MyScene1', 'MyScene2']
specify the scenes which you want to use in Apple Home by their exact names in mydevolo. By default no scene is exported.
deviceBlacklist
['BlockedDevice1', 'BlockedDevice2']
specify the devices which you DON'T want to use in Apple Home by their exact names in mydevolo. By default all devices are exported.
switchBlacklistDoubleRelaySwitch
['BlockedSwitch1 2', 'BlockedSwitch2 1']
specify the switches of double/triple/quattro relays/switches (e.g.: qubino flush 2, fibaro fgs-223) which you DON'T want to use in Apple Home by their exact names in mydevolo. Blacklist never ALL switches of a device. By default all switches are exported.
deviceDebugging
false
when set to true homebridge-devolo will output some debugging information and terminate afterwards. This is helpful to get information for new device integrations.
fakeGato
false
when set to true homebridge-devolo will save history data for some devices, these will reported in the eve app (screenshots here)
lightBlacklist
['BlockedLightDevice1', 'BlockedLightDevice2']
specify door or motion devices which you DON'T want to use his light/lux sensor in Apple Home by their exact names in mydevolo. By default all devices are exported.
tempBlacklist
['BlockedTempDevice1', 'BlockedTempDevice2']
specify door or motion devices which you DON'T want to use his temperature sensor in Apple Home by their exact names in mydevolo. By default all devices are exported.
fakeGaragedoor
false
when set to true homebridge-devolo will emulate a full compatible garage door (more info here)
Multiple central units
If you have multiple central units with the same myDevolo account you will likely receive the following error message when starting up homebridge: "[Devolo] HBDevoloPlatform > SyntaxError: Unexpected token U in JSON at position 0". Please follow the following instructions to resolve this: Log in to your myDevolo account and click on the pen icon beneath the central unit you want to use. Note the serial number of the central unit. Add the following entry to your config.json (beside host, email, password etc.):
...
"gateway" : "your_serial_number"
...
Garage Door
You need a devolo door/window contact (garage door) and a qubino flush 1d (garage door motor) - pictures & screenshots.
Add the following entry to your config.json
...
"fakeGaragedoor": true,
"fakeGaragedoorParams": {
"openTime": 15,
"doorDevice": "garage door contact",
"relayDevice": "garage door motor"
...
Name of parameter
Notes
openTime
specify the time until the garage door is completely open.
doorDevice
specify the door contact by their exact names in myDevolo.
relayDevice
specify the relay device by their exact names in myDevolo.
I'm happy to provide support for new devices. If you own an unsupported device you can provide me a debug log making the device integration easier for me. In order to do so set the config parameter deviceDebugging to true and run the following command: homebridge -D | tee debugoutput.log. The command will auto-finish after a while and create a textfile named debugoutput.log. Please attach this log file to your github issue.
Troubleshooting
If you run into issues related to this plugin, feel free to open an issue. Please start your homebridge installation with the command homebridge -D > logfile.txt 2>&1 and attach the generated logfile.
Changes
v0.1.19-dev
v0.1.18 (2020-05-20)
Everspring Dimmer (AD142-2) supported
Everspring Temp/Humidity (ST-814) supported
Merten Connect Dimmer (508619) supported
v0.1.17 (2020-03-10)
Everspring On/Off Switch (AN158-2) supported
v0.1.16 (2020-01-31)
Bugfix: Fibaro wall switches (FGS-211, FGS-213 and FGS-221) and Home+ 4 by @brutella
Added support for Fibaro Roller Shutter FGR-222. Since it is currently not fully supported by the devolo Home Control Central Unit, only the following functions are available:
Display of the current position
Display of the power total consumption
Display of the current power consumption
complete opening and closing
Attention: partial opening or closing is currently not possible!
v0.1.15 (2019-08-21)
Update API: ModelUID changes since devolo homecontrol firmware from 2 may 2019 (Danfoss Thermostat, Qubino Flush, Fibaro Flood)
Bugfix: Shutter stutter fix - now is operated with a delay of 1500ms
Bugfix: No homekit notifications when homebridge start/restart (Devolo Alarm Siren)
v0.1.14 (2019-04-10)
Bugfix API: Wrong reported state by dDevice.getState, because state not saved last onStateChanged for Devolo Motion Sensor, Door Sensor / Window Contact, Smoke Detector and Leak Sensor since v0.1.9 (not by state change, only when home app force close or room switch - automation was not affected)
Bugfix FakeGato: No graphs if status was not changed for a long time
Bugfix: CurrentConsumption is reported before FakeGato History is loaded (Cannot add a Characteristic with the same UUID as another Characteristic in this Service)
add values and states from devolo requests in homebridge log
v0.1.13 (2019-01-09)
Popp Z-Weather supported
add FakeGato History (Eve App) THERMO for Devolo Room Thermostat, Devolo and Danfoss Thermostat Valve
add FakeGato History (Eve App) WEATHER for Devolo Humidity Sensor
Bugfix in node-devolo for multiple sensors per device
add a full compatible garage door (GarageDoorOpener) with one Devolo Door Sensor / Window Contact and one Qubino Flush 1D
v0.1.10 (2018-08-03)
add lightBlacklist (light/lux sensor) and tempBlacklist (temperature sensor) for Devolo Door Sensor / Window Contact and Devolo Motion Sensor
add FakeGato History (Eve App) DOOR for Devolo Door Sensor / Window Contact
add FakeGato History (Eve App) MOTION for Devolo Motion Sensor
add FakeGato History (Eve App) ENERGY for Devolo Smart Metering (v1/v2), Devolo Flush Relay, Devolo Flush Dimmer, Qubino Flush 1 and Qubino Flush Dimmer
v0.1.9 (2018-07-16)
Devolo flush relay & dimmer supported
Qubino flush X relay & dimmer supported
Danfoss thermostat valve (LC-13) supported
Bugfix for 2 websocket reconnect issues
v0.1.8 (2018-04-20)
Alarm siren supported
Bugfix: Device debugging
v0.1.7 (2018-02-27)
Remote control supported
Bugfix: Status of rules is displayed correctly
Device debugging for faster support of new devices
v0.1.6 (2018-01-18)
Wall Switch supported
Filter devices with deviceBlacklist
Bugfix: Increased max listeners
v0.1.5 (2017-09-29)
Qubino Flush Shutter supported
Sockets instead of slow polling
Various bugfixes
Performance improvements
v0.1.4 (2017-07-15)
Smoke Detector supported
Thermostat Valve supported
Room Thermostat supported
Smart Metering Plug v2 supported
Support of Rules and Scenes via whitelist
Performance optimizations
Bugfix: Restart heartbeat in case of an error
Bugfix: Renew session if it has gone invalid
v0.1.3 (2017-03-06)
Switch Meter Device does not switch if disabled in devolo webgui.
Switch Meter Device shows current consumption and total consumption.
Door Sensor / Window Contact and Motion Device show light level.
Heartrate interval can be specified in config.
Bugfix: Fast switching of Switch Meter Device.
v0.1.2 (2017-02-22)
Bugfix: Switching of Switch Meter Device.
v0.1.1 (2017-02-21)
First version.
License
The MIT License (MIT)
Copyright (c) 2017-2020 Kevin Dietrich
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
请发表评论