Configuration de la passerelle KNX

Ce nƓud se connecte à votre passerelle KNX / IP.

Général

Propriété Description
Nom Nom du nƓud.
Ip / hostname Adresse multidiffĂšre du routeur ETH / KNX ou adresse IP unicast. Si vous avez une interface KNX / IP, utilisez l’adresse IP de l’interface, par exemple 1982.168.1.22, sinon, si vous avez un routeur KNX / IP, mettez l’adresse de multidiffusion 224.0.23.12. Vous pouvez Ă©galement taper un nom d’hĂŽte au lieu d’une IP.

Configuration

Propriété Description
Port IP Le port. La valeur par défaut est 3671.
Protocole IP Tunnel UDP est pour les interfaces KNX / IP, Multicast UDP est pour les routeurs KNX / IP. Laissez Auto pour la dĂ©tection automatique. La valeur par dĂ©faut est “Auto”.
Mode Serial FT1.2 DĂ©finit comment l’interface sĂ©rie FT1.2 est initialisĂ©e : KBerry/BAOS active la sĂ©quence spĂ©cifique pour les modules Weinzierl KBerry/BAOS (reset, mode Link Layer/BAOS, aucun filtre de GA), tandis que Standard FT1.2 utilise un adaptateur FT1.2 gĂ©nĂ©rique sans Ă©tapes spĂ©cifiques Ă  KBerry. La valeur par dĂ©faut est KBerry/BAOS.
Adresse physique KNX L’adresse physique KNX, exemple 1.1.200. La valeur par dĂ©faut est “15.15.22”.
Se lier Ă  l’interface locale Le nƓud utilisera cette interface locale pour les communications. Laissez “Auto” pour la sĂ©lection automatique. Si vous avez plus d’une connexion LAN, par exemple Ethernet et WiFi, il est fortement recommandĂ© de sĂ©lectionner manuellement l’interface, sinon tout le tĂ©lĂ©gramme UDP n’atteindra pas votre ordinateur, donc le nƓud peut ne pas fonctionner comme prĂ©vu. La valeur par dĂ©faut est “Auto”.
Connectez-vous automatiquement au bus KNX au dĂ©marrage Connectez-vous automatiquement au bus au dĂ©part. La valeur par dĂ©faut est “oui”.
Secure d’identification sĂ©curisĂ©e Choisissez comment les donnĂ©es sĂ©curisĂ©es KNX sont fournies: ETS Fichier de clĂ©s ** (DonnĂ©es Secure Keys - et les informations d’identification de tunneling si elles sont prĂ©sentes - proviennent de la clĂ©s),Indementiels manuels ** (Seul KNX IP Tunneling Secure avec un utilisateur saisi manuellement), ouClĂ©mentiel + Mot de passe du tunnel manuel Utilisateur manuel). N’oubliez pas que les tĂ©lĂ©grammes Secure Data KNX nĂ©cessitent toujours un fichier de clĂ©s.
Interface tunnel Adresse individuelle Visible chaque fois que le mode sĂ©lectionnĂ© comprend des informations d’identification manuelles (manuel ou clĂ©s + mot de passe du tunnel manuel). Adresse individuelle KNX facultative pour l’interface du tunnel sĂ©curisĂ© (par exemple 1.1.1); Laissez vide pour laisser KNX Ultimate le nĂ©gocier automatiquement.
ID utilisateur du tunnel Visible lorsque des rĂ©fĂ©rences manuelles sont utilisĂ©es. Identificateur d’utilisateur de tunnel Secure KNX en option dĂ©fini dans ETS.
Mot de passe utilisateur du tunnel Visible lorsque des rĂ©fĂ©rences manuelles sont utilisĂ©es. Mot de passe de l’utilisateur de tunneling Secure KNX configurĂ© dans ETS.

