homebridge-devolo
Advanced tools
(c) 2017-2020, Kevin Dietrich & Nico Hartung
This homebridge plugin allows you to control your Devolo Home Control devices via Apple's homekit. The following devices are currently supported:
Feel free to submit an issue or pull request to add more.
npm install -g homebridgenpm install -g homebridge-devoloconfig.json. Host is the IP address of your Devolo Home Control central unit. Email and password are your mydevolo.com credentials."platforms": [
{
"platform" : "Devolo",
"name" : "Devolo",
"host" : "x.x.x.x",
"email" : "mail@host.com",
"password" : "topsecret123"
}
]
Important: If you are using multiple central units with the same myDevolo account, please follow the special install instructions described below.
| 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) |
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"
...
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. |
Powered by node-devolo. Thanks to @nicoh88.
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.
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.
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)node-devolo for multiple sensors per deviceswitchBlacklistDoubleRelaySwitch for double/triple/quattro relays/switcheslightBlacklist (light/lux sensor) and tempBlacklist (temperature sensor) for Devolo Door Sensor / Window Contact and Devolo Motion SensorThe 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.
FAQs
Homebridge plugin for Devolo Home Control
The npm package homebridge-devolo receives a total of 9 weekly downloads. As such, homebridge-devolo popularity was classified as not popular.
We found that homebridge-devolo demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ruby maintainers from Bundler and rbenv teams are building rv to bring Python uv's speed and unified tooling approach to Ruby development.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.
Security News
AGENTS.md is a fast-growing open format giving AI coding agents a shared, predictable way to understand project setup, style, and workflows.