Homematic(IP) Local for OpenCCU voor Home Assistant (Marketplace-integratie)

Installaties: 10,5K die analysegegevens delen
GitHub-sterren: 606
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: 2.12.1, 26 oktober 2026
Categorie: Hubs en protocollen, Smart home-hubs
Soort: Marketplace-integratie
Merk: Homematic
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: homematicip_local
Bron: github.com/SukramJ/homematicip_local
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

Homematic(IP) Local for OpenCCU is een aangepaste integratie die Home Assistant via het lokale netwerk verbindt met Homematic(IP)-hubs. Het werkt met OpenCCU, CCU2 en CCU3, Debmatic en Homegear, met lokale XML-RPC voor bediening en push-statusupdates en JSON-RPC voor namen en kamers, zonder dat een cloud nodig is. Apparaten verschijnen op veel platforms, waaronder klimaat, rolluiken, lichten, sloten, sirenes, kleppen en update-entiteiten. CCU-programma's kunnen als knopentiteiten worden geïmporteerd en systeemvariabelen kunnen ook worden opgehaald. Een ingebouwd zijbalkpaneel bewerkt configuratiewaarden van apparaten per kanaal, controleert wijzigingen voordat ze worden geschreven en kan parameters terugzetten naar de fabrieksinstellingen. Andere onderdelen zijn services voor schema's en de afwezigheidsmodus van het klimaat, reparatiemeldingen bij verbindingsproblemen, diagnostiek en kant-en-klare automatiseringsblauwdrukken voor knopafstandsbedieningen. Het wordt ingesteld in de Home Assistant-interface en vereist een CCU-account met beheerdersrechten.

Automatische samenvatting van de README en de code van SukramJ/homematicip_local, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Apparaattriggers De apparaten kunnen rechtstreeks automatiseringen starten.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Lichten
Klimaat
Rolluiken
Kleppen
Sloten
Alarmpanelen
Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Geavanceerde instellingen

Callback-host (optioneel)IP-adres voor CCU-callbacks. Laat leeg voor automatische detectie.
Callback-poort (optioneel)Poort voor XML-RPC-callbacks. Laat leeg voor automatische toewijzing.
Pogingen om opdracht te herhalenMaximaal aantal nieuwe pogingen bij tijdelijke opdrachtfouten (time-out, apparaat onbereikbaar). Stel in op 0 om opnieuw proberen uit te schakelen.
Interval voor opdrachtbeperkingMinimale vertraging tussen apparaatopdrachten in seconden. Stel in op 0 om beperking uit te schakelen. Zorgt voor een soepele werking bij grote installaties.
Configuratiepaneel voor apparaten uitschakelenVerberg het configuratiepaneel voor apparaten in de zijbalk.
Systeemmeldingen inschakelenToon meldingen over verbindingsproblemen en apparaatfouten in Home Assistant.
Laatste helderheid van lichten herstellenIndien ingeschakeld gaan lichten aan met de laatste helderheid die niet nul was, in plaats van de standaard 100%.
Luisteren op alle netwerkinterfacesSchakel in als Home Assistant in Docker of een VM draait. Vereist wanneer het IP-adres van HA afwijkt van het IP-adres van de host.
MQTT inschakelenVereist voor ondersteuning van CUxD- en CCU-Jack-apparaten. Vereist een MQTT-broker die met Home Assistant is verbonden.
MQTT-prefixMQTT-topicprefix zoals ingesteld in CCU-Jack. Laat leeg als je de CCU-Jack MQTT-bridge niet gebruikt.
Experimentele functiesSchakel experimentele functies in om nieuwe functionaliteit uit te proberen. Deze functies kunnen in toekomstige versies veranderen of verdwijnen.
ProgrammamarkeringenFilter programma's op markering in de beschrijving (HAHM, HX, INTERNAL). Laat leeg om alle programma's te importeren.
Programma-import inschakelenImporteer CCU-programma's als knopentiteiten om ze vanuit Home Assistant te starten.
Entiteiten van subapparaten aanmakenSplitst apparaten met meerdere kanaalgroepen in een hoofdapparaat met subapparaten. Entiteiten worden op basis van de kanaalgroep aan het bijbehorende subapparaat toegewezen.
Markeringen voor systeemvariabelenFilter systeemvariabelen op markering in de beschrijving (HAHM, HX, INTERNAL). Laat leeg om alle variabelen te importeren.

CCU-verbinding