KNX Secure Essentials
‱ KNX Data Secure protĂšge les tĂ©lĂ©grammes d’adresses de groupe et toujours a besoin d’un fichier de clĂ©s contenant les touches de groupe.
‱ KNX IP Tunneling Secure protĂšge la poignĂ©e de main de connexion avec un mot de passe de mise en service. Selon le mode sĂ©lectionnĂ©, le mot de passe peut provenir du clĂ©s ou ĂȘtre entrĂ© manuellement.
‱ KNX/IP Secure (handshake du tunnel) ne s’applique qu’aux transports IP (Tunnel TCP / routage sĂ©curisĂ©). KNX Data Secure protĂšge les tĂ©lĂ©grammes d’adresses de groupe et peut ĂȘtre utilisĂ© Ă  la fois sur IP (tunneling/routage) et sur TP via Serial FT1.2 lorsqu’un fichier keyring ETS est fourni.

Avancé

Propriété Description
Echo envoyĂ© un message Ă  tous les nƓuds avec la mĂȘme adresse de groupe Envoyez l’entrĂ©e MSG provenant du flux, Ă  tous les nƓuds ayant la mĂȘme adresse de groupe. Les nƓuds recevront le nouveau MSG comme s’il provenait du bus KNX. Ceci est utile en cas d’utilisation de l’émulation KNX et au cas oĂč la connexion au bus KNX n’est pas Ă©tablie. Cette option sera obsolĂšte dans la version suivante et par dĂ©faut est vĂ©rifiĂ©e. La valeur par dĂ©faut est vĂ©rifiĂ©e.
Supprimez les tĂ©lĂ©grammes rĂ©pĂ©tĂ©s (R-FLAG) FOM BUS Ignorez des tĂ©lĂ©grammes KNX rĂ©pĂ©tĂ©s provenant du bus. La valeur par dĂ©faut n’est pas contrĂŽlĂ©e.
Supprimez la demande ACK en mode tunnel Activez-le si vous avez une trĂšs ancienne passerelle KNX / IP. Il ignore la procĂ©dure ACK et accepte tous les tĂ©lĂ©grammes. La valeur par dĂ©faut n’est pas contrĂŽlĂ©e.
Retard entre chaque tĂ©lĂ©gramme (en millisecondes) KNX Specs indique que la vitesse d’envoi de tĂ©lĂ©gramme maximum est de 50 tĂ©lĂ©grammes par seconde. Une vitesse comprise entre 25 et 50 ms devrait ĂȘtre bien, sauf si vous vous connectez Ă  une passerelle KNX distante via une connexion Internet lente (dans ce cas, vous devez augmenter la valeur, par exemple, 200 Ă  500 ms ou plus).
Loglevel Niveau de journal, au cas oĂč vous auriez besoin de dĂ©boguer quelque chose avec le dĂ©veloppement. La valeur par dĂ©faut est “erreur”,
Temporisation de l’état du nƓud DĂ©finissez la frĂ©quence de mise Ă  jour des badges de statut. Avec un dĂ©lai actif, les changements intermĂ©diaires sont ignorĂ©s et seul le dernier est affichĂ© aprĂšs l’intervalle choisi. SĂ©lectionnez ImmĂ©diat pour conserver le comportement en temps rĂ©el.

ETS Importation du fichier

Propriété Description
Si l’adresse du groupe n’a pas de point de donnĂ©es Si une adresse de groupe n’a pas de point de donnĂ©es, elle permet de choisir pour arrĂȘter l’importation, importer Quth un faux point de donnĂ©es de 1,001 ou pour ignorer l’importation de cette adresse de groupe
Liste d’adresses du groupe ETS Utilisez cette section pour importer votre fichier ETS CSV ou ESF. Vous pouvez soit coller le contenu du fichier CSV ou ESF ** oudĂ©finir le chemin du fichier** , par exemple ./pi/homecsv.csv. Veuillez vous rĂ©fĂ©rer aux liens d’aide pour d’autres Infos.

Utilitaire

