Gira X1: Konfiguracja serwera KNX Smart Home i konfiguracja aplikacji

Czym jest Gira X1 – i co robi jednocześnie

Gira X1 (numer zamówienia 1002 00) to urządzenie na szynę DIN zasilane napięciem 24 V DC. Posiada dwa porty Ethernet (jeden dla LAN, jeden dla szkieletu KNX IP) oraz złącze magistrali KNX TP. Pełni jednocześnie trzy role, dlatego w większości projektów mieszkaniowych zastępuje zarówno router KNX IP, jak i oddzielny serwer wizualizacji.

Dwa narzędzia, dwie warstwy: ETS6 i GPA

Częstym źródłem nieporozumień jest to, że X1 wymaga dwóch całkowicie oddzielnych narzędzi konfiguracyjnych. ETS6 konfiguruje samą instalację KNX – parametry urządzeń, adresy grupowe, topologie. Gira Project Assistant (GPA) konfiguruje tylko warstwę wizualizacji na istniejącym projekcie KNX. GPA nie zastępuje ETS6.

Instalacja i licencjonowanie GPA

Gira Project Assistant jest bezpłatnym pobraniem ze strony gira.com. Licencja jest powiązana z numerem seryjnym X1 – brak klucza sprzętowego, brak rocznej subskrypcji. Gdy GPA po raz pierwszy łączy się z X1, odczytuje numer seryjny i aktywuje się automatycznie przez internet. Aktywacja offline jest dostępna za pośrednictwem pomocy technicznej Gira dla lokalizacji bez dostępu do internetu podczas uruchamiania.

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

Struktura budynku w GPA: piętra, pomieszczenia i funkcje

GPA organizuje wizualizację jako strukturę budynku: budynek → piętra → pomieszczenia → funkcje. Aplikacja dokładnie odzwierciedla tę hierarchię. Stworzenie przejrzystej struktury pomieszczeń sprawia, że aplikacja jest intuicyjna dla użytkowników końcowych i upraszcza wybór ulubionych.

GPA automatycznie sugeruje typy funkcji na podstawie DPT zaimportowanych adresów grupowych. GA z DPT 1.001 (1-bit włącz/wyłącz) zostanie zasugerowana jako przełącznik światła lub funkcja binarna. GA z DPT 9.001 (2-bajtowa liczba zmiennoprzecinkowa) zostanie zasugerowana jako wartość temperatury. Zawsze weryfikuj automatyczną sugestię – DPT 9.001 może oznaczać temperaturę, wilgotność lub CO2 w zależności od urządzenia.

Aplikacja Gira Smart Home: dostęp lokalny i zdalny

Aplikacja Gira Smart Home (iOS i Android) łączy się z X1 lokalnie przez KNXnet/IP w tej samej sieci LAN lub zdalnie przez chmurę Gira. Struktura aplikacji dokładnie odzwierciedla strukturę budynku GPA — piętra, pomieszczenia i funkcje pojawiają się w tej samej hierarchii.

Zdalny dostęp bez chmury: WireGuard VPN

W instalacjach, gdzie zależność od chmury jest niedopuszczalna – hotele, domy opieki, budynki komercyjne z politykami danych – przekaźnik chmury Gira może być całkowicie wyłączony. Zdalny dostęp jest wówczas realizowany przez tunel WireGuard VPN z routera na miejscu, zapewniając aplikacji bezpośredni dostęp LAN do X1 przez zaszyfrowany tunel.

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)

Integracja z HomeKit, Alexą i Asystentem Google

X1 integruje się z trzema głównymi platformami głosowymi. Wszystkie trzy są konfigurowane w GPA w ustawieniach integracji. X1 działa jako pomost – tłumaczy między protokołem platformy a zapisami i odczytami adresów grupowych KNX.

Monitorowanie usterek i diagnostyka

X1 udostępnia kilka narzędzi diagnostycznych dostępnych za pośrednictwem interfejsu internetowego (należy przejść do adresu IP X1 w przeglądarce w tej samej sieci LAN). Są one przydatne do weryfikacji rozruchu i znajdowania usterek po instalacji.

Gira eNet vs Gira X1 — ważne rozróżnienie

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.