Alpha Innotec Luxtronik Warmtepomp Plugin v2 voor Domoticz

[Tijntje]

Graag deel ik mijn Luxtronik Warmtepomp Plugin v2 voor Domoticz. Dit is een complete herschrijving van mijn originele plugin, opnieuw opgebouwd met het moderne DomoticzEx framework.

De plugin koppelt Luxtronik 2.0/2.1 warmtepompregelaars aan Domoticz. Zelf gebruik ik hem voor mijn Alpha Innotec WZSV 92K3M.

Waarom een nieuwe plugin?
De originele plugin werkte prima, maar had beperkingen die niet opgelost konden worden zonder een volledige herschrijving:

• Legacy Domoticz framework met 256-device limiet
• Device IDs konden veranderen, waardoor "orphaned devices" ontstonden
• COP-waarden werden ook gelogd tijdens standby, wat de efficiëntie statistieken vertekende
• Geen ondersteuning voor meerdere warmtepompen

Belangrijkste verbeteringen

• DomoticzEx Framework: Modern Device/Unit model met callback ondersteuning
• Stabiele Device IDs: HardwareID-gebaseerde identifiers die nooit veranderen
• Slimme COP-tracking: Aparte metingen voor verwarming, tapwater en totaal - alleen gelogd tijdens stabiele werking
• Gated Sensors: Druk, superheat en ΔT-waarden worden alleen bijgewerkt tijdens actieve cycli
• Multi-instance ondersteuning: Meerdere plugin instances voor huizen met meer dan één warmtepomp
• Beveiligde schrijfacties: Alle schrijfcommando's gevalideerd tegen een expliciete allowlist
• Meertalig: Nederlands, Engels, Duits, Frans en Pools

Device Overzicht
De plugin maakt 62 devices aan, georganiseerd in logische groepen:

code:

Groep                  | Units     | Omschrijving
-----------------------|-----------|---------------------------------------------
Status                 | 1         | Werkingsmodus (Verwarmen/Tapwater/Koelen/Standby)
Bediening              | 10-16     | Verwarmingsmodus, tapwater, koeling, setpoints
Elektrisch vermogen    | 30-32     | Verbruik (totaal, verwarming, tapwater)
Thermisch vermogen     | 40-42     | Warmteproductie (totaal, verwarming, tapwater)
Efficiëntie            | 50-52     | COP-waarden (totaal, verwarming, tapwater)
Verwarmingscircuit     | 60-67     | Aanvoer/retour temp, ΔT, pompsnelheid, debiet
Tapwater               | 80        | Boilertemperatuur
Omgeving               | 90-93     | Buitentemperatuur, kamertemperatuur
Broncircuit            | 100-106   | Brine/bodem temps, ΔT, pomp, debiet
Menggroepen            | 120-131   | MG1 en MG2 temperaturen
Compressor             | 140-144   | Frequentie, capaciteit, min/max freq
Koudemiddel            | 160-167   | Heetgas, zuig, persleiding, verdamp/condens temps
Statistieken           | 180-185   | Draaiuren, starts, cyclustijd
Diagnostiek            | 200-201   | Foutenteller, koeling toegestaan

Nieuwe sensoren in v2

• Compressor draaiuren en aantal starts
• Laatste cyclusduur
• Capaciteitsbenutting (%)
• Persleiding-, verdampings- en condensatietemperatuur
• Controller spread targets (ΔT setpoints)
• Verwarmings- en brondebiet
• Modus-specifieke draaiuren (verwarming, tapwater, koeling)

Installatie

code:

cd /pad/naar/domoticz/plugins
git clone https://github.com/Rouzax/luxtronik-domoticz-plugin-v2.git
sudo systemctl restart domoticz

In Domoticz: Instellingen → Hardware → Toevoegen, selecteer "Luxtronik Heat Pump Controller v2", vul het IP-adres en poort (standaard 8889) van je warmtepomp in.

Migratie vanaf v1
De nieuwe plugin gebruikt een andere key (luxtronikex i.p.v. luxtronik), dus beide kunnen naast elkaar draaien. Migratiescripts zijn meegeleverd om je historische data over te zetten:

code:

# 1. Maak eerst een backup!
sudo systemctl stop domoticz
cp domoticz.db domoticz.db.backup

# 2. Preview wat gemigreerd wordt
sqlite3 domoticz.db < plugins/luxtronikex/migration/discover.sql

# 3. Voer migratie uit
sqlite3 domoticz.db < plugins/luxtronikex/migration/migrate.sql
sudo systemctl start domoticz

De migratie werkt op basis van Unit IDs (niet device-namen), dus het werkt ongeacht je taalinstelling. Alle temperatuurhistorie, energiemeters, percentages en schakelaar-logs worden overgezet.

COP Nauwkeurigheid
Voor zinvolle efficiëntiestatistieken, schakel Instellingen → Log History → "Only add newly received values to the Log" in binnen Domoticz.

De plugin rapporteert COP alleen tijdens stabiele werking (compressor draait op of boven de minimale frequentie, niet in opstart of standby). Gecombineerd met de Domoticz-instelling zorgt dit ervoor dat je maand- en jaargemiddelden de werkelijke efficiëntie weergeven, niet vertekend door standby-periodes.

[bello2011]

[quote]Tijntje schreef op donderdag 4 december 2025 @ 15:20:
Graag deel ik mijn Luxtronik Warmtepomp Plugin v2 voor Domoticz. Dit is een complete herschrijving van mijn originele plugin, opnieuw opgebouwd met het moderne DomoticzEx framework.

Hoi,
Wanneer ik deze plugin ga gebruiken, blijft dan de history van gemeten waarden bestaan of begin je hiermee opnieuw?
Het script welk ik nu gebruik is wp_data.py. Dit heb ik in 2021 ooit van dit forum gehaald.

[Tijntje]

bello2011 schreef op maandag 12 januari 2026 @ 17:14:
[quote]Tijntje schreef op donderdag 4 december 2025 @ 15:20:
Graag deel ik mijn Luxtronik Warmtepomp Plugin v2 voor Domoticz. Dit is een complete herschrijving van mijn originele plugin, opnieuw opgebouwd met het moderne DomoticzEx framework.

Hoi,
Wanneer ik deze plugin ga gebruiken, blijft dan de history van gemeten waarden bestaan of begin je hiermee opnieuw?
Het script welk ik nu gebruik is wp_data.py. Dit heb ik in 2021 ooit van dit forum gehaald.

Nee in heb ik alleen migratie scripts gemaakt voor mijn oude plugin naar de nieuwe.
Opzich als je de oude ID en namen hebt, is het met chatgpt of claude niet heel moeilijk om een migratie script te maken voor je.

[Hillberg]

Is het mogelijk om het debiet van het brinemengsel te meten? Ik bedoel de liters/uur snelheid van het mengsel dat stroomt vanaf de secondaire kant van de warmtewisselaar naar de warmtepomp en weer terug? Ik heb een Alpha Innotec Alterra SWCV 62K3.

Wat ik wil weten is hoeveel vermogen van de warmtewisselaar naar de warmtepomp gaat. Ook wil ik graag debiet weten van het water uit de WKO maar er zit geen sensor aan die kant.

[Tijntje]

Hillberg schreef op vrijdag 23 januari 2026 @ 12:02:
Is het mogelijk om het debiet van het brinemengsel te meten? Ik bedoel de liters/uur snelheid van het mengsel dat stroomt vanaf de secondaire kant van de warmtewisselaar naar de warmtepomp en weer terug? Ik heb een Alpha Innotec Alterra SWCV 62K3.

Wat ik wil weten is hoeveel vermogen van de warmtewisselaar naar de warmtepomp gaat. Ook wil ik graag debiet weten van het water uit de WKO maar er zit geen sensor aan die kant.

Er zitten al een hoop flow rate devices in de plugin:

• https://github.com/Rouzax...ating-circuit-units-60-67
• https://github.com/Rouzax...rce-circuit-units-100-106

Zijn de metrcis die je zoekt wel beschikbaar in de web GUI van de wamtpe pomp.
Als je ze weet te mappen via https://github.com/Bouni/python-luxtronik kan ik ze eenvoudig toevoegen

[Hillberg]

Ik heb middels een Python script alle waarden en omschrijvingen van de metrics uitgelezen. Er zit geen sensor in de Luxtronik die de flow van het brinemengsel meet

