Gira X1 : Configuration du serveur KNX Smart Home et configuration de l'application
Le Gira X1 n'est pas seulement un routeur IP KNX – c'est un routeur IP, un serveur d'application domotique et une passerelle d'accès à distance combinés en un seul appareil sur rail DIN. La configuration nécessite deux outils distincts : ETS6 pour l'installation KNX et Gira Project Assistant (GPA) pour la couche de visualisation. Ce guide couvre les deux, ainsi que la configuration HomeKit, Alexa et l'accès à distance.
Ce qu'est le Gira X1 – et ce qu'il fait simultanément
Le Gira X1 (numéro de commande 1002 00) est un appareil sur rail DIN alimenté en 24 V CC. Il dispose de deux ports Ethernet (un pour le LAN, un pour le backbone KNX IP) et d'un connecteur bus KNX TP. Il remplit trois rôles simultanément, ce qui lui permet de remplacer à la fois un routeur KNX IP et un serveur de visualisation séparé dans la plupart des projets résidentiels.
Routeur KNX IP
- • Tunneling KNXnet/IP (jusqu'à 4 connexions simultanées)
- • Routage KNXnet/IP — backbone IP via multicast 224.0.23.12
- • Adresse individuelle ETS6 : attribuée comme tout routeur KNX IP
- • Table de filtrage d'adresses de groupe pour le transfert de télégrammes
- • Interface de programmation ETS6 — téléchargement, lecture, surveillance
Serveur d'application Smart Home
- • Héberge la structure du bâtiment (étages, pièces, fonctions)
- • Sert l'application Gira Smart Home iOS et Android
- • Stocke les configurations de scènes et les favoris
- • Moteur de notifications push pour les déclencheurs binaires KNX
- • Configuré via Gira Project Assistant (GPA) – séparé d'ETS6
Passerelle d'accès à distance
- • Relais cloud Gira pour l'accès distant à l'application sans VPN
- • Pont HomeKit – s'annonce comme concentrateur Apple HomeKit
- • Intégration de la compétence Amazon Alexa
- • Intégration de l'action Google Assistant
- • Interface web sur IP locale pour les logs et le moniteur de groupe
Remarque matérielle : Le X1 nécessite une alimentation externe 24V CC (non alimenté par le bus). Il consomme environ 5W. Attribuez toujours une adresse IP statique sur le routeur – le X1 doit être accessible à une adresse cohérente pour que l'application et le relais cloud puissent se reconnecter après les cycles d'alimentation.
Deux outils, deux couches : ETS6 et GPA
Une source fréquente de confusion est que le X1 nécessite deux outils de configuration totalement séparés. ETS6 configure l'installation KNX elle-même – paramètres des appareils, adresses de groupe, topologies. Gira Project Assistant (GPA) configure uniquement la couche de visualisation sur le projet KNX existant. GPA ne remplace pas ETS6.
| Tâche | Outil | Remarques |
|---|---|---|
| Programmer les paramètres des appareils KNX | ETS6 | Actionneurs, capteurs, interrupteurs — mise en service KNX standard |
| Créer et attribuer des adresses de groupe | ETS6 | Toutes les définitions DPT et attributions GA effectuées dans ETS6 |
| Télécharger le projet ETS6 vers les appareils | ETS6 | Via le tunneling KNXnet/IP à travers le X1 |
| Attribuer une adresse individuelle au X1 | ETS6 | Le X1 apparaît comme un routeur KNX IP dans la topologie ETS6 |
| Importer les adresses de groupe dans GPA | GPA | Importer le fichier .knxproj – c'est le lien entre ETS6 et GPA |
| Créer des étages et des pièces | GPA | Structure du bâtiment visible dans l'application Gira |
| Attribuer les GA aux objets fonctionnels | GPA | Objets d'éclairage, volet, thermostat, scénario |
| Configurer les icônes et noms de l'application | GPA | Ce que les utilisateurs finaux voient dans l'application iOS/Android |
| Configurer HomeKit, Alexa, Google | GPA | Intégrations de plateformes vocales |
| Enregistrer X1 avec le cloud Gira | GPA + compte Gira | Requis pour l'accès à distance via le relais cloud Gira |
Installation et licence de GPA
Gira Project Assistant est un téléchargement gratuit depuis gira.com. La licence est liée au numéro de série du X1 — pas de dongle, pas d'abonnement annuel. Lorsque GPA est connecté pour la première fois à un X1, il lit le numéro de série et s'active automatiquement via Internet. L'activation hors ligne est disponible via le support Gira pour les sites sans accès Internet pendant la mise en service.
Séquence de configuration de GPA
- Télécharger GPA depuis gira.com (Windows uniquement — pas de version macOS)
- Installer GPA sur l'ordinateur portable de mise en service
- Connecter l'ordinateur portable au même réseau LAN que le X1
- Ouvrir GPA — il découvre le X1 via UPnP (comme la découverte ETS6)
- GPA lit le numéro de série X1 et active la licence en ligne
- Dans GPA : Fichier → Importer un projet KNX → sélectionnez le fichier .knxproj depuis ETS6
- GPA importe toutes les adresses de groupe avec leurs DPT — prêtes à être affectées à des fonctions
ETS6 vers GPA — l'importation .knxproj
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
Structure du bâtiment dans GPA : étages, pièces et fonctions
GPA organise la visualisation comme une structure de bâtiment : bâtiment → étages → pièces → fonctions. L'application reflète exactement cette hiérarchie. Créer une structure de pièces claire rend l'application intuitive pour les utilisateurs finaux et simplifie la sélection des favoris.
GPA suggère automatiquement des types de fonctions en fonction du DPT des adresses de groupe importées. Une AG avec DPT 1.001 (1 bit marche/arrêt) sera suggérée comme un éclairage de commutation ou une fonction binaire. Une AG avec DPT 9.001 (2 octets flottant) sera suggérée comme une valeur de température. Vérifiez toujours la suggestion automatique — DPT 9.001 pourrait être la température, l'humidité ou le CO2 selon l'appareil.
| Type de fonction | Adresses de groupe requises | Affichage dans l'application |
|---|---|---|
| Éclairage (commutation) | DPT 1.001 marche/arrêt | Bouton de bascule marche/arrêt |
| Éclairage (variation) | DPT 1.001 marche/arrêt + DPT 5.001 luminosité (0–100%) | Bouton marche/arrêt + curseur de luminosité |
| Store / volet | DPT 1.008 montée/descente + DPT 5.001 position (0–100%) | Boutons montée/descente + curseur de position |
| Store à lamelles / brise-soleil | DPT 1.008 mouvement + DPT 5.001 position + DPT 5.001 angle des lamelles | Curseur de position + curseur d'angle des lamelles |
| Température ambiante | DPT 9.001 temp. réelle + DPT 9.001 consigne + DPT 20.102 mode HVAC | Widget thermostat avec +/- consigne et sélecteur de mode |
| Scène | DPT 18.001 appel de scène | Bouton de scène (jusqu'à 8 scènes par fonction) |
| Binaire (alarme/état) | DPT 1.001 entrée binaire | Indicateur d'état (actif/inactif) |
| Présence / mouvement | DPT 1.001 binaire (mouvement détecté) | Icône d'état de mouvement — affichage en lecture seule |
Application Gira Smart Home : accès local et à distance
L'application Gira Smart Home (iOS et Android) se connecte au X1 soit localement via KNXnet/IP sur le même LAN, soit à distance via le relais cloud Gira. La structure de l'application reflète exactement la structure du bâtiment GPA — les étages, les pièces et les fonctions apparaissent dans la même hiérarchie.
Connexion locale (LAN)
- • L'application découvre le X1 via KNXnet/IP sur le même réseau WiFi
- • Aucune dépendance au cloud — fonctionne sans Internet
- • Temps de réponse : moins de 100 ms pour la commutation et la gradation
- • Recommandé pour une utilisation quotidienne sur site
- • L'application nécessite une adresse IP X1 si la découverte UPnP est bloquée par l'isolation du point d'accès WiFi
Accès distant via le cloud Gira
- • Enregistrez le X1 avec un compte Gira dans les paramètres GPA
- • Le X1 établit une connexion sortante vers les serveurs cloud Gira
- • L'application se connecte via un relais cloud – aucune redirection de port requise
- • Nécessite un abonnement actif au cloud Gira (inclus avec le X1 les 3 premières années)
- • Temps de réponse : 300–800 ms selon la latence Internet
Favoris et widget d'écran d'accueil
- • Chaque utilisateur de l'application peut sélectionner des adresses de groupe favorites pour l'écran d'accueil
- • Les favoris apparaissent au premier lancement de l'application – aucune navigation requise
- • Widget d'écran d'accueil iOS : affiche l'état de jusqu'à 4 fonctions favorites
- • Utile pour : éclairage principal, consigne de chauffage, état d'alarme, contrôle de portail
Notifications push
- • Configurer dans GPA : sélectionnez une GA binaire (DPT 1.001) comme déclencheur de notification
- • X1 surveille la GA et envoie une notification push via le cloud Gira lorsqu'elle bascule
- • Cas d'utilisation : sonnette, fenêtre ouverte, détection de mouvement, déclenchement d'alarme
- • Nécessite une connexion cloud Gira même pour les installations locales
Accès à distance sans cloud : WireGuard VPN
Pour les installations où la dépendance au cloud n'est pas acceptable – hôtels, maisons de retraite, bâtiments commerciaux avec politiques de données – le relais cloud Gira peut être désactivé. L'accès à distance est alors réalisé via un tunnel VPN WireGuard depuis le routeur du site, donnant à l'application un accès LAN direct au X1 via un tunnel crypté.
Architecture d'accès à distance WireGuard
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)Intégration HomeKit, Alexa et Google Assistant
Le X1 s'intègre avec trois grandes plateformes vocales. Toutes trois sont configurées dans GPA sous les paramètres d'intégration. Le X1 agit comme pont – il traduit entre le protocole de la plateforme et les écritures/lectures d'adresses de groupe KNX.
Apple HomeKit
- • X1 agit comme un pont HomeKit natif – aucun hub requis
- • Chaque fonction GPA correspond à un accessoire HomeKit avec un UUID
- • Catégories HomeKit : ampoule, ventilateur, thermostat, store, prise, interrupteur
- • Appairage : scannez le code QR dans GPA avec l'appareil photo iPhone → app Maison
- • Siri: 'Hey Siri, set living room to 22 degrees'
- • Fonctionne localement – une fois appairé, aucune connexion Internet nécessaire
Amazon Alexa
- • Activer la compétence Gira Smart Home dans l'application Alexa
- • Lier le compte Gira (même compte utilisé pour l'enregistrement cloud X1)
- • Alexa découvre automatiquement les fonctions X1
- • Prend en charge : lumières (on/off/variation), stores (ouvrir/fermer), scènes
- • 'Alexa, dim the office lights to 40%'
- • Nécessite une connexion cloud Gira sur X1
Google Assistant
- • Activer l'action Gira Smart Home dans l'application Google Home
- • Lier le compte Gira — les appareils se synchronisent automatiquement
- • L'application Google Home affiche les fonctions X1 comme des appareils
- • Prend en charge : lumières, stores, thermostat, scènes
- • 'Hey Google, close the bedroom blinds'
- • Nécessite une connexion cloud Gira sur X1
Avantage HomeKit pour les configurations sans cloud :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.
Surveillance des défauts et diagnostic
Le X1 fournit plusieurs outils de diagnostic accessibles via son interface web (naviguez vers l'adresse IP du X1 dans un navigateur sur le même LAN). Ceux-ci sont utiles pour la vérification de la mise en service et la recherche de défauts après l'installation.
Moniteur de groupe
- • Affiche en direct le trafic des télégrammes KNX sur le bus
- • Filtrer par adresse de groupe ou adresse individuelle
- • Décoder les valeurs DPT en temps réel
- • Utile pour vérifier que les affectations des fonctions GPA sont correctes
- • Accès : interface web X1 → Diagnostic → Moniteur de groupe
Fichiers journaux et tension du bus
- • Journaux X1 : événements système, état de la connexion cloud, connexions à l'application
- • Téléchargement des journaux : interface web X1 → Système → Télécharger les journaux
- • Surveillance de la tension du bus KNX : X1 peut déclencher une notification si la tension du bus descend en dessous d'un seuil (configurable dans GPA)
- • Une chute de tension du bus indique une alimentation KNX défaillante ou un court-circuit sur le câble TP
Gira eNet vs Gira X1 — distinction 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.
| Fonctionnalité | Gira X1 | Gira eNet Server |
|---|---|---|
| Protocole | KNX TP (filaire, IEC 14543) | eNet 868 MHz RF (propriétaire Gira) |
| Type d'installation | Construction neuve / rénovation complète | Rénovation sans nouveau câblage |
| Standard de bus | Standard KNX ouvert – tout fabricant | Appareils Gira eNet uniquement |
| Montage sur rail DIN | Oui – connecteur KNX TP sur l'appareil | Oui – antenne RF incluse |
| Application de visualisation | Application Gira Smart Home (même interface) | Application Gira Smart Home (même interface) |
| Configuration ETS6 | Oui – projet ETS6 complet requis | Non – eNet dispose de son propre outil |
| Support HomeKit | Oui – X1 agit comme passerelle HomeKit | Oui – eNet Server agit comme passerelle |
| Interopérabilité | Fonctionne avec MDT, ABB, Siemens, tous les KNX | Appareils Gira eNet uniquement |
| Prix typique | ≈ €800 | ≈ €400 |
Distinction cruciale : Le Gira X1 et le serveur eNet ne peuvent pas être mélangés – ils desservent des technologies de bus différentes. Si un projet utilise KNX TP, spécifiez le X1. Si le projet est une rénovation avec des interrupteurs sans fil Gira eNet, spécifiez le serveur eNet. Il n'existe aucun produit qui relie KNX TP et eNet dans un seul appareil.
Besoin d'un panneau KNX avec serveur de visualisation intégré ?
Nous fournissons des panneaux avec un Gira X1 préinstallé et sous licence, routage IP configuré, adresses de groupe importées dans GPA, et structure du bâtiment prête – testés avant livraison.
Demander un devis →