Intégration domotique IKEA DIRIGERA & TRÅDFRI, gratuite et open source
Les appareils connectés IKEA via le hub DIRIGERA ou la passerelle TRÅDFRI, en local.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.2
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez vos appareils connectés IKEA depuis Gladys, via votre hub DIRIGERA ou votre passerelle TRÅDFRI, sur votre réseau local : sans cloud, sans compte IKEA. Les lampes, prises, stores, purificateurs d'air et capteurs appairés à la passerelle apparaissent dans l'onglet Découverte de Gladys, prêts à être ajoutés. Intégration non officielle, sans lien avec IKEA.
Version de développement (0.1). Construite à partir des API locales documentées des deux passerelles et testée contre des passerelles simulées, pas encore avec du vrai matériel. Vos retours sont les bienvenus sur le dépôt GitHub.
Ce que vous obtenez
| Appareil IKEA | Dans Gladys |
|---|---|
| Ampoules, lampes, rubans LED | lampe : marche/arrêt, luminosité, température de couleur (white spectrum), couleur (CWS) |
| Prises TRETAKT, INSPELNING, TRÅDFRI | interrupteur ; puissance, tension, courant et énergie pour l'INSPELNING |
| Stores FYRTUR, KADRILJ, PRAKTLYSING, TREDANSEN | volet : ouvrir, fermer, stop, position ; la batterie |
| Purificateur d'air STARKVIND | mode (arrêt, bas, moyen, haut, auto), vitesse, PM2.5, durée de vie du filtre, sécurité enfant |
| VINDSTYRKA, ALPSTUGA, TIMMERFLOTTE | température, humidité, PM2.5, indice COV, CO₂ (selon le modèle) |
| PARASOLL, BADRING, VALLHORN, détecteur de mouvement | ouverture, fuite d'eau, mouvement, luminosité ; la batterie |
| SOMRIG, bouton raccourci TRÅDFRI, BILRESA (DIRIGERA) | un bouton par touche et le déclencheur de scène Bouton d'une télécommande IKEA |
| Autres télécommandes | la batterie |
Les appareils sont mis à jour en temps réel : le hub DIRIGERA envoie ses événements sur un websocket, la passerelle TRÅDFRI notifie chaque changement (observation CoAP).
Installation
Hub DIRIGERA
- Installez l'intégration, puis ouvrez son onglet Configuration.
- Cliquez sur Appairer le hub DIRIGERA, puis appuyez sur le bouton d'action sous le hub (le petit bouton sur sa face inférieure) dans les 90 secondes.
- Une fois appairé, ouvrez l'onglet Découverte et ajoutez les appareils voulus.
Passerelle TRÅDFRI
- Repérez le code de sécurité imprimé sous la passerelle (16 caractères, à côté du QR code).
- Cliquez sur Appairer la passerelle TRÅDFRI, saisissez le code, validez.
- Ouvrez l'onglet Découverte et ajoutez les appareils.
Le code ne sert qu'une fois, à créer un accès propre à Gladys : il n'est pas conservé. Les deux passerelles peuvent être appairées en même temps.
Adresse de la passerelle
Les passerelles sont trouvées seules sur le réseau (mDNS, via Gladys). Si
la recherche échoue (autre réseau, routeur qui filtre le multicast), saisissez
l'adresse IP de la passerelle dans la configuration (par exemple
192.168.1.20 ; un nom en .local ne fonctionne pas depuis le conteneur de
l'intégration). Donnez si possible une adresse fixe à la passerelle dans votre
box. Sans adresse saisie, une passerelle qui a changé d'adresse est retrouvée
toute seule.
Le bouton Chercher les passerelles IKEA sur le réseau liste ce qui répond.
Scènes
- Les boutons raccourcis et télécommandes appairés à un hub DIRIGERA deviennent des fonctionnalités « bouton » (appui simple, double appui, appui long), utilisables dans le déclencheur « Changement d'état d'un appareil ».
- Le déclencheur de scène Bouton d'une télécommande IKEA reçoit chaque appui, filtré par télécommande, numéro de bouton et type d'appui.
- La passerelle TRÅDFRI ne transmet pas les appuis de ses télécommandes ni les détections de ses détecteurs de mouvement : seul leur niveau de batterie est disponible. Passez-les sur un hub DIRIGERA pour les utiliser dans les scènes Gladys.
Dépannage
- « introuvable sur le réseau » : saisissez l'adresse IP de la passerelle.
- « le hub a refusé l'accès » : l'accès a été supprimé dans l'application IKEA, ou le hub a été réinitialisé : appairez-le à nouveau.
- « n'a pas été émis par IKEA » : l'adresse ne désigne pas un hub DIRIGERA, ou son certificat a changé. Si c'est bien votre hub, désactivez Vérifier que le certificat du hub a été émis par IKEA.
- « la passerelle a refusé la clé » (TRÅDFRI) : la passerelle a été réinitialisée : appairez-la à nouveau avec son code de sécurité.
- Les appuis d'une télécommande n'apparaissent pas : seules les télécommandes que le hub DIRIGERA présente comme boutons raccourcis envoient leurs appuis ; une télécommande liée directement à des lampes les pilote sans prévenir le hub.
Confidentialité
Tout reste sur votre réseau : l'intégration ne parle qu'à votre passerelle, directement. L'accès donné par le hub (DIRIGERA) ou la clé donnée par la passerelle (TRÅDFRI) sont conservés par Gladys, jamais affichés dans l'interface ni écrits dans les journaux.
Paramètres de configuration
Voici les paramètres demandés par IKEA DIRIGERA & TRÅDFRI dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos appareils IKEA, sur votre réseau local | section | Non | Lampes, prises, stores, purificateurs STARKVIND, capteurs et télécommandes appairés à un hub DIRIGERA ou à une passerelle TRÅDFRI, sans le cloud. DIRIGERA : utilisez « Appairer le hub DIRIGERA » ci-dessous, puis appuyez sur le bouton d'action sous le hub dans les 90 secondes. TRÅDFRI : saisissez le code de sécurité imprimé sous la passerelle dans « Appairer la passerelle TRÅDFRI ». Les passerelles sont trouvées seules sur le réseau ; ne saisissez une adresse que si la recherche échoue (son adresse IP, un nom en .local ne fonctionne pas depuis le conteneur de l'intégration). Intégration non officielle, sans lien avec IKEA. |
| Adresse du hub DIRIGERA | string | Non | Laissez vide : le hub est trouvé sur le réseau. Sinon son adresse IP, par exemple 192.168.1.20. |
| Vérifier que le certificat du hub a été émis par IKEA | boolean | Non | À désactiver seulement si la connexion échoue sur une erreur de certificat et que l'adresse est bien celle de votre hub. |
| Passerelle TRÅDFRI | section | Non | La passerelle TRÅDFRI (le boîtier carré blanc vendu jusqu'en 2022). Ses télécommandes et détecteurs de mouvement ne remontent que leur batterie : la passerelle ne transmet jamais leurs appuis. Un hub DIRIGERA le fait, pour les boutons raccourcis. |
| Adresse de la passerelle TRÅDFRI | string | Non | Laissez vide : la passerelle est trouvée sur le réseau. Sinon son adresse IP, par exemple 192.168.1.21. |
Comment installer IKEA DIRIGERA & TRÅDFRI dans Gladys
- Dans Gladys, ouvrez Intégrations : IKEA DIRIGERA & TRÅDFRI apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-ikea:0.1.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-ikea.
IKEA DIRIGERA & TRÅDFRI nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
IKEA DIRIGERA & TRÅDFRI est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation