Intégration domotique Toshiba Home AC Control, gratuite et open source
Vos climatiseurs Toshiba Home AC Control : mode, consigne, ventilation, balayage, ECO…
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Les climatiseurs et pompes à chaleur air-air Toshiba connectés en Wi-Fi (adaptateur RB-N105S-G / RB-N106S-G, ou Wi-Fi intégré) se pilotent avec l'application Toshiba Home AC Control, à travers le cloud Toshiba. Cette intégration se connecte à ce cloud avec le compte de votre application, comme le fait l'application, et amène vos appareils dans Gladys : marche/arrêt, mode, consigne, ventilation, balayage, modes ECO, Hi-POWER, silencieux et hors-gel 8 °C, températures intérieure et extérieure, en temps réel.
Non officiel : sans lien avec Toshiba ni avec Toshiba Carrier.
Version de développement (0.1). Portée de la bibliothèque Python
toshiba-acqu'utilise l'intégration Home Assistant, et vérifiée par rapport à ce que calcule cette bibliothèque ; pas encore testée avec un vrai compte Toshiba. Vos retours sont les bienvenus sur le dépôt GitHub.
Quels appareils
- Oui : les appareils que vous pilotez avec l'application Toshiba Home AC Control (par exemple les Seiya, Shorai, Daiseikai et consoles vendus en Europe).
- Non : les climatiseurs de fenêtre et mobiles nord-américains de l'application Toshiba AC NA. Ils sont fabriqués par Midea et passent par le cloud Midea : utilisez pour eux l'intégration Midea du store Gladys.
Ce que vous obtenez
Un climatiseur Gladys par appareil du compte, avec les fonctionnalités que l'appareil a (Toshiba les indique dans la liste des appareils) :
| Fonctionnalité | Dans Gladys |
|---|---|
| Marche/arrêt | marche/arrêt du climatiseur |
| Mode | auto, froid, chaud, déshumidification, ventilation (ceux de l'appareil) |
| Consigne | 17 à 30 °C, au degré ; 5 à 13 °C en hors-gel 8 °C |
| Ventilation | auto, silencieux, faible, moyenne basse, moyenne, moyenne haute, forte |
| Balayage vertical | arrêt, balayage, et les 5 positions fixes du volet si l'appareil les a |
| Balayage horizontal | arrêt, balayage (appareils avec balayage horizontal) |
| Sélection de puissance | 50 %, 75 %, 100 % |
| Mode spécial | aucun, Hi-POWER, ECO, silencieux 1/2 (unité extérieure), hors-gel 8 °C, sommeil, sol, confort — un seul à la fois, selon l'appareil |
| Mode cheminée | arrêt, cheminée 1, cheminée 2 (appareils qui l'ont, en mode chaud) |
| Purificateur d'air | marche/arrêt (appareils avec Air Pure Ion) |
| Températures intérieure, extérieure | capteurs de température (°C) |
| Énergie de l'année | kWh depuis le 1er janvier (appareils qui la remontent) |
Les modes spéciaux suivent les règles de Toshiba : ECO, Hi-POWER et silencieux en auto, froid et chaud ; hors-gel 8 °C, sol et sommeil en chaud seulement. Passer en déshumidification ou ventilation arrête le mode spécial, comme le fait l'application.
Installation
- Vérifiez que vos appareils fonctionnent dans l'application Toshiba Home AC Control.
- Dans la configuration de l'intégration, saisissez le nom d'utilisateur et le mot de passe de l'application. Le nom d'utilisateur n'est souvent pas votre adresse e-mail : beaucoup de comptes ont un nom d'utilisateur court, affiché dans l'écran du compte de l'application.
- Cliquez sur Tester la connexion : les appareils du compte sont listés.
- Ouvrez l'onglet Découverte et ajoutez vos appareils.
Saisissez bien le mot de passe : après deux connexions refusées de suite, Toshiba bloque le compte quelques heures, et pendant ce temps même le bon mot de passe est refusé. L'intégration ne retente jamais toute seule une connexion refusée : corrigez la configuration et enregistrez-la.
Options
| Option | Défaut | Rôle |
|---|---|---|
| Langue des noms de fonctionnalités | Français | noms des fonctionnalités et de leurs options |
Fonctionnement
- Gladys parle au cloud Toshiba par Internet, jamais directement à l'appareil : l'appareil doit être en ligne dans l'application.
- Liaison temps réel : Gladys s'enregistre comme un téléphone de votre compte et se connecte à l'IoT Hub Toshiba (Microsoft Azure). Les appareils y envoient leurs changements et, régulièrement, leurs températures, et les commandes passent par elle : tant qu'elle est coupée, les appareils sont lus mais pas pilotables.
- Les états sont aussi lus par l'API Toshiba toutes les 30 minutes (toutes les 5 minutes tant que la liaison temps réel est coupée), et dès son retour.
- La connexion est gardée dans le dossier
/datade l'intégration (Toshiba la donne pour environ trois ans) : un redémarrage de Gladys ne se reconnecte pas, car Toshiba limite le nombre de connexions. Le mot de passe n'y est jamais écrit. - Le badge de transport de chaque appareil affiche cloud, avec un point orange tant que la liaison temps réel est coupée, ou injoignable quand le cloud Toshiba ne répond pas.
En cas de problème
- « a refusé le nom d'utilisateur ou le mot de passe » : essayez le nom d'utilisateur de l'écran du compte de l'application plutôt que l'e-mail. Les mots de passe très longs avec beaucoup de symboles posent problème : simplifiez-le dans l'application si besoin.
- « Toshiba ralentit cette connexion » : le pare-feu Toshiba limite le débit ; cela ne dit rien de votre mot de passe. Patientez, l'intégration réessaie toute seule (après le délai demandé par Toshiba, jusqu'à une heure).
- « a refusé la liaison temps réel, même avec un nouveau jeton » : un
autre client utilise peut-être la même identité. L'intégration enregistre
sa propre identité : si vous faites tourner deux Gladys sur le même compte,
ou avez copié le dossier
/datade l'un vers l'autre, donnez à chacun son propre/data. - Une commande échoue avec « liaison temps réel … coupée » : attendez la reconnexion (l'état indique quand) et réessayez.
- La consigne est refusée : 17 à 30 °C, ou 5 à 13 °C en hors-gel 8 °C.
Crédits
Le protocole (états, commandes, fonctionnalités prises en charge) est porté de la bibliothèque Python toshiba-ac de Kamil Sroka (licence Apache 2.0), utilisée par l'intégration Home Assistant home-assistant-toshiba_ac. Le comportement du pare-feu Toshiba vient des notes de cette intégration et du plugin homebridge-toshiba-home-ac d'Onur Yuksel (MIT).
Paramètres de configuration
Voici les paramètres demandés par Toshiba Home AC Control dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos climatiseurs Toshiba dans Gladys | section | Non | Les climatiseurs et pompes à chaleur air-air Toshiba de votre application Toshiba Home AC Control (adaptateur Wi-Fi RB-N105S-G / RB-N106S-G ou Wi-Fi intégré) sont proposés dans l'onglet Découverte : marche/arrêt, mode, consigne, ventilation, balayage et positions du volet, sélection de puissance, modes Hi-POWER, ECO, silencieux et hors-gel 8 °C, températures intérieure et extérieure, et l'énergie quand l'appareil la remonte. Les états arrivent en temps réel du cloud Toshiba, et les commandes passent par lui. Les appareils nord-américains de l'application Toshiba AC NA sont des Midea : utilisez l'intégration Midea pour eux. Non officiel, sans lien avec Toshiba. |
| Nom d'utilisateur Toshiba Home AC Control | string | Oui | Le nom d'utilisateur avec lequel vous vous connectez à l'application. Beaucoup de comptes ont un nom d'utilisateur court en plus de l'adresse e-mail : si l'e-mail est refusé, utilisez le nom affiché dans l'écran du compte de l'application. |
| Mot de passe | secret | Oui | Vérifiez-le bien : après deux connexions refusées de suite, Toshiba bloque le compte quelques heures. Une connexion refusée n'est jamais retentée toute seule. |
| Langue des noms de fonctionnalités | select | Non | Les noms des fonctionnalités et des options (modes, vitesses, modes spéciaux) des appareils découverts. |
Comment installer Toshiba Home AC Control dans Gladys
- Dans Gladys, ouvrez Intégrations : Toshiba Home AC Control 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-toshiba-ac: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-toshiba-ac.
Toshiba Home AC Control 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
Toshiba Home AC Control 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