Syntaxregeln für benutzerdefinierte Formatdateien

Mit benutzerdefinierten Formatdateien können Sie Ihr eigenes Aufzeichnungsdateiformat erstellen.

Regeln und Syntax in der Konfigurationsdatei:

Es sind nur Multi-Byte-ASCII-Zeichen erlaubt.
Kommentare beginnen mit dem Zeichen „#“. Jeder Kommentar endet mit dem Ende der Zeile.
Das Ende der Zeile wird mit <CR><LF> definiert.
Benutzerdefinierter Text muss in Anführungszeichen stehen.
Alle Variablennamen beginnen mit dem Zeichen „%“.
Der Ausdruck wird in Anführungszeichen gesetzt.
Außerhalb von Anführungszeichen werden „,“ und „;“ durch das mit %DEF_SEPARATOR festgelegte Zeichen ersetzt.
Alle anderen Zeichen werden ignoriert.

Variablen:

%DEF_SEPARATOR

Definiert ein anderes Trennzeichen als „;“ oder „,“ für die CSV-Datei.

Beispiel: %DEF_SEPARATOR="/"

%DEF_INVALID

Definiert eine Zeichenfolge (max. 16 Zeichen) für ungültige Werte, Kommunikationsfehler (keine Daten empfangen) oder fehlende Anfangswerte bei Differenzwerten.

Standardwert: „-“; die Zeichenfolge für ungültige REAL-Werte ist immer „NaN“.

Beispiel: %DEF_INVALID="invalid"

%DEF_FILENAME

Definiert den Namen der Aufzeichnungsdatei. Es können beliebige ASCII-Zeichen und die folgenden Bezeichner (auch Datum- und Uhrzeitbezeichner nach ISO 8601) verwendet werden:

%y (kurze Jahreszahl, zwei Zeichen)
%Y (vollständige Jahreszahl, vier Zeichen)
%m (Monat als Zahl, 01–12)
%d (Tag als Zahl, 01–31)
%W (Kalenderwoche)
%j (Wochentag)
%H (Stunde)
%M (Minute)
%S (Sekunde)
%F (der unter Datenlogger > Aufzeichnungsdateien eingegebene Name der Aufzeichnungsdatei)
%x (Chargennummer mit 5 Ziffern, 0–65535)
%X (Chargennummer mit 10 Ziffern, 0–4294967293)

Beispiel: %DEF_FILENAME="%F(%Y%m%d_%H%M%S_TRG).csv"

%DEF_DATA_TIMESTAMP

Die Datenpunktnummer (n), die die Zeitstempelinformationen enthält. Sie müssen n-1 angeben, da die Zählung der Datenpunkte mit „0“ beginnt.

Beispiel: %DEF_DATA_TIMESTAMP="0"

%DEF_DATA_FILEEXT

Die Datenpunktnummer (n), die die Chargennummer enthält (wird zusammen verwendet mit %x oder %X in %DEF_FILENAME). Sie müssen n-1 angeben, da die Zählung der Datenpunkte mit „0“ beginnt.

Beispiel: %DEF_DATA_FILEEXT="0"

%DEF_TIME

Bestimmt ein benutzerdefiniertes Uhrzeitformat für den Zeitstempel.

%H (Stunde)
%M (Minute)
%S (Sekunde)

Beispiel: %DEF_TIME="%H:%M:%S"

%DEF_DATE

Bestimmt ein benutzerdefiniertes Datumsformat für den Zeitstempel.

%y (kurze Jahreszahl, zwei Zeichen)
%Y (vollständige Jahreszahl, vier Zeichen)
%m (Monat als Zahl, 01–12)
%d (Tag als Zahl, 01–31)
%W (Kalenderwoche)
%j (Wochentag)

Beispiel: %DEF_DATE="%Y/%m/%d"

%DEF_DATETIME

Bestimmt ein benutzerdefiniertes Uhrzeit- und Datumsformat für den Zeitstempel (kombiniert %DEF_DATE und %DEF_DATE).

