Il GTD Therm è un pannello termostatico HVAC a parete di GTD IOT che comunica tramite Modbus TCP su Ethernet. Offre controllo della temperatura con lettura/scrittura della temperatura attuale e desiderata, un selettore di velocità ventilatore a 10 livelli, selezione del contenuto del display LCD, controllo della retroilluminazione del pannello e pulsanti touch a impulso per accensione/spegnimento, ventilatore min/max e cambio modalità. TapHome si connette direttamente al pannello sulla rete locale — non è necessario alcun gateway aggiuntivo.
Il template utilizza il pattern MODBUSWNE (write-no-echo) per tutte le operazioni di scrittura e interroga il dispositivo a intervalli di 2500 ms.
Connessione di rete
Collegare il pannello GTD Therm alla stessa rete locale di TapHome Core utilizzando un cavo Ethernet standard.
- Protocollo: Modbus TCP
- Porta: 502
- Slave ID predefinito: 1
Assegnare un indirizzo IP statico al GTD Therm nelle impostazioni DHCP del router per evitare che l’indirizzo cambi dopo un’interruzione di corrente.
Configurazione
Sul pannello GTD Therm non è necessaria alcuna configurazione speciale. L’interfaccia Modbus TCP è attiva di default sulla porta 502.
Durante l’importazione del template in TapHome, fornire:
- Indirizzo IP — l’IP del pannello sulla rete locale (predefinito: 192.168.0.1)
- Slave ID — indirizzo Modbus slave (predefinito: 1)
Funzionalità del dispositivo
Il template espone 9 dispositivi: un termostato, un selettore di velocità ventilatore, un parametro display LCD, la retroilluminazione del pannello, 4 pulsanti a impulso e un interruttore della modalità di funzionamento.
Termostato
Il dispositivo termostato fornisce il controllo della temperatura con due registri:
- Temperatura attuale — letta da H:30 (Int16 / 10), mostra la temperatura ambiente misurata in °C
- Temperatura desiderata — letta da H:31 (Int16 / 10) e scrivibile tramite MODBUSWNE. Il valore viene moltiplicato per 10 prima della scrittura (es. 22,5 °C viene scritto come 225)
Velocità ventilatore
Un interruttore multi-valore sul registro H:32 con 10 livelli selezionabili:
| Valore | Nome |
|---|---|
| 0 | OFF |
| 1 | MIN |
| 2 | NORMAL |
| 3 | MAX |
| 4–9 | Livelli di velocità estesi |
Parametro display LCD
Un interruttore multi-valore sul registro H:45 che controlla cosa mostra il display LCD del pannello:
| Valore | Contenuto del display |
|---|---|
| 0 | Temperatura impostata |
| 1 | Temperatura attuale |
| 2 | Velocità ventilatore |
| 3 | Valore visualizzato |
| 4–9 | Opzioni di visualizzazione estese |
Retroilluminazione pannello
Interruttore on/off sul registro H:24 (Bool) per controllare la retroilluminazione del pannello termostatico.
Pulsanti touch a impulso
Quattro interruttori a impulso che emulano la pressione fisica dei pulsanti sul pannello. Ciascuno invia un segnale on/off momentaneo tramite MODBUSWNE:
| Pulsante | Registro | Funzione |
|---|---|---|
| ON/OFF | H:2 | Accensione/spegnimento |
| Fan Speed Min | H:3 | Ventilatore alla velocità minima |
| Fan Speed Max | H:4 | Ventilatore alla velocità massima |
| Mode | H:5 | Scorrimento delle modalità operative |
Questi pulsanti a impulso replicano i pulsanti touch fisici sul pannello e consentono di attivare le stesse azioni da remoto tramite TapHome o le Smart Rule.
Modalità di funzionamento
Interruttore on/off sul registro H:33 (Bool) che indica se il termostato è attivamente in funzione (riscaldamento/raffreddamento attivo).
Riepilogo registri
| Dispositivo | Registro | Tipo di dato | Lettura/Scrittura | Intervallo di polling |
|---|---|---|---|---|
| Termostato (temp. attuale) | H:30 | Int16 (÷10) | Lettura | 2500 ms |
| Termostato (temp. desiderata) | H:31 | Int16 (÷10) | Lettura/Scrittura | 2500 ms |
| Velocità ventilatore | H:32 | Int16 | Lettura/Scrittura | 2500 ms |
| Modalità di funzionamento | H:33 | Bool | Lettura/Scrittura | 2500 ms |
| Retroilluminazione pannello | H:24 | Bool | Lettura/Scrittura | 2500 ms |
| Pulsante ON/OFF | H:2 | Bool | Lettura/Scrittura | 2500 ms |
| Pulsante Fan Min | H:3 | Bool | Lettura/Scrittura | 2500 ms |
| Pulsante Fan Max | H:4 | Bool | Lettura/Scrittura | 2500 ms |
| Pulsante Mode | H:5 | Bool | Lettura/Scrittura | 2500 ms |
| Parametro display LCD | H:45 | Int16 | Lettura/Scrittura | 2500 ms |
Risoluzione dei problemi
Nessuna comunicazione Modbus
- Verificare che il cavo Ethernet sia collegato e il pannello sia alimentato
- Confermare l’indirizzo IP del pannello — controllare la tabella di assegnazione DHCP del router
- Assicurarsi che TapHome Core e GTD Therm siano sulla stessa rete/sottorete
- Controllare che nessun firewall blocchi la porta 502
La temperatura mostra 0 o un valore errato
Il termostato utilizza Int16 con conversione ÷10. Un valore grezzo del registro di 225 significa 22,5 °C. Se i valori appaiono 10 volte troppo alti o troppo bassi, verificare che il template utilizzi il fattore di conversione corretto.
