Intégration domotique Faikout, gratuite et open source
Pilotez vos climatisations Daikin en local grâce à leur module Faikout.
Publiée par prohand
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à vos climatisations Daikin équipées d'un module Faikout (anciennement Faikin). Le module Faikout remplace le module Wi-Fi d'origine et se pilote en local, sur votre réseau : pas de cloud, pas de compte, pas d'Internet nécessaire.
Dans Gladys, chaque climatisation devient un appareil avec :
- marche / arrêt, mode (auto, froid, chauffage, déshumidification, ventilation), consigne et vitesse de ventilation ;
- balayage horizontal et vertical (marche ou arrêt : pas de position fixe), et les modes Econo, Powerful, Comfort, Streamer, unité extérieure silencieuse, quand votre climatisation les a ;
- les mesures : température de la pièce, température extérieure, températures d'entrée d'air et du fluide frigorigène, humidité, puissance consommée et le compteur d'énergie (kWh).
L'intégration ne crée que ce que votre climatisation remonte vraiment : une fonction absente de votre modèle n'apparaît pas.
Avant de commencer
- Installez le module Faikout dans la climatisation (voir le manuel d'installation Faikout).
- Connectez-le à votre Wi-Fi : au premier démarrage il crée son propre point d'accès, avec une page de configuration.
- Vérifiez que vous pouvez ouvrir sa page web (
http://<adresse du module>/) depuis votre réseau et piloter la climatisation depuis cette page. - Donnez-lui une adresse IP fixe (réservation DHCP dans votre box ou votre routeur). C'est cette adresse que Gladys utilisera.
Gladys parle au module comme sa propre page web : il faut garder les
commandes web du Faikout actives (webcontrol, actives par défaut).
Configuration
Dans Intégrations → Faikout → Configuration :
| Champ | Rôle |
|---|---|
| Unités Faikout | L'adresse de chaque module, séparées par des virgules. Un nom suivi de = devant l'adresse donne son nom à l'appareil. |
| Mot de passe web | Seulement si un mot de passe web est défini dans les réglages du Faikout (le même pour toutes les unités). Laissez vide sinon. Le mot de passe des réglages n'est pas utile. |
| Intervalle de rafraîchissement | Toutes les combien de secondes chaque climatisation est lue (30 s par défaut, de 5 à 600). Un réglage fait à la télécommande apparaît dans Gladys au plus tard après ce délai. |
Exemple :
Salon=192.168.1.50, Chambre=192.168.1.51, 192.168.1.52
- Sans nom, l'appareil prend le nom du module (son hostname).
- Un nom en
.local(par exempleguestac.local) n'est souvent pas résolu depuis le conteneur de l'intégration : préférez l'adresse IP. - Un port autre que 80 s'écrit
192.168.1.50:8080. - Avec un mot de passe web, Gladys l'envoie comme la page du Faikout une fois connecté (un cookie, en clair sur votre réseau, comme le signalent les réglages du Faikout). Le mot de passe des réglages reste inconnu de Gladys : il n'en a jamais besoin.
Cliquez ensuite sur Tester la connexion : pour chaque unité, le message dit si elle répond, son modèle, son protocole (S21, X50A…), son mode et la température de la pièce.
Enfin, ouvrez l'onglet Découverte de l'intégration et créez les appareils proposés.
Ce que montre le badge de chaque appareil
| Badge | Signification |
|---|---|
| Local | Le Faikout répond, la climatisation aussi. |
| Local + point orange | Le Faikout répond, mais pas la climatisation : vérifiez le câble S21/X50. |
| Injoignable | Le Faikout ne répond pas : coupé, hors Wi-Fi, ou adresse changée. |
Scènes
Déclencheurs
| Déclencheur | Quand |
|---|---|
| Une climatisation se déconnecte ou revient | Le Faikout ne répond plus (raison unreachable), la climatisation ne répond plus au Faikout (raison aircon), puis quand tout répond de nouveau. |
| Une climatisation est modifiée hors de Gladys | Marche, mode, consigne ou ventilation changés à la télécommande infrarouge, sur la page web du Faikout, ou par un minuteur du Faikout. Jamais par Gladys elle-même. |
| Une climatisation commence ou finit un dégivrage | En chauffage par temps froid, l'unité extérieure s'arrête quelques minutes pour fondre son givre. |
Chaque déclencheur se filtre par climatisation, et par état (ou par ce qui a
changé). Les valeurs sont disponibles dans la scène, par exemple
{{triggerEvent.data.mode}} ou {{triggerEvent.data.temperature}}.
Les changements faits par le Faikout auto (qui déplace la consigne et le mode tout seul) ne déclenchent pas « modifiée hors de Gladys ».
Actions
| Action | Rôle |
|---|---|
| Régler une climatisation | Marche, mode, consigne et ventilation en une seule fois. Un champ laissé vide garde sa valeur. |
| Régler le Faikout auto | Le Faikout chauffe ou refroidit tout seul pour garder la pièce entre cible − marge et cible + marge. Une marge de 0 l'arrête. |
| Lire une climatisation | Une lecture fraîche : en ligne, marche, mode, consigne, température de la pièce et extérieure, humidité. Ne tombe jamais en erreur : testez la sortie En ligne. |
Les sorties de ces actions sont utilisables par les actions suivantes de la scène (conditions, messages…).
Pour une simple commande (allumer, changer la consigne), l'action standard Contrôler un appareil de Gladys marche aussi.
Suivi de l'énergie
Quand la climatisation remonte son compteur d'énergie (champ Whoutside du
Faikout, souvent avec le protocole S21), l'appareil a une fonction Compteur
d'énergie, en kWh. C'est un index : Gladys en déduit tout seul la
consommation par demi-heure et son coût, et la montre dans l'intégration
Suivi de l'énergie.
- Après la création de l'appareil, ouvrez Intégrations → Suivi de l'énergie dans Gladys : la climatisation y apparaît, rattachée à votre compteur principal si vous en avez un.
- Le compteur avance par pas de 100 Wh : sur une courte période, la consommation se voit par paliers.
- La puissance consommée (en W) reste disponible pour le direct.
- Une climatisation qui ne remonte pas ce compteur n'a pas cette fonction.
- Multi-split (plusieurs unités intérieures sur une seule unité extérieure) : le compteur est celui de l'unité extérieure, chaque Faikout peut donc remonter le même : vérifiez dans Suivi de l'énergie qu'il n'est pas compté deux fois.
Widgets du tableau de bord
- Climatisation Faikout : une climatisation. Tuiles en direct (pièce, consigne, extérieur, puissance), une courbe des températures pièce, consigne et extérieur sur 24 h, puis état, mode, ventilation, volets, modes confort, et Faikout auto ou dégivrage quand ils tournent. Un bouton Allumer ou Éteindre (l'inverse de l'état actuel) et Actualiser. Choisissez la climatisation dans les réglages du widget.
- Vue d'ensemble Faikout : toutes vos climatisations sur une carte, avec leur mode et la température de la pièce.
Dépannage
- « pas de réponse » au test de connexion : ouvrez
http://<adresse>/depuis un ordinateur du même réseau que Gladys. Si la page ne s'ouvre pas, le souci est le réseau (adresse, Wi-Fi, VLAN), pas Gladys. - « mot de passe web absent ou faux » : un mot de passe web est défini sur le Faikout. Tapez le même dans Mot de passe web (copiez-le depuis les réglages du Faikout).
- Une commande échoue avec « did not apply » : la climatisation n'a pas cette fonction, ou le Faikout ne peut pas la piloter.
- Le Faikout auto ne s'applique pas : le Faikout est piloté par un
contrôleur externe (EnvMon, commande MQTT
control), qui a la priorité. - Un appareil reste injoignable après un changement d'adresse : mettez la nouvelle adresse dans Unités Faikout. L'appareil Gladys est lié à l'adresse MAC du module : il garde son historique et ses scènes.
Confidentialité
Tout reste sur votre réseau : l'intégration ne parle qu'aux adresses que vous
lui donnez, en HTTP et WebSocket locaux. Le mot de passe web, s'il y en a un, est gardé
par Gladys avec la configuration et envoyé seulement aux unités. Elle garde seulement, dans son volume
/data, l'adresse MAC, le nom, le modèle et la liste des fonctions de chaque
unité, pour retrouver ses appareils même si une climatisation est éteinte au
démarrage.
Paramètres de configuration
Voici les paramètres demandés par Faikout dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Faikout remplace le module Wi-Fi d'une climatisation Daikin et se pilote sur votre réseau, sans cloud. Connectez d'abord chaque unité à votre Wi-Fi (voir le manuel d'installation Faikout), laissez ses commandes web actives (elles le sont par défaut), puis listez les unités ci-dessous. Gladys trouve seul leurs fonctions. |
| Unités Faikout | string | Non | L'adresse de chaque unité, séparées par des virgules. Préférez une adresse IP fixe : les noms en .local ne sont souvent pas résolus dans l'intégration. Mettez un nom et = devant pour nommer l'appareil, par exemple Salon=192.168.1.50. |
| Mot de passe web | secret | Non | Seulement si un mot de passe web est défini dans les réglages du Faikout : le même pour toutes les unités. Laissez vide sinon. Le mot de passe des réglages n'est pas utile. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture de chaque unité, en secondes. Un changement fait à la télécommande apparaît dans Gladys au plus tard après ce délai. |
Comment installer Faikout dans Gladys
- Dans Gladys, ouvrez Intégrations : Faikout 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/prohand/gladys-faikout:1.1.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/prohand/gladys-faikout.
Faikout 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
Faikout 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 prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation