TapHome
Community Beta Integrazione HVAC

alpha innotec Luxtronik 2.1 Smart Home Interface (SHI)

Pompe di calore alpha innotec con regolatore Luxtronik 2.1 in TapHome tramite Modbus TCP (porta 502) attraverso la Smart Home Interface integrata, attivata nel menu del regolatore — senza gateway né moduli aggiuntivi. Temperature, setpoint e modalità di controllo di ACS e MC1, blocco riscaldamento e ACS, ACS extra, limitazione della potenza (Smart Grid, §14a) ed energia elettrica e termica.

Modbus TCP20 dispositiviRevisione 1.0 Ultimo aggiornamento: 12 novembre 2026

Inviato da Novobilský

alpha innotec Luxtronik 2.1 Smart Home Interface (SHI)

Importa nell'app TapHomeHardware › Modbus › Aggiungi da modello

Scarica template
In questa pagina

Indirizzo di rete

TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo.

Preparazione della rete

Guida all'integrazione

La Smart Home Interface (SHI) di alpha innotec è un’interfaccia software integrata nel regolatore di riscaldamento e pompa di calore Luxtronik 2.1. Consente a un sistema di gestione energetica o di smart home di leggere e scrivere setpoint e parametri selezionati della pompa di calore tramite Modbus TCP sulla porta 502 — non serve alcun modulo hardware aggiuntivo, basta un collegamento Ethernet al regolatore e l’interfaccia attivata nel suo menu.

Questo template della community è pensato per un’installazione tipica con un circuito miscelato (MC1). Legge le temperature dell’impianto, controlla i setpoint dell’acqua calda sanitaria (ACS) e del riscaldamento, blocca su richiesta il riscaldamento o l’ACS, limita la potenza assorbita dalla pompa di calore (Smart Grid / §14a EnWG) e mostra l’energia elettrica e termica.

Collegamento hardware

La presa di rete è la presa sinistra nella parte inferiore dell’unità di controllo Luxtronik (la posizione esatta dipende dalla variante della pompa di calore). Durante i lavori di collegamento elettrico occorre far passare attraverso l’unità un cavo di rete schermato di categoria 6; il suo connettore RJ45 va inserito in questa presa sinistra. L’altra estremità si collega alla stessa rete locale di TapHome Core.

alpha innotec raccomanda di proteggere il regolatore da attacchi e accessi non autorizzati con un router o un firewall e, nelle reti aziendali o comunali, di utilizzare una rete locale separata o una VLAN. Modbus TCP è un protocollo datato con un basso livello di sicurezza — non aprire la porta 502 verso internet; le connessioni in ingresso da internet non sono necessarie. Mantenere aggiornato il software del regolatore.

Configurazione

Tutte le impostazioni si effettuano sul display del regolatore, nell’area di programma Service → Control panel. Alcune voci di menu sono visibili o modificabili solo con l’accesso ai dati da installatore o da assistenza tecnica. Se le voci indicate di seguito non sono disponibili, alzare l’accesso ai dati a Installer con il codice numerico nell’area di programma Service (“Determine data access” nel manuale d’uso del regolatore) e, a lavoro terminato, riportarlo su User.

Impostazioni di rete

Il regolatore deve avere un indirizzo fisso nella rete locale, perché TapHome si collega a esso tramite indirizzo IP.

  1. Aprire Service → Control panel → DHCP.
  2. Scegliere una delle opzioni:
    • Client — il regolatore ottiene l’indirizzo dal server DHCP (router). In questo caso creare nel router una prenotazione DHCP per il regolatore, in modo che l’indirizzo non cambi.
    • Off — l’indirizzo si imposta manualmente. Aprire quindi Control panel → IP-address, inserire IP, subnetmask, broadcast, gateway, DNS 1 e DNS 2 in base alla rete locale e salvare. L’indirizzo IP deve rientrare nell’intervallo della rete (ad esempio gateway 192.168.2.1 e maschera 255.255.255.0 consentono da 192.168.2.2 a 192.168.2.254, se non utilizzati da un altro dispositivo).
  3. Leggere l’indirizzo IP del regolatore nella schermata IP-address e annotarlo per TapHome.

Con DHCP impostato su Client (o Server), i valori nella schermata IP-address sono di sola lettura; si possono modificare solo con DHCP Off. Il passaggio dell’opzione DHCP a Server o a Off richiede sempre un riavvio (reset) del regolatore.

Impostazioni di rete del Luxtronik 2.1: opzione DHCP Client e schermata dell'indirizzo IP con le voci IP, subnet mask, broadcast, gateway e DNS

Attivazione della Smart Home Interface (Modbus TCP)

  1. Aprire Service → Control panel → Connectivity → Smart Home Interface.
  2. Selezionare Settings e impostare ModBus TCP su On.
  3. Confermare con il segno di spunta per salvare l’impostazione.

alpha innotec prescrive di disattivare la funzione Smart Grid del regolatore quando si usa la SHI — altrimenti le due funzioni possono influenzarsi a vicenda. Nella SHI deve scrivere un solo sistema: quando più partecipanti SHI scrivono lo stesso punto dati, il regolatore segnala l’errore 816 e mantiene la SHI disattivata finché l’errore è presente.

Percorso di menu del Luxtronik 2.1: Connectivity, Smart Home Interface, Settings con ModBus TCP impostato su On, più le schermate di stato e dei dati ricevuti

Il menu SHI è disponibile nel software del Luxtronik 2.1 dalla versione V3.90. La modalità di riscaldamento generale e la funzione ACS extra usate da questo template richiedono il software V3.92 o successivo — se il software del regolatore è più vecchio, aggiornarlo prima.

Verifica della connessione sul regolatore

In Smart Home Interface → status, la riga ModBus TCP mostra lo stato dell’interfaccia:

StatoSignificato
OffLa SHI è disattivata
StandbyLa SHI è attivata, ma da almeno 10 minuti non è stata rilevata alcuna lettura o scrittura
ActiveLa SHI è attivata ed è stata rilevata una lettura o scrittura negli ultimi 10 minuti

Smart Home Interface → Received data elenca ogni setpoint e parametro scritto tramite SHI (modalità di riscaldamento, setpoint e offset del riscaldamento, modalità, setpoint e offset dell’ACS…). I valori non scritti o azzerati mostrano ---. Mentre la SHI è attiva ed è stato scritto un valore, sulla schermata di navigazione del regolatore compare un simbolo SHI; selezionandolo si apre la panoramica dei dati ricevuti.

Parametri di connessione

ParametroValore
ProtocolloModbus TCP
Porta TCP502
Indirizzo IPindirizzo del regolatore (vedi Impostazioni di rete)
Modbus slave ID1 (predefinito del template)

In TapHome, aggiungere il modulo da questo template e inserire l’indirizzo IP e il Modbus slave ID del regolatore.

Funzionalità del dispositivo

Stato dell’impianto e diagnostica

Il modulo decodifica lo stato di funzionamento della pompa di calore (riscaldamento, ACS, standby e altri) e i generatori di calore attivi — compressori VD1 e VD2 e resistenze integrative da ZWE1 a ZWE3. Il numero di errore del regolatore viene mostrato come errore sul modulo. Richiesta di riscaldamento e di ACS, funzioni abilitate, stati della pompa della salamoia e delle pompe di circolazione del riscaldamento, di MC1 e dell’ACS, versione del software e ore di funzionamento sono disponibili come attributi del modulo.

Temperature

Sensori di temperatura separati mostrano la temperatura di ritorno e il relativo setpoint, la temperatura di ritorno all’accumulo inerziale, la temperatura di mandata, la temperatura esterna e la sua media sulle 24 ore e le temperature di ingresso e uscita della sorgente di calore (salamoia o aria).

Acqua calda sanitaria

  • Termostato ACS — temperatura attuale e setpoint dell’ACS; il setpoint può essere scritto da TapHome. Temperatura ACS minima e massima sono attributi.
  • Modalità di controllo ACS — come TapHome influenza l’ACS: nessuna influenza, setpoint, offset di temperatura o livello operativo. Per scrivere il setpoint ACS, impostare prima questa modalità su Setpoint.
  • Blocco ACS — sospende temporaneamente la produzione di ACS, ad esempio durante una tariffa elettrica costosa.
  • ACS extra — avvia una produzione di ACS una tantum; al termine il regolatore disattiva la funzione da solo. Temperatura obiettivo, durata e tempo residuo sono attributi.

Riscaldamento

  • Modalità di controllo riscaldamento — come TapHome influenza la temperatura di ritorno del circuito di riscaldamento: nessuna influenza, setpoint di ritorno, offset di temperatura o livello operativo. Si applica solo quando la modalità di riscaldamento generale è impostata su individuale (per circuito).
  • Modalità di riscaldamento generale — controllo individuale per circuito, offset globale o livello operativo globale per tutti i circuiti contemporaneamente.
  • Blocco riscaldamento — impedisce il funzionamento in riscaldamento.

Circuito miscelato MC1

  • Termostato di mandata MC1 — temperatura di mandata attuale e obiettivo del circuito miscelato MC1; il setpoint può essere scritto da TapHome. Temperatura di mandata minima e massima sono attributi.
  • Modalità di controllo MC1 — nessuna influenza, setpoint di mandata, offset di temperatura o livello operativo.

Energia

  • Energia elettrica — energia elettrica totale consumata e potenza elettrica assorbita attuale.
  • Energia termica riscaldamento — potenza termica ed energia termica fornita per il riscaldamento. Energia elettrica per riscaldamento e ACS, energia termica per ACS, energia termica totale e potenza assorbita minima prevista sono attributi.

Limitazione della potenza (Smart Grid / §14a)

L’interruttore Limite di potenza (Power limit) seleziona la modalità di limitazione:

  • Nessun limite (No limit) — funzionamento normale.
  • Limite morbido (Soft limit, ad esempio surplus fotovoltaico) — la pompa di calore cerca di restare sotto la potenza impostata; quando il riscaldamento o l’ACS scende sotto la propria temperatura limite, ignora il limite.
  • Limite rigido (Hard limit) — limitazione secondo il §14a della legge tedesca sul settore energetico (EnWG).

Il valore limite (0–30 kW) si imposta con l’azione Imposta limite di potenza (Set power limit). Il limite attuale e i segnali EVU1 ed EVU2 sono attributi.

TapHome interroga il regolatore in modo continuo, il che mantiene lo stato SHI su Active. Il menu Received data sul regolatore mostra quali valori scritti sono attualmente applicati.

Risoluzione dei problemi

Nessun dato in TapHome

  • Verificare che il regolatore sia collegato alla rete e che l’indirizzo IP in TapHome corrisponda alla schermata IP-address.
  • Verificare che ModBus TCP sia impostato su On in Smart Home Interface → Settings.
  • Verificare lo slave ID in TapHome e che la porta 502 non sia bloccata da un firewall tra TapHome e il regolatore.

Lo stato SHI mostra Standby

  • Da 10 minuti nessuna lettura o scrittura ha raggiunto il regolatore — verificare la connessione di rete e che il modulo TapHome sia in funzione.

I setpoint scritti non vengono applicati o tornano ai valori predefiniti

  • Aprire Received data — un valore mostrato come --- non è stato scritto o è stato azzerato.
  • Prima di scrivere una temperatura, verificare che la relativa modalità di controllo (ACS, riscaldamento o MC1) sia impostata su Setpoint.
  • Verificare che la funzione Smart Grid del regolatore sia disattivata.

Errore 816 sul regolatore

  • Più partecipanti SHI scrivono lo stesso punto dati. Lasciare un solo sistema che scrive nella SHI; la SHI resta disattivata finché l’errore è presente.

La temperatura ACS mostra 75,0 °C

  • Questo valore sostitutivo compare quando il sensore ACS è guasto o quando l’impianto utilizza un ingresso termostato al posto di un sensore. Con un ingresso termostato, ignorare questo valore.

Un valore indica 32767

  • 32767 significa che il registro o la funzione non è disponibile — ad esempio la funzione non è configurata, il regolatore è spento o occorre prima impostare un’altra modalità. Il dispositivo mostra quindi dati non validi.

