Preparazione della rete per un'installazione TapHome
Un indirizzo fisso per il Core e per ogni dispositivo in rete — prenotazione IP nel router, nome mDNS e indirizzo del broker MQTT integrato
Ultimo aggiornamento:
Il TapHome Core comunica con i dispositivi della rete domestica all’indirizzo salvato nella sua configurazione. Quando il router assegna al Core o a un dispositivo un indirizzo IP diverso — dopo la sostituzione del router, un riavvio o il passaggio a DHCP —, l’integrazione smette di funzionare e il dispositivo segnala un errore. Prima dell’installazione, quindi, dai al Core e a ognuno di questi dispositivi un indirizzo fisso: una prenotazione IP nel router, oppure un nome mDNS, se il dispositivo lo supporta. Per il broker MQTT integrato, inserisci in TapHome l’indirizzo 127.0.0.1.
La regola di base: un indirizzo fisso
Ogni dispositivo con cui il Core comunica in rete, e il Core stesso, deve avere un indirizzo che non cambia:
- Prenotazione IP nel router (prenotazione DHCP, in alcuni router «DHCP statico» o «Address Reservation») — il router assegna all’indirizzo MAC del dispositivo sempre lo stesso indirizzo IP. Funziona per ogni dispositivo; quando sostituisci un dispositivo, basta spostare la prenotazione sul nuovo indirizzo MAC.
- Nome mDNS (ad esempio
shellyplus1-a8032ab12345.local) — il dispositivo lo annuncia da solo in rete e il nome non cambia con l’indirizzo IP. Funziona solo per i dispositivi che supportano mDNS. Quando aggiungi un dispositivo in TapHome tramite la ricerca in rete e il dispositivo annuncia un nome mDNS, TapHome lo usa da solo (Scanner IP).
Quando sostituisci il router, inserisci le prenotazioni anche in quello nuovo.
Indirizzo dell’unità di controllo Core
L’indirizzo IP, l’indirizzo MAC e il nome mDNS dell’unità di controllo si trovano nell’app in Impostazioni → Il mio Luogo (righe Indirizzo IP, Indirizzo MAC e mDNS nome).
- Consigliamo una prenotazione IP nel router in base all’indirizzo MAC dell’unità di controllo.
- Un IP statico nell’app (Impostazioni → Il mio Luogo → Impostazioni di rete, deseleziona Abilita DHCP) funziona anche, ma l’indirizzo deve trovarsi fuori dall’intervallo che il router assegna tramite DHCP — altrimenti il router può assegnarlo a un altro dispositivo e gli indirizzi entrano in conflitto. Dopo la sostituzione del router con uno che usa una rete diversa, il Core con IP statico non è raggiungibile finché l’impostazione non viene corretta. Procedura → Architettura di rete.
- Il nome mDNS dell’unità di controllo è il nome della posizione senza segni diacritici con il suffisso
.local(posizione «Villa Felicità» →Villa-Felicita.local). Cambia quando rinomini la posizione.
Dispositivi in rete
| Dispositivo | Quale indirizzo serve | Consiglio |
|---|---|---|
| Modbus TCP (inverter, wallbox, pompe di calore) | l’indirizzo del dispositivo in TapHome | prenotazione IP nel router |
| HTTP, TCP, UDP tramite Packet Parser (Shelly, stazioni meteo, gateway) | l’indirizzo del dispositivo in TapHome | nome mDNS, se il dispositivo lo annuncia; altrimenti prenotazione IP |
| Dispositivi MQTT (Shelly MQTT, Zigbee2MQTT, Tasmota) | l’indirizzo del Core nel dispositivo (broker) | prenotazione IP per il Core; in TapHome 127.0.0.1 (sotto) |
| Campanelli SIP | l’indirizzo del Core nel campanello e l’indirizzo del campanello in TapHome | prenotazione IP per entrambi |
| Telecamere IP | l’indirizzo della telecamera in TapHome | prenotazione IP nel router |
| Un’altra unità di controllo Core | l’indirizzo della seconda unità di controllo | prenotazione IP per entrambe → Collegare più Core |
Usa un IP statico impostato direttamente nel dispositivo solo quando lo richiede il produttore; anche in questo caso l’indirizzo deve trovarsi fuori dall’intervallo DHCP del router.
Broker MQTT integrato
Il broker MQTT integrato è in ascolto per impostazione predefinita sulla porta 1883 (TCP). Si usano due indirizzi diversi:
- In TapHome (modulo Packet Parser con il protocollo MQTT, campo indirizzo IP del broker) inserisci
127.0.0.1. È l’indirizzo con cui l’unità di controllo raggiunge sé stessa e non cambia nemmeno quando cambia l’indirizzo IP dell’unità di controllo. Non inserire qui l’indirizzo IP dell’unità di controllo — quando cambia, il modulo smette di ricevere i messaggi. - Nel dispositivo MQTT (ad esempio nell’interfaccia web di Shelly) inserisci l’indirizzo IP dell’unità di controllo con una prenotazione nel router. Usa il nome mDNS dell’unità di controllo solo quando il produttore del dispositivo dichiara che risolve un nome
.localnell’indirizzo del server.
Alcuni template avevano come indirizzo predefinito del broker il nome
taphome.mqtt.broker.local. L’unità di controllo non conosce questo nome e il modulo non si connette — sostituiscilo con127.0.0.1.
Porte e firewall
Le porte che il firewall deve consentire per l’app, il Core e il cloud → impostazioni del firewall.
Checklist prima della consegna
- Il Core ha una prenotazione IP nel router (oppure un IP statico fuori dall’intervallo DHCP).
- Ogni dispositivo Modbus TCP, HTTP e SIP e ogni telecamera ha una prenotazione IP oppure è inserito in TapHome con il suo nome mDNS.
- I moduli MQTT in TapHome hanno
127.0.0.1come indirizzo del broker, i dispositivi MQTT hanno l’indirizzo IP dell’unità di controllo con la prenotazione. - Hai consegnato al cliente l’elenco delle prenotazioni (indirizzo MAC, indirizzo IP, dispositivo) — gli servirà quando sostituirà il router.
- Dopo un riavvio del router, tutti i dispositivi in TapHome riportano i valori senza errori.
Vedi anche — Requisiti per dispositivi di terze parti.