Intégration domotique Frisquet Connect, gratuite et open source
Chaudières Frisquet avec box Connect : zones, consignes, modes, eau chaude, alarmes et gaz consommé.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.2.0
- ★ 0
Présentation
Cette intégration relie Gladys à votre chaudière Frisquet équipée de la box Frisquet Connect, par le même service en ligne que l'appli « Frisquet Connect ». Vous retrouvez dans Gladys :
- chaque zone de chauffage (Zone 1, Zone 2, Zone 3 selon votre installation) avec sa température ambiante, sa consigne, ses consignes confort / réduit / hors-gel et son mode ;
- la chaudière : température extérieure (si une sonde est raccordée), eau chaude sanitaire (marche / arrêt et mode), alarmes, mode vacances, mise en veille et gaz consommé pour le chauffage et l'eau chaude ;
- un widget de tableau de bord pour changer de mode d'un geste, des actions de scène et un déclencheur sur les alarmes.
Intégration communautaire, sans lien avec Frisquet. Le service Frisquet Connect n'a pas d'API publique : l'intégration parle la même langue que l'appli officielle, d'après le travail des projets cités dans le README. Développée sans la chaudière ni le compte : vos retours sont les bienvenus, en particulier si un mode ou une commande ne se comporte pas comme dans l'appli.
Prérequis
- Une chaudière Frisquet avec la box Frisquet Connect installée et appairée.
- Un compte dans l'appli Frisquet Connect (e-mail et mot de passe) qui voit votre chaudière.
- Gladys Assistant 5.2.0 ou plus récent (le mode des zones utilise les préréglages de thermostat apparus en 5.2.0).
- Un accès Internet pour Gladys : tout passe par le service en ligne de Frisquet, rien ne passe par le réseau local.
Configuration
- Dans Gladys, Intégrations → Frisquet Connect → Configuration.
- Renseignez l'e-mail et le mot de passe de l'appli Frisquet Connect.
- Choisissez la langue des noms (français par défaut). Les noms des fonctionnalités sont figés quand vous ajoutez un appareil : changez la langue avant.
- Choisissez l'intervalle de relève : toutes les 5 minutes (par défaut), 10 ou 15 minutes.
- Enregistrez, puis cliquez sur Tester la connexion : le message indique le nombre de chaudières et de zones trouvées.
- Onglet Découverte : ajoutez la chaudière et les zones qui vous intéressent.
Si votre compte contient plusieurs chaudières (une maison et un appartement, par exemple), toutes apparaissent ; le nom de chaque zone est alors précédé du nom de l'installation.
Ce que fait chaque appareil
La chaudière
| Fonctionnalité | Ce qu'elle montre ou fait |
|---|---|
| Température extérieure | La sonde extérieure, si elle est raccordée. |
| Eau chaude | Marche / arrêt de l'eau chaude. « Marche » reprend le dernier mode utilisé. |
| Mode eau chaude | MAX, Éco, Éco programmé, Éco+, Éco+ programmé, Arrêt (selon la chaudière). |
| Alarme / Alarme en cours | Le texte de l'alarme affichée par Frisquet, et un indicateur oui / non. |
| Mode vacances | Actif quand des vacances sont programmées et en cours (lecture seule). |
| Chaudière en veille | La chaudière est en veille. |
| Gaz chauffage / eau chaude | Gaz consommé ce mois-ci et cette année, en kWh, tel que Frisquet le compte. |
Les alarmes « installateur » (par exemple un rappel permanent sur le plancher chauffant) ne sont pas des pannes : elles sont ignorées.
Les zones de chauffage
| Fonctionnalité | Ce qu'elle montre ou fait |
|---|---|
| Température ambiante | La température mesurée par la sonde d'ambiance de la zone. |
| Consigne | La consigne appliquée en ce moment. La changer modifie la consigne du mode en cours (confort ou réduit), durablement, comme dans l'appli. |
| Consigne confort / réduit / hors-gel | Les trois consignes de la zone, réglables de 5 à 30 °C par pas de 0,5 °C. |
| Mode | Programme (suit la programmation hebdomadaire), Confort, Réduit ou Hors-gel en permanence. Dans Gladys, « Réduit » s'affiche « Éco ». |
| Dérogation en cours | Une dérogation est active (mode forcé jusqu'au prochain changement du programme). |
| Boost | Seulement si la zone le propose : chauffe renforcée temporaire. |
| Mode en cours | Une phrase : « Confort (programme) », « Réduit (dérogation) », « Hors-gel (vacances) »… |
Choisir Programme met aussi fin à une dérogation en cours.
Rythme, délais et quotas
- La box Connect transmet l'état de la chaudière au service Frisquet par radio, toutes les quelques minutes. Lire plus souvent ne donnerait rien de plus : l'intégration relève toutes les 5 minutes par défaut (10 ou 15 au choix), et la consommation de gaz (mensuelle) toutes les 6 heures.
- Une commande est acceptée tout de suite par le service, mais la chaudière ne l'applique qu'à son prochain échange avec la box : comptez quelques minutes. Gladys affiche aussitôt la valeur demandée, puis l'intégration relit la chaudière 20 secondes et 3 minutes après.
- Le service limite le nombre de requêtes : l'intégration espace ses appels d'au moins une demi- seconde et ne relit que les chaudières dont un appareil est ajouté dans Gladys. Après un mot de passe refusé, elle attend 30 minutes avant de réessayer seule (pour ne pas bloquer votre compte) ; corriger la configuration relance tout de suite.
- Une valeur qui ne change pas est republiée toutes les 6 heures, pour que Gladys ne l'affiche pas comme ancienne.
Widget
Ajoutez le widget Chauffage Frisquet à un tableau de bord.
- Sans réglage (ou avec une chaudière) : toutes les zones d'un coup d'œil, température et consigne de chacune, et une ligne par zone avec son mode en cours.
- Avec une zone choisie : sa température et sa consigne en direct, le mode en cours, les consignes confort / réduit / hors-gel, la température extérieure, et quatre boutons : Programme, Confort, Réduit et Dérogation (qui inverse la période en cours jusqu'au prochain changement du programme, comme la touche de dérogation de la chaudière) ou Fin dérogation. Le mode actif porte une coche.
Le mode hors-gel n'a pas de bouton dans le widget, pour ne pas couper le confort par un geste malheureux : il se choisit dans l'appareil ou par une scène.
Scènes
Déclencheur
- Alarme chaudière Frisquet — une nouvelle alarme apparaît sur la chaudière (défaut, box Connect déconnectée…). Choisissez la chaudière, ou laissez vide pour toutes. Le texte de l'alarme est disponible dans la variable « Alarme ». Une alarme déjà présente à l'installation ou au redémarrage ne déclenche rien.
Actions
- Mode de chauffage Frisquet — choisissez une zone, ou une chaudière pour toutes ses zones, et le mode : retour au programme, confort / réduit / hors-gel permanent, confort ou réduit jusqu'au prochain changement (dérogation), ou fin de la dérogation.
- Eau chaude Frisquet — choisissez la chaudière et le mode : Marche (dernier mode utilisé), Arrêt, MAX, Éco, Éco programmé, Éco+, Éco+ programmé.
Les consignes se règlent avec l'action standard de Gladys « Contrôler un appareil ».
Exemples de scènes
- Départ en week-end : quand l'alarme de la maison passe en mode absent, action Mode de chauffage Frisquet sur la chaudière avec « Hors-gel permanent », puis Eau chaude Frisquet sur « Arrêt ». Au retour, « Retour au programme » et « Marche ».
- Retour plus tôt que prévu : quand votre téléphone revient dans la zone de la maison en semaine, action « Confort jusqu'au prochain changement » sur la zone du séjour.
- Prévenir d'une panne : déclencheur Alarme chaudière Frisquet, puis un message Telegram « Chaudière : {{triggerEvent.data.alarm}} ».
- Heures creuses : à 22 h, consigne réduit à 17 °C ; à 6 h, consigne confort à 20 °C (action « Contrôler un appareil »).
Dépannage
- « Frisquet Connect a refusé l'e-mail ou le mot de passe » : vérifiez-les en vous connectant à l'appli Frisquet Connect, puis corrigez la configuration.
- « Frisquet Connect ne répond pas » : le service est indisponible ou en maintenance ; l'intégration réessaie seule. L'alarme « Box Frisquet Connect déconnectée » signale, elle, que la box n'atteint plus Internet (box débranchée, Wi-Fi coupé).
- Une commande ne change rien : attendez quelques minutes (voir les délais ci-dessus). Si la valeur revient à l'ancienne après 5 minutes, signalez-le avec les journaux.
- « Pas de valeur récente » sur la consommation de gaz : votre compte ne la fournit peut-être pas ; les autres fonctionnalités marchent sans.
- Journaux : en temps normal l'intégration n'écrit rien. Pour le détail, passez
LOG_LEVELàdebug. Le jeton et le mot de passe n'apparaissent jamais dans les journaux.
Limites
- Développée sans la chaudière ni le compte : les réponses du service viennent d'autres projets communautaires qui les ont relevées sur de vraies chaudières. Retours bienvenus.
- Le mode vacances est en lecture seule : la manière de le programmer par le service n'est pas documentée. Programmez-le dans l'appli ou sur la chaudière, ou utilisez « Hors-gel permanent ».
- La dérogation est une commande sans numéro de zone dans le service Frisquet : sur une installation à plusieurs zones, elle peut s'appliquer à la zone 1 ou à toutes les zones, selon la chaudière. À vérifier chez vous.
- La programmation hebdomadaire n'est pas modifiable depuis Gladys (seulement suivie).
- La consommation de gaz est celle que Frisquet calcule, par mois : ce n'est pas un compteur de gaz, et elle n'est pas envoyée au suivi d'énergie de Gladys, qui la compterait comme de l'électricité.
- Le mode de l'eau chaude des installations solaires n'est pas géré.
- Tout passe par Internet : sans accès au service Frisquet, Gladys ne voit plus la chaudière (la chaudière, elle, continue de chauffer normalement).
Paramètres de configuration
Voici les paramètres demandés par Frisquet Connect dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte Frisquet Connect | section | Non | Utilisez l'e-mail et le mot de passe de l'appli Frisquet Connect. La chaudière doit être équipée de la box Frisquet Connect. Le cloud relaie la chaudière toutes les quelques minutes : un changement met jusqu'à 5 minutes à apparaître. Sans lien avec Frisquet. |
string | Oui | L'e-mail de connexion à l'appli Frisquet Connect. | |
| Mot de passe | secret | Oui | Conservé par Gladys, envoyé seulement à Frisquet Connect. |
| Langue des noms | select | Non | Langue des noms de fonctionnalités (figés à l'ajout d'un appareil) et des textes de l'intégration. |
| Intervalle de relève | select | Non | Fréquence de lecture des chaudières. La box Connect met à jour le cloud toutes les quelques minutes : plus vite ne sert à rien. |
Comment installer Frisquet Connect dans Gladys
- Dans Gladys, ouvrez Intégrations : Frisquet Connect 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-frisquet:1.0.1), 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-frisquet.
Frisquet Connect nécessite Gladys >=5.2.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
Frisquet Connect 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