:strip_icc():strip_exif()/u/2761/crop5d863c57a7d5d.jpeg?f=community)
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:
De plugin maakt 62 devices aan, georganiseerd in logische groepen:
Nieuwe sensoren in v2
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:
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.
/f/image/aaLVLofR9BqFpYCLr2Y0toa3.png?f=fotoalbum_large)
/f/image/MSPiVujsgOdRgxFuHaQVJ3tX.png?f=fotoalbum_large)
/f/image/6DQvCN3C3izqRa3GwOqpAPOP.png?f=fotoalbum_large)
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
- 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
De plugin maakt 62 devices aan, georganiseerd in logische groepen:
code:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| 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)
code:
1
2
3
| 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
2
3
4
5
6
7
8
9
10
| # 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.
:strip_exif()/f/image/aaLVLofR9BqFpYCLr2Y0toa3.png?f=user_large)
:strip_exif()/f/image/MSPiVujsgOdRgxFuHaQVJ3tX.png?f=user_large)
:strip_exif()/f/image/6DQvCN3C3izqRa3GwOqpAPOP.png?f=user_large)
Als het niet gaat zoals het moet, dan moet het maar zoals het gaat.
:strip_icc():strip_exif()/u/430082/crop5e9df3cc2d6b7_cropped.jpeg?f=community)