[Tijntje]

Hillberg schreef op donderdag 29 januari 2026 @ 10:55:
Ik heb middels een Python script alle waarden en omschrijvingen van de metrics uitgelezen. Er zit geen sensor in de Luxtronik die de flow van het brinemengsel meet

Dan zo ik het ook niet weten hoe ik hem naar boven moet halen.

[Tijntje]

v2.0.1

Kleine update gepusht naar de repository.

De belangrijkste toevoeging is een instelbare maximale COP-limiet. Wellicht herkenbaar: af en toe krijg je kortstondige COP-pieken tijdens overgangsmomenten — even een moment waarop de verhouding vermogen/warmte een onrealistisch hoge waarde oplevert voordat het systeem stabiliseert. Zelfs als zo'n piek maar een paar seconden duurt, trekt het je dag- en maandgemiddelden omhoog en worden je efficiëntiestatistieken onbetrouwbaar.

Je kunt nu een maximale COP-drempel instellen in de hardwareconfiguratie (Mode1 veld). Elke COP-waarde boven de limiet wordt geblokkeerd en niet gelogd. Zet hem op 0 of laat het veld leeg om filtering uit te schakelen. Een waarde rond 10–30 is voor de meeste bodemgebonden systemen een goed startpunt, maar je kent je eigen installatie het best.

De filtering werkt samen met het bestaande steady-state filter (compressor moet op of boven de minimale frequentie draaien), dus met die twee samen krijg je een schone COP-historie die daadwerkelijk de werkelijke efficiëntie weergeeft.

Overige fixes in deze release:

• Single-connection refactor — heartbeat reads (READ_CALCUL + READ_PARAMS) delen nu één TCP-verbinding i.p.v. twee per cyclus
• TCP partial read kwetsbaarheid opgelost die bij slechte netwerkverbinding stilletjes data kon corrumperen
• Retry-logica gecorrigeerd — de oude MAX_RETRIES=1 betekende in feite nul retries
• Nettere teardown bij plugin stop

Updaten:

code:

cd /pad/naar/domoticz/plugins/luxtronik-domoticz-plugin-v2
git pull
sudo systemctl restart domoticz

Geen migratie nodig, geen device-wijzigingen — gewoon pullen en herstarten.

[Tijntje]

v2.0.3

Twee nieuwe features in deze release: pompvermogen-compensatie en koudemiddel-diagnostiek.

Pompvermogen-compensatie

Het vermogen dat de regelaar rapporteert (en dus ook de COP) meet alleen het compressorvermogen — bevestigd door de voetnoot "alleen compressor" in de handleiding. De
circulatiepompen (HUP en VBO) zitten op aparte voedingen (X8 vs X9/X10) en worden niet meegeteld. Bij mijn WZSV 92K3M op een typisch werkpunt (HUP 68%, VBO 12%) is dat zo'n
30W aan niet-meegerekend pompvermogen, waardoor de COP circa 15% te optimistisch uitvalt.

Je kunt nu pompvermogen-compensatie inschakelen in de hardwareconfiguratie. Het schat het pompvermogen op basis van de snelheidspercentages die al beschikbaar zijn in het
protocol, met een kwadratisch model, en telt dat op bij het compressorvermogen vóórdat je power- en COP-devices de waarde zien. Al je bestaande devices tonen automatisch
gecorrigeerde waardes — geen nieuwe devices nodig.

Instellingen:

• Pump Power Compensation — On/Off (standaard: Off)
• Pump Power Ranges (W) — HUP min, HUP max, VBO min, VBO max (standaard: 2,60,3,140 voor WZSV 92K3M)

Kijk in de technische gegevens van je handleiding bij "Opgenomen vermogen circulatiepomp verwarmingscircuit | warmtebron" voor de juiste waarden voor jouw model.

Koudemiddel-diagnostiek

Vier nieuwe devices voor wie meer inzicht wil in het koudemiddelcircuit. Allemaal standaard op unused — activeer wat je wilt via Setup → Devices:

• Condensatietemperatuur — uit firmware-berekening (gated)
• Onderkoelings — condensatietemperatuur minus vloeistoflijntemperatuur, indicator voor koudemiddelvulling (gated)
• Condensatiedruk — uit firmware-berekening (gated)
• Koeling vrijgave timer — afteltimer tot koeling wordt vrijgegeven (UU:MM:SS)

