Homematic IP Local (HCU) voor Home Assistant (Marketplace-integratie)

Installaties: 357 die analysegegevens delen
GitHub-sterren: 74
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: 2.6.1, 27 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: hcu_integration
Bron: github.com/Ediminator/homematicip-hcu
Problemen: Probleem melden

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

Screenshots Uit de README van Ediminator/homematicip-hcu.

Bridged weather station in the Homematic IP app

Over dit item

Homematic IP Local (HCU) verbindt Home Assistant via het lokale netwerk met een Homematic IP Home Control Unit. Het ontvangt statuswijzigingen en gebeurtenissen via een permanente WebSocket-verbinding, dus het netwerk wordt niet gepolld. Entiteiten omvatten klimaat, rolluiken, lichten, schakelaars, sloten, kleppen, sensoren, alarmen, sirenes, updates en meer, en groepen voor kamerverwarming, rolluiken, schakelen en verlichting worden gesynchroniseerd. Acties zijn onder andere partymodus, vakantiemodus, ecomodus, koelmodus, een geluid afspelen, een schakelaar voor een ingestelde tijd aanzetten, en gebruikersberichten maken of verwijderen die in de Homematic IP-app worden getoond. Een HA Entity Bridge, als alpha aangeduid, maakt lichten, schakelaars en sensoren van Home Assistant als virtuele apparaten beschikbaar voor de HCU. De installatie verloopt in de gebruikersinterface met een verbinding als app-gebruiker of als pluginGebruiker, en er kunnen meerdere HCU-units worden toegevoegd.

Automatische samenvatting van de README en de code van Ediminator/homematicip-hcu, 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.

Verbinden met Homematic IP HCU

Hostnaam of IP-adres
Poort van de authenticatie-API (standaard: 6969)
Poort van de WebSocket-API (standaard: 9001)

Authenticeren bij HCU

Activeringssleutel

Ook gevraagd bij het wijzigen van de verbinding.

Verbindingsmodus kiezen

App-gebruiker: ondersteuning voor alle functies (geen ontwikkelaarsmodus nodig). Vereist het indrukken van de systeemknop op de HCU.
Plugingebruiker: schakelt pluginfuncties in (gebruikersberichten, antwoorden voor ontdekken en bedienen). Vereist een activeringssleutel uit de HCU WebUI → Ontwikkelaarsmodus.

App-gebruiker: verbinding aanvragen

HCU SGTIN (automatisch gedetecteerd)De SGTIN van 24 tekens van je HCU, bijvoorbeeld 3014F711A0001234567890. Wordt normaal automatisch gedetecteerd. Vul dit alleen handmatig in als het veld leeg is.

Fabrikanten selecteren

Fabrikanten om te verbergen

Homematic IP HCU opnieuw configureren

Hostnaam of IP-adres
Poort van de authenticatie-API
Poort van de WebSocket-API

Verbindingsmodus kiezen

Verbindingsmodus
Bestaande authenticatietokens behouden
✓ Verbonden
✗ Niet verbonden
Niet geconfigureerd

Na het instellen

✓ Verbonden
✗ Niet verbonden
niet geconfigureerd
App-gebruiker
Plugingebruiker
DualBridge (app + plugin)
Niet-geconfigureerde kanalen uitschakelenSchakelt kanalen uit die niet in de Homematic IP-app zijn geconfigureerd of niet aan een kamer zijn toegewezen. Deze kanalen worden niet in Home Assistant aangemaakt.
Automatisch herladen bij apparaatwijzigingenAls dit is ingeschakeld, wordt de integratie automatisch opnieuw geladen wanneer een apparaat uit de HCU wordt verwijderd, of wanneer de naam van een apparaat, de kanaalrol of de schakelaarvisualisatie verandert. Het opnieuw laden duurt ongeveer 1 tot 2 seconden, waarin alle entiteiten kort als niet beschikbaar worden weergegeven. Schakel deze optie uit als je automatisch opnieuw laden wilt voorkomen en apparaatwijzigingen handmatig wilt beheren (bijvoorbeeld door Home Assistant te herstarten).
Standaard comforttemperatuurStel hier de comforttemperatuur in die voor de partymodus wordt gebruikt.
Groepen verbergenKies welke groepen verborgen moeten worden. De groepsnamen vind je in de extra attributen van elke entiteit.
Fabrikanten verbergenKies welke fabrikanten in Home Assistant verborgen moeten worden.
Geavanceerde foutopsporingSchakel in om de volledige ruwe gegevens van HMIP_SYSTEM_EVENT-gebeurtenissen te loggen. Schakel dit weer uit als je het niet meer nodig hebt.
Geavanceerde attributenSchakel in om extra ontwikkelaarsattributen per entiteit te tonen.
Doeltemperatuur
Einddatum en eindtijd
ApparaattypeHet soort apparaat bepaalt welke entiteitsvelden hierna worden getoond.
Licht
Schakelaar
Energiemeter
Fijnstofsensor
Klimaatsensor / weersensor
Bewegingssensor / aanwezigheidssensor
Deursensor / raamsensor
Rookmelder
Vochtsensor / watersensor
Batterij
Laadpaal voor elektrische auto's
Netaansluitpunt
Warmtepomp
HVAC
Te bewerken apparaat
Apparaatnaam
Aan/uit
Helderheid
Kleurtemperatuur
RGB-kleur
Aan-tijd (automatisch uit)
Temperatuur
Luchtvochtigheid
Verlichtingssterkte
CO₂
Windsnelheid
Neerslag
Storm
Zonneschijn
Te verwijderen apparaten

Teksten uit de code van Ediminator/homematicip-hcu. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

AlarmpanelenAlarm
Binaire sensorenInbraakalarm, Veiligheidsalarm, Vakantiemodus
KnoppenIdentificeren, Veiligheidsalarm bevestigen
GebeurtenissenDeurbel
SelectiesSchakelaarstatus bij inschakelen, Akoestisch signaal testen, Optisch signaal testen
SensorenInterne inschakeltijd, Inschakeltijd
SchakelaarsInterne inschakeltijd gebruiken
TekstenPincode voor toegangsautorisatie
UpdatesFirmware

Acties

Geluid afspelenSpeelt een geluidsbestand af op een compatibel apparaat (bijvoorbeeld HmIP-MP3P-deurbel, alarmsirenes).Velden: Geluidsbestand, Volume, Duur
Regelstatus instellenSchakelt een eenvoudige automatiseringsregel in de HCU in of uit.Velden: Regel-ID, Ingeschakeld
Vakantiemodus activerenActiveert de systeembrede vakantiemodus voor alle verwarmingsgroepen tot een opgegeven tijdstip.Velden: Temperatuur, Eindtijd
Ecomodus activeren (permanente afwezigheid)Activeert de systeembrede modus voor permanente afwezigheid (Eco) voor alle verwarmingsgroepen.
Afwezigheidsmodus deactiverenDeactiveert elke actieve afwezigheidsmodus (vakantie of Eco) en zet de verwarming terug op het vorige schema.
Feestmodus activerenActiveert de feestmodus voor een specifieke verwarmingsgroep met een specifieke temperatuur.Velden: Temperatuur, Eindtijd, Duur
Inschakelen met tijdSchakelt een schakelaar in voor een bepaalde duurVelden: Inschakeltijd
Koelmodus instellenActiveert of deactiveert de systeembrede koelmodus voor alle verwarmingsgroepen.Velden: Koeling
API-opdracht verzendenVerzend een ruwe API-opdracht naar de HCU. Wees voorzichtig, want dit geeft directe toegang tot de API en kan bij onjuist gebruik ongewenste neveneffecten veroorzaken. Zie de API-documentatie van EQ3 voor details.Velden: Verzoekpad, Verzoekinhoud
Gebruikersbericht aanmakenMaakt een gebruikersbericht aan dat wordt weergegeven in de Homematic IP-app. Zie de API-documentatie van eQ-3 voor details.Velden: Berichtcategorie, Gebruikersbericht-ID, Titel, Bericht, Gedragstype
Gebruikersbericht verwijderenVerwijder een eerder aangemaakt gebruikersbericht uit de Homematic IP-app. Zie de API-documentatie van EQ3 voor details.Velden: Gebruikersbericht-ID

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.

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

Uit de README van Ediminator/homematicip-hcu, MIT License. Ingekort.