Gira X1: Configurazione del server KNX Smart Home e configurazione dell'app

Cos'è il Gira X1 – e cosa fa simultaneamente

Il Gira X1 (numero d'ordine 1002 00) è un dispositivo su guida DIN alimentato a 24 V CC. Dispone di due porte Ethernet (una per LAN, una per backbone KNX IP) e un connettore bus KNX TP. Svolge contemporaneamente tre ruoli, motivo per cui sostituisce sia un router KNX IP che un server di visualizzazione separato nella maggior parte dei progetti residenziali.

Due strumenti, due livelli: ETS6 e GPA

Una fonte comune di confusione è che l'X1 richiede due strumenti di configurazione completamente separati. ETS6 configura l'installazione KNX stessa – parametri del dispositivo, indirizzi di gruppo, topologie. Gira Project Assistant (GPA) configura solo il livello di visualizzazione sul progetto KNX esistente. GPA non sostituisce ETS6.

Installazione e licenza di GPA

Gira Project Assistant è un download gratuito da gira.com. La licenza è legata al numero di serie dell'X1 — nessun dongle, nessun abbonamento annuale. Quando GPA viene collegato per la prima volta a un X1, legge il numero di serie e si attiva automaticamente tramite Internet. L'attivazione offline è disponibile tramite il supporto Gira per siti senza accesso a Internet durante la messa in servizio.

ETS6 export:
  File → Export project → .knxproj (standard KNX project format)

GPA import:
  File → Import → KNX project → select .knxproj

After import, GPA shows all group addresses with:
  - GA name (from ETS6 — name your GAs clearly)
  - DPT type (e.g. DPT 9.001 — temperature, 2-byte float)
  - Current value (live, read from bus)

Best practice:
  Use a consistent GA naming convention in ETS6 before import
  e.g. "L1 Living Room Ceiling — On/Off" for GA 1/0/1
  GPA uses ETS6 names as the default function name

Struttura dell'edificio in GPA: piani, stanze e funzioni

GPA organizza la visualizzazione come una struttura edilizia: edificio → piani → stanze → funzioni. L'app rispecchia esattamente questa gerarchia. Creare una chiara struttura delle stanze rende l'app intuitiva per gli utenti finali e semplifica la selezione dei preferiti.

GPA suggerisce automaticamente i tipi di funzione in base al DPT degli indirizzi di gruppo importati. Un GA con DPT 1.001 (1 bit on/off) verrà suggerito come luce di commutazione o funzione binaria. Un GA con DPT 9.001 (2 byte float) verrà suggerito come valore di temperatura. Verificare sempre il suggerimento automatico — DPT 9.001 potrebbe essere temperatura, umidità o CO2 a seconda del dispositivo.

App Gira Smart Home: accesso locale e remoto

L'app Gira Smart Home (iOS e Android) si connette all'X1 localmente tramite KNXnet/IP sulla stessa LAN, o da remoto tramite il relay cloud Gira. La struttura dell'app rispecchia esattamente la struttura dell'edificio GPA — piani, stanze e funzioni appaiono nella stessa gerarchia.

Accesso remoto senza cloud: WireGuard VPN

Per installazioni in cui la dipendenza dal cloud non è accettabile – hotel, case di cura, edifici commerciali con policy sui dati – il relay cloud Gira può essere completamente disabilitato. L'accesso remoto viene quindi ottenuto tramite un tunnel VPN WireGuard dal router del sito, dando all'app accesso LAN diretto all'X1 su un tunnel crittografato.

Client smartphone (remote)
    │
    │  WireGuard tunnel (UDP, encrypted, port 51820)
    ▼
Site router / firewall
  WireGuard server — assigns client IP in 10.8.0.x
    │
    │  LAN — 192.168.1.0/24
    ▼
Gira X1
  IP: 192.168.1.200 (static — mandatory)
  Port 3671 UDP — KNXnet/IP (LAN only, not port-forwarded)

Gira Smart Home app configuration:
  Settings → Connection → Manual → IP: 192.168.1.200
  App connects directly to X1 over VPN as if on-site LAN
  Gira cloud registration: disabled in GPA

WireGuard recommended over OpenVPN for mobile:
  Battery-efficient on iOS/Android
  Reconnects instantly after network switch (WiFi to LTE)
  Supported in: pfSense, OPNsense, Ubiquiti EdgeRouter,
  Mikrotik RouterOS, Unifi (via third-party package)

Integrazione con HomeKit, Alexa e Google Assistant

L'X1 si integra con tre principali piattaforme vocali. Tutte e tre sono configurate in GPA nelle impostazioni di integrazione. L'X1 funge da ponte – traduce tra il protocollo della piattaforma e le scritture/letture degli indirizzi di gruppo KNX.

Monitoraggio guasti e diagnostica

L'X1 fornisce diversi strumenti di diagnostica accessibili tramite la sua interfaccia web (navigare all'indirizzo IP dell'X1 in un browser sulla stessa LAN). Questi sono utili per la verifica della messa in servizio e la ricerca dei guasti dopo l'installazione.

Gira eNet vs Gira X1 — distinzione importante

Gira markets two separate smart home platforms that are frequently confused. The X1 is for wired KNX installations. The eNet Server is a completely different product for Gira's proprietary wireless 868 MHz eNet protocol — used in retrofit scenarios where KNX TP cabling is not possible.