Propriété Description
Rassemblez les informations de dĂ©bogage pour le dĂ©pannage Veuillez cliquer sur le bouton et l’ajouter au problĂšme GitHub que vous souhaitez ouvrir, cela m’aidera beaucoup Ă  vous aider.
Obtenez tous les GA d’occasion pour le filtre de routage KNX Appuyez sur Read pour rĂ©cupĂ©rer une liste de texte brut de toutes les adresses de groupe appartenant Ă  cette passerelle, qui a Ă©tĂ© utilisĂ©e dans les flux. Vous pouvez utiliser cette liste pour remplir votre table de filtre de routeur KNX / IP.

Travailler avec le fichier ETS CSV ou ESF

Au lieu de crĂ©er un nƓud KNX-ultime pour chaque adresse de groupe Ă  contrĂŽler, vous pouvez importer votre fichier d’adresses de groupe CSV ETS ou, Ă  partir de V 1.1.35, un fichier ESF Ă©galement (si, par exemple, vous n’avez qu’ETS Ă  l’intĂ©rieur). Versions ETS prises en charge: ETS 4 et Ă  partir.

À partir de la version 1.4.18, vous pouvez Ă©galement entrer simplement le chemin d’accĂšs au fichier dans ce champ (par exemple: /home/pi/mycsv.csv).

GrĂące Ă  cela, le nƓud KNX-ultime oĂč vous avez sĂ©lectionnĂ© Mode universel (Ă©coutez toutes les adresses de groupe) , devient un nƓud d’entrĂ©e / sortie universel, conscient de tous les points de donnĂ©es, des adresses de groupe et du nom de l’appareil (ex: lampe de salon). Envoyez simplement la charge utile au nƓud KNX-ultime, et il le codera avec le bon point de donnĂ©es et l’enverra dans le bus. De mĂȘme, lorsque le nƓud KNX-ultime reçoit un tĂ©lĂ©gramme du bus, il offre une charge utile dĂ©codĂ©e droite Ă  l’aide du point de donnĂ©es spĂ©cifiĂ© dans le fichier ETS CSV ou ESF.

À partir de version 1.1.11 ** , vous pouvez utiliserMode universel (Ă©coutez toutes les adresses de groupe) ** Option sans avoir besoin d’un fichier ETS CSV ou ESF importĂ©. Vous devez transmettre un message au nƓud, contenant le type de point de donnĂ©es et une valeur. DĂšs que le nƓud reçoit un tĂ©lĂ©gramme de KNX Bus, il sortira une valeur brute et Ă  cĂŽtĂ©, il essaiera de dĂ©coder la valeur sans connaĂźtre le type de point de donnĂ©es. Remarque : ETS Adresse du groupe CSV Fichier exportĂ© est la meilleure option, car il contient des points de donnĂ©es prĂ©cis avec sous-type. ETS ESF ExportĂ© File est plus simple et il n’a pas le sous-type.

Si vous pouvez utiliser les deux, veuillez prĂ©fĂ©rer le fichier exportĂ© de l’adresse du groupe CSV * *, car l’ESF peut conduire Ă  une fausse valeur de sortie. Veuillez vĂ©rifier manuellement et Ă©ventuellement ajuster les points de donnĂ©es chaque fois que vous importez le fichier ESF**. Ă  partir de la version 1.4.1 Vous pouvez Ă©galement importer des adresses de groupe Ă©galement Ă  l’exĂ©cution, via MSG, en utilisant le nƓud de surveillance.

