Die Konfigurationsdatei - DSC
Aufbau der Konfigurationsdatei
Der Name der Konfigurationsdatei, sobald sie heruntergeladen wird, lautet „dsc_knx_itemlist_0.csv“.
Die Datei ist in Spalten unterteilt, welche wie folgt beschrieben sind:
- myGEKKO Net: der Controller zu welchem die Daten gehören.
Der Nutzer darf dies NICHT verändern. - Systemname: Name des Systems, zu welchem die Daten gehören. Beispiel: „lights“
Der Nutzer darf dies NICHT verändern. - Item Gruppen-ID: die Identifikationsnummer des Elements im System. Beispiel: „item0“
Der Nutzer darf dies NICHT verändern. - Seitenname: Name der Seite auf welcher das Element sich befindet. Beispiel: „Living room“
Der Nutzer darf dies NICHT verändern. - Elementname: Name des Elements. Beispiel: „Hauptlicht“
Der Nutzer darf dies NICHT verändern. - Status/Kommando Name: Name des Datenpunkts, der geteilt werden soll. Beispiel: „dimLevel“
Der Nutzer darf dies NICHT verändern. - Format: den Datentyp des Status oder Befehls mit seinem Wertebereich, gefolgt von dem Bereich und der Einheit. Zum Beispiel: “float[0.00,100.0](%)”.
- KNX DPT: der KNX Datentyp der mit dem Wert verbunden ist und dazu genutzt wird um die Daten zu übertragen/empfangen. Beispiel: „DPT_1“
Der Nutzer darf dies NICHT verändern. - Formel: eine mathematische Formel, die auf die rohen Daten angewendet werden. Es sind Addition, Subtraktion, Multiplikation und Division erlaubt. Die Rohdaten sind mit „x“ gekennzeichnet. Das Feld kann auch leer bleiben. Beispiel: "(x+1)/4"
Kann auch leer bleiben. - Aktiviert: ob der Status/Kommando für das Teilen freigegeben ist. Standardmäßig auf „false“.
Darf nicht leer sein. Nimmt nur „true“ oder „false“ als Werte an. - KNX Gruppenadresse: die KNX Gruppenadresse, die mit dem Wert verbunden ist und dazu genutzt wird um die Daten zu übertragen/empfangen. Beispiel: „1/1/4“
- Kommentar: Notizen, die der Konfigurator macht, um sich an Dinge zu erinnern oder die Konfiguration zu verdeutlichen. Sie greifen nicht in den myGEKKO Controller ein und sind rein informativ. Zum Beispiel: „Diese Leuchte ist derzeit außer Betrieb“.
Kann auch leer bleiben.
Eine Datei ist dann entsprechend so aufgebaut (ohne „<>“):
#0-<myGEKKO Net>;1-<Systemname>;2-<Item ID>;3-<Seitenname>;4-<Elementname>;5-<Status/Kommando Name>;6-<Format>;7-<KNX DPT>;8-<Formel>*;9-<Aktiviert>*;10-<KNX Gruppenaddresse>**;11-<Kommentar>*
Eine Beispiel-Konfiguration wäre:
local;lights;item0;Kitchen;Small light;currentState;enum[0=off,1=on]();DPT_1;;true;GA -/-/-;The small light of the kitchen;
Zusätzlich müssen einige Dinge zur Datei beachtet werden:
- Spalten, die mit einem „*“ markiert sind, sollten vom Nutzer ausgefüllt werden und können auch nicht leer bleiben. Wenn eine dieser Informationen leer ist, wird die Zeile beim Einlesen übersprungen.
- Spealten, die mit zwei „**“ markiert sind, sollten vom Nutzer ausgefüllt werden und können jedoch leer bleiben.
- Wenn ein neues Element am Controller erstellt wird, werden alle Status/Kommandos in eigenen Zeilen hinzugefügt. In diesen Zeilen ist „Aktiviert“ auf „false“, die Fomel leer, KNX DPT entspricht dem vom Controller vorgeschlagenen Standardwert und die KNX GRuppenadresse ist leer („-/-/-“). Beispiel:
local;lights;item0;Test;Test;currentState;;false;DPT_1;-/-/-;
- NICHT eine der Spalten ändern, die nicht mit einem „*“ oder „**“ markiert sind.
- Wenn der Nutzer eine der Zeilen eines Elements entfernt, wird diese beim nächsten Download wieder hinzugefügt.
- Falls der Nutzer eine Zeile nicht konfigurieren möchte, jedoch auch nicht entfernen, dann kann diese Zeile mit einem „#“ am Anfang auskommentiert werden. Auskommentierte Zeilen werden nicht gelesen.
- Ein Datenelement oder Status wird nur verarbeitet, sofern die KNX Gruppenadresse gültig ist. Unabhängig davon, ob „Enable“ auf „true“ gestellt ist.
Liste der Operatoren für den Formel-Teil
- „*“ = Multiplikation
- „/“ = Division
- „+“ = Addition
- „-“ = Subtraction
- „^“ = Exponent
- „>“ = Größer als
- „<“ = Kleiner als
- „>=“ = Größer gleich
- „<=“ = Kleiner gleich
- „!=“ = ungleich
- „==“ = gleich
- „>>“ = Rechte Verschiebung
- „<<“ = Linke Verschiebung
- „&&“ = Logisches UND (AND)
- „||“ = Logisches ODER (OR)
- „&“ = Bitweise UND (AND)
- „|“ = Bitweise ODER (OR)
Export der Konfigurationsdatei
Die Konfigurationsdatei für den Data Share Container kann einfach heruntergladen werden.
- Als Konfigurator anmelden
- Die Einstellungen auf der Startseite öffnen
- Den Reiter für die Netzwerkeinstellungen (Globus-Symbol) öffnen
- „Data Share Container“ wählen
- Mit der „Konfiguration exportieren“-Schaltfläche den Speicher-Dialog für die Datei öffnen
- Einen Speicherort wählen und die Datei herunterladen
- Die Datei sollte nun heruntergeladen werden und dann am Gerät zur Verfügung stehen.
Import der Konfigurationsdatei
Sobald die Datei angepasst wurde, kann diese auch wieder importiert werden.
- Als Konfigurator anmelden
- Die Einstellungen auf der Startseite öffnen
- Den Reiter für die Netzwerkeinstellungen (Globus-Symbol) öffnen
- „Data Share Container“ wählen
- Mit der „Konfiguration importieren“-Schaltfläche den Auswahl-Dialog für die Datei öffnen
- Die Datei auswählen und hochladen
- Die Datei sollte nun hochgeladen werden. Der Controller wird die Datei kontrollieren und auf den internen Speicher kopieren. Dies wird durch das erste OK dargestellt. Falls Fehler in der Formatierung gefunden wurden, wird darunter die fehlerhafte Zeile in der Datei angezeigt.