Aller au contenu principal

Intégration domotique Homematic CCU, gratuite et open source

Intégration Homematic CCU pour Gladys Assistant

Appareils Homematic et Homematic IP de votre CCU3, RaspberryMatic ou piVCCU, en local.

Voir sur GitHubToutes les intégrations

Fait entrer dans Gladys les appareils Homematic et Homematic IP de votre CCU3, RaspberryMatic ou piVCCU, en local : thermostats et têtes de radiateur, contacts de fenêtre, détecteurs de mouvement, de fumée et d'eau, interrupteurs et prises avec mesure, volets, variateurs, capteurs météo, les boutons de vos télécommandes, les variables système et les programmes de la CCU.

Développée sans le matériel : vos retours sont bienvenus. L'intégration a été écrite d'après la documentation de la CCU, le code de son interface web et des enregistrements réels de CCU publiés par le projet aiohomematic, mais n'a jamais tourné face à une vraie CCU. Dites-nous ce qui marche et ce qui ne marche pas : github.com/guim31/gladys-homematic-ccu/issues.

Sans lien avec eQ-3. Homematic et Homematic IP sont des marques d'eQ-3 AG.

Prérequis​

  • Une CCU3, une RaspberryMatic ou une piVCCU, joignable depuis Gladys sur son port web (80, ou 443 en HTTPS). Les appareils sont appairés à la CCU, comme d'habitude : Gladys ne la remplace pas.
  • Un utilisateur de la CCU avec les droits administrateur : l'intégration lit les valeurs par un court script HomeMatic, que la CCU n'exécute que pour un administrateur. Si l'authentification est désactivée sur votre CCU (le réglage par défaut), gardez l'utilisateur Admin et laissez le mot de passe vide.
  • Gladys 5.1 ou plus récent.

Configuration​

