Konfiguration des Gateways

Konfiguration des Gateways

In diesem Abschnitt wird beschrieben, wie ein Gateway im myGEKKO OS aktiviert und konfiguriert wird.

 
Hinweis

In myGEKKO OS stehen bis zu vier Gateway-Elemente zur Verfügung. Diese sind unabhängig voneinander in Bezug auf Konfiguration, Kommunikationsprotokoll und Zeitreferenz.

Aktivierung des Gateways

  1. Öffnen Sie das Einstellungsmenü des Systems
  2. Klicken Sie auf das Welt-Symbol, um in den Netzwerkbereich zu gelangen.
  3. Navigieren Sie zum Abschnitt „Gateway“.
  4. Klicken Sie auf einen der vier verfügbaren „Add“-Buttons, um ein neues Gateway hinzuzufügen.
 
Hinweis

Zum Aktivieren eines Gateways werden Konfigurator-Rechte benötigt.

Sobald ein Gateway hinzugefügt wurde, erscheint das zugehörige Konfigurationsmenü – das Gateway ist nun aktiv.

Der Konfigurationsbildschirm eines Gateways ist in fünf Bereiche unterteilt:

  • Allgemeine Informationen
  • Gateway-Einstellungen
  • Berechtigungseinstellungen
  • Konfigurationsverwaltung
  • Diagnosebereich

Im Abschnitt „Allgemeine Informationen“ findet der Benutzer:

  • Name: Bezeichnet den Namen des Gateways. Standardmäßig lautet dieser „Gateway“. Der Name kann vom Benutzer geändert werden und darf bis zu 64 Zeichen lang sein.
  • Status: Zeigt den aktuellen Zustand des Gateways an. Die möglichen Statuswerte sind in einer separaten Tabelle definiert.
  • Delete: Schaltet das Gateway aus und entfernt es. Dabei werden die Verbindung geschlossen, Logdateien beendet und die Konfiguration auf die Standardwerte zurückgesetzt. Die Konfigurationsdatei selbst bleibt erhalten.

Status

Grund

Lösung

No connection

Die Initialisierung wurde erfolgreich durchgeführt, aber das Gateway ist nicht verbunden.

Überprüfen Sie die Verbindungsparameter.

Prüfen Sie die Hardware des Connectors.

Kontaktieren Sie den Support, falls das Problem weiterhin besteht.

No config. file

Keine Konfigurationsdatei gefunden, d.h. der Benutzer hat keine gültige Gateway-Konfigurationsdatei hochgeladen.

Überprüfen Sie die Konfigurationsdatei.

Laden Sie die Konfigurationsdatei erneut hoch.

Init fail

Die Initialisierung des Connectors schlägt fehl.

Überprüfen Sie die Verbindungsparameter.

Prüfen Sie die Hardware des Connectors.

Kontaktieren Sie den Support, falls das Problem weiterhin besteht.

Thread stop

Der Thread wurde gestoppt.

Starten Sie den myGEKKO-Controller neu, wenn dieser Zustand bestehen bleibt.

Kontaktieren Sie den Support, falls das Problem weiterhin besteht.

No error

Initialstatus des Gateways.

OK

Das Gateway ist verbunden und sendet/empfängt Daten.

Im Abschnitt „Gateway-Einstellungen“ findet der Benutzer folgende Optionen:

  • Enabled: Hier wird festgelegt, ob das Gateway aktiviert ist, um Daten zu senden und zu empfangen. Das Gateway kann konfiguriert sein, ohne dass der Datenaustausch tatsächlich aktiv ist. Mögliche Einstellungen sind: „Aktiv“ oder „Aus“
  • Protocol: Das Kommunikationsprotokoll, über das die Daten gesendet und empfangen werden. Hinweis: Aktuell steht nur KNX zur Verfügung.
  • Link: Die Kommunikationsschnittstelle des ausgewählten Protokolls. Eine Liste der verfügbaren Schnittstellen für jedes Protokoll ist im nächsten Abschnitt („Links“) zu finden.
  • Connector Status: Zeigt den aktuellen Status des Verbindungsmoduls (Connectors) an. Eine Übersicht der möglichen Statuswerte ist ebenfalls in der Tabelle der Links zu finden.

