Captures d’écran Extraites du README de Ediminator/homematicip-hcu.
À propos
Homematic IP Local (HCU) connecte Home Assistant à une Homematic IP Home Control Unit via le réseau local. Elle reçoit les changements d’état et les événements par une connexion WebSocket persistante, donc elle n’interroge pas le réseau de façon cyclique. Les entités couvrent la climatisation, les volets, les lumières, les interrupteurs, les serrures, les vannes, les capteurs, les alarmes, les sirènes, les mises à jour et plus encore, et les groupes de chauffage de pièce, de volets, de commutation et de lumière sont synchronisés. Les actions comprennent le mode fête, le mode vacances, le mode éco, le mode refroidissement, la lecture d’un son, l’activation d’un interrupteur pour une durée définie, et la création ou la suppression de messages utilisateur affichés dans l’app Homematic IP. Un HA Entity Bridge, marqué alpha, expose les lumières, les interrupteurs et les capteurs de Home Assistant à la HCU sous forme d’appareils virtuels. La configuration se fait dans l’interface avec une connexion en tant qu’utilisateur d’app ou qu’utilisateur de plugin, et plusieurs unités HCU peuvent être ajoutées.
Résumé automatique du README et du code de Ediminator/homematicip-hcu, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Déclencheurs d’appareil Ses appareils peuvent lancer des automatisations directement.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Lumières
- Climatisation
- Volets
- Vannes
- Serrures
- Alarmes
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Connexion à Homematic IP HCU
- Nom d’hôte ou adresse IP
- Port de l’API d’authentification (par défaut : 6969)
- Port de l’API WebSocket (par défaut : 9001)
S’authentifier auprès de la HCU
- Clé d’activation
Également demandé lors d’une modification de la connexion.
Choisir le mode de connexion
- Utilisateur d’app : prise en charge complète des fonctions (mode développeur inutile). Nécessite d’appuyer sur le bouton système de la HCU.
- Utilisateur de plugin : active les fonctions de plugin (messages utilisateur, réponses de découverte et de contrôle). Nécessite la clé d’activation de la WebUI de la HCU → Mode développeur.
Utilisateur d’app : demander la connexion
- SGTIN de la HCU (détecté automatiquement)Le SGTIN de 24 caractères de ta HCU, par exemple 3014F711A0001234567890. Normalement détecté automatiquement : ne le saisis à la main que si le champ est vide.
Sélectionner les fabricants
- Fabricants à masquer
Reconfigurer Homematic IP HCU
- Nom d’hôte ou adresse IP
- Port de l’API d’authentification
- Port de l’API WebSocket
Choisir le mode de connexion
- Mode de connexion
- Conserver les jetons d’authentification existants
- ✓ Connecté
- ✗ Non connecté
- Non configuré
Après la mise en place
- ✓ Connecté
- ✗ Non connecté
- non configuré
- Utilisateur d’app
- Utilisateur de plugin
- DualBridge (app + plugin)
- Désactiver les canaux non configurésDésactive les canaux qui ne sont pas configurés dans l’app Homematic IP ou qui ne sont pas attribués à une pièce. Ces canaux ne seront pas créés dans Home Assistant.
- Rechargement automatique lors des changements d’appareilsLorsque cette option est activée, l’intégration se recharge automatiquement quand un appareil est retiré de la HCU, ou quand le nom d’un appareil, le rôle d’un canal ou la visualisation d’un interrupteur change. Le rechargement prend environ 1 à 2 secondes, pendant lesquelles toutes les entités apparaissent brièvement comme indisponibles. Désactive cette option si tu veux empêcher les rechargements automatiques et gérer les changements d’appareils manuellement (par exemple en redémarrant Home Assistant).
- Température de confort par défautDéfinis ici la température de confort utilisée pour le mode fête.
- Masquer les groupesChoisis les groupes à masquer. Tu trouveras les noms des groupes dans les attributs supplémentaires de chaque entité.
- Masquer les fabricantsChoisis les fabricants à masquer dans Home Assistant.
- Débogage avancéActive cette option pour journaliser les données brutes complètes des événements HMIP_SYSTEM_EVENT. Désactive-la de nouveau quand tu n’en as plus besoin.
- Attributs avancésActive pour afficher des attributs développeur supplémentaires par entité.
- Température cible
- Date et heure de fin
- Type d’appareilLe type d’appareil détermine quels champs d’entité s’affichent ensuite.
- Lumière
- Interrupteur
- Compteur d’énergie
- Capteur de particules fines
- Capteur de climat / météo
- Capteur de mouvement / de présence
- Capteur de porte / de fenêtre
- Alarme incendie
- Capteur d’humidité / d’eau
- Batterie
- Borne de recharge de véhicule électrique
- Point de raccordement au réseau
- Pompe à chaleur
- CVC
- Appareil à modifier
- Nom de l’appareil
- Marche/Arrêt
- Luminosité
- Température de couleur
- Couleur RVB
- Durée d’allumage (arrêt automatique)
- Température
- Humidité
- Éclairement
- CO₂
- Vitesse du vent
- Précipitations
- Tempête
- Ensoleillement
- Appareils à supprimer
Textes issus du code de Ediminator/homematicip-hcu. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- AlarmesAlarme
- Capteurs binairesAlarme d’intrusion, Alarme de sécurité, Mode vacances
- BoutonsIdentifier, Acquitter l’alarme de sécurité
- ÉvénementsSonnette
- SélecteursÉtat de l’interrupteur au démarrage, Test du signal acoustique, Test du signal optique
- CapteursDurée d’activation interne, Durée d’activation
- InterrupteursUtiliser la durée d’activation interne
- TextesCode PIN d’autorisation d’accès
- Mises à jourMicrologiciel
Actions
- Lire un sonLit un fichier son sur un appareil compatible (par exemple la sonnette HmIP-MP3P, les sirènes d’alarme).Champs : Fichier son, Volume, Durée
- Définir l’état d’une règleActive ou désactive une règle d’automatisation simple dans la HCU.Champs : ID de la règle, Activée
- Activer le mode vacancesActive le mode vacances pour tout le système et tous les groupes de chauffage jusqu’à une heure donnée.Champs : Température, Heure de fin
- Activer le mode éco (absence permanente)Active le mode d’absence permanente (éco) pour tout le système et tous les groupes de chauffage.
- Désactiver le mode absenceDésactive tout mode absence actif (vacances ou éco) et rétablit le programme de chauffage précédent.
- Activer le mode fêteActive le mode fête pour un groupe de chauffage donné avec une température précise.Champs : Température, Heure de fin, Durée
- Allumer avec une duréeAllume un interrupteur pendant une durée donnéeChamps : Durée d’activation
- Définir le mode refroidissementActive ou désactive le mode refroidissement pour tout le système et tous les groupes de chauffage.Champs : Refroidissement
- Envoyer une commande APIEnvoie une commande API brute à la HCU. À utiliser avec prudence, car cela donne un accès direct à l’API et peut causer des effets secondaires imprévus en cas de mauvaise utilisation. Consulte la documentation de l’API d’EQ3 pour plus de détails.Champs : Chemin de la requête, Corps de la requête
- Créer un message utilisateurCrée un message utilisateur affiché dans l’app Homematic IP. Consulte la documentation de l’API d’eQ-3 pour plus de détails.Champs : Catégorie du message, ID du message utilisateur, Titre, Message, Type de comportement
- Supprimer un message utilisateurSupprime un message utilisateur créé précédemment dans l’app Homematic IP. Consulte la documentation de l’API d’EQ3 pour plus de détails.Champs : ID du message utilisateur
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du README
Custom integration for Home Assistant to control Homematic IP devices locally through the Homematic IP Home Control Unit (HCU).
Community Project: This is a passion project built in personal spare time. Continued development depends on the community. Every bug report, diagnostics file, and piece of user feedback directly shapes what gets improved next.
- Local Push Updates: Persistent WebSocket connections push state changes and events instantly without polling your network.
- Complete Platform Coverage: Integrates climate, covers, lights, switches, locks, valves, sensors, binary sensors, events, update notifications, selects, numbers, texts, and buttons.
- Homematic IP Group Synchronization: Discovers and syncs room heating groups, shutter groups, switching groups, and light groups.
- Direct Device Triggers: Native Home Assistant device triggers let you build button automations directly in the visual editor.
- Hardware Timing Companions:
- Internal On Time: Automatically passes hardware on-time values configured in the Homematic IP app with every turn_on command.
- Ramp Time: Configures hardware fade durations for dimmers without requiring a transition parameter on every action.
- HA Entity Bridge (Alpha): Exposes Home Assistant entities back into the HCU as virtual devices.
- Energy and Metering Support: Integrates power draw and accumulated energy counters directly into the Home Assistant Energy Dashboard.
- Multiple Gateways: Add multiple HCU units within a single Home Assistant installation.
S’affiche dans Vulpo :
carte Lumière, carte Bascule rapide, carte Volet, carte Climat, Apple Watch, centre de contrôle, Activité en direct de climatisation.Informations
- Installations
- 357 partagent leurs statistiques
- Étoiles GitHub
- 74
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- 2.6.1,
- Catégorie
- Hubs et protocoles, Hubs domotiques
- Type
- Intégration de la Marketplace
- Marque
- Homematic
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
hcu_integration- Problèmes
- Signaler un problème
