Homematic(IP) Local for OpenCCU pour Home Assistant (intégration de la Marketplace)

Installations: 10,5 k partagent leurs statistiques
Étoiles GitHub: 606
Connexion: Fonctionne en local
Maintenance: Mise à jour au cours des 6 derniers mois
Version: 2.12.1, 26 octobre 2026
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: homematicip_local
Source: github.com/SukramJ/homematicip_local
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

À propos

Homematic(IP) Local for OpenCCU est une intégration personnalisée qui connecte Home Assistant aux centrales Homematic(IP) via le réseau local. Elle fonctionne avec OpenCCU, CCU2 et CCU3, Debmatic et Homegear, en utilisant XML-RPC local pour le contrôle et les mises à jour d’état en push, et JSON-RPC pour les noms et les pièces, sans aucun cloud. Les appareils apparaissent sur de nombreuses plateformes, dont les entités de climatisation, de volets, de lumières, de serrures, de sirènes, de vannes et de mise à jour. Les programmes de la CCU peuvent être importés comme entités de bouton, et les variables système peuvent aussi être récupérées. Un panneau intégré dans la barre latérale modifie les valeurs de configuration des appareils par canal, valide les changements avant de les écrire et peut remettre les paramètres aux valeurs d’usine. Elle comprend aussi des services pour les plannings et le mode absence de la climatisation, des avis de correction pour les problèmes de connexion, des diagnostics, et des blueprints d’automatisation prêts à l’emploi pour les télécommandes à boutons. Elle se configure dans l’interface de Home Assistant et nécessite un compte CCU disposant des droits d’administrateur.

Résumé automatique du README et du code de SukramJ/homematicip_local, 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.

Réglages avancés

Hôte de rappel (facultatif)Adresse IP pour les rappels de la CCU. Laisse vide pour la détection automatique.
Port de rappel (facultatif)Port pour les rappels XML-RPC. Laisse vide pour une attribution automatique.
Tentatives de renvoi des commandesNombre maximal de tentatives de renvoi en cas d’échec temporaire d’une commande (délai dépassé, appareil injoignable). Mets 0 pour désactiver le renvoi.
Intervalle de limitation des commandesDélai minimal entre les commandes d’appareil, en secondes. Mets 0 pour désactiver la limitation. Assure un fonctionnement fluide pour les grandes installations.
Désactiver le panneau de configuration des appareilsMasque le panneau de configuration des appareils dans la barre latérale.
Activer les notifications systèmeAffiche dans Home Assistant des notifications pour les problèmes de connexion et les erreurs d’appareil.
Restaurer la dernière luminosité des lumièresSi activé, les lumières s’allument avec le dernier niveau de luminosité non nul au lieu des 100 % par défaut.
Écouter sur toutes les interfaces réseauÀ activer si Home Assistant fonctionne dans Docker ou une VM. Obligatoire quand l’IP de HA diffère de l’IP de l’hôte.
Activer MQTTObligatoire pour la prise en charge des appareils CUxD et CCU-Jack. Nécessite un broker MQTT connecté à Home Assistant.
Préfixe MQTTPréfixe de topic MQTT configuré dans CCU-Jack. Laisse vide si tu n’utilises pas le pont MQTT de CCU-Jack.
Fonctionnalités expérimentalesActive les fonctionnalités expérimentales pour essayer de nouvelles fonctions. Ces fonctionnalités peuvent changer ou être supprimées dans les versions futures.
Marqueurs de programmeFiltre les programmes selon un marqueur dans la description (HAHM, HX, INTERNAL). Laisse vide pour importer tous les programmes.
Activer l’import des programmesImporte les programmes de la CCU comme entités de bouton pour les déclencher depuis Home Assistant.
Créer des entités de sous-appareilDivise les appareils ayant plusieurs groupes de canaux en un appareil principal avec des sous-appareils. Les entités sont attribuées au sous-appareil correspondant selon le groupe de canaux.
Marqueurs de variable systèmeFiltre les variables système selon un marqueur dans la description (HAHM, HX, INTERNAL). Laisse vide pour importer toutes les variables.

Connexion à la CCU

Nom d’hôte/adresse IP de la CCU
Nom de l’instance de l’intégrationIdentifiant unique de cette installation de Home Assistant. Permet à plusieurs instances de Home Assistant de se connecter simultanément à la même CCU. N’a aucun rapport avec le nom d’hôte/l’adresse IP de la CCU. Ne le modifie pas après la configuration : les entités seraient recréées.
Mot de passe de la CCUSensible à la casse. Caractères autorisés : A-Z, a-z, 0-9 et .!$():;#-
Ignorer la détection automatique du backendActive cette option si tu utilises des ports non standard ou si la détection du backend se bloque. Tu configureras manuellement les interfaces et les ports à l’étape suivante.
Nom d’utilisateur de la CCUSensible à la casse. L’utilisateur doit avoir le rôle d’administrateur

