FB_CTRL_LOG_MAT_FILE(nur auf einem PC-System)

VAR_INPUT

VAR_INPUT
    fLogData    : T_CTRL_LOGGER_DATA;
    eMode   : E_CTRL_MODE;
END_VAR

VAR_GLOBAL CONSTANT
    nCTRL_LOGGER_DATA_ARRAY_SIZE     :UINT := 10;
END_VAR

TYPE
    T_CTRL_LOGGER_DATA     :ARRAY [1..nCTRL_LOGGER_DATA_ARRAY_SIZE]
OF FLOAT;
END_TYPE

fLogData : Array mit den Werten, die in das Log-File geschrieben werden.

eMode : Eingang, der die Betriebsart des Bausteins festlegt.

VAR_OUTPUT

VAR_OUTPUT
    eState      : E_CTRL_STATE;
    bFileOpen       : BOOL
    bFileClosed     : BOOL
    fBufferUsage    : FLOAT     (* Buffer fill level in percent [0 ... 100] *)
    nLoggedColumns  : DINT;
    bBusy       : BOOL
    eErrorId        : E_CTRL_ERRORCODES;
    bError      : BOOL;
END_VAR

eState : State des Funktionsbausteins.

bFileOpen : Ein TRUE an diesem Ausgang signalisiert, dass die Datei erfolgreich geöffnet wurde.

bFileClosed : Ein TRUE an diesem Ausgang signalisiert, dass die Datei erfolgreich geschlossen wurde.

fBufferUsage : Aktueller Füllstand des externen Buffers in Prozent.

nLoggedColumns : Anzahl der in die Datei geschriebenen Spalten.

bBusy : Ein TRUE an diesem Ausgang signalisiert, dass das Loggen einer Zeile aktiv ist.

eErrorId : Liefert bei einem gesetzten bError-Ausgang die Fehlernummer.

bError : Wird TRUE, sobald ein Fehler eintritt.

VAR_IN_OUT

VAR_IN_OUT
    stParams        : ST_CTRL_LOG_MAT_FILE_PARAMS;
END_VAR

stParams : Parameterstruktur des Log-Bausteins. Diese besteht aus den folgenden Elementen:

TYPE
ST_CTRL_LOG_MAT_FILE_PARAMS:
STRUCT
    tLogCycleTime    : TIME := T#0ms; (* controller cycle
time [TIME] *)
    tTaskCycleTime       : TIME := T#0ms; (* task cycle time
[TIME] *)
    sFileName        : STRING;
    nNumberOfRows    : INT(1..10);
    sMatrixName      : STRING;
    arRowDescription     : ARRAY [1..10] OF STRING(25);
    bWriteTimeStamps     : BOOL := TRUE;
    bWriteRowDescription : BOOL := TRUE;
    pLogBuffer_ADR       : POINTER TO
ST_CTRL_MULTIPLE_PWM_OUT_DATA;
    nLogBuffer_SIZEOF    : UDINT;
END_STRUCT
END_TYPE

tLogCycleTime : Zykluszeit, mit der Einträge in das Log-File geschrieben werden. Diese muss größer oder gleich der TaskCycleTime sein.

tTaskCycleTime : Zykluszeit, mit der der Funktionsbaustein aufgerufen wird. Diese entspricht der Task-Zykluszeit der aufrufenden Task, wenn der Baustein in jedem Zyklus aufgerufen wird.

sFileName : Name und Pfad des Log-Files, z.B.: d:\Logfile.mat.

nNumberOfRows : Anzahl der Spalten, die in die Datei geschrieben werden (maximal 10).

sMatrixName : Name des Daten-Arrays.

arRowDescription : Array aus Strings, die die Zeilenüberschriften enthalten.

bWriteTimeStamps : Wenn dieser Parameter auf TRUE gesetzt ist, wird in die 1. Zeile des Daten-Arrays der Zeitstempel der Messung geschrieben.

bWriteRowDescription : Wenn dieser Parameter auf TRUE gesetzt ist, wird ein cell-Array angelegt, in das die Beschreibungen der Zeilen geschrieben werden.

pLogBuffer_ADR : Adresse des externen LogBuffers. Um einen Buffer zu erkennen muss die Adresse ungleich 0 sein.

nLogBuffer_SIZEOF: Größe des LogBuffers. Der Buffer muss ein ARRAY OF BYTE mit mindestens 1501 Elementen sein. Die Größe des Buffers kann mit Hilfe des Ausgangs fBufferUsage optimiert werden.

Beispiel

PROGRAM PRG_LOG_MAT_FILE_TEST_BUFFERED
VAR
    eMode       : E_CTRL_MODE;
    stParams        : ST_CTRL_LOG_MAT_FILE_PARAMS;
    LoggerData      : T_CTRL_LOGGER_DATA;

    eErrorId        : E_CTRL_ERRORCODES;
    bError      : BOOL;

    fbCtrlLogMatFile    : FB_CTRL_LOG_MAT_FILE;
    LogBuffer       : ARRAY[0..2000] OF BYTE;
    
    bInit       : BOOL := TRUE;

    fIn         : LREAL;
    fOut        : LREAL;

    fMaxBufferUsage     : LREAL;
END_VAR

IF bInit
THEN
    stCtrl_GLOBAL_CycleTimeInterpretation.bInterpretCycleTimeAsTicks := FALSE;
    stCtrl_GLOBAL_CycleTimeInterpretation.fBaseTime := 0;

    stParams.tLogCycleTime      := T#2ms;
    stParams.tTaskCycleTime         := T#2ms;
    stParams.nNumberOfRows      := 3;
    stParams.sFileName          := 'D:\test.mat';
    stParams.sMatrixName        := 'TwinCAT_ControllerToolbox_Log';

    stParams.arRowDescription[1]    := 'Input';
    stParams.arRowDescription[2]    := 'Output 1';
    stParams.arRowDescription[3]    := 'Output 2';

    stParams.bWriteRowDescription   := TRUE;
    stParams.bWriteTimeStamps           := TRUE;

    eMode   := eCTRL_MODE_ACTIVE;
    bInit   := FALSE;
END_IF

stParams.nLogBuffer_SIZEOF      := SIZEOF( LogBuffer );
stParams.pLogBuffer_ADR := ADR( LogBuffer );

(* creat test data *)
  fIn   := fIn + 0.01;
  fOut  := SIN(fIn);

(* copy test data to the Logger-Input *)
  LoggerData[ 1 ] := fIn;
  LoggerData[ 2 ] := fOut;
  LoggerData[ 3 ] := fOut * 2;

(* log only 1000 columns *)
  IF fbCtrlLogMatFile.nLoggedColumns >= 25
  THEN
    eMode := eCTRL_MODE_Passive;
  END_IF

(* call logger *)
  fbCtrlLogMatFile( fLogData := LoggerData,
          eMode := eMode,
          stParams :=stParams,
          eErrorId => eErrorId,
          bError => bError);

(* get max buffer usage *)
  fMaxBufferUsage := MAX(fbCtrlLogMatFile.fBufferUsage, fMaxBufferUsage);

Voraussetzungen