deCONZ / Phoscon Smart-Home-Integration, kostenlos und Open Source
The Zigbee devices of a deCONZ gateway (ConBee, RaspBee): lights, plugs, covers, sensors, remotes.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
You have a ConBee stick or a RaspBee board with deCONZ and the Phoscon app, and you do not want to pair everything again in Zigbee2MQTT? This integration connects Gladys to your gateway as it is: your lights, plugs, covers, thermostats, sensors and remotes appear in the Discovery tab of Gladys, their changes arrive live and your commands go to the gateway. Everything stays on your local network.
Unofficial integration, not affiliated with dresden elektronik (the maker of deCONZ, Phoscon, ConBee and RaspBee).
Development version (0.1). Developed and tested against faithful copies of the deCONZ API answers, not yet against a real gateway. Feedback is welcome on the GitHub repository.
What you get
| In deCONZ | In Gladys |
|---|---|
| Lights (color, color temperature, dimmable) | light: on/off, brightness, color temperature (mireds), color |
| Plugs, relays, "On/Off light" | switch (and power, voltage, current, energy when the plug measures them) |
Covers (Window covering device) | shutter: open, close, stop, position (100 % = open) |
ZHAThermostat (radiator valves) | thermostat: temperature, setpoint, mode (off, heat, auto), activity |
ZHATemperature, ZHAHumidity, ZHAPressure | temperature (°C), humidity (%), pressure (hPa) sensors |
ZHAOpenClose, ZHAPresence | opening sensor, motion sensor |
ZHAWater, ZHAFire, ZHACarbonMonoxide | water leak, smoke, carbon monoxide detectors |
ZHALightLevel | illuminance (lux) |
ZHAPower, ZHAConsumption | power (W), voltage (V), current (A), energy (kWh, an index for a meter) |
ZHAVibration, ZHAMoisture, ZHAAirQuality | vibration and tilt, soil moisture, VOC (ppb) |
ZHABattery and the battery of every sensor | battery (%) of the device |
ZHASwitch (remotes, wall switches) | button, and the deCONZ remote button scene trigger |
deCONZ often splits one device into several "resources" (a Xiaomi sensor = temperature + humidity + pressure): the integration groups them into one Gladys device by their Zigbee address, with one battery. It is named after its light, or its main sensor, in Phoscon.
Whether each device is reachable shows on its connection badge.
Setup
- deCONZ runs and the Phoscon app opens in your browser (for example
http://192.168.1.20). - In the configuration of the integration, type the gateway address: the
IP address of the machine running deCONZ, as seen from the Gladys machine
(not
localhost: the integration runs in its own container). Leave it empty, or press Find the gateway, for Gladys to look for it on the network (SSDP). - The port is the one of the Phoscon app: 80 by default, otherwise the one in its address (e.g. 8080 for deCONZ in Docker). Save.
- API key: in Phoscon, open Settings → Gateway → Advanced and press Authenticate app. Within 60 seconds, press the Get an API key button of the integration: the key is saved and the connection starts. (A key created elsewhere can also be pasted in the "API key" field.)
- Open Discovery and add your devices. The Test the connection button sums up what the gateway holds.
The live events go through the deCONZ WebSocket, on the port it announces (often 443 on a Raspberry Pi, 8081 in Docker): that port must be reachable from the Gladys machine too.
Remotes and wall switches
Every press of a remote fires the deCONZ remote button scene trigger, which
you can filter by device, button number and gesture: click
(short_release), press, hold, release after a hold, double, triple or
quadruple click, shake, drop, tilt, rotation. The button, event, code
and gesture variables are available to the actions of the scene.
deCONZ codes each press button × 1000 + gesture: 1002 = button 1, click;
2001 = button 2, held; 4003 = button 4, released after a hold. On a Hue
dimmer, for example, 1 = on, 2 = brighter, 3 = dimmer, 4 = off. To learn the
number of a button, press it and look at the button variable (or the logs of
the integration).
The Aqara cube gives its side (button) and its gesture: flipped 90° or
180°, pushed, double tap, shaken, dropped, turned (the angle × 100 is in
code). The Hue Tap gives its buttons 1 to 4.
The device also has a Button feature taking the value of the last gesture (without the button number): handy for a one-button remote; for several buttons, prefer the scene trigger.
Good to know
- The deCONZ groups and scenes are not taken over yet, nor the locks, sirens and fans: they are left out (see the logs).
- A thermostat accepts the modes it knows: a mode the valve refuses returns the deCONZ error.
- The ids of the devices in Gladys come from the Zigbee address: they do not change when deCONZ renumbers its resources.
- The gateway must serve HTTP on your local network (the default).
Troubleshooting
- "The deCONZ gateway is unreachable": check the address and the port (the Phoscon ones), and that deCONZ runs.
- "The gateway refused the API key": the key was deleted in Phoscon (Settings → Gateway → Advanced, list of apps): do step 4 again.
- No live changes, or "the event connection is lost": the deCONZ WebSocket port is not reachable from Gladys (firewall, port not published by the deCONZ container).
- Find the gateway finds nothing: some setups (Docker, VLANs) do not answer SSDP; type the address by hand.
Konfigurationseinstellungen
Diese Einstellungen fragt deCONZ / Phoscon in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your deCONZ gateway, as it is | section | Nein | For the ConBee and RaspBee users who keep deCONZ and the Phoscon app: no migration to Zigbee2MQTT, no pairing again. This integration reads the lights, plugs, covers, thermostats, sensors and remotes of your gateway through its local API, follows their changes live and sends your commands. Type the address of the gateway as seen from the Gladys machine (its LAN IP address, the one of the Phoscon app), or press "Find the gateway". Unofficial, not affiliated with dresden elektronik. |
| Gateway address | string | Nein | The IP address or host name of the machine running deCONZ (the address of the Phoscon app). Empty: the integration looks for it on the network. |
| Port of the Phoscon app | number | Nein | 80 by default; the port in the Phoscon address otherwise (e.g. 8080 for deCONZ in Docker). |
| API key | section | Nein | deCONZ only gives an API key to an app the gateway was unlocked for: 1. Save the address above. 2. In Phoscon, open Settings → Gateway → Advanced and press "Authenticate app". 3. Within 60 seconds, press "Get an API key" below: the key is saved here, the devices appear in Discovery. |
| API key | secret | Nein | Filled by the "Get an API key" button. A key created elsewhere can be pasted too. |
So installierst du deCONZ / Phoscon in Gladys
- Öffne in Gladys Integrationen: deCONZ / Phoscon erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-deconz:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-deconz.
deCONZ / Phoscon benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
deCONZ / Phoscon ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation