IDM Heatpump voor Home Assistant (Marketplace-integratie)

Installaties: 229 die analysegegevens delen
GitHub-sterren: 16
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v0.23.1, 26 oktober 2026
Categorie: Klimaat
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: idm_heatpump
Bron: github.com/Xerolux/idm-heatpump-hass
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 Xerolux/idm-heatpump-hass.

IDM Heatpump integration: local Modbus TCP, local Navigator data and optional KNX

Over dit item

IDM Heatpump koppelt warmtepompen van het type IDM Navigator 2.0, Navigator 10 en Navigator Pro via lokaal Modbus TCP aan Home Assistant. Het werkt zonder cloudservice en omvat verwarmingscircuits, warm tapwater, pv-overschot, energiegegevens en diagnostiek. Entiteiten komen beschikbaar als sensoren, binaire sensoren, klimaat, boilers, nummers, selecties, schakelaars en knoppen, en met acties kun je de systeemmodus instellen, fouten bevestigen en de klok van de regelaar instellen. Een optioneel functieprofiel voegt berekend rendement, cyclus- en korte-cyclusanalyse en bedieningen voor een boost van warm tapwater toe, terwijl externe pv-, batterij- en kamersensoren naar de regelaar kunnen worden doorgestuurd. Optionele extra's zijn een experimentele AI-adviseur met alleen leesrechten die rapporten opstelt uit gemeten gegevens, en een KNX-brug die werkt zonder de gatewaymodule van IDM. De installatie gebeurt in de gebruikersinterface.

Automatische samenvatting van de README en de code van Xerolux/idm-heatpump-hass, 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.
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

Klimaat
Boilers
Schakelaars
Sensoren

Instellen

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

IDM Navigator Heat Pump instellen

NaamWeergavenaam van het apparaat in Home Assistant, bijvoorbeeld "IDM Heat Pump".
Modbus-IP / hostnaamIP-adres of hostnaam voor Modbus TCP. Gebruik je een Modbus-proxy, vul dan hier het adres van de proxy in.
PoortModbus TCP-poort van de regelaar. De standaardwaarde is 502.
Slave-IDModbus-slave-ID. De standaardwaarde is 1. Wijzig dit alleen als meerdere apparaten dezelfde bus delen.
Lokale Navigator-webtoegang gebruikenStandaard: ingeschakeld. Schakel dit alleen uit als je Modbus zonder extra lokale Navigator-webgegevens wilt gebruiken.
Pincode lokaal netwerk (Navigator-web)Vul de lokale netwerkcode in die op het Navigator-display is ingesteld. Vul geen cloud- of app-wachtwoord en geen tweestapscode in. Laat leeg voor gebruik met alleen Modbus; 0 schakelt de lokale webtoegang op de regelaar uit.
Een Modbus-proxy gebruikenSchakel dit in als het Modbus-adres hierboven een proxy is en niet de warmtepomp zelf.
Oorspronkelijk IP-adres van de warmtepomp voor webtoegangAlleen nodig bij gebruik van een Modbus-proxy. Vul het oorspronkelijke IP-adres of de hostnaam van de warmtepomp in, bijvoorbeeld 192.0.2.103.

Stap 2

Modbus-IP / hostnaamIP-adres of hostnaam voor Modbus TCP. Gebruik je een Modbus-proxy, vul dan hier het adres van de proxy in.
PoortModbus TCP-poort. De standaardwaarde is 502.
Slave-IDModbus-slave-ID. De standaardwaarde is 1.
Lokale Navigator-webtoegang gebruikenStandaard: ingeschakeld. Schakel dit alleen uit als je Modbus zonder extra lokale Navigator-webgegevens wilt gebruiken.
Pincode lokaal netwerk (Navigator-web)Lokale netwerkcode die op het Navigator-display is ingesteld. Cloud- of app-wachtwoorden en tweestapscodes werken hier niet. Laat leeg voor gebruik met alleen Modbus; 0 schakelt de lokale webtoegang op de regelaar uit.
Een Modbus-proxy gebruikenSchakel dit in als het Modbus-adres hierboven een proxy is en niet de warmtepomp zelf.
Oorspronkelijk IP-adres van de warmtepomp voor webtoegangAlleen nodig bij gebruik van een Modbus-proxy. Vul het oorspronkelijke IP-adres of de hostnaam van de warmtepomp in, bijvoorbeeld 192.0.2.103.
Navigator-modelWijzig dit alleen als de automatische detectie niet goed werkt. Het model wordt in bijna alle gevallen automatisch herkend. Een verkeerde handmatige keuze kan de registerkaart verslechteren en leiden tot ontbrekende of niet beschikbare sensoren.

Stap 3

ScanintervalHoe vaak gegevens van de warmtepomp worden uitgelezen (in seconden). Kortere intervallen betekenen snellere updates, maar meer netwerkverkeer.
Ongebruikte sensoren verbergenMaakt geen entiteiten aan voor ongebruikte of niet-ondersteunde registers wanneer de laatste poll sentinelwaarden zoals −1,0, 255, 65535 of −32768 teruggeeft. Normale waarden van 0 blijven zichtbaar.
VerwarmingscircuitsSelecteer alle verwarmingscircuits die in je systeem zijn geïnstalleerd en actief zijn. Circuit A is altijd actief.
Aantal zonemodulesAantal geïnstalleerde IDM-zonemodules. Kies 0 als je systeem er geen heeft; bij een hoger aantal opent een extra pagina voor het aantal kamers van elke module. Als je het aantal verlaagt, worden de koppelingen voor zones die niet meer bestaan verwijderd.
FunctieprofielVanilla toont de kern-entiteiten van IDM. iDM Smart Energy & Comfort schakelt daarnaast berekende rendementssensoren, cyclusanalyse, detectie van korte cycli en de veilige bedieningen voor een boost van warm tapwater in. Het wijzigt zelf geen instellingen van de warmtepomp.
Automatisch laden van warm tapwater met pv-overschot inschakelenStart de veilige boost van warm tapwater automatisch wanneer het expliciet geselecteerde pv-overschot (of pv-productie min huisverbruik) beschikbaar is. Het doorsturen van extern vermogen moet met de bronentiteiten zijn ingesteld. Standaard uitgeschakeld.
Minimaal pv-overschotHet overschot moet bij de beoordeling boven deze drempel blijven. Er wordt niets geschreven als een bron ontbreekt, niet beschikbaar is of een ongeldige eenheid heeft.
Minimale laadtoestand van de batterijVoorkomt dat automatisch laden een batterij gebruikt die onder deze laadtoestand ligt. Laat de batterijbron in de externe vermogenskoppeling leeg om deze extra voorwaarde uit te schakelen.
Automatische doeltemperatuur warm tapwaterDe automatische boost verhoogt alleen het instelpunt van het warm tapwater en laat de systeemmodus ongewijzigd. Start in de modus Automatisch of Alleen warm water minstens 5 °C onder de doeltemperatuur; het vorige instelpunt wordt hersteld.
Duur van automatische boost warm tapwaterMaximale tijd voor één automatische boost van warm tapwater voordat de vorige toestand wordt hersteld.
Wachttijd automatiseringVolledige wachttijd nadat een automatische boost eindigt. Blijft bewaard na herladen en herstarten. Beperkt niet het eigen laden van de PV-verwarmingsbuffer door de Navigator, dat wordt gestart door doorgestuurde vermogenswaarden.
Automatisch doorsturen van extern vermogenMaakt het mogelijk bestaande Home Assistant-sensoren te selecteren en cyclisch te schrijven naar de IDM GLT-vermogensregisters.
Sensor voor dynamische stroomprijsOptionele lokale Home Assistant-sensor in EUR/kWh, €/kWh of ct/kWh. Als je deze selecteert, wordt de waargenomen energie berekend tegen het huidige tarief. Ontbrekende of ongeldige prijzen laten die energie zonder prijs in plaats van de vaste schatting te gebruiken.
Circuits met verschiltemperatuurregelingSelecteer alleen geïnstalleerde circuits waarvan het verwarmingssysteem in de Navigator op verschiltemperatuurregeling staat (bijvoorbeeld een houtkachel). Toont opslag, referentie, temperatuurverschil en status en verwijdert de normale verwarmingsbediening. Geen automatische detectie.
Sensor voor PV-voorspelling van de voorspellende adviseurOptionele Home Assistant-sensor met een uurlijkse voorspelling van de PV-productie (bijvoorbeeld PVForecast- of Solcast-attributen). Nodig voor aanbevelingen van warmwatervensters op basis van PV.

Stap 4

Temperatuursensor verwarmingscircuit AStuur deze sensor door naar hc_a_ext_room_temp.
Temperatuursensor verwarmingscircuit BStuur deze sensor door naar hc_b_ext_room_temp.
Temperatuursensor verwarmingscircuit CStuur deze sensor door naar hc_c_ext_room_temp.
Temperatuursensor verwarmingscircuit DStuur deze sensor door naar hc_d_ext_room_temp.
Temperatuursensor verwarmingscircuit EStuur deze sensor door naar hc_e_ext_room_temp.
Temperatuursensor verwarmingscircuit FStuur deze sensor door naar hc_f_ext_room_temp.
Temperatuursensor verwarmingscircuit GStuur deze sensor door naar hc_g_ext_room_temp.

Stap 5

VochtigheidssensorStuur deze sensor door naar ext_humidity.

Stap 6

Temperatuursensor warmteopslagStuur deze sensor door naar glt_heat_storage_temp.
Temperatuursensor koudeopslagStuur deze sensor door naar glt_cold_storage_temp.
Temperatuursensor onderkant warmwatervatStuur deze sensor door naar glt_dhw_temp_bottom.
Temperatuursensor bovenkant warmwatervatStuur deze sensor door naar glt_dhw_temp_top.

Modbus-verbinding mislukt

Volgende stap
Lokale web-pincode
Oorspronkelijk IP-adres van de warmtepomp voor webtoegangVereist wanneer Modbus een proxy gebruikt. Voer het adres van de warmtepomp zelf in.

Na het instellen

ScanintervalHoe vaak gegevens van de warmtepomp worden gelezen (in seconden). Kortere intervallen betekenen snellere updates maar meer netwerkverkeer.
Ongebruikte sensoren verbergenMaakt geen entiteiten aan voor ongebruikte of niet-ondersteunde registers wanneer de laatste poll sentinelwaarden zoals −1.0, 255, 65535 of −32768 teruggeeft. Normale waarden van 0 blijven zichtbaar.
VerwarmingscircuitsSelecteer alle verwarmingscircuits die in je systeem zijn geïnstalleerd en actief zijn. Circuit A is altijd actief.
Aantal zonemodulesAantal geïnstalleerde IDM-zonemodules. Selecteer 0 als je systeem er geen heeft. Bij een hoger aantal opent een extra pagina voor het aantal kamers van elke module. Als je het aantal verlaagt, worden de koppelingen voor zones die niet meer bestaan verwijderd.
FunctieprofielVanilla toont de kern-IDM-entiteiten. iDM Smart Energy & Comfort schakelt daarnaast berekende rendementssensoren, cyclusanalyse, detectie van korte cycli en de veilige bedieningselementen voor DHW-boost in. Het wijzigt zelf geen instellingen van de warmtepomp.
Automatisch laden van warm water met PV-overschot inschakelenStart de veilige DHW-boost automatisch wanneer het expliciet geselecteerde PV-overschot (of PV-productie min huisverbruik) beschikbaar is. Het doorsturen van extern vermogen moet met de bronentiteiten zijn geconfigureerd. Standaard uitgeschakeld.
Minimaal PV-overschotHet overschot moet bij de beoordeling boven deze drempel blijven. Er wordt niets geschreven als een bron ontbreekt, niet beschikbaar is of een ongeldige eenheid heeft.
Minimale laadtoestand van de accuVoorkomt dat automatisch laden een accu gebruikt die onder deze laadtoestand ligt. Laat de accubron in de externe vermogenskoppeling leeg om deze extra voorwaarde uit te schakelen.
Automatische doeltemperatuur voor warm tapwaterDe automatische boost verhoogt alleen de instelwaarde voor warm tapwater en laat de systeemmodus ongewijzigd. Start minstens 5 °C onder de doeltemperatuur in de modus Automatisch of Alleen warm water; herstelt de vorige instelwaarde.
Duur van automatische boost voor warm tapwaterMaximale tijd voor één automatische boost voor warm tapwater voordat de vorige toestand wordt hersteld.
Afkoeltijd van de automatiseringVolledige wachttijd nadat een automatische boost is beëindigd. Blijft bewaard na herladen en herstarten. Beperkt niet het eigen laden van de PV-verwarmingsbuffer door de Navigator, dat wordt gestart door doorgestuurde vermogenswaarden.
Automatisch doorsturen van extern vermogenMaakt het kiezen van bestaande Home Assistant-sensoren mogelijk en het cyclisch schrijven naar de IDM GLT-vermogensregisters.
Sensor voor dynamische elektriciteitsprijsOptionele lokale Home Assistant-sensor in EUR/kWh, €/kWh of ct/kWh. Als je er een kiest, wordt de waargenomen energie tegen het actuele tarief geprijsd. Ontbrekende of ongeldige prijzen laten die energie zonder prijs in plaats van de vaste schatting te gebruiken.
Circuits met verschiltemperatuurregelingKies alleen geïnstalleerde circuits waarvan het verwarmingssysteem in de Navigator op verschiltemperatuurregeling staat (bijvoorbeeld een houtkachel). Toont buffer, referentie, temperatuurverschil en status; verwijdert de normale verwarmingsbediening. Geen automatische detectie.
PV-voorspellingssensor voor de voorspellende adviseurOptionele Home Assistant-sensor met een PV-productievoorspelling per uur (bijvoorbeeld PVForecast of Solcast-attributen). Nodig voor op PV gebaseerde aanbevelingen voor warmwatervensters.
Temperatuursensor verwarmingscircuit AStuur deze sensor door naar hc_a_ext_room_temp.
Temperatuursensor verwarmingscircuit BStuur deze sensor door naar hc_b_ext_room_temp.
Temperatuursensor verwarmingscircuit CStuur deze sensor door naar hc_c_ext_room_temp.
Temperatuursensor verwarmingscircuit DStuur deze sensor door naar hc_d_ext_room_temp.
Temperatuursensor verwarmingscircuit EStuur deze sensor door naar hc_e_ext_room_temp.
Temperatuursensor verwarmingscircuit FStuur deze sensor door naar hc_f_ext_room_temp.
Temperatuursensor verwarmingscircuit GStuur deze sensor door naar hc_g_ext_room_temp.
VochtigheidssensorStuur deze sensor door naar ext_humidity.
Temperatuursensor warmtebufferStuur deze sensor door naar glt_heat_storage_temp.
Temperatuursensor koudebufferStuur deze sensor door naar glt_cold_storage_temp.
Temperatuursensor onderkant warmwaterboilerStuur deze sensor door naar glt_dhw_temp_bottom.
Temperatuursensor bovenkant warmwaterboilerStuur deze sensor door naar glt_dhw_temp_top.
Basisgroepsadres
ObjectgroepenAlleen objecten uit de geselecteerde groepen worden gepubliceerd en geregistreerd.
Overschrijvingen van groepsadressenEén register = adres per regel, bijvoorbeeld outdoor_temp = 1/2/3. Regels die met # beginnen worden genegeerd. Laat leeg om elk adres van het basisadres af te leiden.
Sensor voor PV-overschot
Sensor voor PV-productie
Sensor voor huisverbruik
Sensor voor laden/ontladen van de accuW of kW. Kies omkeren als de bron de openWB-conventie gebruikt (negatief betekent ontladen).
Sensor voor laadtoestand van de accuPercentage van 0 tot 100, ook met decimalen. Wordt afgerond naar een geheel getal voor het GLT-register. Maak dit veld leeg om het doorsturen te stoppen en de optionele HA-accuvoorwaarde te verwijderen; er wordt geen terugvalwaarde geschreven. De leessentinel -1 wordt niet verzonden.
Sensor voor vermogen van elektrisch verwarmingselement
Sensor voor bidirectioneel netvermogen

Teksten uit de code van Xerolux/idm-heatpump-hass. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenAdviseur: afwijking gedetecteerd, Adviseur: optimalisatie beschikbaar, Laatste compressorcyclus te kort, PV-overschotbedrijf, Compressor 1, Compressor 2, Compressor 3, Compressor 4, Koelvraag, Warmwatervraag, Communicatieprobleem, Warm tapwater bereikt streefwaarde niet en nog 26
KnoppenFouten bevestigen, AI-dagrapport (experimenteel), AI-efficiëntietoelichting (experimenteel), AI-gezondheidstoelichting (experimenteel), AI-weekrapport (experimenteel), Verbinding opnieuw laden, Warmwaterboost annuleren, Warmwaterboost starten, Prioriteitsladen warm water aanvragen
NummersAccuontlading (extern setpoint), Acculaadtoestand (extern setpoint), Bivalentiepunt 1, Bivalentiepunt 1 (2e warmtewekker), Bivalentiepunt 1 (3e warmtewekker), Bivalentiepunt 2, Bivalentiepunt 2 (2e warmtewekker), Bivalentiepunt 2 (3e warmtewekker), Cascadebivalentie koeling alternatief, Cascadebivalentie koeling parallel, Cascadebivalentie warm water alternatief, Cascadebivalentie warm water parallel en nog 31
SelectiesZonnemodus, Zonnebedrijfsmodus, Systeemmodus
SensorenAdviseur: warmteverlies gebouw, Adviseur: thermische traagheid gebouw, Adviseur: betrouwbaarheid, Adviseur: warmwateradvies, Adviseur: efficiëntiescore, Adviseur: verwachte COP, Adviseur: gezondheidsscore, Adviseur: 24-uursplan, Adviseur: reden voor bedrijf, Adviseur: optimale aanvoertemperatuur, Adviseur: voorspelde warmtevraag 24 uur, Adviseur: aanbevelingen en nog 265
SchakelaarsExterne koelvraag, Externe vraag naar warmwaterlading, Externe verwarmingsvraag, Eenmalige warmwatervraag
BoilersWarm tapwater, Warm water (Web)

Acties

Systeemmodus instellenStelt de bedrijfsmodus van de warmtepomp in.Velden: Modus
Fouten bevestigenBevestigt en wist actieve foutmeldingen op de warmtepomp.
Register schrijvenSchrijft een waarde rechtstreeks naar een Modbus-register. Alleen voor ervaren gebruikers: onjuiste waarden kunnen het systeem beschadigen.Velden: Registeradres, Waarde, Datatype, Risico accepteren
Extern klimaat instellenSchrijft de externe kamertemperatuur en optioneel de luchtvochtigheid naar de IDM GLT-registers.Velden: Verwarmingskring, Kamertemperatuur, Luchtvochtigheid
Extern vermogen instellenSchrijft externe vermogens- en accumetingen naar de IDM GLT-registers.Velden: PV-overschot, PV-productie, Huisverbruik, Accuontlading, Acculaadtoestand, Vermogen elektrisch verwarmingselement
KNX-groepsadressen exporterenGeeft de IDM KNX-objecttabel van deze controller terug, zodat deze in ETS opnieuw kan worden aangemaakt.Velden: Basisgroepsadres, Objectgroepen
Experimenteel AI-rapport genererenAlleen-lezen en apart ingeschakeld. Gebruikt de geselecteerde provider; voor de cloud is expliciete toestemming nodig. Maximaal 300 seconden lokaal, 120 seconden voor de cloud.Velden: IDM-integratie, Rapporttype
Experimenteel AI-dashboard exporterenGeeft een volledige dashboardconfiguratie terug met je huidige entiteit-ID's.Velden: IDM-integratie
Klok van de regelaar instellenStelt de klok van de Navigator in op de opgegeven tijd (standaard: nu) via de lokale webinterface.Velden: Datum en tijd

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Zonneboilersysteem niet gevonden, IDM-web-pincode niet ingesteld, Aanvullende IDM-webgegevens niet beschikbaar, Web-pincode van IDM Navigator geweigerd, Webadres van IDM Navigator niet gevonden, Webverbinding met IDM Navigator geweigerd, Webinterface van IDM Navigator reageerde niet, Webantwoord van IDM Navigator kon niet worden gelezen, Geen verbinding met IDM-warmtepomp mogelijk, IDM-hostnaam niet gevonden, IDM Modbus TCP-verbinding geweigerd, IDM Modbus TCP-verbinding verlopen, Geen Modbus-antwoord van IDM-warmtepomp, IDM-firmware of Modbus-functie niet ondersteund, IDM-verbinding gaf geen bruikbare gegevens terug

Uit de README

Monitor and control your IDM Navigator heat pump locally through Modbus TCP — without a cloud dependency.
Website · Documentation · Download · Community

Uit de README van Xerolux/idm-heatpump-hass, MIT License. Ingekort.