Vous pouvez travailler avec un mĂ©lange de nƓuds KNX-ultime, certains avec le mode ** Universal (Ă©coutez toutes les adresses de groupe)** VĂ©rifiĂ© et d’autres non. Vous ĂȘtes absolument libre!

  • ** ETS CSV Group Adresses List Import ** _Attention: il ne doit pas y avoir de caractĂšres de tabulation au nom de l’adresse du groupe ** _Si l’adresse du groupe n’a pas de point de donnĂ©es ** > Si une adresse de groupe n’a pas de point de donnĂ©es dans l’ETS, vous pouvez sĂ©lectionner pour arrĂȘter et interrompre l’intĂ©gralitĂ© du processus d’importation, pour sauter l’adresse du groupe affectĂ©e ou pour ajouter l’adresse du groupe affectĂ©e avec un faux point de donnĂ©es et continuer l’importation. Comment exporter les ETS -> CSV <- Liste des adresses de groupe > Sur ETS, cliquez sur la liste des adresses de groupe, puis cliquez avec le bouton droit, puis sĂ©lectionnez «Exporter des adresses de groupe». Dans la fenĂȘtre d’exportation, sĂ©lectionnez ces options:

** Format de sortie** : CSV

** Format CSV** : 1/1 nom / adresse

** Exportation avec ligne d’en-tĂȘte** : vĂ©rifiĂ©

** CSV Séparateur** : Tabulator.

Collez ensuite le contenu du fichier ici.

Notez que le fichier ETS CSV doit contenir les points de données pour chaque adresse de groupe.

Le nƓud analyse votre fichier CSV ETS avant de l’utiliser et vous indiquera les rĂ©sultats dans l’onglet de dĂ©bogage de la page Node-Red.

Le rĂ©sultat peut ĂȘtre de deux types: ** Erreur ** etavertissement

** L’erreur** se produit lorsqu’un point de donnĂ©es n’est pas spĂ©cifiĂ© pour une adresse de groupe. Il s’agit d’une erreur critique et arrĂȘte le processus d’importation du fichier ETS CSV.

** L’avertissement** se produit lorsque le sous-type d’un Datapoint n’est pas spĂ©cifiĂ©. Dans ce cas, l’analyseur de nƓud y ajoutera un par dĂ©faut, mais vous avertit que vous montrez et corrigez le point de donnĂ©es, en ajoutant un sous-type. Un sous-type est le nombre restant Ă  droite du “.” dans un point de donnĂ©es (ex: 5.001).

Remarque: les champs doivent ĂȘtre entourĂ©s de ** “** par exemple:

“ACTUATEURS LIGHTS” “0 / - / -“ “” “” “” “” “” Car “ ** Comment exporter les ETS -> ESF <- Liste des adresses de groupe**

Sur la fenĂȘtre ETS, sĂ©lectionnez votre projet, puis cliquez sur l’icĂŽne d’exportation (l’icĂŽne avec la flĂšche vers le haut)

Sélectionnez pour exporter le projet au format ESF (pas le .knxprod par défaut)

Copiez ensuite le contenu du fichier et collez-le dans le champ de la liste d’adresses de groupe de passerelle “ETS”.

<Table Style = "Font-Size: 12px">
    <tr>
    <th Colspan = "2" style = "Font-Size: 14px"> Couleurs d'Ă©tat du nƓud Explication </th>
    </tr>
    <tr>
    <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/greendot.png"> </ img> </ td>
    <TD> réagir aux télégrammes d'écriture </td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/greenring.png"> </ img> </ td>
        <TD> Protection de référence circulaire. <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Protections" target = "_ blanc"> voir cette page. </a> </ td>
    </tr>
    <tr>
    <td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/bluedot.png" alt="Blue status dot" /></td>
    <TD> réagir aux télégrammes de réponse. </td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/bluering.png"> </img> </td>
        <TD> Auto Envoi de la valeur du nƓud comme rĂ©ponse au bus. <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---Virtual-Device" cible = "_ Blank"> Voir le pĂ©riphĂ©rique virtuel. </a> </ td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/greudot.png"> </ img> </ td>
        <TD> réagir aux télégrammes de lecture. </td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/greyring.png"> </ img> </ td>
        <TD> Filtre RBE: aucun télégramme n'a été envoyé. </td>
    </tr>
    <tr>
        <td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/reddot.png" alt="Red status dot" /></td>
        <td> Erreur ou déconnecté. </td>
    </tr>
    <tr>
        <td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/redring.png" alt="Red status ring" /></td>
        <TD> Node désactivé en raison d'une référence circulare. <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Protections" target = "_ blanc"> voir cette page. </a> </ td>
    </tr>