De gated devices updaten alleen tijdens steady-state bedrijf, dus je krijgt geen onzinwaarden als de compressor stilstaat.

Updaten:

code:

cd /pad/naar/domoticz/plugins/luxtronik-domoticz-plugin-v2
git pull
sudo systemctl restart domoticz

Geen migratie nodig, geen device-wijzigingen — gewoon pullen en herstarten. Nieuwe devices verschijnen als unused; activeer wat je wilt.

[Tijntje]

Luxtronik-plugin voor Domoticz: v3.2.0, en alles wat er sinds 2.0.3 bij is gekomen

Het is een tijdje stil geweest in dit topic, maar niet in de code. Sinds v2.0.3 zijn er zeven releases verschenen en is er inmiddels een echte documentatiesite. Hieronder de hoogtepunten, de nieuwste eerst.

Documentatie: rouzax.github.io/luxtronik-domoticz-plugin
Download en release notes: GitHub releases

Eerst een correctie op v2.0.3

De koudemiddel-devices die ik in 2.0.3 aankondigde (condensatietemperatuur, onderkoeling en condensatiedruk) klopten niet. Toen ik protocoldumps naast de webinterface en de handleiding legde, bleek dat die adressen geen sensoren waren: het waren instellingen van de regelaar (zoals de maximale heetgastemperatuur van 115 °C) en het firmwarenummer van de ruimtebediening. Onderkoeling is op deze regelaar simpelweg niet te meten, want er zit geen vloeistoflijnsensor in. Die drie devices zijn in 2.1.0 vervangen door waardes die wel kloppen:

• Condensatietemperatuur, nu de verzadigingstemperatuur die de regelaar zelf uit de hogedruk berekent
• Refrigerant lift, condensatie minus verdamping: de grootste factor in je COP
• Condensing-supply ΔT, discharge headroom (marge tot de heetgas-uitschakeling), compressieverhouding en frequentie-headroom

Excuus aan wie op de oude waardes heeft zitten turen.

v3.2.0: looptijd per dag, week en maand

Wat ik zelf het meest miste: hoe lang heeft de warmtepomp gisteren eigenlijk gedraaid, en hoe vaak? De oude devices lieten alleen het totaal sinds installatie zien, een lijn die alleen maar stijgt. Units 186 t/m 192 lezen dezelfde tellers uit de regelaar, maar dan als Domoticz-counter. Op de kaart zie je de waarde van vandaag, en in de log staan staafgrafieken per dag, week, maand en jaar. Voor de compressor, het aantal starts, verwarmen, tapwater en het elektrische bijverwarmingselement. Dat laatste is handig om te zien op welke dagen het element bijsprong.


Benieuwd naar het theme in de screenshots? Dat is Machinon, dat ik ook onderhoud.

Op Domoticz 2026.4 staan de looptijden in minuten, omdat een plugin daar de deler van een counter nog niet kan instellen. Daarvoor heb ik een PR bij Domoticz zelf gedaan, en die is inmiddels gemerged: vanaf beta build 18539 maakt de plugin de counters direct in uren aan. Wil je een bestaande counter toch in uren, zet dan in het bewerkscherm Counter Divider op 60 en Unit op h. De plugin blijft daar daarna vanaf.

v3.2.0: health bars

Vanaf Domoticz 2026.4 kunnen kaarten een gekleurde balk tonen. De plugin vult die nu voor acht devices: heetgas, aanvoer, tapwater, oververhitting, de drie COP's en de duur van de laatste compressorrun.



Ik wilde geen grenzen verzinnen. Elke grens komt dus uit je eigen regelaar of uit de documentatie:

• Heetgas wordt rood vanaf de T-HG max uit je regelaar (live uitgelezen, bij mij 115 °C)
• Aanvoer wordt rood vanaf de Vorlauf max uit je regelaar, en onder 16 °C (de storingsgrens bij koelen)
• Tapwater is oranje onder 50 °C (legionella-groeigebied) en rood boven 65 °C
• Oververhitting wordt rood onder 2 K (storing 765)
• Laatste run is rood onder 6 minuten en oranje tot 30 minuten. Dat komt uit de eigen richtlijn van Alpha Innotec over pendelen