TLS et choix des interfaces

Activer Homematic (Bidcos-RF)
Activer BidCos-Wired (HM-Wired)
Activer CCU-Jack
Configurer des ports personnalisésActive pour configurer des ports non standard sur la page suivante. Sinon, les ports sont définis automatiquement selon le réglage TLS.
Activer CUxD
Activer Homematic IP
Utiliser TLS (connexion chiffrée)Active TLS pour une communication chiffrée avec ta CCU.
Vérifier le certificat TLSVérifie le certificat TLS de la CCU. Désactive pour les certificats auto-signés.
Activer les groupes (groupes de chauffage)

Démon OpenCCU-Loom (Beta)

Nom d’hôte/adresse IP du démon
Nom de l’instance de l’intégration
Port du démon (vide = 8119)Non utilisé en cas de connexion via un boîtier openccu-lite : le port du serveur web du boîtier s’applique (443 avec TLS, 80 sans).
Utiliser TLS (HTTPS/WSS)Uniquement si le démon sert en HTTPS (un certificat est configuré dans ses réglages north.rest.tls). Par défaut, le démon sert en HTTP simple sur 8119 ; avec TLS activé, la connexion échoue. Via un boîtier openccu-lite, TLS concerne plutôt le serveur web du boîtier.
Vérifier le certificat TLS
Créer des entités de sous-appareilDivise les appareils ayant plusieurs groupes de canaux en un appareil principal avec des sous-appareils. Les entités sont attribuées au sous-appareil correspondant selon le groupe de canaux.

Configuration des ports

Port HM-RFPorts standard : 2001 (sans TLS), 42001 (TLS)
Port BidCos-WiredPorts standard : 2000 (sans TLS), 42000 (TLS)
Port HmIP-RFPorts standard : 2010 (sans TLS), 42010 (TLS)
Port JSON-RPCPorts standard : 80 (sans TLS), 443 (TLS). Mets 0 pour utiliser les valeurs par défaut.
Chemin des groupes
Port des groupesPorts standard : 9292 (sans TLS), 49292 (TLS)

Réauthentifier la connexion CCU

Mot de passe CCUSensible à la casse. Caractères autorisés : A-Z, a-z, 0-9 et .!$():;#-
Nom d’utilisateur CCUSensible à la casse. L’utilisateur doit avoir le rôle administrateur

Reconfigurer la connexion

Nom d’hôte/adresse IP de la CCU
Mot de passe CCUSensible à la casse. Caractères autorisés : A-Z, a-z, 0-9 et .!$():;#-
Nom d’utilisateur CCUSensible à la casse. L’utilisateur doit avoir le rôle administrateur

Sélection du TLS et des interfaces

Activer Homematic (Bidcos-RF)
Activer BidCos-Wired (HM-Wired)
Activer CCU-Jack
Configurer des ports personnalisésActive cette option pour configurer des ports non standard sur la page suivante. Sinon, les ports sont définis automatiquement selon le réglage TLS.
Activer CUxD
Activer Homematic IP
Utiliser TLS (connexion chiffrée)Active TLS pour une communication chiffrée avec ta CCU.
Vérifier le certificat TLSVérifie le certificat TLS de la CCU. Désactive cette option pour les certificats auto-signés.
Activer les groupes (groupes de chauffage)

Après la mise en place