Dans Gladys, Intégrations → Homematic CCU → Configuration :

  • Adresse de la CCU : son adresse IP ou son nom, ex. 192.168.1.50. Écrivez https://192.168.1.50 si la CCU redirige son interface web vers le HTTPS.
  • Utilisateur et Mot de passe : un administrateur de la CCU (Admin et un mot de passe vide quand l'authentification est désactivée).
  • Accepter un certificat auto-signé : activé par défaut, la CCU signe elle-même son certificat HTTPS.
  • Interfaces lues : Homematic IP (radio), Homematic (radio), Homematic filaire, Groupes de chauffage (Homematic IP). Décochez une famille pour la tenir hors de Gladys.
  • Variables système : les visibles s'affichent sur l'appareil Homematic CCU, ou aucune.
  • Intervalle de lecture : 30 s par défaut, de 10 s à 5 min.
  • Langue des noms : la langue des noms de fonctionnalités donnés à l'ajout d'un appareil.

Ouvrez ensuite l'onglet Découverte et ajoutez les appareils voulus. Tester la connexion lit la CCU et dit ce qu'elle a trouvé : son firmware, le nombre d'appareils pour Gladys, de programmes et de variables système.

Comment la CCU est lue. La CCU annonce ses changements en rappelant un serveur que l'intégration ouvrirait ; le bac à sable de Gladys ne donne aux intégrations aucun port entrant, l'intégration lit donc la CCU : à chaque intervalle, un court script demande à la CCU les valeurs qu'elle connaît déjà, celles des appareils ajoutés à Gladys. Rien ne passe par la radio, le duty cycle n'est pas consommé, et la charge de la CCU reste la même quel que soit le nombre d'appareils. Une commande est relue trois secondes après son envoi.

Appareils​

Un appareil Gladys par appareil Homematic, avec le nom qu'il a dans la CCU. Un appareil à plusieurs sorties a des fonctionnalités numérotées (Interrupteur 1, Interrupteur 2…). Tout appareil à piles a Batterie faible. Un appareil que la CCU signale injoignable affiche le badge « injoignable ».

Thermostats et têtes de radiateur​

Têtes de radiateur et thermostats muraux Homematic IP (HmIP-eTRV, HmIP-WTH, HmIP-BWTH, HmIP-STH…), groupes de chauffage, Homematic HM-CC-RT-DN et HM-TC-IT-WM-W-EU :

  • Température, Humidité (si le thermostat la mesure) ;
  • Consigne, de 4,5 °C (arrêt) à 30,5 °C, par demi-degré ;
  • Mode de chauffage : automatique (le programme hebdomadaire de la CCU), chauffage (consigne manuelle) ou arrêt (4,5 °C). Passer d'« arrêt » à « chauffage » règle 20 °C ;
  • Chauffe : la vanne est-elle ouverte (Gladys n'a pas de type de fonctionnalité pour un pourcentage d'ouverture de vanne) ;
  • Fenêtre (thermostat) : la fenêtre ouverte détectée par le thermostat.

Le relais d'un thermostat mural qui commande un plancher chauffant n'est pas un interrupteur dans Gladys : il suit la régulation de la CCU.

Contacts de fenêtre et de porte​

Ouverture pour les contacts (HmIP-SWDO, HmIP-SCI, HM-Sec-SC…), Poignée de fenêtre pour les poignées (HmIP-SRH, HM-Sec-RHS) : une poignée en position oscillo-battante compte comme ouverte.

Détecteurs de mouvement, de présence, de fumée et d'eau​

Mouvement et Éclairement (HmIP-SMI, HM-Sec-MDIR…), Présence (HmIP-SPI), Fumée (seulement le détecteur qui voit la fumée : les autres du groupe, qui ne font que sonner, restent à 0), Fuite d'eau (HmIP-SWD, HM-Sec-WDS).

Interrupteurs, prises et compteurs d'énergie​

Interrupteur pour chaque sortie (HmIP-PS, HmIP-PSM, HmIP-BSM, HmIP-FSM, HmIP-DRSI4, HM-LC-Sw…), avec Puissance, Énergie (kWh), Tension et Courant quand l'appareil les mesure. Une interface de compteur (HmIP-ESI) donne sa puissance (négative quand vous injectez) et ses index.

Volets, stores et variateurs​

Position (0 % fermé, 100 % ouvert) et Volet (ouvrir, fermer, arrêter) pour les actionneurs de volets et de stores (HmIP-BROLL, HmIP-FBL, HM-LC-Bl1…). Lumière et Intensité lumineuse pour les variateurs (HmIP-BDT, HM-LC-Dim…).

Capteurs météo et climat​

Température, Humidité, Éclairement, Vitesse du vent, Pression atmosphérique et Pluie, selon ce que le capteur mesure (HmIP-SWO, HmIP-STHO, HmIP-SRD, HM-WDS…).

L'appareil Homematic CCU​

Messages de service et Messages d'alarme : les compteurs de la CCU. Puis une fonctionnalité par variable système visible, en lecture seule : variables logiques et alarmes en marche/arrêt, les autres en texte (une liste affiche le nom de sa valeur, un nombre son unité).

Serrures, gâches, portes de garage, motorisations de fenêtre et sirènes ne sont jamais pilotables depuis Gladys : une erreur ouvrirait la maison ou ferait taire une alarme. Leurs piles et leurs boutons restent lisibles.

Déclencheur de scène : Bouton Homematic appuyé​

Bouton Homematic appuyé lance une scène quand une touche de télécommande, d'interrupteur mural ou une entrée est actionnée (HmIP-WRC2/6, HmIP-BRC2, HmIP-KRCA, HmIP-DSD-PCB, HM-PB-2-WM55…). Filtres : l'appareil, le numéro de la touche (le canal de la touche dans la CCU, 1 pour la première), appui court ou long. La scène peut utiliser le nom de l'appareil, le numéro de la touche et l'appui.

Ajoutez d'abord la télécommande dans Gladys (son appareil affiche sa pile). L'appui est vu à la lecture suivante de la CCU : avec un intervalle de 10 s, en moins de 10 s. Deux appuis sur la même touche entre deux lectures comptent pour un.

Action de scène : Lancer un programme de la CCU​

Lancer un programme de la CCU démarre un programme de la CCU par son nom, tel qu'écrit dans la CCU (Programmes et connexions), sans tenir compte des majuscules. Le nom accepte les variables de scène. Un programme désactivé n'est pas lancé.

Widget : Homematic CCU​

Le widget Homematic CCU affiche les messages de service et d'alarme de la CCU, les appareils injoignables et les piles faibles parmi les appareils ajoutés à Gladys, et jusqu'à quatre boutons qui lancent des programmes de la CCU : saisissez leurs noms, séparés par des virgules, dans les réglages du widget. Chaque bouton demande une confirmation.

Exemples de scènes​

  • Sonnette : déclencheur Bouton Homematic appuyé sur la HmIP-DSD-PCB, touche 1 → envoyer un message avec une image de caméra.
  • Départ de la maison : appui long sur la touche 4 du porte-clés → éteindre les lumières, puis Lancer un programme de la CCU « Départ » pour baisser le chauffage.
  • Fenêtre ouverte : une Ouverture de fenêtre à 0 (ouverte) pendant 5 minutes → envoyer un message « fermez la fenêtre, le chauffage tourne ».

Dépannage​

  • La CCU ne répond pas : vérifiez l'adresse, que Gladys joint la CCU (même réseau, pas de pare-feu entre les deux) et que l'interface web s'ouvre dans un navigateur.
  • La CCU redirige vers le HTTPS : l'option « redirection automatique vers HTTPS » de la CCU est active : écrivez l'adresse avec https://.
  • Utilisateur ou mot de passe refusé : vérifiez-les dans la CCU (Réglages → Gestion des utilisateurs). La CCU refuse aussi une connexion quand trop de sessions sont ouvertes : elles expirent au bout de 30 minutes.
  • L'utilisateur de la CCU doit être administrateur : donnez-lui le rôle administrateur, ou utilisez Admin.
  • Un appareil manque : il doit être terminé dans la boîte de réception de la CCU, et son interface cochée. Relancez la recherche dans l'onglet Découverte après l'ajout d'un appareil à la CCU.
  • Une fonctionnalité de capteur manque : elle apparaît dès que la CCU a reçu une valeur pour elle ; relancez la recherche plus tard.
  • Journaux : dans Gladys, Paramètres → Système → Intégrations. Mettez LOG_LEVEL=debug pour voir chaque lecture.

Limites​

  • Développée sans le matériel : vos retours sont bienvenus.
  • Pas de temps réel : les valeurs suivent l'intervalle de lecture (10 s au mieux), un appui de bouton aussi.
  • Pas de configuration des appareils (programmes hebdomadaires, paramètres), pas d'appairage : utilisez la CCU.
  • Les variables système sont en lecture seule ; les programmes se lancent mais ne se modifient pas.
  • CUxD, CCU-Jack et les autres interfaces d'extensions ne sont pas lues.
  • Une seule CCU par installation de l'intégration.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre CCUsectionNonCCU3, RaspberryMatic ou piVCCU. L'intégration lit la CCU par son interface web, avec un utilisateur administrateur : si l'authentification est désactivée sur la CCU, gardez Admin et laissez le mot de passe vide.
Adresse de la CCUstringOuiAdresse IP ou nom de la CCU, avec https:// si son interface web redirige vers le HTTPS.
UtilisateurstringNonUn utilisateur de la CCU avec les droits d'administrateur (la lecture des appareils les exige).
Mot de passesecretNonVide si l'utilisateur n'en a pas.
Accepter un certificat auto-signébooleanNonEn HTTPS, la CCU utilise son propre certificat, qu'aucune autorité n'a signé.
Interfaces luesmulti_selectNonLes familles d'appareils de la CCU à faire entrer dans Gladys.
Variables systèmeselectNonAffichées, en lecture seule, sur l'appareil Homematic CCU.
Intervalle de lectureselectNonFréquence de lecture de la CCU : un court script par lecture, sans trafic radio.
Langue des nomsselectNonLangue des noms de fonctionnalités donnés à l'ajout d'un appareil dans Gladys.

Comment installer Homematic CCU dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Homematic CCU 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/guim31/gladys-homematic-ccu: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).
  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/guim31/gladys-homematic-ccu.

Homematic CCU 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​

Homematic CCU 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.

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