CCU-hostnaam/IP-adres
Naam van integratie-instantieUnieke id voor deze Home Assistant-installatie. Hiermee kunnen meerdere Home Assistant-instanties tegelijk met dezelfde CCU verbinden. Heeft geen verband met de CCU-hostnaam/het IP-adres. Wijzig dit na de installatie niet, want entiteiten zouden opnieuw worden aangemaakt.
CCU-wachtwoordHoofdlettergevoelig. Toegestane tekens: A-Z, a-z, 0-9 en .!$():;#-
Automatische backenddetectie overslaanSchakel deze optie in als je niet-standaardpoorten gebruikt of als de backenddetectie vastloopt. Je stelt de interfaces en poorten in de volgende stap handmatig in.
CCU-gebruikersnaamHoofdlettergevoelig. De gebruiker moet de beheerdersrol hebben

TLS en interfacekeuze

Homematic (Bidcos-RF) inschakelen
BidCos-Wired (HM-Wired) inschakelen
CCU-Jack inschakelen
Aangepaste poorten instellenSchakel in om niet-standaardpoorten op de volgende pagina in te stellen. Anders worden poorten automatisch ingesteld op basis van de TLS-instelling.
CUxD inschakelen
Homematic IP inschakelen
TLS gebruiken (versleutelde verbinding)Schakel TLS in voor versleutelde communicatie met je CCU.
TLS-certificaat verifiërenControleer het TLS-certificaat van de CCU. Schakel uit bij zelfondertekende certificaten.
Groepen inschakelen (verwarmingsgroepen)

Stap 4

Hostnaam/IP-adres van daemon
Naam van integratie-instantie
Daemonpoort (leeg = 8119)Wordt niet gebruikt bij verbinding via een openccu-lite-box: dan geldt de poort van de webserver van de box (443 met TLS, 80 zonder).
TLS gebruiken (HTTPS/WSS)Alleen als de daemon HTTPS aanbiedt (er is een certificaat ingesteld in de north.rest.tls-instellingen). Standaard biedt de daemon gewone HTTP aan op 8119; met TLS aan mislukt de verbinding. Via een openccu-lite-box verwijst TLS naar de webserver van de box.
TLS-certificaat verifiëren
Entiteiten van subapparaten aanmakenSplitst apparaten met meerdere kanaalgroepen in een hoofdapparaat met subapparaten. Entiteiten worden op basis van de kanaalgroep aan het bijbehorende subapparaat toegewezen.

Poortconfiguratie

HM-RF-poortStandaardpoorten: 2001 (zonder TLS), 42001 (TLS)
BidCos-Wired-poortStandaardpoorten: 2000 (zonder TLS), 42000 (TLS)
HmIP-RF-poortStandaardpoorten: 2010 (zonder TLS), 42010 (TLS)
JSON-RPC-poortStandaardpoorten: 80 (zonder TLS), 443 (TLS). Stel in op 0 om de standaardwaarden te gebruiken.
Groepenpad
GroepenpoortStandaardpoorten: 9292 (zonder TLS), 49292 (TLS)

CCU-verbinding opnieuw verifiëren

CCU-wachtwoordHoofdlettergevoelig. Toegestane tekens: A-Z, a-z, 0-9 en .!$():;#-
CCU-gebruikersnaamHoofdlettergevoelig. De gebruiker moet de rol beheerder hebben

Verbinding opnieuw configureren

CCU-hostnaam/IP-adres
CCU-wachtwoordHoofdlettergevoelig. Toegestane tekens: A-Z, a-z, 0-9 en .!$():;#-
CCU-gebruikersnaamHoofdlettergevoelig. De gebruiker moet de rol beheerder hebben

TLS en interfacekeuze

Homematic (Bidcos-RF) inschakelen
BidCos-Wired (HM-Wired) inschakelen
CCU-Jack inschakelen
Aangepaste poorten configurerenSchakel in om op de volgende pagina niet-standaardpoorten te configureren. Anders worden de poorten automatisch ingesteld op basis van de TLS-instelling.
CUxD inschakelen
Homematic IP inschakelen
TLS gebruiken (versleutelde verbinding)Schakel TLS in voor versleutelde communicatie met je CCU.
TLS-certificaat verifiërenVerifieer het TLS-certificaat van de CCU. Schakel uit voor zelfondertekende certificaten.
Groepen (verwarmingsgroepen) inschakelen

Na het instellen

