KNX-Enocean Gateway -> Firmware Setup

ACHTUNG: Es handelt sich hier nicht um eine offizielle KNX ETS Firmware !!!

Diese Firmware basiert im KNX Teil auf der Arbeit von: https://github.com/thelsing und im EnOcean Teil auf der Konnekting Firmware https://gitlab.com/konnekting/firmware/eo-gw1.1

Der Einsatz dieser Firmware entspricht in keinster Weise den Vorgaben der KNX-Association !!!

–> Jeder baut sich seine Firmware selber und übernimmt damit selber die Verantwortung für sein Handeln

–> Es ist immer empfehlenswert vor jedem Gebrauch einer solchen selber erstellten ETS KNXProd, ein Export/Backup des aktuellen ETS-Projektes durchzuführen.

Installation aktuell nur über Windows 10/11 mit installierter ETS5/6 möglich !!!

Download: OpenKNXproducer

Zum erstellen der KNXprod für die ETS benötigt ihr folgendes Tool: OpenKNXproducer (Nachfolger des Multiplychannel)

Download Link: https://github.com/OpenKNX/OpenKNXproducer/releases

Hier per klick auf OpenKNXproducer.zip das File herunterladen.
Hinweis: nutzt immer die “Latest” Version (hier noch die 1.1.1, wird sich in Zukunft sicher ändern)

Windows signalisiert bei mir einen “ungewöhnlichen Download”, diese Info kann ignoriert werden.

Das Zip-File öffnen und Readme lesen!

1.) Zip-File in ein beliebiges Verzeichnis entpacken
2.) Das Verzeichnis öffnen
3.) mit der rechten Maustaste auf “Install-OpenKNX-Tools.ps1” klicken und weiter auf “Mit PowerShell ausführen” klicken.

Alle benötigten Dateien werden jetzt an den richtigen Ort kopiert, ggf. die Sicherheitswarnung mit “Datei öffnen” bestätigen.
(es wird nur kopiert -> mehr passiert nicht!)

Download: Firmware (Release)

Download Link: https://github.com/OpenKNX/OAM-EnoceanGateway/releases

Hier das “Latest” Release auswählen und das dazu passende ZIP-File herunterladen.

Das Zip-File öffnen und Readme lesen!

Erstellung der KNXprod (nur möglich wenn “OpenKNXproducer” auf dem PC vorhanden ist)

1.) Zip-File in ein beliebiges Verzeichnis entpacken
2.) Das Verzeichnis öffnen
3.) mit der rechten Maustaste auf “Build-knxprod.ps1” klicken
4.) “Mit PowerShell ausführen” wählen, ggf. die Sicherheitswarnung mit “Datei öffnen” bestätigen
(jetzt wird eine zum Release passende Produktdatenbank *.knxprod gebaut, dieser Vorgang kann eine gewisse Zeit dauern)
5.) Die EnoceanGateway.knxprod kann nun in die ETS eingebunden werden

Firmware-Download auf die Enocean-Gateway Hardware

1.) Verbinde das Gateway per USB-C an deinen PC und stelle sicher, das nur dieses Arduino-Device an diesen PC angebunden ist!
2.) Der KNX BUS kann, muss aber nicht an das Gateway angesteckt werden
3.) rechte Maustaste auf “Upload-Firmware-SAMD.ps1”
4.) “Mit PowerShell ausführen” wählen (jetzt wird die Firmware auf die Hardware geladen)
5.) die erfolgreiche Erkennung der Schnittstelle und Programmierung im Screen der Powershell prüfen.
Hinweis: Ein normaler Flash-Vorgang dauert in der Regel nicht länger als 30sek. Sollte es doch länger dauern, dann den Vorgang abbrechen, die Reset-Taste 2x drücken und den Vorgang noch einmal neu starten.
Bei Problemen:
– falls der SAMD am USB nicht gefunden wurde, die Reset-Taste 2x drücken (die LED muss pulsieren) und dann nochmal “Mit Powershell ausführen” wählen.

UND DAS WAR ES SCHON 🙂
jetzt könnt ihr das Enocean-Gateway verwenden wie jedes andere KNX-Device!

Die Nachfolgende Installationsbeschreibung ist hiermit “obsolete” und muss nicht mehr beachtet werden !!!

Setup Konfiguration (“old”)

Installation of GIT & VSC (Visual Studio Code)

Only tested on Windows 10!

Download and install git from https://git-scm.com/downloads with default options

Download and install visual studio code from https://code.visualstudio.com/download (User installer, 64 bit)

Start visual studio code

Go to extensions (Ctrl-Shift-X)

Enter “platformio” in search field

Install “PlatformIO IDE” extension

Installation of Multiply-Channel tool

Open https://github.com/mumpf/multiply-channels/releases

Download the newest release of multiply-channels, currently it is version 2.1.2. (click on MultiplyChannels.exe and the download will start automatically)

Save it to C:\Users\<username>\bin (usually you have to create bin directory)

Use VSC to download the firmware

ATTENTION: for the new Firmware Version with the Logic channels, plaese use the new instruction:

https://gitlab.com/DIY-Smarthome-Projekt/knx-enocean-gateway/-/blob/release/doc/knx-dev-setup.md

The video below shows the old version. You can use it, but you have to note, that for the new Firmware version, two parts are different:

1.) You have to use the new git commands from the instruction

2.) to build the KNXprod, now you have to press “strg+shift+T” instead of “strg+shift+P”. Chosse the “MultiplyChannels knx-enocean-gateway”

I will update the video as soon as possible!

How to upload the Firmware to your Hardware

Connect your device via USB to your PC

Attention: before you upload the code and the Serial Monitor is active, please always disable the “PlatformIO:Serial Monitor”. for That press the “Plug” Symbol on the buttom blue line and press “Terminate Task” in the pop Up window.

Press Ctrl-Shift-B, select Upload USB build task and press enter.

Wait until file is uploaded.

Remove always the USB cable after flash process is finish !!!

KNXprod Settings

NEW: in all Application-Versions >=0.5 the next steps are obsolete (in the Parameter settings the Checkboxes are not visable)

OLD: for the new version it is necessary to change this parameter in the ETS Software

The Checkbox “Nichtflüchtiger Speicher vorhanden (EEPROM)?” must be inactive!