Intégration domotique Fujitsu Airstage & FGLair, gratuite et open source
Climatiseurs Fujitsu des applications Airstage et FGLair : mode, consigne, ventilation, éco…
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Les climatiseurs et pompes à chaleur air-air Fujitsu avec Wi-Fi se pilotent avec l'une de deux applications Fujitsu : Airstage (l'actuelle, avec les appareils et adaptateurs Wi-Fi récents) ou FGLair (les anciens modules Wi-Fi, encore très répandus en Europe). Cette intégration amène dans Gladys les appareils de l'une ou l'autre : marche/arrêt, mode, consigne, ventilation, balayage, modes économie, puissance et unité extérieure silencieuse, températures intérieure et extérieure. Les appareils Airstage peuvent aussi être pilotés en local, par leur adaptateur Wi-Fi, sans le cloud.
Non officiel : sans lien avec Fujitsu General.
Version de développement (0.1). Écrite à partir des projets que les utilisateurs de Homebridge et de Home Assistant utilisent avec ces appareils (voir Remerciements), et vérifiée sur leurs données ; pas encore testée avec un vrai appareil ou un vrai compte Fujitsu. Vos retours sont les bienvenus sur le dépôt GitHub.
Quels appareils
| Votre application | À renseigner | Comment Gladys joint l'appareil |
|---|---|---|
| FUJITSU AIRSTAGE (Airstage Mobile) | le compte Airstage, et/ou l'adresse de l'adaptateur Wi-Fi de l'appareil | l'adaptateur sur votre réseau, ou le cloud Airstage (Europe ou États-Unis) |
| FGLair | le compte FGLair | le cloud FGLair (Europe, ou les autres régions) |
- Les deux applications peuvent servir en même temps : renseignez les deux comptes.
- Non couverts : les appareils Atlantic de l'application Cozytouch (utilisez l'intégration Overkiz du store), et les appareils Fujitsu sans Wi-Fi ou sur un autre contrôleur (KNX, Modbus, Intesis…).
Ce que vous obtenez
Un climatiseur Gladys par unité intérieure, avec les fonctionnalités que l'appareil possède (Fujitsu les indique : un réglage absent ne crée pas de fonctionnalité) :
| Fonctionnalité | Dans Gladys |
|---|---|
| Marche/arrêt | marche/arrêt du climatiseur |
| Mode | auto, froid, chaud, déshumidification, ventilation |
| Consigne | 16 à 30 °C en chaud, 18 à 30 °C sinon, au demi-degré |
| Ventilation | auto, silencieux, faible, moyenne, forte |
| Balayage vertical | arrêt, balayage, et les positions fixes (jusqu'à 4) |
| Position verticale | position 1 (haut) à 6 ou 8 (bas), sur les appareils à 6 ou 8 positions |
| Balayage horizontal | arrêt, balayage |
| Économie, Puissance (Powerful) | interrupteurs |
| Unité extérieure silencieuse | interrupteur |
| Ventilation économique | interrupteur (Airstage) |
| Hors-gel (10 °C) | interrupteur (Airstage) : chauffage à 10 °C pour que la pièce ne gèle pas |
| Températures intérieure, extérieure | capteurs de température (°C) |
| Code d'erreur | texte, en lecture seule (Airstage) |
Comme dans les applications : la déshumidification met la ventilation en auto, une position verticale fixe arrête le balayage vertical, le hors-gel allume l'appareil en chaud à 10 °C (et l'éteint quand il s'arrête). Avec FGLair, choisir un mode allume aussi l'appareil, et l'allumer reprend son dernier mode.
Installation
- Vérifiez que vos appareils fonctionnent dans l'application Airstage ou FGLair.
- Dans la configuration de l'intégration, renseignez ce que vous utilisez :
- Application Airstage : l'e-mail et le mot de passe de
l'application, la région (Europe pour un compte créé en Europe) et le
pays du compte, en anglais comme choisi dans l'application (
France,Belgium,Switzerland…). - Adaptateurs Wi-Fi Airstage (facultatif) : une entrée par appareil,
séparées par des virgules : son adresse IP, son adresse MAC, et un nom si
vous voulez, par exemple
192.168.1.20 E8:FB:1C:12:34:56 Salon, 192.168.1.21 E8:FB:1C:65:43:21. Donnez à chaque adaptateur une adresse IP fixe dans votre box. L'adresse MAC est sur l'étiquette de l'adaptateur et dans votre box ; pour un appareil déjà trouvé par le cloud Airstage, elle figure aussi dans la page de l'appareil dans Gladys. Les adaptateurs qui répondent en HTTPS sont détectés tout seuls ; écrivezhttps://192.168.1.20pour l'imposer. - Application FGLair : l'e-mail et le mot de passe de l'application, et la région (Europe, ou les autres régions).
- Application Airstage : l'e-mail et le mot de passe de
l'application, la région (Europe pour un compte créé en Europe) et le
pays du compte, en anglais comme choisi dans l'application (
- Enregistrez, puis cliquez sur Tester la connexion : chaque compte liste ses appareils, chaque adaptateur répond avec son modèle.
- Ouvrez l'onglet Découverte et ajoutez vos appareils.
Options
| Option | Par défaut | Rôle |
|---|---|---|
| Région Airstage | Europe | le cloud Airstage du compte (Europe, États-Unis) |
| Pays du compte Airstage | France | envoyé à la connexion, comme le fait l'application |
| Région FGLair | Europe | le cloud FGLair du compte (Europe, autres régions) |
| Langue des noms de fonctionnalités | Français | noms des fonctionnalités et de leurs options |
| Privilégier la connexion locale | activé | réglage de Gladys : un appareil Airstage dont l'adaptateur est dans la liste passe par lui, le cloud en secours ; désactivé : le cloud d'abord |
Fonctionnement
- Adaptateurs Airstage : Gladys lit chaque adaptateur sur votre réseau toutes les 30 secondes et lui envoie les commandes. Le conteneur de l'intégration est sur un réseau bridge : les adaptateurs sont joints par leur adresse IP (pas de découverte automatique).
- Cloud Airstage : les appareils et tous leurs réglages sont lus toutes les 2 minutes ; une commande part en requête que le cloud transmet à l'appareil, et Gladys la suit jusqu'à ce que l'appareil l'ait prise.
- Cloud FGLair : les réglages de chaque appareil sont lus toutes les 5 minutes, et quelques secondes après une commande. FGLair a aussi un mode local, mais il faut que l'appareil rappelle Gladys, ce que le conteneur de l'intégration ne peut pas recevoir.
- Les connexions sont conservées dans le dossier
/datade l'intégration : un redémarrage de Gladys ne se reconnecte pas. Les mots de passe n'y sont jamais écrits. Un mot de passe refusé n'est jamais réessayé tout seul : corrigez-le et enregistrez. - Le badge de transport de chaque appareil indique local (par son adaptateur), cloud, ou injoignable. Un point orange signale que l'appareil passe par l'autre voie parce que la voie habituelle a échoué (adaptateur injoignable, cloud en panne).
Dépannage
- « l'e-mail ou le mot de passe a été refusé » : vérifiez-les dans l'application, ainsi que la région (un compte créé en Europe est sur le cloud Europe), puis enregistrez.
- Un adaptateur est injoignable : vérifiez son adresse IP (fixe dans votre box), que Gladys et l'appareil sont sur le même réseau, et l'adresse MAC : une MAC fausse fait répondre « NG 0002 » à l'adaptateur.
- Entrées d'adaptateurs non comprises : chaque entrée doit avoir une adresse IP (ou un nom d'hôte avec un point) et une adresse MAC.
- La consigne est refusée : 16 à 30 °C en chaud, 18 à 30 °C dans les autres modes ; elle ne se règle pas en mode ventilation.
- « trop de requêtes » : le cloud ralentit Gladys ; elle réessaie après le délai demandé par le cloud, jusqu'à une heure.
Remerciements
Le protocole du cloud et des adaptateurs Airstage vient de
homebridge-fujitsu-airstage
de Patrick Stankard (MIT) et de pyairstage
de Daniel Rufus Kaldheim (MIT), la bibliothèque de l'intégration Home Assistant
ha_airstage. Le protocole
FGLair vient de ayla-iot-unofficial
(MIT), la bibliothèque de l'intégration Home Assistant fujitsu_fglair, et de
pyfujitseu (MIT), recoupés avec
homebridge-fujitsu-hvac
(MIT). Voir le fichier NOTICE du dépôt.
Paramètres de configuration
Voici les paramètres demandés par Fujitsu Airstage & FGLair dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos climatiseurs Fujitsu dans Gladys | section | Non | Les climatiseurs et pompes à chaleur air-air Fujitsu de votre application Airstage (appareils récents et adaptateurs Wi-Fi) ou FGLair (appareils plus anciens) sont proposés dans l'onglet Découverte : marche/arrêt, mode, consigne, ventilation, balayage vertical et horizontal, modes économie, puissance et unité extérieure silencieuse, hors-gel, températures intérieure et extérieure, code d'erreur, selon l'appareil. Renseignez le compte de votre application, et pour les appareils Airstage aussi l'adresse de leur adaptateur Wi-Fi pour les piloter en local, sans le cloud. Les appareils Atlantic de l'application Cozytouch relèvent de l'intégration Overkiz. Non officiel, sans lien avec Fujitsu General. |
| Application Airstage | section | Non | L'e-mail et le mot de passe de l'application Fujitsu Airstage. Laissez vide si vous n'utilisez que FGLair ou les adaptateurs en local. |
| E-mail Airstage | string | Non | |
| Mot de passe Airstage | secret | Non | |
| Région Airstage | select | Non | |
| Pays du compte Airstage | string | Non | En anglais, comme choisi dans l'application (France, Belgium, Switzerland…). |
| Adaptateurs Wi-Fi Airstage sur le réseau | section | Non | Facultatif : Gladys parle alors directement à l'adaptateur sur votre réseau, plus vite et sans le cloud. Une entrée par appareil, séparées par des virgules : son adresse IP, son adresse MAC, et un nom si vous voulez, par exemple « 192.168.1.20 E8:FB:1C:12:34:56 Salon ». Donnez à l'adaptateur une adresse IP fixe dans votre box. L'adresse MAC est sur l'étiquette de l'adaptateur, dans votre box, ou dans la page de l'appareil dans Gladys pour un appareil trouvé par le cloud Airstage. |
| Adaptateurs (IP MAC nom, …) | string | Non | |
| Application FGLair | section | Non | L'e-mail et le mot de passe de l'application Fujitsu FGLair (anciens modules Wi-Fi). Laissez vide si vous n'utilisez qu'Airstage. |
| E-mail FGLair | string | Non | |
| Mot de passe FGLair | secret | Non | |
| Région FGLair | select | Non | |
| Langue des noms de fonctionnalités | select | Non | Les noms des fonctionnalités et des options (modes, vitesses, positions) des appareils découverts. |
Comment installer Fujitsu Airstage & FGLair dans Gladys
- Dans Gladys, ouvrez Intégrations : Fujitsu Airstage & FGLair 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-fujitsu:0.1.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/LM1LC3N7/gladys-fujitsu.
Fujitsu Airstage & FGLair 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
Fujitsu Airstage & FGLair 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