Hôte de rappel (facultatif)Adresse IP pour les rappels de la CCU. Laisse vide pour la détection automatique.
Port de rappel (facultatif)Port pour les rappels XML-RPC. Laisse vide pour une attribution automatique.
Tentatives de nouvel essai des commandesNombre maximal de nouvelles tentatives en cas d’échec temporaire d’une commande (délai dépassé, appareil injoignable). Mets 0 pour désactiver les nouvelles tentatives.
Intervalle de limitation des commandesDélai minimal entre les commandes envoyées aux appareils, en secondes. Mets 0 pour désactiver la limitation. Assure un fonctionnement fluide pour les grandes installations.
Désactiver le panneau de configuration des appareilsMasque le panneau de configuration des appareils dans la barre latérale.
Activer les notifications systèmeAffiche dans Home Assistant des notifications pour les problèmes de connexion et les erreurs d’appareil.
Restaurer la dernière luminosité des lumièresSi activé, les lumières s’allument avec le dernier niveau de luminosité non nul au lieu de 100 % par défaut.
Écouter sur toutes les interfaces réseauActive cette option si Home Assistant tourne dans Docker ou une VM. Nécessaire quand l’IP de HA diffère de l’IP de l’hôte.
Activer MQTTNécessaire pour la prise en charge des appareils CUxD et CCU-Jack. Nécessite un broker MQTT connecté à Home Assistant.
Préfixe MQTTPréfixe de topic MQTT configuré dans CCU-Jack. Laisse vide si tu n’utilises pas le pont MQTT de CCU-Jack.
Fonctions expérimentalesActive les fonctions expérimentales pour essayer de nouvelles fonctionnalités. Elles peuvent changer ou être supprimées dans de futures versions.
Créer des entités de sous-appareilsDivise les appareils comportant plusieurs groupes de canaux en un appareil principal avec des sous-appareils. Les entités sont attribuées au sous-appareil correspondant selon le groupe de canaux.
Paramètres UN-IGNORERéactive des paramètres d’appareil masqués sous forme d’entités. Consulte la documentation pour les paramètres disponibles.
Indiquer la position du volet depuis le canal de groupeUtilise le canal de groupe pour indiquer la position du volet. Active cette option pour les volets qui indiquent des positions incorrectes sur leurs canaux individuels.
Nom d’hôte/adresse IP de la CCU
Mot de passe CCUSensible à la casse. Caractères autorisés : A-Z, a-z, 0-9 et .!$():;#-
Nom d’utilisateur CCUSensible à la casse. L’utilisateur doit avoir le rôle administrateur
Activer Homematic (Bidcos-RF)
Activer BidCos-Wired (HM-Wired)
Activer CCU-Jack
Configurer des ports personnalisésActive cette option pour configurer des ports non standard sur la page suivante. Sinon, les ports sont définis automatiquement selon le réglage TLS.
Activer CUxD
Activer Homematic IP
Utiliser TLS (connexion chiffrée)Active TLS pour une communication chiffrée avec ta CCU.
Vérifier le certificat TLSVérifie le certificat TLS de la CCU. Désactive cette option pour les certificats auto-signés.
Activer les groupes (groupes de chauffage)
Port HM-RFPorts standard : 2001 (sans TLS), 42001 (TLS)
Port BidCos-WiredPorts standard : 2000 (sans TLS), 42000 (TLS)
Port HmIP-RFPorts standard : 2010 (sans TLS), 42010 (TLS)
Port JSON-RPCPorts standard : 80 (sans TLS), 443 (TLS). Mets 0 pour utiliser les valeurs par défaut.
Chemin des groupes
Port des groupesPorts standard : 9292 (sans TLS), 49292 (TLS)
Nom d’hôte/adresse IP du démon
Port du démon (vide = 8119)Non utilisé lors d’une connexion via un boîtier openccu-lite : le port du serveur web du boîtier s’applique (443 avec TLS, 80 sans).
Jeton porteur de l’API
Utiliser TLS (HTTPS/WSS)Uniquement si le démon sert en HTTPS (un certificat est configuré dans ses réglages north.rest.tls). Par défaut, le démon sert en HTTP simple sur 8119 ; avec TLS activé, la connexion échoue. Via un boîtier openccu-lite, TLS concerne plutôt le serveur web du boîtier.
Vérifier le certificat TLS
Jeton du boîtier openccu-liteLe jeton d’API du boîtier openccu-lite avec lequel cette entrée se connecte (portée addon:openccu-loom ou accès complet, depuis la page des jetons du boîtier). Colle-en un nouveau pour le remplacer ; si le champ reste vide, le jeton enregistré est conservé.
Autoriser les utilisateurs non administrateurs à modifier les planningsSi activé, les utilisateurs non administrateurs peuvent modifier les plannings des appareils via les cartes de planning. Les administrateurs ont toujours un accès complet.
Marqueurs de programmesListe de marqueurs séparés par des virgules pour activer la récupération des programmes. Pour réinitialiser, saisis un espace.
Activer l’analyse des programmesActive l’analyse et la récupération des programmes de la CCU
Marqueurs de variables systèmeListe de marqueurs séparés par des virgules pour activer la récupération des variables système. Pour réinitialiser, saisis un espace.
Activer l’analyse des variables systèmeActive l’analyse et la récupération des variables système de la CCU
Intervalle d’analyse (secondes)Intervalle en secondes entre les analyses des programmes et des variables système

Textes issus du code de SukramJ/homematicip_local. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Entités