Callback-host (optioneel)IP-adres voor CCU-callbacks. Laat leeg voor automatische detectie.
Callback-poort (optioneel)Poort voor XML-RPC-callbacks. Laat leeg voor automatische toewijzing.
Pogingen om opdrachten opnieuw te proberenMaximaal aantal nieuwe pogingen bij tijdelijke opdrachtfouten (time-out, apparaat onbereikbaar). Stel in op 0 om nieuwe pogingen uit te schakelen.
Beperkingsinterval voor opdrachtenMinimale vertraging tussen apparaatopdrachten in seconden. Stel in op 0 om beperking uit te schakelen. Zorgt voor een soepele werking bij grote installaties.
Configuratiepaneel voor apparaten uitschakelenVerberg het configuratiepaneel voor apparaten in de zijbalk.
Systeemmeldingen inschakelenToon meldingen over verbindingsproblemen en apparaatfouten in Home Assistant.
Laatste helderheid van lichten herstellenIndien ingeschakeld gaan lichten aan met de laatste helderheid die niet nul was, in plaats van de standaard 100%.
Luisteren op alle netwerkinterfacesSchakel in als Home Assistant in Docker of een VM draait. Vereist wanneer het IP-adres van HA afwijkt van het IP-adres van de host.
MQTT inschakelenVereist voor ondersteuning van CUxD- en CCU-Jack-apparaten. Vereist een MQTT-broker die met Home Assistant is verbonden.
MQTT-prefixMQTT-topicprefix die in CCU-Jack is geconfigureerd. Laat leeg als je de MQTT-brug van CCU-Jack niet gebruikt.
Experimentele functiesSchakel experimentele functies in om nieuwe functionaliteit uit te proberen. Deze functies kunnen in toekomstige versies veranderen of verdwijnen.
Entiteiten voor subapparaten aanmakenSplitst apparaten met meerdere kanaalgroepen op in een hoofdapparaat met subapparaten. Entiteiten worden op basis van de kanaalgroep aan het bijbehorende subapparaat toegewezen.
UN-IGNORE-parametersSchakel verborgen apparaatparameters weer in als entiteiten. Zie de documentatie voor beschikbare parameters.
Rolluikpositie rapporteren via groepskanaalGebruik het groepskanaal om de rolluikpositie te rapporteren. Schakel dit in voor rolluiken die op hun afzonderlijke kanalen een onjuiste positie rapporteren.
CCU-hostnaam/IP-adres
CCU-wachtwoordHoofdlettergevoelig. Toegestane tekens: A-Z, a-z, 0-9 en .!$():;#-
CCU-gebruikersnaamHoofdlettergevoelig. De gebruiker moet de rol beheerder hebben
Homematic (Bidcos-RF) inschakelen
BidCos-Wired (HM-Wired) inschakelen
CCU-Jack inschakelen
Aangepaste poorten configurerenSchakel in om op de volgende pagina niet-standaardpoorten te configureren. Anders worden de poorten automatisch ingesteld op basis van de TLS-instelling.
CUxD inschakelen
Homematic IP inschakelen
TLS gebruiken (versleutelde verbinding)Schakel TLS in voor versleutelde communicatie met je CCU.
TLS-certificaat verifiërenVerifieer het TLS-certificaat van de CCU. Schakel uit voor zelfondertekende certificaten.
Groepen (verwarmingsgroepen) inschakelen
HM-RF-poortStandaardpoorten: 2001 (zonder TLS), 42001 (TLS)
BidCos-Wired-poortStandaardpoorten: 2000 (zonder TLS), 42000 (TLS)
HmIP-RF-poortStandaardpoorten: 2010 (zonder TLS), 42010 (TLS)
JSON-RPC-poortStandaardpoorten: 80 (zonder TLS), 443 (TLS). Stel in op 0 om de standaardwaarden te gebruiken.
Groepenpad
GroepenpoortStandaardpoorten: 9292 (zonder TLS), 49292 (TLS)
Hostnaam/IP-adres van de daemon
Poort van de daemon (leeg = 8119)Niet gebruikt bij verbinding via een openccu-lite-box: dan geldt de poort van de webserver van de box (443 met TLS, 80 zonder).
API-bearertoken
TLS gebruiken (HTTPS/WSS)Alleen als de daemon HTTPS aanbiedt (er is een certificaat ingesteld in de north.rest.tls-instellingen). Standaard biedt de daemon gewoon HTTP aan op 8119; met TLS aan mislukt de verbinding dan. Via een openccu-lite-box verwijst TLS naar de webserver van de box.
TLS-certificaat controleren
Token van de openccu-lite-boxHet API-token van de openccu-lite-box waarmee deze invoer verbinding maakt (scope addon:openccu-loom of volledige toegang, van de tokenpagina van de box). Plak een nieuw token om het te vervangen; als je het leeg laat, blijft het opgeslagen token behouden.
Gebruikers zonder beheerdersrechten toestaan schema's te bewerkenAls dit is ingeschakeld, kunnen gebruikers zonder beheerdersrechten apparaatschema's bewerken via de schemakaarten. Beheerders hebben altijd volledige toegang.
ProgrammamarkeringenDoor komma's gescheiden lijst met markeringen voor programma's waarvan het ophalen wordt ingeschakeld. Stel in op een spatie om te resetten.
Programmascan inschakelenHet scannen en ophalen van CCU-programma's inschakelen
Markeringen voor systeemvariabelenDoor komma's gescheiden lijst met markeringen voor systeemvariabelen waarvan het ophalen wordt ingeschakeld. Stel in op een spatie om te resetten.
Scan van systeemvariabelen inschakelenHet scannen en ophalen van CCU-systeemvariabelen inschakelen
Scaninterval (seconden)Interval in seconden tussen scans naar programma's en systeemvariabelen

