Gira X1: KNX Smart Home Server Konfiguration und App-Einrichtung
Der Gira X1 ist nicht nur ein KNX-IP-Router – er ist ein kombinierter IP-Router, Smart-Home-App-Server und Fernzugriffs-Gateway in einem einzigen Hutschienengerät. Die Konfiguration erfordert zwei separate Werkzeuge: ETS6 für die KNX-Installation und Gira Project Assistant (GPA) für die Visualisierungsebene. Diese Anleitung deckt beides ab, plus HomeKit, Alexa und Fernzugriffseinrichtung.
Was der Gira X1 ist – und was er gleichzeitig tut
Der Gira X1 (Bestellnummer 1002 00) ist ein Hutschienengerät, das mit 24 V DC versorgt wird. Es verfügt über zwei Ethernet-Ports (einen für LAN, einen für KNX-IP-Backbone) und einen KNX-TP-Busanschluss. Es übernimmt gleichzeitig drei Rollen, weshalb es in den meisten Wohnprojekten sowohl einen KNX-IP-Router als auch einen separaten Visualisierungsserver ersetzt.
KNX-IP-Router
- • KNXnet/IP-Tunneling (bis zu 4 gleichzeitige Verbindungen)
- • KNXnet/IP-Routing – IP-Backbone über Multicast 224.0.23.12
- • ETS6-Einzeladresse: wie jeder KNX-IP-Router zugewiesen
- • Gruppenadressenfiltertabelle für Telegrammweiterleitung
- • ETS6-Programmierschnittstelle – Download, Lesen, Überwachen
Smart-Home-App-Server
- • Beherbergt die Gebäudestruktur (Etagen, Räume, Funktionen)
- • Bedient die Gira Smart Home iOS- und Android-App
- • Speichert Szenenkonfigurationen und Favoriten
- • Push-Benachrichtigungs-Engine für KNX-Binärtrigger
- • Konfiguriert über Gira Project Assistant (GPA) – getrennt von ETS6
Remote Access Gateway
- • Gira-Cloud-Relay für Fernzugriff auf die App ohne VPN
- • HomeKit-Bridge – meldet sich als Apple HomeKit-Hub an
- • Integration der Amazon Alexa-Fertigkeit
- • Integration der Google Assistant-Aktion
- • Weboberfläche auf lokaler IP für Protokolle und Gruppenmonitor
Hardware-Hinweis: Das X1 benötigt eine externe 24V DC-Stromversorgung (nicht busgespeist). Es verbraucht etwa 5W. Weisen Sie dem Router immer eine statische IP-Adresse zu – das X1 muss unter einer konsistenten Adresse erreichbar sein, damit die App und das Cloud-Relay nach Stromzyklen wieder verbinden können.
Zwei Werkzeuge, zwei Ebenen: ETS6 und GPA
Eine häufige Verwirrung besteht darin, dass das X1 zwei völlig separate Konfigurationswerkzeuge benötigt. ETS6 konfiguriert die KNX-Installation selbst – Geräteparameter, Gruppenadressen, Topologien. Gira Project Assistant (GPA) konfiguriert nur die Visualisierungsebene auf dem bestehenden KNX-Projekt. GPA ersetzt nicht ETS6.
| Aufgabe | Werkzeug | Anmerkungen |
|---|---|---|
| KNX-Geräteparameter programmieren | ETS6 | Aktoren, Sensoren, Schalter – Standard-KNX-Inbetriebnahme |
| Gruppenadressen erstellen und zuweisen | ETS6 | Alle DPT-Definitionen und GA-Zuweisungen in ETS6 durchgeführt |
| ETS6-Projekt auf Geräte herunterladen | ETS6 | Via KNXnet/IP-Tunneling durch das X1 |
| X1 individuelle Adresse zuweisen | ETS6 | X1 erscheint in der ETS6-Topologie als KNX-IP-Router |
| Gruppenadressen in GPA importieren | GPA | Die .knxproj-Datei importieren – dies ist die Verbindung zwischen ETS6 und GPA |
| Etagen und Räume erstellen | GPA | Gebäudestruktur in der Gira App sichtbar |
| GAs funktionalen Objekten zuweisen | GPA | Licht-, Jalousie-, Thermostat-, Szenenobjekte |
| App-Symbole und -Namen konfigurieren | GPA | Was Endbenutzer in der iOS/Android-App sehen |
| HomeKit, Alexa, Google einrichten | GPA | Sprachplattform-Integrationen |
| X1 mit Gira Cloud registrieren | GPA + Gira-Konto | Erforderlich für den Fernzugriff über Gira Cloud Relay |
Installation und Lizenzierung von GPA
Gira Project Assistant ist ein kostenloser Download von gira.com. Die Lizenz ist an die X1-Seriennummer gebunden – kein Dongle, kein Jahresabonnement. Wenn GPA zum ersten Mal mit einem X1 verbunden wird, liest es die Seriennummer und aktiviert sich automatisch über das Internet. Eine Offline-Aktivierung ist über den Gira-Support für Standorte ohne Internetzugang während der Inbetriebnahme möglich.
GPA-Einrichtungsablauf
- GPA von gira.com herunterladen (nur Windows – keine macOS-Version)
- GPA auf dem Inbetriebnahme-Laptop installieren
- Laptop mit demselben LAN wie der X1 verbinden
- GPA öffnen – es erkennt den X1 über UPnP (wie ETS6-Erkennung)
- GPA liest die X1-Seriennummer aus und aktiviert die Lizenz online
- In GPA: Datei → KNX-Projekt importieren → die .knxproj-Datei aus ETS6 auswählen
- GPA importiert alle Gruppenadressen mit ihren DPTs – bereit zur Zuweisung an Funktionen
ETS6 zu GPA – der .knxproj-Import
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
Gebäudestruktur in GPA: Etagen, Räume und Funktionen
GPA organisiert die Visualisierung als Gebäudestruktur: Gebäude → Etagen → Räume → Funktionen. Die App spiegelt diese Hierarchie exakt wider. Eine klare Raumstruktur macht die App für Endbenutzer intuitiv und vereinfacht die Favoritenauswahl.
GPA schlägt automatisch Funktionstypen basierend auf dem DPT der importierten Gruppenadressen vor. Eine GA mit DPT 1.001 (1-Bit Ein/Aus) wird als Schaltlicht oder Binärfunktion vorgeschlagen. Eine GA mit DPT 9.001 (2-Byte Gleitkomma) wird als Temperaturwert vorgeschlagen. Überprüfen Sie immer den automatischen Vorschlag – DPT 9.001 könnte je nach Gerät Temperatur, Luftfeuchtigkeit oder CO2 sein.
| Funktionstyp | Erforderliche Gruppenadressen | App-Anzeige |
|---|---|---|
| Licht (Schalten) | DPT 1.001 Ein/Aus | Ein/Aus-Umschaltknopf |
| Licht (Dimmen) | DPT 1.001 Ein/Aus + DPT 5.001 Helligkeit (0–100%) | Ein/Aus-Umschalter + Helligkeitsregler |
| Jalousie / Rollladen | DPT 1.008 auf/ab + DPT 5.001 Position (0–100%) | Auf/Ab-Tasten + Positionsschieber |
| Raffstore / Lamelle | DPT 1.008 Bewegung + DPT 5.001 Position + DPT 5.001 Lamellenwinkel | Positionsschieber + Lamellenwinkelschieber |
| Raumtemperatur | DPT 9.001 Ist-Temp + DPT 9.001 Sollwert + DPT 20.102 HVAC-Modus | Thermostat-Widget mit +/- Sollwert und Moduswahl |
| Szene | DPT 18.001 Szenenaufruf | Szenentaste (bis zu 8 Szenen pro Funktion) |
| Binär (Alarm/Status) | DPT 1.001 Binäreingang | Statusanzeige (aktiv/inaktiv) |
| Anwesenheit / Bewegung | DPT 1.001 binär (Bewegung erkannt) | Bewegungsstatus-Symbol — reine Anzeige |
Gira Smart Home App: lokaler und Fernzugriff
Die Gira Smart Home App (iOS und Android) verbindet sich mit dem X1 entweder lokal über KNXnet/IP im selben LAN oder remote über den Gira Cloud Relay. Die App-Struktur spiegelt exakt die GPA-Gebäudestruktur wider — Etagen, Räume und Funktionen erscheinen in derselben Hierarchie.
Lokale Verbindung (LAN)
- • App findet X1 über KNXnet/IP im selben WiFi-Netzwerk
- • Keine Cloud-Abhängigkeit — funktioniert ohne Internet
- • Reaktionszeit: unter 100ms für Schalten und Dimmen
- • Empfohlen für den täglichen Einsatz vor Ort
- • Die App benötigt eine X1-IP-Adresse, wenn die UPnP-Erkennung durch WLAN-AP-Isolation blockiert wird
Fernzugriff über die Gira-Cloud
- • Registrieren Sie die X1 mit einem Gira-Konto in den GPA-Einstellungen
- • Die X1 baut eine ausgehende Verbindung zu den Gira-Cloud-Servern auf
- • Die App verbindet sich über ein Cloud-Relay – keine Portweiterleitung erforderlich
- • Erfordert ein aktives Gira-Cloud-Abonnement (bei der X1 für die ersten 3 Jahre inbegriffen)
- • Reaktionszeit: 300–800 ms, abhängig von der Internetlatenz
Favoriten und Home-Bildschirm-Widget
- • Jeder App-Benutzer kann bevorzugte Gruppenadressen für den Startbildschirm auswählen
- • Favoriten erscheinen beim ersten App-Start – keine Navigation erforderlich
- • iOS Home-Bildschirm-Widget: zeigt Status von bis zu 4 Favoritenfunktionen
- • Nützlich für: Hauptbeleuchtung, Heizungssollwert, Alarmstatus, Torsteuerung
Push-Benachrichtigungen
- • Konfiguration in GPA: Wählen Sie eine binäre GA (DPT 1.001) als Benachrichtigungsauslöser
- • X1 überwacht die GA und sendet Push über die Gira-Cloud, wenn sie umschaltet
- • Anwendungsfälle: Türklingel, offenes Fenster, Bewegungserkennung, Alarmauslösung
- • Erfordert Gira-Cloud-Verbindung auch bei lokalen Installationen
Fernzugriff ohne Cloud: WireGuard VPN
Für Installationen, bei denen Cloud-Abhängigkeit nicht akzeptabel ist – Hotels, Pflegeheime, Gewerbegebäude mit Datenrichtlinien – kann das Gira-Cloud-Relay vollständig deaktiviert werden. Der Fernzugriff erfolgt dann über einen WireGuard-VPN-Tunnel vom Standort-Router, der der App direkten LAN-Zugriff auf den X1 über einen verschlüsselten Tunnel ermöglicht.
WireGuard-Fernzugriffsarchitektur
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)HomeKit-, Alexa- und Google-Assistant-Integration
Der X1 integriert sich in drei große Sprachplattformen. Alle drei werden in der GPA unter den Integrationseinstellungen konfiguriert. Der X1 fungiert als Brücke – er übersetzt zwischen dem Plattformprotokoll und KNX-Gruppenadressen-Schreib- und Leseoperationen.
Apple HomeKit
- • X1 fungiert als native HomeKit-Brücke – kein Hub erforderlich
- • Jede GPA-Funktion wird einem HomeKit-Zubehör mit einer UUID zugeordnet
- • HomeKit-Kategorien: Glühbirne, Ventilator, Thermostat, Jalousie, Steckdose, Schalter
- • Kopplung: QR-Code in GPA mit iPhone-Kamera scannen → Home-App
- • Siri: 'Hey Siri, set living room to 22 degrees'
- • Funktioniert lokal – nach der Kopplung ist kein Internet erforderlich
Amazon Alexa
- • Gira Smart Home Skill in der Alexa App aktivieren
- • Gira-Konto verknüpfen (gleiches Konto wie für X1-Cloud-Registrierung)
- • Alexa erkennt X1-Funktionen automatisch
- • Unterstützt: Licht (ein/aus/dimmen), Jalousien (öffnen/schließen), Szenen
- • 'Alexa, dim the office lights to 40%'
- • Erfordert Gira-Cloud-Verbindung auf X1
Google Assistant
- • Gira Smart Home Aktion in der Google Home App aktivieren
- • Gira-Konto verknüpfen – Geräte synchronisieren automatisch
- • Die Google Home App zeigt X1-Funktionen als Geräte an
- • Unterstützt: Licht, Jalousien, Thermostat, Szenen
- • 'Hey Google, close the bedroom blinds'
- • Erfordert Gira-Cloud-Verbindung auf X1
HomeKit-Vorteil für cloudfreie Setups:HomeKit is the only integration that works without Gira cloud — once paired, the X1 and iPhone communicate directly on the LAN (or via the iPhone's Apple TV or HomePod as a home hub for remote access). For installations without Gira cloud subscription, HomeKit + WireGuard VPN provides full remote access and voice control without any Gira cloud dependency.
Fehlerüberwachung und Diagnose
Das X1 bietet mehrere Diagnosetools, die über seine Weboberfläche zugänglich sind (navigieren Sie im selben LAN mit einem Browser zur X1-IP-Adresse). Diese sind nützlich für die Inbetriebnahme-Überprüfung und Fehlersuche nach der Installation.
Gruppenmonitor
- • Zeigt live den KNX-Telegrammverkehr auf dem Bus an
- • Filtern nach Gruppenadresse oder Einzeladresse
- • DPT-Werte in Echtzeit dekodieren
- • Nützlich zur Überprüfung der korrekten Zuordnung von GPA-Funktionen
- • Zugriff: X1-Weboberfläche → Diagnose → Gruppenmonitor
Logdateien und Busspannung
- • X1-Protokolle: Systemereignisse, Cloud-Verbindungsstatus, App-Anmeldungen
- • Protokolldownload: X1-Weboberfläche → System → Protokolle herunterladen
- • KNX-Busspannungsüberwachung: X1 kann eine Benachrichtigung auslösen, wenn die Busspannung unter einen Schwellenwert fällt (konfigurierbar in GPA)
- • Busspannungsabfall deutet auf eine defekte KNX-Stromversorgung oder einen Kurzschluss auf der TP-Leitung hin
Gira eNet vs. Gira X1 — wichtiger Unterschied
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.
| Funktion | Gira X1 | Gira eNet Server |
|---|---|---|
| Protokoll | KNX TP (verkabelt, IEC 14543) | eNet 868 MHz HF (Gira-proprietär) |
| Installationstyp | Neubau / Komplettsanierung | Nachrüstung ohne neue Verkabelung |
| Bus-Standard | Offener KNX-Standard – jeder Hersteller | Nur Gira eNet-Geräte |
| Hutschienenmontage | Ja – KNX-TP-Anschluss am Gerät | Ja – HF-Antenne enthalten |
| Visualisierungs-App | Gira Smart Home App (gleiche Benutzeroberfläche) | Gira Smart Home App (gleiche Benutzeroberfläche) |
| ETS6-Konfiguration | Ja – vollständiges ETS6-Projekt erforderlich | Nein – eNet hat eigenes Tool |
| HomeKit-Unterstützung | Ja – X1 fungiert als HomeKit-Bridge | Ja – eNet Server fungiert als Bridge |
| Interoperabilität | Funktioniert mit MDT, ABB, Siemens, allen KNX | Nur Gira eNet-Geräte |
| Typischer Preis | ≈ €800 | ≈ €400 |
Wichtiger Unterschied: Der Gira X1 und der eNet Server können nicht gemischt werden – sie bedienen unterschiedliche Bustechnologien. Wenn ein Projekt KNX TP verwendet, geben Sie den X1 an. Wenn es sich um eine Nachrüstung mit Gira eNet Funk-Schaltern handelt, geben Sie den eNet Server an. Es gibt kein Produkt, das KNX TP und eNet in einem einzigen Gerät verbindet.
Benötigen Sie ein KNX-Panel mit integriertem Visualisierungsserver?
Wir liefern Panels mit einem vorinstallierten und lizenzierten Gira X1, konfiguriertem IP-Routing, in GPA importierten Gruppenadressen und fertiger Gebäudestruktur – vor der Auslieferung getestet.
Angebot anfragen →