%y (kurze Jahreszahl, zwei Zeichen)
%Y (vollständige Jahreszahl, vier Zeichen)
%m (Monat als Zahl, 01–12)
%d (Tag als Zahl, 01–31)
%W (Kalenderwoche)
%j (Wochentag)
%H (Stunde)
%M (Minute)
%S (Sekunde)

Beispiel: %DEF_DATETIME="%Y-%m-%d %H:%M:%S"

%DEF_SPLIT_MINUTES

Bestimmt eine benutzerdefinierte Dateiteilung nach Anzahl der Minuten. Gültige Einstellungen: 1, 10, 60, 1440 (1 Tag), 10080 (1 Woche). Beispiel: %DEF_SPLIT_MINUTES="10"

%DEF_INT

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_INT="S16"

%DEF_UINT

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_UINT="US16"

%DEF_WORD

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_WORD="HEX4"

%DEF_BIN

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_BIN="BITS"

%DEF_DINT

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_DINT="S32"

%DEF_UDINT

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_UDINT="US32"

%DEF_DWORD

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_DWORD="HEX8"

%DEF_REAL

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_REAL="FLT"

%DEF_REALEXP

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_REALEXP="FLT"

%DEF_ASCII

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_ASCII="CHAR2"

%DEF_DT

Text zur Anzeige, wenn %DATAFORMATS verwendet wird. Beispiel: %DEF_DT="DATE AND TIME"

%DEF_TITLE

Nur aus Kompatibilitätsgründen enthalten. Beispiel: %DEF_TITLE="KW Watcher"

Kopfzeilenvariablen:

Beispiel:

%HEADER="Date","Time",%NUMBER_DYN
%HEADER+=,,%NAMES
%HEADER+=,,%COLUMNS
%HEADER+=,,%COM
%HEADER+=,,%TYPES
%HEADER+=,,%DATAFORMATS
%HEADER+=,,%REGISTER
%HEADER+=,,%UNITS

%HEADER

Mit %HEADER können Sie beliebigen Text und Variablen festlegen.

Bei mehr als einer Kopfzeile, muss jede Zeile mit %HEADER gefolgt von „+=“ anstatt „=“ beginnen.

%NUMBER_DYN

Nummeriert die Spalten automatisch in aufsteigender Reihenfolge.

%NAMES

Schreibt den Namen aller Datenpunkte, getrennt durch das Trennzeichen.

%COMS

Schreibt die Teilnehmeradresse aller Datenpunkte, getrennt durch das Trennzeichen.

%REGISTERS

Schreibt die Registeradresse (z.B. DT100) aller Datenpunkte, getrennt durch das Trennzeichen.

%TYPES

Schreibt den Registertyp (MOMENT/DIFFERENCE) aller Datenpunkte, getrennt durch das Trennzeichen.

%DATAFORMATS

Schreibt das Datenformat (INT, DINT...) aller Datenpunkte, getrennt durch das Trennzeichen.

Der Text für jedes Datenformat kann mit den Variablen %DEF_... festgelegt werden.

%UNITS

Schreibt die Einheit (m³, °C, kWh...) aller Datenpunkte, getrennt durch das Trennzeichen.

%COLUMNS

Schreibt die Spaltennummer aller Datenpunkte, getrennt durch das Trennzeichen.

Datensatzvariablen:

Beispiel:

%LOGDATA=%DATE,%TIME,%VALUES

%LOGDATA: Definiert die Reihenfolge der Daten in einer Datensatzzeile (z.B. für Datum, Uhrzeit, zusätzlichen Text und die Daten).
%DATE: Verwendet das mit %DEF_DATE eingestellte Datumsformat.
%TIME: Verwendet das mit %DEF_TIME eingestellte Uhrzeitformat.
%UNIXTIME: Verwendet das Unix-Zeitformat (Sekunden seit 1970-01-01). Beispiel: %LOGDATA=%UNIXTIME,%DATE,%TIME,%VALUES
%VALUES: Schreibt die aufgezeichneten Datenwerte, getrennt durch das Trennzeichen.

Anmerkung

Achten Sie darauf, dass Sie die Trennzeichen zwischen Variablen und Text manuell setzen müssen.