Aller au contenu principal

Intégration domotique Panasonic Aquarea, gratuite et open source

Intégration Panasonic Aquarea pour Gladys Assistant

PAC Panasonic Aquarea via Aquarea Smart Cloud ou HeishaMon : températures, modes, énergie.

Voir sur GitHubToutes les intégrations

Cette intégration amène votre pompe à chaleur air-eau Panasonic Aquarea dans Gladys, de l'une de ces deux façons :

  • Aquarea Smart Cloud, le cloud Panasonic, pour une pompe à chaleur reliée par un adaptateur CZ-TAW1 ou CZ-TAW1B et visible dans l'application Panasonic Comfort Cloud ;
  • HeishaMon, une petite carte libre branchée sur le port CN-CNT de la pompe à chaleur, lue en local : par votre broker MQTT, ou directement par sa page web.

Vous obtenez les températures et consignes des zones de chauffage, le ballon d'eau chaude, la température extérieure, le mode, les modes silencieux et puissance, le dégivrage, le code erreur (aussi déclencheur de scène) et l'énergie pour les tableaux de bord énergie de Gladys. Non officiel, sans lien avec Panasonic.

Version de développement (0.1). Développée et testée sans pompe à chaleur : le cloud Panasonic et HeishaMon ont été simulés d'après la documentation des projets qui les utilisent (intégrations Home Assistant, HeishaMon). Vos retours sont les bienvenus sur le dépôt GitHub.

Ce que vous obtenez​

Un appareil Gladys par pompe à chaleur, avec les fonctionnalités qu'elle remonte :