BoutonsCréer une sauvegarde, Activer le mode d’installation BidCos-RF, Activer le mode d’installation HmIP-RF
NombresOuverture de la vanne
SélecteursTonalité de la sirène, Mode de la porte, Mode de fonctionnement, Motif lumineux de la sirène
CapteursMessages d’alarme, Niveau de détection de porteuse, Latence de connexion, Niveau du volet, Niveau d’inclinaison, Latence du démon, Direction, État de la porte, Niveau de cycle d’utilisation, Compteur d’énergie injectée total, Compteur d’énergie total, Boîte de réception et 20 autres

Actions

Ajouter une liaisonAppel à addLink pour les liaisons dans l’interface RPC XMLChamps : Description de la liaison, Nom de la liaison, Adresse du canal récepteur, Adresse du canal émetteur
Vider le cacheVide le cache. Nécessite un redémarrageChamps : Centrale
Effacer l’affichage de texteEfface toutes les lignes de l’affichage de texte HmIP-WRCD
Confirmer tous les appareils en attenteConfirme tous les appareils en attente en une seule fois et les ajoute à Home AssistantChamps : Centrale
Copier le planningCopie un planning complet d’un appareil vers un autreChamps : Adresse de l’appareil, Appareil source, Appareil cible
Copier le profil de planningCopie un profil de planning au sein du même appareil ou vers un autre appareilChamps : Adresse de l’appareil, Appareil, Profil source, Appareil cible, Profil cible
Créer une sauvegarde de la CCUCrée et télécharge une sauvegarde système depuis la CCU. Enregistre le fichier de sauvegarde dans le répertoire de sauvegarde configuré.Champs : Centrale
Créer des liaisons centralesCrée des liaisons vers la centrale pour activer les événements d’appui sur les touches de supportChamps : Appareil, Centrale
Désactiver le mode absence de la climatisationDésactive le mode absence de la climatisation
Activer le mode absence de la climatisation par calendrierActive le mode absence de la climatisation par calendrierChamps : Température de consigne, Heure de fin, Heure de début
Activer le mode absence de la climatisation pour une duréeActiver le mode absence de la climatisation pour une duréeChamps : Température de consigne, Heures
Exporter la définition de l’appareilExporter la définition d’un appareil vers 'Ton répertoire de configuration home-assistant'/homematicip_local/export*Champs : Appareil
Récupérer les variables systèmeRécupérer les variables système depuis le backendChamps : Centrale
Forcer la disponibilité de l’appareilForcer un appareil à être disponible, ce qui remplace l’état réelChamps : Adresse de l’appareil, Appareil
Obtenir la valeur de l’appareilObtenir la valeur d’un appareil via l’interface RPC XMLChamps : Canal, Adresse de l’appareil, Appareil, Paramètre
Obtenir le paramset de liaisonAppel de getParamset pour les liaisons dans l’interface RPC XMLChamps : Adresse du canal récepteur, Adresse du canal émetteur
Obtenir les pairs de liaisonAppel de getLinkPeers dans l’interface RPC XMLChamps : Canal, Adresse de l’appareil, Appareil
Obtenir le paramsetAppel de getParamset dans l’interface RPC XMLChamps : Canal, Adresse de l’appareil, Appareil, Clé du paramset
Obtenir la programmationRenvoyer la programmation complète d’un appareilChamps : Adresse de l’appareil, Appareil
Obtenir le profil de programmationRenvoyer un profil de programmation pour un appareil de climatisationChamps : Adresse de l’appareil, Appareil, Profil

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Connexion CCU dégradée, Échec de la connexion CCU, Erreur interne de la CCU, Échec de la connexion réseau de la CCU, Délai de connexion CCU dépassé, Échec de la récupération des données de l’appareil, Le serveur XmlRPC n’a reçu aucun événement

Extrait du README

Homematic(IP) Local for OpenCCU is a custom integration for Home Assistant.
Browse all configurable devices grouped by interface
View device details including reachability, RSSI, and firmware
Edit MASTER paramset values per channel with auto-generated forms (sliders, toggles, dropdowns)
Validate changes before writing to the device
Reset parameters to factory defaults

Extrait du README de SukramJ/homematicip_local, MIT License. Abrégé.

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.

Widgets et Activités en direct dans Vulpo

Informations

Installations: 10,5 k partagent leurs statistiques
Étoiles GitHub: 606
Connexion: Fonctionne en local
Maintenance: Mise à jour au cours des 6 derniers mois
Version: 2.12.1, 26 octobre 2026
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: homematicip_local
Source: github.com/SukramJ/homematicip_local
Problèmes: Signaler un problème