Intégration domotique FRITZ!SmartHome, gratuite et open source
Prises, têtes thermostatiques, volets, lampes et boutons de votre FRITZ!Box (DECT).
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Reliez à Gladys les appareils domotiques AVM de votre FRITZ!Box : prises FRITZ!DECT 200 et 210 (marche/arrêt, puissance, énergie), têtes thermostatiques FRITZ!DECT 301 et 302 et Comet DECT (consigne, chauffage marche/arrêt, température mesurée, batterie, fenêtre ouverte, boost), volets en DECT ULE (Rollotron), lampes FRITZ!DECT 500, détecteurs HAN-FUN, et les boutons FRITZ!DECT 400 et 440 comme déclencheurs de scène. Tout reste sur votre réseau local : l'intégration parle à la box par son interface AHA-HTTP, documentée par AVM. Pas de cloud, pas de compte MyFRITZ!.
Cette intégration ne remplace pas l'intégration FRITZ!Box (internet, Wi-Fi invités, présence, appels) : les deux se complètent et peuvent fonctionner ensemble.
Développée sans le matériel : vos retours sont les bienvenus. L'intégration est couverte par des tests automatiques construits sur de vraies réponses de FRITZ!Box (recueillies par la bibliothèque pyfritzhome), et les méthodes de connexion sont vérifiées sur les exemples d'AVM, mais elle n'a pas encore tourné contre une vraie box. Dites-nous sur le forum Gladys comment elle se comporte avec vos appareils.
Ce que vous obtenez
- Un appareil Gladys par appareil Smart Home de la box, avec les fonctionnalités qu'il possède (voir Appareils) : commutateur et compteur d'une prise, consigne et mode de chauffage d'une tête thermostatique, position d'un volet, allumage, luminosité et couleur d'une lampe, état d'un détecteur, température, humidité et batterie.
- Un widget de tableau de bord : puissance des prises, têtes qui chauffent, fenêtres ouvertes, et une ligne par appareil.
- Trois déclencheurs de scène : un bouton FRITZ!DECT appuyé (quelle touche, appui court ou long), une tête thermostatique qui détecte une fenêtre ouverte, une pile qui faiblit.
- Une action de scène : mettre une tête thermostatique sur sa température confort ou éco, lancer un boost ou le mode « fenêtre ouverte » pour un temps, ou y mettre fin.
Prérequis
- Une FRITZ!Box sous FRITZ!OS 7 ou plus récent (FRITZ!OS 7.24 ou plus récent conseillé : connexion sécurisée PBKDF2) et des appareils Smart Home appairés (Smart Home > Appareils).
- Un utilisateur de la FRITZ!Box avec le droit Smart Home.
- Gladys Assistant 5.1.0 ou plus récent.
- Gladys sur le même réseau local que la box.
Configuration
Préparer la FRITZ!Box
- Ouvrez l'interface de la box (http://fritz.box).
- Dans Système > Utilisateurs FRITZ!Box, créez un utilisateur pour Gladys (ex.
gladys) avec un mot de passe solide, et cochez le droit Smart Home. Les autres droits sont inutiles. - Vérifiez que vos appareils apparaissent dans Smart Home > Appareils.
Réglages
| Réglage | Description |
|---|---|
| Adresse | adresse IP ou nom de la box. Vide : elle est cherchée sur le réseau (SSDP), puis fritz.box. |
| Nom d'utilisateur | l'utilisateur créé ci-dessus. |
| Mot de passe | son mot de passe, gardé par Gladys, jamais écrit dans les logs. |
| Connexion chiffrée | port 443 au lieu de 80. Le certificat de la box n'est pas vérifié. |
| Intervalle | fréquence de lecture : 10 s, 30 s (par défaut), 1 min ou 2 min. Les appuis sur les boutons la suivent. |
| Langue des noms | langue des noms de fonctionnalités des appareils ajoutés, et des messages (français par défaut). |
Lancez Tester la connexion : elle se connecte, compte les appareils et les liste dans l'onglet Découverte.
Ajouter vos appareils
Ouvrez l'onglet Découverte de l'intégration et ajoutez les appareils voulus. Un appareil hors de portée de la box est proposé aussi (il affiche ses valeurs dès son retour). Un appareil appairé plus tard apparaît à la lecture suivante.
Appareils
L'intégration lit elle-même les appareils, à l'intervalle choisi : une seule requête à la box pour tous les appareils. Seules les valeurs qui changent sont envoyées à Gladys.
Prises
FRITZ!DECT 200, 210 et prises HAN-FUN d'autres marques :
| Fonctionnalité | Type dans Gladys | Remarques |
|---|---|---|
| Alimentation | commutateur | marche/arrêt, pilotable |
| Puissance consommée | puissance, en W | |
| Énergie | énergie, en kWh | total mesuré par la prise |
| Tension | tension, en V | quand la box la fournit |
| Température | température, en °C | mesurée par la prise, décalage de la box |
Une prise verrouillée dans la box (« verrouillage de commutation ») refuse les commandes, avec un message.
Têtes thermostatiques
FRITZ!DECT 301, 302 et Comet DECT :
| Fonctionnalité | Type dans Gladys | Remarques |
|---|---|---|
| Consigne | consigne de thermostat, en °C | pilotable, de 8 à 28 °C par demi-degré |
| Chauffage | mode du thermostat (arrêt/chauffe) | arrêt ferme la vanne ; chauffe revient au programme de la semaine |
| Fenêtre (mode fenêtre ouverte) | détecteur d'ouverture | « ouvert » tant que la tête garde sa vanne fermée |
| Boost | entrée (oui/non) | oui pendant un boost |
| Température | température, en °C | mesurée |
| Batterie | batterie, en % |
Les commandes sont bornées exprès : une consigne sous 8 °C ou au-dessus de 28 °C est ramenée dans cette plage, et « chauffe » revient à la température confort ou éco du programme de la box, jamais au « marche » permanent (vanne ouverte quelle que soit la température). Une tête verrouillée dans la box, en mode été ou qui suit le programme vacances refuse les commandes, avec un message. Les fonctionnalités fenêtre et boost n'existent que sur les têtes récentes (pas sur les premières Comet DECT).
Volets
Rollotron et autres volets en DECT ULE / HAN-FUN :
| Fonctionnalité | Type dans Gladys | Remarques |
|---|---|---|
| Position | position du volet, % | 100 = ouvert, 0 = fermé ; pilotable |
| Volet | état du volet | ouvrir, arrêter, fermer |
Lampes
FRITZ!DECT 500 et autres lampes HAN-FUN :
| Fonctionnalité | Type dans Gladys | Remarques |
|---|---|---|
| Lumière | éclairage on/off | pilotable |
| Luminosité | luminosité, en % | pilotable |
| Couleur | couleur | pilotable (FRITZ!OS 7.39 ou plus récent) ; vide en blanc |
Détecteurs
Détecteurs HAN-FUN appairés à la box : un contact de porte ou de fenêtre devient un détecteur d'ouverture, un détecteur de fumée un capteur de fumée, un détecteur de mouvement un détecteur de mouvement, un détecteur d'eau un détecteur de fuite ; les autres une entrée (oui = alarme).
Boutons et capteurs
Les boutons FRITZ!DECT 400 et 440 affichent leur batterie (et la température et l'humidité mesurées par le 440). Leurs appuis sont le déclencheur Bouton appuyé. Un répéteur FRITZ!DECT affiche sa température.
Widget de tableau de bord
FRITZ!SmartHome : trois tuiles (puissance tirée par les prises, têtes qui chauffent sur le total, fenêtres ouvertes), puis jusqu'à dix lignes : têtes thermostatiques (température mesurée → consigne, ou arrêt, boost, fenêtre ouverte, été, vacances), prises (allumée et puissance), lampes, volets, détecteurs, pile faible, appareil hors de portée. Réglage : les appareils à afficher ; vide, les appareils ajoutés (ou tous ceux de la box si aucun n'est encore ajouté). Le widget se contente d'afficher : pilotez les appareils depuis leurs propres boîtes du tableau de bord ou par des scènes.
Déclencheurs de scène
| Déclencheur | Filtres (facultatifs) | Variables |
|---|---|---|
| Bouton FRITZ!DECT appuyé | bouton, quelle touche (400, ou l'une des quatre du 440), appui court ou long (400) | nom de l'appareil, touche, appui |
| Fenêtre ouverte détectée | tête thermostatique | nom de l'appareil, minutes avant de rechauffer |
| Pile faible | appareil | nom de l'appareil, niveau de pile (%) |
La box donne l'heure du dernier appui de chaque touche : l'intégration voit un appui à sa lecture suivante (10 s à 2 min plus tard, selon l'intervalle), et deux appuis sur la même touche entre deux lectures comptent pour un. Les événements antérieurs à un démarrage de l'intégration ne sont pas rejoués.
Actions de scène
Régler une tête thermostatique : tête, mode, durée.
- Température confort / Température éco : les températures réglées dans la box pour cette tête.
- Boost : vanne grande ouverte pendant la durée (30 min par défaut).
- « Fenêtre ouverte » : vanne fermée pendant la durée (15 min par défaut), par exemple le temps d'aérer.
- Fin du boost et de « fenêtre ouverte ».
La durée est de 24 heures au plus, la limite de la box : le boost et le mode « fenêtre ouverte » s'arrêtent toujours d'eux-mêmes.
Exemples de scènes
- Aérer la chambre : quand le contact de la fenêtre de la chambre s'ouvre, « Régler une tête thermostatique » → « Fenêtre ouverte » pour 20 minutes ; quand il se ferme, « Fin du boost et de fenêtre ouverte ».
- Un bouton pour la salle de bain : appui court sur le FRITZ!DECT 400 de la salle de bain, boost de la tête de la salle de bain pendant 30 minutes ; appui long, coupure de la prise du sèche-serviettes.
- Rappel de pile : quand une pile faiblit, envoyer un message « Pile de {{triggerEvent.data.device_name}} : {{triggerEvent.data.battery}} % ».
Dépannage
- « a refusé le nom ou le mot de passe » : vérifiez-les dans Système > Utilisateurs FRITZ!Box. Après un échec, l'intégration attend 15 minutes, puis de plus en plus longtemps jusqu'à 4 heures (ou un changement de configuration), avant de réessayer : la box bloque les connexions de plus en plus longtemps après des échecs.
- « bloque les connexions pendant … s » : la box refuse les connexions après des échecs ; l'intégration attend.
- « n'a pas le droit Smart Home » : cochez-le pour l'utilisateur dans Système > Utilisateurs FRITZ!Box.
- « Aucune FRITZ!Box trouvée » : saisissez l'adresse de la box dans la configuration.
- Un appareil affiche « Hors de portée » : il a perdu la liaison DECT avec la box (pile, distance).
- Commandes refusées : l'appareil est verrouillé dans la box, ou la tête est en mode été ou vacances.
- Plus de détails : réglez
LOG_LEVEL=debugsur le conteneur de l'intégration.
Limites
- Les groupes et les modèles de la box ne sont pas proposés : un groupe ferait doublon avec les appareils qu'il contient. Pilotez les appareils un par un, ou par une scène Gladys.
- Un appui sur un bouton est vu à la lecture suivante de la box, pas instantanément ; deux appuis entre deux lectures comptent pour un.
- La température de blanc des lampes n'est pas proposée, seulement la couleur.
- Les périodes vacances et été, les températures confort et éco et le programme de la semaine se règlent dans la box, pas depuis Gladys.
- Développée sans le matériel : fondée sur la documentation d'AVM et sur de vraies réponses recueillies par pyfritzhome ; le comportement d'appareils absents de ces réponses peut différer.
Paramètres de configuration
Voici les paramètres demandés par FRITZ!SmartHome dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter votre FRITZ!Box | section | Non | Vos appareils domotiques DECT (prises, têtes thermostatiques, volets, lampes, boutons, détecteurs) sont lus dans la FRITZ!Box. Dans la FRITZ!Box (http://fritz.box), créez un utilisateur avec le droit « Smart Home » dans Système > Utilisateurs FRITZ!Box. Puis lancez « Tester la connexion » et ajoutez vos appareils dans l'onglet Découverte. |
| Adresse de la FRITZ!Box | string | Non | Laissez vide pour la trouver automatiquement sur le réseau. |
| Nom d'utilisateur FRITZ!Box | string | Oui | Un utilisateur de Système > Utilisateurs FRITZ!Box, avec le droit « Smart Home ». |
| Mot de passe | secret | Oui | |
| Connexion chiffrée (HTTPS) | boolean | Non | Port 443 au lieu de 80. Le certificat de la box n'est pas vérifié. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture des appareils dans la box. Les appuis sur les boutons sont vus à ce rythme. |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités des nouveaux appareils, et langue des messages. |
Comment installer FRITZ!SmartHome dans Gladys
- Dans Gladys, ouvrez Intégrations : FRITZ!SmartHome 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/guim31/gladys-fritz-smarthome:1.0.0), 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/guim31/gladys-fritz-smarthome.
FRITZ!SmartHome 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
FRITZ!SmartHome 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 guim31, 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