Heb je zelf al balken getekend, of pas je ze later aan, dan blijft de plugin eraf. Retour, brine en bronflow hebben bewust geen balk. In de test werd de retour bij elke tapwaterrun rood, Domoticz tekent een as die door 0 °C gaat vanuit het midden, en de flowsensor meet in normaal bedrijf onder het minimum uit de handleiding. Een balk die vals alarm geeft is erger dan geen balk.

v3.1.0: storingen en een paar belangrijke fixes

• Laatste storing toont de nieuwste storing uit het geheugen van de regelaar als code, tekst en tijd, bijvoorbeeld "790: Ernstige inverter fout (2022-07-15 13:18)". De Nederlandse teksten komen uit de handleiding. Komt er een nieuwe storing bij, dan krijg je één melding via je Domoticz-notificaties.
• Firmware en warmtepomptype als devices (standaard unused).
• Werkmodus kent nu alle acht toestanden van de regelaar. Een EVU-blokkade stond eerder als "Koelen" in beeld.
• Met pompcompensatie aan bleef de werkmodus op "Verwarmen" hangen terwijl alleen de pompen liepen. Opgelost: Idle kijkt nu naar het compressorvermogen.
• De gated devices (COP, druk, oververhitting enzovoort) wachtten na het opstarten maar zo'n 40 seconden in plaats van 2 minuten. Daardoor kwamen opstartwaardes in je grafieken en COP-gemiddeldes. Nu meet de plugin de wachttijd echt in tijd.
• Veiligheid: een selectorniveau dat niet bestaat, bijvoorbeeld uit een script, werd eerder omgezet naar "Automatisch" of een naburige stand en naar de warmtepomp geschreven. Dat wordt nu geweigerd en gelogd als WRITE BLOCKED.

v3.0.0: nieuwe instellingenpagina en update-check

• Pompcompensatie kies je nu gewoon op model (WZSV 62, 92, 122 of 162, met de waardes uit de handleiding), of op Custom met vier losse velden.
• Taal staat standaard op "Zelfde als Domoticz".
• Een dagelijkse update-check meldt een nieuwe release één keer, in de log en via je notificaties. Er gaat niets over jou of je warmtepomp naar buiten, hij installeert niets, en je kunt hem uitzetten.
• Minimaal Domoticz 2026.1 en Python 3.11. Zit je nog op een oudere Domoticz, blijf dan op 2.2.0.

v2.2.0 en v2.1.2

• Een device dat je zelf hebt hernoemd, wordt nooit meer teruggezet, ook niet als je de taal van de plugin wijzigt. Hetzelfde geldt voor omschrijvingen en selectorlabels.
• Na een herstart van de plugin konden de bedienings-devices (modi en setpoints) stilletjes ophouden met werken. Dat is in 2.1.2 opgelost.

Upgraden vanaf 2.0.3

De repository heet nu luxtronik-domoticz-plugin (zonder -v2). Oude links worden doorgestuurd, maar de nette installatie is nu een map luxtronikex op de dist-branch, met alleen de bestanden die Domoticz nodig heeft. Je devices en historie hangen aan de hardware-entry in Domoticz, niet aan de map, dus overstappen kost je niets:

code:

sudo systemctl stop domoticz
cd /pad/naar/domoticz/plugins
rm -rf luxtronik-domoticz-plugin-v2
git clone -b dist https://github.com/Rouzax/luxtronik-domoticz-plugin.git luxtronikex
sudo systemctl start domoticz

Updaten gaat daarna met git pull in die map. Liever geen git? Pak dan de zip uit de release uit in je plugins-map. De plugin staat ook in PyPluginStore en pp-manager als luxtronikex.

Let op bij de overstap naar 3.x: de instellingen zijn naar nieuwe velden verhuisd. Je oude waardes blijven gewoon werken, maar de hardwarepagina toont de standaardwaardes. Kies je waardes dus opnieuw voordat je op Update drukt. Tot je dat doet, zet de plugin je oude waardes bij elke start in de log.

Vragen, ideeën of rare waardes op jouw warmtepomp? Laat het hier weten of maak een issue aan op GitHub.