Verfügbäre Schnittstellen des KNX-Protokolls:

Schnittstelle

Erklärung

NC

Nicht verbunden.

USB/ONBOARD

Verbindung des myGEKKO Controllers mit dem KNX-Bus (TP) über einen USB-Dongle oder die integrierte KNX-Schnittstelle (Onboard).

KNXnet/IP Tunneling Interface

Verbindung über ein IP-Interface zum KNX-Bus (TP). Es handelt sich um eine Punkt-zu-Punkt-Verbindung zwischen dem myGEKKO Controller und dem IP-Interface. Die IP-Adresse des Interfaces muss angegeben werden.

KNXnet/IP Routing

Kommunikation über Ethernet mit anderen Geräten, unter Verwendung der Multicast-Adresse 224.0.23.12.

Tiny-Serial

FT1.2-Serial

myGEKKO NODE

Verbindung des Controllers zum KNX-Bus (TP) mittels des myGEKKO NODE.

Liste der möglichen Connector-Status für das KNX-Protokoll:

  • Init. Error 7, 5, 4, 3, 2, 1: Interne Fehlercodes – die Verbindung konnte nicht aufgebaut werden.
  • Waiting for Init.: Der Connector wartet auf die Initialisierung.
  • OK: Der Connector funktioniert einwandfrei.
  • Warning 1, 2, 3: Interne Warncodes – die Verbindung ist aktiv, es kann jedoch zu Problemen kommen.
  • Unknown IF: Die gewählte Schnittstelle ist unbekannt – tritt z. B. bei Auswahl von „NC“ (Not Connected) auf.

Je nach ausgewähltem Link werden zusätzliche Eingabefelder angezeigt, um die Verbindung korrekt zu konfigurieren:

  • Bei Auswahl von KNXnet/IP Tunneling Interface:

  • IP: Die IPv4-Adresse, die dem Controller im KNX-Netzwerk zugewiesen ist.

  • Bei Auswahl von Tiny-Serial oder FT1.2-Serial:

  • Port: Der zu verwendende serielle Anschluss (aus den verfügbaren Optionen):

    • COM-Port 1
    • COM-Port 2
    • USB.COM-Port 1
    • USB.COM-Port 2
    • USB.COM-Port 3
    • USB.COM-Port 4
    • USB.RS485
    • USB.RS232
  • Bei Auswahl von myGEKKO Node:
    • MAC/IP: Die MAC- oder IP-Adresse des myGEKKO Node-Boards, mit dem verbunden werden soll.
    • IP: Ein Textfeld, das die beim Verbindungsaufbau erkannte IP-Adresse anzeigt.
    • Version: Die erkannte Version des verbundenen myGEKKO Node-Moduls.

Im Abschnitt Gateway-Berechtigungen kann der Benutzer die Rechte des Gateways im Hinblick auf die Signale festlegen. Mögliche Optionen:

  • Nur lesen: Das Gateway kann die einzelnen Zustände der IO-Signale lesen und über die gewählte Verbindung und das gewählte Protokoll übertragen.
  • Lesen + Schreiben: Zusätzlich zum Lesen kann das Gateways auch Befehle senden, um den aktuellen Zustand der Signale zu verändern.

Im Abschnitt Gateway-Konfigurationsverwaltung stehen dem Benutzer folgende Optionen zur Verfügung:

  • Bericht generieren: Schaltfläche zum Erstellen einer Berichtdatei, die Informationen über die Aktivitäten von Zuständen und Befehlen enthält. Nach Erstellung kann der Bericht über die Schaltfläche „Download“ heruntergeladen werden.
  • Download: Schaltfläche zum Herunterladen der zuletzt gespeicherten Version der Konfigurationsdatei.
  • Upload: Schaltfläche zum Hochladen einer vom Benutzer vorbereiteten Konfigurationsdatei auf den Controller.

Fehler beim Hochladen einer Konfigurationsdatei

Beim Hochladen einer Konfigurationsdatei führt ein Formatfehler zum Abbruch des gesamten Importvorgangs.

Die Zeile mit dem ersten gefundenen Fehler sowie der Grund des Fehlers werden im Viewer angezeigt.