Teksten uit de code van SukramJ/homematicip_local. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

NummersKlepopening
SelectiesSirenetoon, Deurmodus, Bedrijfsmodus, Sirenelichtpatroon
SensorenAlarmmeldingen, Carrier-sense-niveau, Verbindingslatentie, Rolluikniveau, Kantelniveau, Daemonlatentie, Richting, Deurstatus, Duty-cycle-niveau, Energieteller teruglevering totaal, Energieteller totaal, Inbox en nog 20

Acties

Koppeling toevoegenAanroep van addLink voor koppelingen in de RPC XML-interfaceVelden: Beschrijving van de koppeling, Naam van de koppeling, Kanaaladres van de ontvanger, Kanaaladres van de zender
Cache wissenWis de cache. Vereist een herstartVelden: Centrale
Tekstdisplay wissenAlle regels op het HmIP-WRCD-tekstdisplay wissen
Alle vertraagde apparaten bevestigenAlle vertraagde apparaten in één keer bevestigen en toevoegen aan Home AssistantVelden: Centrale
Schema kopiërenKopieer een volledig schema van het ene apparaat naar het andereVelden: Apparaatadres, Bronapparaat, Doelapparaat
Schemaprofiel kopiërenKopieer een schemaprofiel binnen hetzelfde apparaat of naar een ander apparaatVelden: Apparaatadres, Apparaat, Bronprofiel, Doelapparaat, Doelprofiel
CCU-back-up makenMaak een systeemback-up van de CCU en download die. Slaat het back-upbestand op in de ingestelde back-upmap.Velden: Centrale
Centrale koppelingen makenVelden: Apparaat, Centrale
Afwezigheidsmodus klimaat uitschakelenAfwezigheidsmodus voor klimaat uitschakelen
Afwezigheidsmodus klimaat inschakelen via agendaAfwezigheidsmodus voor klimaat inschakelen via agendaVelden: Streeftemperatuur, Eindtijd, Starttijd
Klimaatafwezigheidsmodus inschakelen op basis van duurKlimaatafwezigheidsmodus inschakelen op basis van duurVelden: Streeftemperatuur, Uren
Apparaatdefinitie exporterenExporteer een apparaatdefinitie naar 'Je Home Assistant-configuratiemap'/homematicip_local/export*Velden: Apparaat
Systeemvariabelen ophalenSysteemvariabelen ophalen uit de backendVelden: Centrale
Apparaatbeschikbaarheid forcerenForceer een apparaat als beschikbaar, dit overschrijft de werkelijke statusVelden: Apparaatadres, Apparaat
Apparaatwaarde ophalenHaal een apparaatwaarde op via de RPC XML-interfaceVelden: Kanaal, Apparaatadres, Apparaat, Parameter
Link-paramset ophalenAanroep van getParamset voor links in de RPC XML-interfaceVelden: Kanaaladres ontvanger, Kanaaladres zender
Link-peers ophalenAanroep van getLinkPeers in de RPC XML-interfaceVelden: Kanaal, Apparaatadres, Apparaat
Paramset ophalenAanroep van getParamset in de RPC XML-interfaceVelden: Kanaal, Apparaatadres, Apparaat, Paramset-sleutel
Schema ophalenGeef het volledige schema van een apparaat terugVelden: Apparaatadres, Apparaat
Schemaprofiel ophalenGeef een schemaprofiel van een klimaatapparaat terugVelden: Apparaatadres, Apparaat, Profiel

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:CCU-verbinding verslechterd, CCU-verbinding mislukt, Interne CCU-fout, CCU-netwerkverbinding mislukt, Time-out van CCU-verbinding, Apparaatgegevens ophalen mislukt, XmlRPC-Server heeft geen gebeurtenissen ontvangen

Uit de 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

Uit de README van SukramJ/homematicip_local, MIT License. Ingekort.