FonctionnalitéCloudHeishaMonDans Gladys
Marche/arrêt de la pompe à chaleur✓✓un interrupteur
Mode de chauffage : arrêt, chauffage, froid, auto✓✓un mode de thermostat
Activité : au repos, chauffe, refroidit✓✓l'état de fonctionnement du thermostat
Température des zones 1 et 2✓✓des températures
Consignes des zones, chauffage et refroidissement✓✓des consignes de thermostat (un décalage sur une courbe)
Température et consigne du ballon d'eau chaude✓✓une température et une consigne de chauffe-eau
Chauffe de l'eau chaude✓✓l'état « en chauffe » du chauffe-eau
Température extérieure✓✓une température (hors moyenne de la pièce)
Températures de départ et de retour d'eau✓des températures (hors moyenne de la pièce)
Fréquence du compresseur (Hz)✓une valeur
Puissance consommée (W) et énergie consommée (kWh)✓puissance et index d'énergie (tableaux de bord énergie)
Chaleur produite (W)✓une valeur en W
Consommation par jour (kWh)✓une consommation journalière (tableaux de bord énergie)
Mode silencieux (arrêt, niveaux 1 à 3)✓✓une liste modifiable
Mode puissance (arrêt, 30, 60, 90 min)✓✓une liste (en lecture seule pour l'instant)
Dégivrage✓✓marche/arrêt (lecture seule)
Code erreur (H62, F12…)✓✓un texte, et le déclencheur de scène « Erreur de la PAC »

Prérequis​

  • Gladys Assistant 5.2.0 ou plus récent.
  • Cloud : votre Panasonic ID (adresse e-mail et mot de passe), avec la pompe à chaleur visible dans l'application Panasonic Comfort Cloud ; Gladys doit accéder à Internet.
  • HeishaMon : une carte HeishaMon sur la pompe à chaleur, connectée à votre Wi-Fi. Idéalement avec un broker MQTT (Mosquitto…) sur lequel la carte publie ; sans broker, Gladys lit la page web de la carte.

Installation​

Avec Aquarea Smart Cloud​

  1. Vérifiez que la pompe à chaleur apparaît dans l'application Panasonic Comfort Cloud avec votre Panasonic ID.
  2. Dans Gladys, ouvrez l'intégration, Configuration, section Aquarea Smart Cloud : saisissez votre Panasonic ID et son mot de passe, enregistrez.
  3. Si votre Panasonic ID utilise la double authentification, le statut demande un code : cliquez sur Envoyer un code de double authentification, saisissez le code actuel de votre application d'authentification.
  4. Ouvrez l'onglet Découverte : votre pompe à chaleur y est, ajoutez-la.

Avec HeishaMon et un broker MQTT​

  1. Dans la page web de HeishaMon (Settings), vérifiez le serveur MQTT (votre broker) et le topic de base MQTT (panasonic_heat_pump par défaut).
  2. Dans Gladys, section HeishaMon : saisissez l'adresse du broker vue depuis la machine Gladys (mqtt://192.168.1.10:1883, pas localhost), le topic de base, et l'utilisateur et le mot de passe du broker s'il en a. Plusieurs pompes à chaleur : séparez leurs topics de base par des virgules.
  3. Onglet Découverte : la pompe à chaleur apparaît aussitôt (HeishaMon garde ses dernières valeurs sur le broker), ajoutez-la.

Avec HeishaMon, sans broker​

Saisissez l'adresse de la carte elle-même dans Adresse du broker MQTT ou de HeishaMon : http://192.168.1.30. Gladys lit sa page toutes les 30 secondes par défaut (option ci-dessous) et lui envoie les commandes.

Le bouton Tester la connexion lit la pompe à chaleur avec la configuration enregistrée et résume ce qu'il a trouvé.

Options​

  • Intervalle entre deux lectures du cloud : 2 minutes par défaut (de 1 minute à 1 heure). Panasonic limite les appels d'un compte : n'allez pas plus vite que nécessaire. La consommation par jour est lue une fois par heure.
  • Version de l'application (avancé) : laissez vide. Seulement si Panasonic refuse la version annoncée par l'intégration, saisissez la version de l'application Comfort Cloud (par exemple 4.3.0).
  • Vérifier le certificat TLS : à désactiver pour un broker mqtts:// au certificat auto-signé.
  • Intervalle entre deux lectures de la page HeishaMon : sans broker seulement.
  • Intervalle minimum entre deux mesures d'une grandeur : 30 secondes par défaut. Températures et puissances changent toutes les quelques secondes sur une pompe à chaleur en marche : Gladys garde la dernière à ce rythme. Modes, consignes et marche/arrêt ne sont jamais retardés.
  • Langue des noms des fonctionnalités : français ou anglais.
  • Préférer la connexion locale (interrupteur de Gladys) : quand le cloud et HeishaMon sont tous deux renseignés, activé = HeishaMon, désactivé = le cloud. Une pompe à chaleur lue par le cloud et par HeishaMon fait deux appareils différents dans Gladys.

Bon à savoir​

  • Le mode est celui des pièces : Arrêt coupe le chauffage des pièces mais garde l'eau chaude si la pompe à chaleur en produit (HeishaMon : « ECS seule » ; cloud : zones arrêtées, ballon conservé). Pour tout arrêter, utilisez Marche/arrêt de la pompe à chaleur. Choisir chauffage, froid ou auto garde l'eau chaude comme elle était et met la pompe à chaleur en marche si besoin.
  • Consignes sur une loi d'eau : quand une zone suit une courbe de chauffe, sa consigne est un décalage de la courbe, de −5 à +5 °C (nommée « Décalage (courbe) ») ; en mode direct c'est la température de l'eau. Sur HeishaMon, une zone régulée par un thermostat d'ambiance en mode direct garde sa consigne dans les réglages de la courbe : pas encore géré.
  • Le froid est proposé sur toute pompe à chaleur HeishaMon (HeishaMon ne dit pas si l'installateur l'a activé) ; sur le cloud, seulement si la pompe à chaleur le gère. Une pompe à chaleur sans froid ignore les commandes de froid.
  • Énergie : par HeishaMon, la puissance consommée (chauffage, froid et eau chaude, ou les valeurs plus précises des pompes à chaleur récentes) est cumulée en un index d'énergie en kWh, conservé aux redémarrages : ajoutez-le à vos tableaux de bord énergie. Par le cloud, Panasonic donne la consommation par jour : chaque journée terminée est envoyée l'heure suivante (la journée en cours n'est pas complète).
  • Le déclencheur d'erreur se déclenche quand la pompe à chaleur signale un nouveau code erreur, pas pour celui déjà présent au démarrage de l'intégration. Filtrez sur la pompe à chaleur et sur un code (H62…) dans la scène.
  • Badges : un point orange quand l'adaptateur cloud ne répond pas en direct (les valeurs sont alors la copie gardée par le cloud), quand HeishaMon est hors ligne, ou quand il n'a rien envoyé depuis 15 minutes.

Dépannage​

  • « Panasonic a refusé le Panasonic ID ou le mot de passe » : vérifiez-les dans l'application Comfort Cloud, puis enregistrez à nouveau la configuration. L'intégration ne réessaie pas seule, pour ne pas bloquer votre compte.
  • « nouvelles conditions d'utilisation » : ouvrez l'application Panasonic Comfort Cloud et acceptez-les.
  • La pompe à chaleur manque côté cloud : l'intégration se connecte comme l'application Panasonic Comfort Cloud : la pompe à chaleur doit y apparaître avec le même Panasonic ID.
  • HeishaMon : « aucune valeur sur panasonic_heat_pump/main/… » : le broker répond, mais HeishaMon n'y publie pas : vérifiez son serveur MQTT et son topic de base.
  • HeishaMon est hors ligne : la carte a envoyé son dernier message (alimentation, Wi-Fi).

Vie privée​

  • Cloud : l'intégration ne parle qu'à Panasonic (authglb.digital.panasonic.com, accsmart.panasonic.com) et lit la version de l'application Comfort Cloud sur Google Play. Votre mot de passe n'est envoyé à Panasonic qu'à une connexion ; la session (jetons) est gardée dans le volume de l'intégration, jamais le mot de passe.
  • HeishaMon : tout reste sur votre réseau local.

Paramètres de configuration​

Voici les paramètres demandés par Panasonic Aquarea dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Votre pompe à chaleur Aquarea dans GladyssectionNonDeux façons de joindre la pompe à chaleur : le cloud Panasonic (Aquarea Smart Cloud, avec un adaptateur CZ-TAW1 ou CZ-TAW1B), ou une carte HeishaMon sur son port CN-CNT, lue en local par votre broker MQTT ou par sa propre page web. Remplissez l'une des deux sections ci-dessous. Avec les deux, l'interrupteur « Préférer la connexion locale » de Gladys choisit HeishaMon s'il est activé, le cloud sinon. Vous obtenez les températures et consignes des zones, le ballon d'eau chaude, la température extérieure, le mode, les modes silencieux et puissance, le dégivrage, le code erreur (aussi déclencheur de scène) et l'énergie. Non officiel, sans lien avec Panasonic.
Aquarea Smart Cloud (cloud Panasonic)sectionNonLe Panasonic ID que vous utilisez dans l'application Panasonic Comfort Cloud, où apparaît votre pompe à chaleur. L'intégration se connecte comme l'application et lit chaque pompe à chaleur toutes les quelques minutes : Panasonic limite les appels d'un compte. Si votre Panasonic ID demande un code de double authentification, enregistrez la configuration, puis saisissez le code du moment avec le bouton « Envoyer un code de double authentification » ci-dessous.
Panasonic ID (adresse e-mail)stringNon
Mot de passe du Panasonic IDsecretNon
Intervalle entre deux lectures du cloud (s)numberNonChaque pompe à chaleur est lue à ce rythme (2 minutes, comme l'intégration Home Assistant). La consommation par jour est lue une fois par heure.
Version de l'application (avancé)stringNonLaissez vide : l'intégration annonce la version actuelle de l'application Comfort Cloud, lue dans les magasins d'applications. Saisissez-en une (ex. 4.3.0) seulement si Panasonic refuse la version.
HeishaMon (local)sectionNonHeishaMon est une petite carte libre branchée sur le port CN-CNT de la pompe à chaleur. En général elle publie sur votre broker MQTT : saisissez l'adresse du broker (mqtt://192.168.1.10:1883) et le topic de base réglé dans HeishaMon (panasonic_heat_pump par défaut ; plusieurs pompes à chaleur : séparez leurs topics de base par des virgules). Sans broker, saisissez l'adresse de la carte elle-même (http://192.168.1.30) : Gladys lit alors sa page à l'intervalle ci-dessous.
Adresse du broker MQTT ou de HeishaMonstringNon
Topic de base de HeishaMonstringNon
Utilisateur du brokerstringNon
Mot de passe du brokersecretNon
Vérifier le certificat TLS (mqtts)booleanNonÀ désactiver seulement pour un broker au certificat auto-signé sur votre réseau local.
Intervalle entre deux lectures de la page HeishaMon (s)numberNonSeulement sans broker (adresse http://). Par MQTT, HeishaMon envoie chaque changement aussitôt.
Dans GladyssectionNonComment les valeurs arrivent dans Gladys.
Intervalle minimum entre deux mesures d'une grandeur (s)numberNonTempératures, puissances et fréquence du compresseur changent toutes les quelques secondes sur une pompe à chaleur en marche : Gladys garde la dernière mesure à ce rythme. Modes, consignes et marche/arrêt ne sont jamais retardés.
Langue des noms des fonctionnalitésselectNonNoms donnés aux fonctionnalités de la pompe à chaleur dans Découverte (Température extérieure, Consigne eau chaude…).

Comment installer Panasonic Aquarea dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Panasonic Aquarea apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-aquarea: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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-aquarea.

Panasonic Aquarea 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​

Panasonic Aquarea 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.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le