Nachfolgend die Liste möglicher Fehler und empfohlene Lösungen:

Fehler

Grund

Lösung

Wrong signal address

Die IO-Adresse wurde aufgrund eines falschen Formats oder Inhalts nicht erkannt.

Prüfen Sie die Dokumentation, um die Adresse korrekt zu schreiben.

Signal name too long

Der angegebene Name für das IO-Signal überschreitet die maximale Länge.

Verwenden Sie einen Namen mit maximal 64 Zeichen.

Wrong data type

Der angegebene Datentyp ist unbekannt oder falsch geschrieben.

Stellen Sie sicher, dass der Datentyp korrekt geschrieben ist. Eine Liste befindet sich im Anhang.

Wrong signal direction

Die Signalrichtung wurde nicht korrekt angegeben.

Verwenden Sie PUBLISH oder SUBSCRIBE, oder lassen Sie das Feld leer (Standard: PUBLISH).

Wrong enable

Das Aktivierungsfeld enthält keinen gültigen Wert.

Nur „true“ oder „false“ zulässig (Groß-/Kleinschreibung egal).

Wrong signal change time

Der Wert zur Änderungsüberwachung liegt außerhalb des gültigen Bereichs.

Gültiger Bereich: 1 bis 86400 Sekunden.

Wrong force sending time

Der Wert zur forcierten Sendung ist ungültig.

Gültiger Bereich: 2 bis 604800 Sekunden.

Wrong change type

Der Änderungstyp ist unbekannt.

Zulässig sind: ABS (absolute Änderung) oder % (prozentuale Änderung).

Wrong value to change

Der Vergleichswert ist ungültig.

Bei ABS: nur positive Werte. Bei %: Bereich 0,0 bis 100,0.

Wrong signal DPT

Der verwendete DPT ist ungültig.

Einen gültigen DPT laut Anleitung zur Konfigurationsdatei verwenden.

Wrong KNX address

Die Gruppenadresse ist außerhalb des gültigen Bereichs.

Eine gültige Adresse im Format X/Y/Z eintragen, z. B. 1/1/1.

Signal comment too long

Der Kommentar des IO-Signals ist zu lang.

Kommentar auf max. 512 Zeichen beschränken.

KNX address duplicated

Diese Gruppenadresse wird bereits von einem anderen Signal verwendet.

Eine noch nicht verwendete Gruppenadresse eintragen.

Invalid row size

Die Zeile enthält nicht genügend Felder.

Zeile auf Vollständigkeit und Pflichtfelder überprüfen.

Warning empty KNX address

Die Gruppenadresse ist leer oder unvollständig.

Kann ignoriert werden, wenn Adressen bewusst offen gelassen wurden (z. B. 1/1/-, -/-/-).

 
Hinweis

Die Anzahl der Signale, die in der Konfigurationsdatei enthalten sein dürfen, ist lizenzabhängig begrenzt. Nach dem Hochladen einer Konfigurationsdatei wird die aktuell verwendete Signalanzahl oben im Bildschirm angezeigt.

Beispiel: 10/50 bedeutet, dass derzeit 10 Signale verwendet werden, wobei die Lizenz maximal 50 Signale erlaubt.

Im Bereich Diagnose des Gateways stehen dem Benutzer folgende Optionen zur Verfügung:

  • Log aktivieren: Hier kann ausgewählt werden, ob ein Log (Protokollierung) aktiviert werden soll und wohin die Logdatei gespeichert wird.

  • Mögliche Optionen:

    • Aus
    • USB-Stick: Die Logdatei wird auf einem externen USB-Stick gespeichert.
    • Server: Die Logdatei wird auf einem zuvor konfigurierten Server abgelegt.
    • Intern: Die Logdatei wird im internen Speicher des Controllers gespeichert.
    •  
      Hinweis

      Große Logdateien können den internen Speicher des Controllers überlasten.

  • Log herunterladen: Schaltfläche zum Herunterladen der aktuellen Logdatei.
  • Diagnose: Zeigt Status- und Fehlermeldungen des DataShare-Moduls an. Diese Informationen dienen insbesondere dem technischen Support.