Dispositivi disponibili 20

Questi dispositivi compaiono in TapHome dopo l'importazione.

Luxtronik 2.1 SHI Modulo
Attributi di servizio
Stav systemu
Pozadavek topeni
Pozadavek TUV
Topeni povoleno
TUV povoleno
Mixovaci okruh MC1 — topeni povoleno
Pumpa solanky
Obehova pumpa MC1
Obehova pumpa topeniho okruhu
Obehova pumpa TUV
Verze softwaru
Provozni hodiny TC
Provozni hodiny topeni
Provozni hodiny TUV
Azioni di servizio
Nastavit limit prikonu

Luxtronik 2.1 SHI

Lettura (modulo)
VAR err := MODBUSR(A, 10201, UInt16);
IF(err != 0) ADDERROR(1, "Chyba systemu c. " + TOSTRING(err)); END
VAR state := MODBUSR(A, 10002, UInt16);
IF(state = 0) ADDINFO(0, "Stav: Vypnuto"); END
IF(state = 1) ADDINFO(1, "Stav: Topeni"); END
IF(state = 2) ADDINFO(2, "Stav: TUV"); END
IF(state = 3) ADDINFO(3, "Stav: Ohrev MVS"); END
IF(state = 5) ADDINFO(5, "Stav: Pohotovost"); END
IF(state = 7) ADDINFO(7, "Stav: Externi zdroj"); END
VAR gen := MODBUSR(A, 10000, UInt16);
IF(GETBIT(gen, 0)) ADDINFO(10, "Aktivni zdroj: VD1"); END
IF(GETBIT(gen, 1)) ADDINFO(11, "Aktivni zdroj: VD2"); END
IF(GETBIT(gen, 2)) ADDINFO(12, "Aktivni zdroj: ZWE1"); END
IF(GETBIT(gen, 3)) ADDINFO(13, "Aktivni zdroj: ZWE2"); END
IF(GETBIT(gen, 4)) ADDINFO(14, "Aktivni zdroj: ZWE3"); END
Attributi di servizio
Stav systemu
SWITCH(MODBUSR(A, 10002, UInt16), 0, "Vypnuto", 1, "Topeni", 2, "TUV", 3, "Ohrev MVS", 4, "Chlazeni", 5, "Pohotovost", 6, "Pasivni chlazeni", 7, "Externi zdroj", "Neznamy")
Pozadavek topeni
IF(MODBUSR(A, 10003, UInt16) != 0, "Aktivni", "Neaktivni")
Pozadavek TUV
IF(MODBUSR(A, 10004, UInt16) != 0, "Aktivni", "Neaktivni")
Topeni povoleno
IF(MODBUSR(D, 10000, Bool), "Ano", "Ne")
TUV povoleno
IF(MODBUSR(D, 10001, Bool), "Ano", "Ne")
Mixovaci okruh MC1 — topeni povoleno
IF(MODBUSR(D, 10006, Bool), "Ano", "Ne")
Pumpa solanky
IF(MODBUSR(A, 10350, UInt16) != 0, "Bezi", "Stoji")
Obehova pumpa MC1
IF(MODBUSR(A, 10351, UInt16) != 0, "Bezi", "Stoji")
Obehova pumpa topeniho okruhu
IF(MODBUSR(A, 10354, UInt16) != 0, "Bezi", "Stoji")
Obehova pumpa TUV
IF(MODBUSR(A, 10355, UInt16) != 0, "Bezi", "Stoji")
Verze softwaru
"V" + TOSTRING(MODBUSR(A, 10400, UInt16)) + "." + TOSTRING(MODBUSR(A, 10401, UInt16)) + "." + TOSTRING(MODBUSR(A, 10402, UInt16))
Provozni hodiny TC
TOSTRING(MODBUSR(A, 10404, UInt32)) + " h"
Provozni hodiny topeni
TOSTRING(MODBUSR(A, 10406, UInt32)) + " h"
Provozni hodiny TUV
TOSTRING(MODBUSR(A, 10408, UInt32)) + " h"
Azioni di servizio
Nastavit limit prikonu
Parametri: Limit (0–30 Lim)
MODBUSWNE(SH, 10041, UInt16, Lim * 10);
Teplota zpetneho potrubi Sensore di temperatura

