IKEA DIRIGERA & TRÅDFRI Smart-Home-Integration, kostenlos und Open Source
IKEA smart home devices through the DIRIGERA hub or the TRÅDFRI gateway, locally.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.2
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Control your IKEA smart home devices from Gladys, through your DIRIGERA hub or your TRÅDFRI gateway, on your local network: no cloud, no IKEA account. The lights, plugs, blinds, air purifiers and sensors paired with the gateway appear in the Discovery tab of Gladys, ready to be added. Unofficial integration, not affiliated with IKEA.
Development version (0.1). Built from the documented local APIs of both gateways and tested against simulated gateways, not yet against real hardware. Your feedback is welcome on the GitHub repository.
What you get
| IKEA device | In Gladys |
|---|---|
| Bulbs, lamps, LED strips | a light: on/off, brightness, color temperature (white spectrum), color (CWS) |
| TRETAKT, INSPELNING, TRÅDFRI plugs | a switch; power, voltage, current and energy for the INSPELNING |
| FYRTUR, KADRILJ, PRAKTLYSING, TREDANSEN blinds | a shutter: open, close, stop, position; the battery |
| STARKVIND air purifier | mode (off, low, medium, high, auto), speed, PM2.5, filter life, child lock |
| VINDSTYRKA, ALPSTUGA, TIMMERFLOTTE | temperature, humidity, PM2.5, VOC index, CO₂ (depending on the model) |
| PARASOLL, BADRING, VALLHORN, TRÅDFRI motion sensor | opening, water leak, motion, light level; the battery |
| SOMRIG, TRÅDFRI shortcut button, BILRESA (DIRIGERA) | one button per key and the IKEA remote button scene trigger |
| Other remotes | the battery |
The devices are updated in real time: the DIRIGERA hub pushes its events on a websocket, the TRÅDFRI gateway notifies every change (CoAP observe).
Installation
DIRIGERA hub
- Install the integration, then open its Configuration tab.
- Click Pair the DIRIGERA hub, then press the action button under the hub (the small button on its bottom) within 90 seconds.
- Once paired, open the Discovery tab and add the devices you want.
TRÅDFRI gateway
- Find the security code printed under the gateway (16 characters, next to the QR code).
- Click Pair the TRÅDFRI gateway, type the code, confirm.
- Open the Discovery tab and add the devices.
The code is only used once, to create an access of its own for Gladys: it is not kept. Both gateways can be paired at the same time.
Gateway address
The gateways are found on the network by themselves (mDNS, through Gladys).
If the search fails (another network, a router that filters multicast), type
the IP address of the gateway in the configuration (for example
192.168.1.20; a .local name does not work from the integration container).
Give the gateway a fixed address in your router if you can. Without a typed
address, a gateway whose address changed is found again by itself.
The Find the IKEA gateways on the network button lists what answers.
Scenes
- Shortcut buttons and remotes paired with a DIRIGERA hub become "button" features (single press, double press, long press), usable in the "Device state change" trigger.
- The IKEA remote button scene trigger receives every press, filtered by remote, button number and press type.
- The TRÅDFRI gateway does not forward the presses of its remotes nor the detections of its motion sensors: there, only their battery level is available. Move them to a DIRIGERA hub to use them in Gladys scenes.
Troubleshooting
- "not found on the network": type the IP address of the gateway.
- "the hub refused the access": the access was removed from the IKEA app, or the hub was reset: pair it again.
- "was not issued by IKEA": the address does not point to a DIRIGERA hub, or its certificate changed. If it really is your hub, turn off Check that the hub certificate was issued by IKEA.
- "the gateway refused the key" (TRÅDFRI): the gateway was reset: pair it again with its security code.
- The button presses of a remote do not show: only the remotes that the DIRIGERA hub exposes as shortcut buttons send their presses; a remote linked directly to lights controls them without telling the hub.
Privacy
Everything stays on your network: the integration only talks to your gateway, directly. The access given by the hub (DIRIGERA) or the key given by the gateway (TRÅDFRI) is stored by Gladys, never shown in the interface and never written in the logs.
Konfigurationseinstellungen
Diese Einstellungen fragt IKEA DIRIGERA & TRÅDFRI in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your IKEA devices, on your local network | section | Nein | Lights, plugs, blinds, STARKVIND air purifiers, sensors and remotes paired with a DIRIGERA hub or a TRÅDFRI gateway, without the cloud. DIRIGERA: press "Pair the DIRIGERA hub" below, then the action button under the hub within 90 seconds. TRÅDFRI: type the security code printed under the gateway in "Pair the TRÅDFRI gateway". The gateways are found on the network by themselves; type an address only if the search fails (its IP address, a .local name does not work from the integration container). Unofficial integration, not affiliated with IKEA. |
| DIRIGERA hub address | string | Nein | Leave empty: the hub is found on the network. Otherwise its IP address, for example 192.168.1.20. |
| Check that the hub certificate was issued by IKEA | boolean | Nein | Turn off only if the connection fails with a certificate error and the address is really your hub's. |
| TRÅDFRI gateway | section | Nein | The TRÅDFRI gateway (the white square box sold until 2022). Its remotes and motion sensors only report their battery: the gateway never forwards their presses. A DIRIGERA hub does, for the shortcut buttons. |
| TRÅDFRI gateway address | string | Nein | Leave empty: the gateway is found on the network. Otherwise its IP address, for example 192.168.1.21. |
So installierst du IKEA DIRIGERA & TRÅDFRI in Gladys
- Öffne in Gladys Integrationen: IKEA DIRIGERA & TRÅDFRI erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-ikea:0.1.2) 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-ikea.
IKEA DIRIGERA & TRÅDFRI 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
IKEA DIRIGERA & TRÅDFRI 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