Beachten
Kein Support für Beta-Versionen von deCONZ
Verbindet sich mit der von dresden-elektronik entwickelten deCONZ REST-API-Software. Diese Software zielt darauf ab, eine universelle ZigBee-Gateway-Lösung zu sein und nutzt Hardware von dresden-elektronik: den ConBee(X) USB-Stick und das RaspBee(X), ein Modul für den Raspberry Pi.
Sie müssen zuerst eine Verbindung zu deCONZ herstellen.
- a) Geben Sie die IP-Adresse für deCONZ ein
b) Geben Sie den Standard-Bridge-Port 80 und den Standard-Websocket 443 ein.
[z. B. Phoscon App - Hilfe - API-Informationen - Kein Filter - Suche nach Port/WebSocketPort] - Nachdem Sie IP-Adresse und Port eingegeben und gespeichert haben, klicken Sie auf „API-Schlüssel erstellen“. Nun können Sie die Zugangsdaten für deCONZ eingeben oder in der Phoscon-App ioBroker als Drittanbieter-App registrieren.
Um Fehler nach einem Update (deCONZ/Adapter) zu vermeiden, stoppen Sie den Adapter und löschen Sie die entsprechenden Einträge in der Objektstruktur. Beim nächsten Start wird die Objektstruktur neu erstellt.
- Gruppen
- Lichter
- Sensoren
Senden Sie mehrere Befehle gleichzeitig
Zu diesem Zweck gibt es ein Objekt namens "action".
Beispiele:
"on": true, "xy": [0.6586,0.3138]
"on": true, "transitiontime": 5, "hue": 360
Links
deCONZ REST-API-Plugin
Dokumentation des deCONZ REST-API-Plugins
Gateways (Hardware)
Sponsoren
Changelog
WORK IN PROGRESS
- (copilot) Adapter requires node.js >= 22 now
1.7.11 (2026-09-03)
- chore(deps-dev): bump @alcalzone/release-script-plugin-license
- chore(deps-dev): bump js-yaml from 4.3.0 to 4.3.1
1.7.10 (2026-08-03)
- chore(deps-dev): bump @iobroker/testing from 5.2.2 to 5.3.0
- chore(deps-dev): bump @types/node from 25.9.4 to 25.9.5
- chore(deps-dev): bump axios from 1.16.0 to 1.18.1
1.7.9 (2026-07-03)
- chore(deps-dev): bump @types/node from 25.9.1 to 25.9.4
- chore(deps-dev): bump @alcalzone/release-script from 5.2.0 to 5.2.1
- chore(deps-dev): bump js-yaml from 4.1.1 to 4.3.0
1.7.8 (2026-06-03)
- chore(deps-dev): bump @alcalzone/release-script-plugin-license
- chore(deps-dev): bump @types/node from 25.6.0 to 25.9.1
- chore(deps-dev): bump @alcalzone/release-script from 5.1.1 to 5.2.0
- chore(deps-dev): bump @alcalzone/release-script-plugin-iobroker
- chore(deps-dev): bump @alcalzone/release-script-plugin-manual-review
- chore(deps-dev): bump @iobroker/eslint-config from 2.2.0 to 2.3.4
- chore(deps): bump ws from 8.20.0 to 8.20.1
- chore(deps-dev): bump protobufjs from 7.5.5 to 7.5.8
- chore(deps-dev): bump @protobufjs/utf8 from 1.1.0 to 1.1.1
- chore(deps-dev): bump axios from 1.15.0 to 1.16.0
- Update from template: S6020-addChangelogOld
- Update from template: X0000-dropNode20
- Update from template: W8917-dependabot-addIgnoreTypesNode
- chore(deps-dev): bump @types/node from 20.19.37 to 25.6.0
1.7.7 (2026-05-03)
- chore(deps-dev): bump protobufjs from 7.5.4 to 7.5.5
- chore(deps-dev): bump follow-redirects from 1.15.11 to 1.16.0
- chore(deps-dev): bump axios from 1.14.0 to 1.15.0
- Update from template: X0000-updateNodeJsAtTestAndRelease
1.7.6 (2026-04-02)f
- migrate from request to fetch
1.7.4 (2026-03-29)
- update dependencies
1.7.3 (2026-03-29)
- (iobroker-bot) Adapter requires node.js >= 20 now.
- update dependencies
- fix: errors found by ioBroker repo checker
1.7.2 (2026-03-29)
- fix: remove [skip ci] from release commit so test-and-release triggers on tag
1.7.1 (2026-03-29)
- chore: update GitHub Actions to v6 (Node.js 24 compatibility)
- fix: export VERSION and DATE env vars for Python subprocess in release workflow
- fix: make UTCtoLocal robust against invalid/already-timezone-aware timestamps
- Bump node-forge from 1.3.2 to 1.4.0
- Update from template: S5043-useNodePrefix
- Bump picomatch
- chore: update monthly release workflow - add io-package.json and README changelog
- chore: add monthly release workflow
- Uncomment NPM deployment steps in workflow
- Bump flatted from 3.3.3 to 3.4.2
- Update from template: X0000-updateNodeJsAtTestAndRelease
- Bump minimatch
- Bump ajv from 6.12.6 to 6.14.0
- fix: correct indentation of migration code and main() closure
- fix: add missing closing brace for deconz class after ESLint reformat
- Update Node.js versions in CI workflow
- chore: migrate to ESLint 9 with @iobroker/eslint-config
- fix: migrate gateway config from Gateway_info to adapter.config on upgrade
- Bump lodash from 4.17.21 to 4.17.23
- Update from template: X0000-setupAutomergeDependabot
1.7.0 (2024-11-22)
- (mattreim) Hide virtual sensors function
- (mattreim) Hide switch groups function
- (mattreim) Update dependencies
- (mattreim) Updated/added some translations
- (mattreim) Some bug fixes and more
1.6.4 (2024-10-06)
- (mattreim) Add "protectedNative" and "encryptedNative"
- (mattreim) Fix websocket connection
- (Jey Cee) Fix missing port for create api key function
1.6.3 (2024-10-04)
- (Jey Cee) Fix connection problems
1.6.2 (2024-10-04)
- (Jey Cee) Fix no connection on new installation
1.6.1 (2024-10-03)
- (Jey Cee/mattreim) Highlight helper text for authentication
1.6.0 (2024-10-02)
- (Jey Cee/mattreim) Migrate config to JSONConfig
- (Jey Cee) Removed device and group management from config
- (mattreim) Add natives
- (Jey Cee) Update dependencies
- (Jey Cee) Use default test and release action
1.5.0 (2024-08-11)
- Updated/added some translations
- (mattreim) Dependencies have been updated
- (mattreim) Logo compressed
- (mattreim) Remove common.title
1.4.1 (2024-05-05)
- (mattreim) Added new objects for various sensors
1.4.0 (2024-01-29)
- (mattreim) Added new objects for Tuya and Bosch thermostats
1.3.23 (2023-11-05)
- fix crash when new device was added closes #319
- added possibility to change the port for websocket connection
- updated/added translations
- (grizzelbee) Fix: Re-enabled window covers
- (grizzelbee) Upd: Dependencies got updated
- (grizzelbee) New: Added ukrainian translation
1.3.21 (2022-05-13)
- added schedule to object definition
- changed limit for duration to 999999
1.3.20 (2022-02-26)
- (withstu) add retry if gateway is busy
- change min/max range for offset
- updated translations
- fix link for overview page
- fix parameter can not be set since deConz 2.11.5
- fix xy is invalid: #289 #295
- remove Sentry
1.3.19 (2021-08-08)
- fix for js-controller 3.3.x
1.3.17
- fix crash #248
1.3.16
- added datapoints melody and volume (Used by NEO-Alarm-Sirene by Tuya)
- added new effects for Müller Licht Tint: sunset, party, worklight, campfire, romance, nightlight
- added new effects for Lidl Melinera: steady, snow, rainbow, snake, twinkle, fireworks, flag, waves, updown, vintage, fading, collide, strobe, sparkles, carnival, glow
- added 2 new datapoints they were used by Lidl Melinera effects: effectspeed: simple number; effectcolours: array of rgb values = [[255,0,0],[0,255,0],[0,0,255]] https://github.com/dresden-elektronik/deconz-rest-plugin/issues/3716#issuecomment-735467996
1.3.15 (2021-05-08)
- fix info message: "State value to set for "deconz.0.Sensors.3.pending" has to be stringified but received type "object""
- fix info message: State value to set for "deconz.0.Sensors.3.orientation" has to be stringified but received type "object"
1.3.13
- fixes for js-controller 3.3
1.3.12
- fixes for js-controller 3.3
1.3.11
- fix auto reconnect
1.3.10
- (bortim) added change-event handling, new in deConz v2.05.78
1.3.9
- set default port to 80
1.3.8
- fix colorloopspeed is not working
- fix set xy has no effect
- some small fixes
1.3.7
- stable re-release
1.3.6
- fix object definition dimup and dimdown
1.3.5
- disable node v8 tests
- fix createscene object definition
- prevent websocket to connect if port, api key or ip is missing
- catch errors on ackStateVal
- fix "Cannot read property 'id' of undefined" for controlId
- fix crash on scene actions with js-controller 3
- catch onStateChange stateObj is null
- fix level update when bri was set by other deConz instance
1.3.4
- fix message "State value to set is invalid"
- terminate websocket connection on error to make sure the session is closed
- check response is not undefined
- catch request errors and send to sentry
- prevent sending message with wrong value type
1.3.3
- fix catch response of setLightState is undefined
- fix ws.terminate at unload
- catch ip/port undefined at auto updates
- catch res is undefined at deleteApiKey
1.3.2
- transitiontime now in seconds instead 1/10 seconds
- fix colorspeed
- use new class style
- add sentry for error collection
- fix transition time if set to 0
- objects will be now deleted if the device is removed by adapter
- fix multiple websocket connections
- try to fix #120 reconnect after 60 seconds
1.3.1
- fix set dimspeed
- connect to Websocket in any case
1.3.0
- fix websocket connection if there are no upnp broadcast answer from deconz
- corrected duration role
- added level to lights and groups
1.2.6
- fix crash by executing commands without parameters
1.2.5
- code cleanup
- (Zefau) fixed duplicated subscription
- (Zefau) useless loop within getGroupAttributes()
- refactor logging
- refactor state change
- fix API Key Dialog
- Websocket reconnect after 60 Seconds if no message is received
1.2.4
- dynamicly add boolean states for button events
- added new object definitions
- (mobilutz) remove ip overwrite
- (njeisecke) add transitiontime for bri_inc (dim step)
1.2.3
- fix expire time for alive
- add object for open zigbee network to add new devices without admin config
- removed input for opne network time
- fix device list in admin config
1.2.2
- adapter configuration handling rewritten
- fix lastupdated UTC to locale time
1.2.1
- convert lastupdated time to locale
- object creation refactored
- fix adapter config update
- add auto detect deConz
- include ssdp discovery to repo
1.2.0
- fix adapter crash when deConz is not reachable
- show connection state as adapter state
- add auto reconnect to deconz
- add new objects for thermostat support and others
1.1.3
- Changed default port to 80
- (mplogas) fixed config save
- (mplogas) added config.delay to set up presence sensor cooldown
1.1.2
- fix button objects
- changed buttonpressed from boolean to number
1.1.0
- added objects for "tiltangle", "vibration", "vibrationstrength" and "orientation"
- (asgothian) added object "buttonpressd"
- some fixes
1.0.2
- fix set bri for groups
1.0.1
- small fixes
1.0.0
- (thewhobox) skip helper groups
- (thewhobox) added channels for lights, groups and sensors
- (thewhobox) skip unusable sensors
- (thewhobox/KristianHeider) turn light/groups on when changing brightness
- (jey-cee) added object group for remotes
- (jey-cee) stop overwrite objects on adapter start
- (jey-cee) prepared for compact mode
- (jey-cee) new possible to change offset (if the device accept it)
- (jey-cee) new possible to change duration (if the device accept it)
- (jey-cee) get API key with credentials
0.4.0
- (asgothian) Fix for hue change
- (halloamt) Added support for dimming lights and groups
- (halloamt) Added support for custom actions
0.3.1
- Fixing hue from range 0-65535 to 0-360
0.3.0
- Added scene support
- Drop nodejs 4 support
0.2.5
- Fix/Change handling create objects during running Adapter
0.2.4
- Fix create objects during running adapter
0.2.3
- Create objects during runing adapter
0.2.2
- Changed id naming
- Use websocket messages instead polling afterwards
0.2.1
- (Jey-Cee) Added new elements to config
- (Jey-Cee) Changed som small things
0.2.0
- (Jey-Cee) next Try with Xiaomi Sensors
- (Jey-Cee) Added "pressure" sensor
- (Jey-Cee) Added create group to adapter config
0.1.7
- (Jey-Cee) add possibility to delete devices from deConz
- (Jey-Cee) fix issue on getAll... functions when there are is nothing
0.1.6
- (Jey-Cee) fix Xiaomi Sensors recognition
0.1.5
- (Jey-Cee) Try to fix Sensors
0.1.4
- (Jey-Cee) Added support for Admin v3
- (Jey-Cee) Create API Key without use of WebApp/Phoscon (only with deConz standard password)
0.1.3
- (Jey-Cee) Stop Spam in log
- (Jey-Cee) Added filter for name to id conversation
0.1.2
- (Jey-Cee) Added new datapoints for sensors (experimental)
0.1.1
- (Jey-Cee) Adapter complete rewritten
0.1.0
- (Jey-Cee) first release
License
Apache-2.0
Copyright (c) 2017-2026 Jey Cee jey-cee@live.com