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.