L’exemple montre un code de formatage pour un fichier d’enregistrement CSV.
Cet exemple est basé sur KW_Watcher_log.cfg.
Fichier d’enregistrement : fichier 1
Points de données (format des données, adresse) : datapoint1 (INT, DT100), datapoint2 (UINT, DT101), datapoint3 (INT, DT102), datapoint4 (UINT, DT103)
#This is a user defined log file configuration for KW Watcher
%DEF_TITLE="KW Watcher" #Mandatory: This title will be shown in the configurator.
%DEF_SEPARATOR="," #Overwrites the setting in the configurator.
%DEF_FILENAME="%F(%y%m%d_%H%M%S_TRG).csv" #case-sensitive ISO 8601 format
%DEF_DATE="%Y/%m/%d" #case-sensitive ISO 8601 format
%DEF_TIME="%H:%M:%S" #case-sensitive ISO 8601 format
%DEF_INT="S16"
%DEF_UINT="US16"
%DEF_WORD="HEX4"
%DEF_BIN="BITS"
%DEF_DINT="S32"
%DEF_UDINT="US32"
%DEF_DWORD="HEX8"
%DEF_REAL="FLT"
%DEF_REALEXP="FLT"
%DEF_ASCII="CHAR2"
%HEADER="Date","Time",%COLUMNS
%HEADER+=,,%NAMES
%HEADER+=,,%COMS #e.g. COM1 [Unit no.10]
%HEADER+=,,%REGISTERS #e.g. DT100
%HEADER+=,,%TYPES #Momentary or difference value
%HEADER+=,,%DATAFORMATS #INT, DINT, etc.
%HEADER+=,,%UNITS #ISO units
%LOGDATA=%DATE,%TIME,%VALUES
Lorsqu’un nouveau fichier est créé, un en-tête de sept lignes est inséré avant le premier enregistrement.
Date, Time, 1, 2, 3, 4 #Row1
,,datapoint1, datapoint2, datapoint3, datapoint4 #Row2
,,COM1,COM1,COM1,COM1 #Row3
,,DT100,DT101,DT102,DT103 #Row4
,,INT,UINT,INT,UINT #Row5
,,S16,US16,S16,US16 #Row6
,,,,, #Row7
2020/01/21,14:55:30,0,0,0,0 #Row8
%DEF_SEPARATOR=","
Le séparateur est une virgule.
%DEF_FILENAME="%F(%y%m%d_%H%M%S_TRG).csv"
%F crée le nom du fichier d’enregistrement à partir du nom défini dans
. La date et l’heure au format spécifié ainsi que la chaîne de caractères "_TRG" sont indiquées entre parenthèses et l’extension de fichier .csv est ajoutée.Exemple : file1(200121_145530_TRG).csv
%DEF_INT="S16"
à %DEF_ASCII="CHAR2"
Utilisé pour spécifier le format des données.
%HEADER="Date","Time",%COLUMNS
Le texte défini par l’utilisateur ("Date", "Time") est suivi des numéros de colonne pour tous les points de données (ligne 1 : 1 à 4 pour datapoint1 à datapoint4).
%HEADER+=,,%NAMES
%NAMES
renvoie les noms des points de données (ligne 2).
%HEADER+=,,%COMS
%COMS
renvoie le port COM utilisé pour lire les données (ligne 3).
%HEADER+=,,%REGISTERS
%REGISTERS
renvoie le registre de données de chaque point de données (ligne 4).
%HEADER+=,,%TYPES
%TYPES
renvoie le type de données de chaque point de données (ligne 5).
%HEADER+=,,%DATAFORMATS
%DATAFORMATS
renvoie le format du type de données comme spécifié par %DEF_INT
à %DEF_ASCII
(ligne 6).
%HEADER+=,,%UNITS
%UNITS
renvoie l’unité de chaque point de données (par ex. °C, kg). Dans cet exemple, aucune unité n’est définie (ligne 7).
%LOGDATA=%DATE,%TIME,%VALUES
C’est la première ligne des données d’enregistrement. Elle commence avec la date spécifiée par %DEF_DATE
et l’heure spécifiée par %DEF_TIME
, suivie des valeurs des points de données.