</ table>

Using KNX Ultimate with kBerry on Raspberry Pi 3 (UART / FT1.2)

This guide explains how to connect a kBerry KNX interface directly to a Raspberry Pi 3 and use it with KNX Ultimate over the hardware UART (ttyAMA0) using the FT1.2 (TPUART) protocol.

This procedure was tested with Raspberry Pi OS Bookworm on a
Raspberry Pi 3 (November 25, 2025).

1. Prerequisites

  • Raspberry Pi 3 (Model B or B+)
  • Raspberry Pi OS (Bookworm recommended)
  • kBerry KNX interface mounted on the GPIO header
  • Node-RED with KNX Ultimate installed
  • Basic terminal access (SSH or local console)

2. Wiring / Hardware Overview

The kBerry uses the Raspberry Pi’s primary UART:

  • TX / RX: GPIO14 (TXD) and GPIO15 (RXD)
  • GND: Common ground between Raspberry Pi and kBerry
  • Power: Provided via the GPIO header

Make sure the kBerry is properly seated on the Raspberry Pi GPIO header and that no other HAT is conflicting with those pins.

3. Disable Bluetooth and Enable the Hardware UART

3.1 Edit the correct config file (Bookworm)

sudo nano /boot/firmware/config.txt

Add (or ensure you have):

enable_uart=1
dtoverlay=pi3-disable-bt

3.2 Disable ModemManager (if present)

sudo systemctl disable --now ModemManager

3.3 Disable Bluetooth service

sudo systemctl disable --now bluetooth.service

4. Disable Serial Login Console / Enable Hardware UART

Start the configuration tool:

sudo raspi-config

Then navigate through the menus:

  • Interface Options (or Interfacing Options on older systems)
  • Serial Port

You will see two questions:

  • “Login shell to be accessible over serial?” → choose No
  • “Enable serial port hardware?” → choose Yes

Finish and exit raspi-config, then reboot when asked (or manually later).

5. Verify UART

ls -l /dev/serial0
ls -l /dev/ttyAMA0
dmesg | grep tty

Expected:

/dev/serial0 -> ttyAMA0
/dev/ttyAMA0 exists

6. Add Node-RED user to dialout

Linux uses the dialout group to grant access to serial ports like /dev/ttyAMA0 or /dev/ttyUSB0.
The user that runs Node-RED must belong to this group, otherwise KNX Ultimate cannot open the serial port.

If you installed Node-RED with the official script, the service user is usually nodered. On some systems it may be pi or another user; adapt the commands accordingly.

Check the current groups:

id nodered   # or: id pi

Add the user to the dialout group:

sudo usermod -aG dialout nodered

After changing group membership, log out and log in again for that user, or simply reboot:

sudo reboot

This step is only needed when you use a serial gateway; pure KNX/IP setups do not require dialout.

7. Configure KNX Ultimate

In the KNX Ultimate gateway node:

  • Interface type: Serial FT1.2 / TPUART
  • Serial port: /dev/ttyAMA0
  • Baud rate: 19200
  • Data bits: 8
  • Parity: Even
  • Stop bits: 1

8. Troubleshooting

No /dev/ttyAMA0

  • Check /boot/firmware/config.txt entries
  • Reboot
  • Re-check dmesg

/dev/serial0 → ttyS0

  • dtoverlay=pi3-disable-bt not applied
  • Re-check config file path
  • Reboot

Serial cannot be opened

  • Ensure the Node-RED user is in dialout (id nodered)
  • Check that no other program is using /dev/ttyAMA0
  • Verify that the KNX Ultimate gateway node is configured for /dev/ttyAMA0

Done.