Teplota zpetneho potrubi

Lettura temperatura
MODBUSR(A, 10100, UInt16) / 10
Zadana teplota zpetneho potrubi Sensore di temperatura

Zadana teplota zpetneho potrubi

Lettura temperatura
MODBUSR(A, 10101, UInt16) / 10
Teplota akumulacniho zasobiku (zpetna) Sensore di temperatura

Teplota akumulacniho zasobiku (zpetna)

Lettura temperatura
MODBUSR(A, 10102, UInt16) / 10
Teplota primarnich potrubi (flow) Sensore di temperatura

Teplota primarnich potrubi (flow)

Lettura temperatura
MODBUSR(A, 10105, UInt16) / 10
Venkovni teplota Sensore di temperatura

Venkovni teplota

Lettura temperatura
MODBUSR(A, 10108, Int16) / 10
Prumerna venkovni teplota (24 h) Sensore di temperatura

Prumerna venkovni teplota (24 h)

Lettura temperatura
MODBUSR(A, 10109, Int16) / 10
Teplota vstupu zdroje tepla Sensore di temperatura

Teplota vstupu zdroje tepla

Lettura temperatura
MODBUSR(A, 10110, Int16) / 10
Teplota vystupu zdroje tepla Sensore di temperatura

Teplota vystupu zdroje tepla

Lettura temperatura
MODBUSR(A, 10111, Int16) / 10
Teple uzit. voda — regulace Termostato
Attributi di servizio
Min. teplota TUV
Max. teplota TUV

Teple uzit. voda — regulace

Lettura temperatura
MODBUSR(A, 10120, Int16) / 10
Lettura temperatura desiderata
MODBUSR(A, 10121, UInt16) / 10
Scrittura temperatura desiderata
MODBUSWNE(SH, 10006, UInt16, Se * 10)
Attributi di servizio
Min. teplota TUV
TOSTRING(MODBUSR(A, 10122, Int16) / 10, "F1") + " °C"
Max. teplota TUV
TOSTRING(MODBUSR(A, 10123, Int16) / 10, "F1") + " °C"
Rezim nastaveni TUV Interruttore multivalore
Valori / Stati: Bez vlivu · Zadana teplota · Teplotni offset · Uroven provozu

Rezim nastaveni TUV

Lettura stato interruttore
MODBUSR(H, 10005, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10005, UInt16, Mu)
Blokace TUV Interruttore
Valori / Stati: Zablokováno · Normální provoz

Blokace TUV

Lettura stato interruttore
MODBUSR(H, 10051, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10051, UInt16, St)
Mimorizadny ohrev TUV Interruttore
Valori / Stati: Zapnuto · Vypnuto

Mimorizadny ohrev TUV

Lettura stato interruttore
MODBUSR(H, 10071, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10071, UInt16, St)
Attributi di servizio
Cilova teplota mimoradneho TUV
TOSTRING(MODBUSR(A, 10500, Int16) / 10, "F1") + " °C"
Trvani mimoradneho TUV
TOSTRING(MODBUSR(A, 10501, Int16)) + " min"
Zbyvajici cas TUV
TOSTRING(MODBUSR(A, 10502, Int16)) + " min"
Rezim nastaveni topeni Interruttore multivalore
Valori / Stati: Bez vlivu · Zadana zpetna teplota · Teplotni offset · Uroven provozu

Rezim nastaveni topeni

Lettura stato interruttore
MODBUSR(H, 10000, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10000, UInt16, Mu)
Topeni — celkovy rezim Interruttore multivalore
Valori / Stati: Individualni (dle okruhu) · Globalni offset · Globalni uroven

Topeni — celkovy rezim

Lettura stato interruttore
MODBUSR(H, 10065, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10065, UInt16, Mu)
Blokace topeni Interruttore
Valori / Stati: Zablokováno · Normální provoz

Blokace topeni

Lettura stato interruttore
MODBUSR(H, 10050, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10050, UInt16, St)
Mixovaci okruh MC1 — teplota flow Termostato
Attributi di servizio
Min. teplota flow MC1
Max. teplota flow MC1

Mixovaci okruh MC1 — teplota flow

Lettura temperatura
MODBUSR(A, 10140, Int16) / 10
Lettura temperatura desiderata
MODBUSR(A, 10141, Int16) / 10
Scrittura temperatura desiderata
MODBUSWNE(SH, 10011, UInt16, Se * 10)
Attributi di servizio
Min. teplota flow MC1
TOSTRING(MODBUSR(A, 10142, Int16) / 10, "F1") + " °C"
Max. teplota flow MC1
TOSTRING(MODBUSR(A, 10143, Int16) / 10, "F1") + " °C"
Rezim nastaveni MC1 Interruttore multivalore
Valori / Stati: Bez vlivu · Zadana teplota flow · Teplotni offset · Uroven provozu

Rezim nastaveni MC1

Lettura stato interruttore
MODBUSR(H, 10010, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10010, UInt16, Mu)
Spotrebovana elektricka energie Contatore elettrico

Spotrebovana elektricka energie

Lettura consumo totale
MODBUSR(A, 10310, Int32) / 10
Lettura domanda
MODBUSR(A, 10301, UInt16) / 10
Tepelna energie — topeni Contatore elettrico
Attributi di servizio
Spotreba el. energie — topeni
Spotreba el. energie — TUV
Tepelna energie — TUV
Tepelna energie celkem
Predikce min. prikonu

Tepelna energie — topeni

Lettura consumo totale
MODBUSR(A, 10322, Int32) / 10
Lettura domanda
MODBUSR(A, 10300, Int16) / 10
Attributi di servizio
Spotreba el. energie — topeni
TOSTRING(MODBUSR(A, 10312, Int32) / 10, "F1") + " kWh"
Spotreba el. energie — TUV
TOSTRING(MODBUSR(A, 10314, Int32) / 10, "F1") + " kWh"
Tepelna energie — TUV
TOSTRING(MODBUSR(A, 10324, Int32) / 10, "F1") + " kWh"
Tepelna energie celkem
TOSTRING(MODBUSR(A, 10320, Int32) / 10, "F1") + " kWh"
Predikce min. prikonu
TOSTRING(MODBUSR(A, 10302, UInt16) / 10, "F1") + " kW"
Limit prikonu (Smart Grid / EVU) Interruttore multivalore
Valori / Stati: Bez omezeni · Mekke omezeni (FV prebytky) · Tvrde omezeni (§14a)
Azioni di servizio
Nastavit limit prikonu

Limit prikonu (Smart Grid / EVU)

Lettura stato interruttore
MODBUSR(H, 10040, UInt16)
Scrittura stato interruttore
MODBUSW(SH, 10040, UInt16, Mu)
Attributi di servizio
Aktualni limit prikonu
TOSTRING(MODBUSR(H, 10041, UInt16) / 10, "F1") + " kW"
Signal EVU1
TOSTRING(MODBUSR(A, 10360, UInt16))
Signal EVU2
TOSTRING(MODBUSR(A, 10361, UInt16))
Azioni di servizio
Nastavit limit prikonu
Parametri: Limit kW (0–30 Lim)
MODBUSWNE(SH, 10041, UInt16, Lim * 10);
Connessione: Modbus TCP • Slave ID: $[SlaveId]

Parametri di importazione

Inserisci questi valori quando importi l'XML.

Richiesto nell'appPredefinito
IP adresa192.168.1.116
Modbus Slave ID1

Hai trovato un problema con questo template?

Dicci cosa non funziona, cosa manca o come dovrebbe comportarsi il template. Il tuo feedback ci aiuta a mantenere il catalogo accurato.

Modello · portale TapHome alpha innotec Luxtronik 2.1 Smart Home Interface (SHI) Apri questo template nel Customer Portal per applicarlo a una delle tue case, o crea una proposta di modifica e inviala al catalogo. Modbus TCP Vedi nel portale TapHome