KNX Stack - C++ Code ESP32 pour l'IDE Arduino

[Smart Guido 73]

KNX Stack – Visualisation & écran tactile avec ESP32-S3

Un ESP32-S3 se connecte directement à une passerelle KNX/IP via le protocole KNXnet/IP Tunneling et fournit une interface tactile réactive dans le style d'un bouton-poussoir en verre KNX. L'interface fonctionne sur n'importe quel navigateur web ainsi que sur une application Android fournie pour les panneaux muraux (par ex. 4" avec 480 × 480 px).

1. Points forts

• 6 touches en verre (grille 2×3) - avec LED d'état, barres de pourcentage (variateur/store) et icônes personnalisables.
  
• Logique avancée - distinction entre appui court et appui long, commande à touche unique pour la variation et les stores, gestion des scènes.
  
• État en direct - mise à jour dynamique lors des changements d'état sur le bus.
  
• Ligne d'état - texte d'information défilant (heure, date, températures, vent, lux, météo, valeurs de bus libres).
  
• Outils de télégrammes - moniteur de bus (24 derniers télégrammes) et interface d'envoi/lecture pour 21 types DPT.
  
• Design & Interface - 7 thèmes de couleurs, 4 styles de touches, images de fond personnalisées, écran de veille avec horloge numérique.
  
• Multilingue - allemand, anglais, français (le réglage est enregistré dans l'ESP32).
  

2. Architecture système
Firmware

• Technologie - Arduino / ESP32-S3 (knx_stack.ino)
  
• Fonction - Pile KNX-IP, serveur web, API REST, mémoire de configuration (NVS/LittleFS)
  

Application panneau mural

• Technologie - .NET MAUI Android (KnxWallPanel)
  
• Fonction - Application Kiosk (plein écran, maintien de l'écran allumé, reconnexion automatique) pour Android 7.1 à 17
  

3. Types de touches pris en charge

• Commutation / Marche / Arrêt (DPT 1)
  
• Rappel de scène (DPT 17 – scènes 1 à 64)
  
• Envoyer une valeur (DPT 5.001 – 0 à 100 %)
  
• Store (2 touches) - Appui long = Déplacement (DPT 1), Appui court = Arrêt (DPT 1)
  
• Store (1 touche) - Appui long = Inversion du sens, Appui court = Arrêt
  
• Variation (2 touches) - Appui long = Varier (DPT 3), Appui court = Commuter (DPT 1)
  
• Variation (1 touche) - Appui long = Variation alternée plus clair/plus sombre, Appui court = Commuter
  

4. Démarrage rapide / Configuration
Flash de l'ESP32-S3

1. Ouvrir l'IDE Arduino avec le core ESP32. Aucune bibliothèque externe requise.
   
2. Sélectionner la carte ESP32S3 Dev Module.
   
3. Schemas de partition : Default 4MB with spiffs (important pour les téléversements & OTA).
   
4. Adapter les identifiants en haut du sketch :
   

         const char* ssid = "VOTRE_WIFI"; 
         const char* password = "VOTRE_MOT_DE_PASSE"; 
         const char* defaultGatewayIp = "192.168.1.10"; // Passerelle KNX/IP 
         const char* otaPassword = "VOTRE_MOT_DE_PASSE_OTA";

1. Téléverser le sketch, lire l'adresse IP dans le moniteur série (115200 baud) ou ouvrir http://knx-stack.local.
   

Configuration initiale via l'interface Web

1. Menu ☰ → Réglages → Passerelle KNX : vérifier l'IP (point vert = tunnel établi).
   
2. Réglages → Touches : attribuer les adresses de groupe et les types de touches.
   
3. Réglages → Ligne d'état : activer les valeurs à afficher.
   

5. Détails techniques & API REST

• Protocole KNX - KNXnet/IP Tunneling via UDP (Port 3671), reconnexion automatique (pause de 10s), Heartbeat toutes les 60s.
  
• Réseau           - mDNS (knx-stack.local), support Arduino OTA, mode d'économie d'énergie Wi-Fi désactivé pour une latence minimale.
  
• Stockage         - touches et paramètres dans NVS (Preferences), fond d'écran personnalisé via LittleFS.
  

Endpoints HTTP (Extrait)
GET   /api/status -> État, heure, valeurs des touches et du bus 
GET   /api/config -> Obtenir toute la configuration 
POST /api/press  -> Déclencher une touche via API (Param : i=0..5, a=short|long|end) 
POST /api/send   -> Envoyer un télégramme bus (Param : ga, dpt, val) 
POST /api/read   -> Lire une adresse de groupe (Param : ga, dpt) 
GET   /api/log     -> Obtenir les derniers télégrammes

6. Remarques importantes
Sécurité - L'interface web ne possède aucune authentification. Utilisation exclusive sur un réseau local sécurisé (LAN/VLAN).
Limites de la passerelle. L'ESP32 occupe en permanence un emplacement de connexion tunnel de votre passerelle KNX/IP.





Lien de téléchargement :
Knx Switch