Integración domótica deCONZ / Phoscon, gratuita y de código abierto
The Zigbee devices of a deCONZ gateway (ConBee, RaspBee): lights, plugs, covers, sensors, remotes.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
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.
Parámetros de configuración
Estos son los parámetros que deCONZ / Phoscon te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Your deCONZ gateway, as it is | section | No | 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 | No | 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 | No | 80 by default; the port in the Phoscon address otherwise (e.g. 8080 for deCONZ in Docker). |
| API key | section | No | 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 | No | Filled by the "Get an API key" button. A key created elsewhere can be pasted too. |
Cómo instalar deCONZ / Phoscon en Gladys
- En Gladys, abre Integraciones: deCONZ / Phoscon aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/lm1lc3n7/gladys-deconz:0.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-deconz.
deCONZ / Phoscon requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
deCONZ / Phoscon es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación