FB_CMA_Source

Dieser Funktionsbaustein schreibt Daten aus einem externen SPS Datenpuffer in einen MultiArray Puffer.

Er häuft ununterbrochen Eingangsdaten an, bis die Größe des MultiArray erreicht ist. Wenn das MultiArray komplett gefüllt ist, wird es an die Zielanalyse-ID übergeben.

Eine Instanz von FB_CMA_Source darf nicht als Ziel für irgendeinen anderen Analysebaustein verwendet werden. Sie bietet ausschließlich Quellfunktionalitäten.

Eine Zeitreihensammlung kann im Falle eines Fehlerauftritts unterbrochen werden. Verlorene Signaldaten können zu einem unerwarteten Ergebnis der Analysekette führen, je nach Konfiguration der Algorithmen.

Ein- und Ausgänge

Die Ausgangspuffer entsprechen folgender Definition (Shape). Die variablen Parameter sind Teil des Bausteineingangs stInitPars.

MultiArray im	Elementtyp	Dimensionen	Dimensionsgrößen
output stream	eTypeCode	`nDims`	`aDimSizes`

Eingangsparameter

Die Eingangsparameter dieses Bausteins repräsentieren Initialisierungsparameter und müssen bereits bei der Deklaration der FB Instanz zugewiesen werden! (Alternativ: Init()-Methode). Sie dürfen nur einmalig zugewiesen werden. Eine Änderung zur Laufzeit ist nicht möglich.

VAR_INPUT
    stInitPars       : ST_MA_MultiArray_InitPars;       // init parameter
    nOwnID           : UDINT;                           // ID for this FB instance
    aDestIDs         : ARRAY[1..cCMA_MaxDest] OF UDINT; // IDs of destinations for output
    nResultBuffers   : UDINT := 4;                      // number of MultiArrays which should be initialized for results (0 for no initialization)
    tTransferTimeout : LTIME := LTIME#40US;             // timeout checking off during access to inter-task FIFOs
END_VAR

stInitPars: Funktionsbausteinspezifische Struktur der Initialisierungsparameter vom Typ ST_MA_MultiArray_InitPars. MultiArray Puffer werden für die Ergebnispuffer spezifiziert. Diese Parameter müssen mit der obigen Definition der Ausgangspuffer übereinstimmen.
nOwnID: Identifiziert die Bausteininstanz mit einer eindeutigen ID. Diese muss immer größer als null sein. Eine bewährte Vorgehensweise ist die Definition einer Enumeration für diesen Zweck.
aDestIDs: Legt die Ziele durch Angabe derer IDs fest, zu denen die Ergebnisse weitergeleitet werden sollen. Die Definition des Ausgangspuffers (wie oben beschrieben) muss mit der Definition des Eingangspuffers jedes gewählten Zieles übereinstimmen.
nResultBuffers: Der Funktionsbaustein initialisiert einen Transfer Tray Stream mit der gegebenen Anzahl an MultiArray Puffern. Der Defaultwert ist vier.
tTransferTimeout: Einstellung des synchronen Timeout für interne MultiArray Weiterleitungen. Siehe Kapitel Parallelverarbeitung.

Ausgangsparameter

VAR_OUTPUT
    bError         : BOOL;                           // TRUE if an error occurs. Reset by next method call.
    hrErrorCode    : HRESULT;                        // '< 0' = error; '> 0' = info; '0' = no error/info
    ipErrorMessage : I_TcMessage := fbErrorMessage;  // Shows detailed information about occurred errors, warnings and more.
    nCntResults    : ULINT;                          // Counts outgoing results (MultiArrays were calculated and sent to transfer tray).
END_VAR

bError: Der Ausgang ist TRUE, falls ein Fehler auftritt.
hrErrorCode: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.
ipErrorMessage: Beinhaltet nähere Informationen zum aktuellen Rückgabewert. Siehe hierzu den Abschnitt Fehlerbeschreibung und Information. Für diesen speziellen Schnittstellenzeiger ist intern sichergestellt, dass er immer gültig/zugewiesen ist.

Eigenschaften

Folgende Eigenschaften können optional verwendet werden, um den Zeitstempel der Eingangswerte zugehörig zum nächsten Input-Aufruf zu spezifizieren. Werden die Eigenschaften nicht gesetzt, so wird intern automatisch ein aktueller Zeitstempel und eine typische Zeitdifferenz zwischen zwei Eingangswerten ermittelt.
Am FB_CMA_Sink werden Zeitspanne und Zeitstempel der Eingangswerte der Analysekette zugeordnet zum Ergebnis der Analyse bereitgestellt.

Name	Typ	Zugriff	Beschreibung
nTimestamp	ULINT [T_DCTIME64; 1ns steps since 1.1.2000]	Set	Angabe des Zeitstempels zugehörig zum ältesten Wert, welcher mit dem nächsten Input-Aufruf übergeben wird. (Beispiel: StartTimeNextLatch -CycleTime)
tSamplePeriod	LTIME	Set	Angabe der Zeitdifferenz zwischen zwei Eingangswerten. (Beispiel: CycleTime / cOversamples). Diese Angabe ist nur einmalig nötig, da es sich um einen konstanten Wert handelt.

Methoden

Input1D():

Schreibt Daten von einem externen eindimensionalen Datenpuffer in ein MultiArray. Jedes Mal wenn neue Eingangsabtastungen vorliegen, muss diese Methode aufgerufen werden, normalerweise zyklisch.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Input1D : HRESULT
VAR_INPUT
    pDataIn       : POINTER TO BYTE;      // address of data buffer (e.g. oversampling data) as one-dimensional array
    nDataInSize   : UDINT;                // size of data buffer in bytes
    eElementType  : E_MA_ElementTypeCode;
    nWorkDim      : UDINT;                // It designates the dimension in the multi array being processed.
    pStartIndex   : POINTER TO UDINT;     (* optional: default:0->internally handled; It designates the index of the first MultiArray element to be copied.
                                             If allocated it must point to a onedimensional array of UDINT with so many elements as dimensions of the MultiArray.
                                             Upon successful completion of the copy, corresponding StartIndex is incremented by the number of copied elements. *)
    nOptionPars   : DWORD;                // option mask
END_VAR
VAR_OUTPUT
    bNewResult    : BOOL;                 // TRUE every time when outgoing MultiArray was calculated and sent to transfer tray.
    bError        : BOOL;                 // TRUE if an error occurs.
    hrErrorCode   : HRESULT;              // '< 0' = error; '> 0' = info; '0' = no error/info
END_VAR

pDataIn: Der Datenpuffer muss die Daten von allen Kanälen enthalten.
eElementType: Dieser Eingang ist vom Typ E_MA_ElementTypeCode. Der Elementtyp des spezifizierten MultiArray Puffers (Initialisierungsparameter) muss mit dem Elementtyp des angegebenen externen Datenpuffers übereinstimmen.
nWorkDim: Definiert die Dimension, in welcher die Daten angesammelt werden. Im Allgemeinen ist das MultiArray auch eindimensional und nWorkDim := 0, aber das MultiArray kann auch zusätzliche Dimensionen haben, die dann jedoch nicht verarbeitet werden dürfen.
pStartIndex: Dies ist ein optionaler Parameter, der dann nützlich ist, wenn das MultiArray mehr als eine Dimension erhalten hat. Gibt den Index des ersten zu kopierenden MultiArray Elements an. Wenn zugewiesen, dann muss es auf ein eindimensionales Array von UDINT zeigen, das so viele Elemente hat, wie das MultiArray Dimensionen hat. Im Anschluss an einen erfolgreichen Kopiervorgang wird der entsprechende Start-Index um die Anzahl der kopierten Elemente inkrementiert.
bError: Dieser Ausgang ist TRUE, wenn ein Fehler auftritt.
hrErrorCode: Tritt ein Fehler auf, dann wird ein beschreibender Fehlercode vom Typ HRESULT angezeigt. Mögliche Werte sind in der Liste der Fehlercodes definiert. Dieser Ausgang ist gleich dem Rückgabewert der Methode.

Input1DStd():

Schreibt Daten von einem externen eindimensionalen Datenpuffer in ein MultiArray. Jedes Mal wenn neue Eingangsabtastungen vorliegen, muss diese Methode aufgerufen werden, normalerweise zyklisch.

Diese Methode verwendet Standardwerte für die Parameter nWorkDim := 0 und pStartIndex := 0.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Input1DStd : HRESULT
VAR_INPUT
    pDataIn       : POINTER TO BYTE;      // address of data buffer (e.g. oversampling data) as one-dimensional array
    nDataInSize   : UDINT;                // size of data buffer in bytes
    eElementType  : E_MA_ElementTypeCode;
    nOptionPars   : DWORD;                // option mask
END_VAR
VAR_OUTPUT
    bNewResult    : BOOL;                 // TRUE every time when outgoing MultiArray was calculated and sent to transfer tray.
    bError        : BOOL;                 // TRUE if an error occurs.
    hrErrorCode   : HRESULT;              // '< 0' = error; '> 0' = info; '0' = no error/info
END_VAR

pDataIn: Der Datenpuffer muss die Daten von allen Kanälen enthalten.
eElementType: Dieser Eingang ist vom Typ E_MA_ElementTypeCode. Der Elementtyp des spezifizierten MultiArray Puffers (Initialisierungsparameter) muss mit dem Elementtyp des angegebenen externen Datenpuffers übereinstimmen.
bError: Dieser Ausgang ist TRUE, wenn ein Fehler auftritt.
hrErrorCode: Tritt ein Fehler auf, dann wird ein beschreibender Fehlercode vom Typ HRESULT angezeigt. Mögliche Werte sind in der Liste der Fehlercodes definiert. Dieser Ausgang ist gleich dem Rückgabewert der Methode.

Input2D():

Schreibt Daten von einem externen zweidimensionalen Datenpuffer in ein MultiArray. Jedes Mal wenn neue Eingangsabtastungen vorliegen, muss diese Methode aufgerufen werden, normalerweise zyklisch.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Input2D : HRESULT
VAR_INPUT
    pDataIn       : POINTER TO BYTE;      // address of data buffer (e.g. oversampling data) as twodimensional array (e.g.[1..channels,1..oversamples] )
    nDataInSize   : UDINT;                // size of data buffer in bytes
    eElementType  : E_MA_ElementTypeCode;
    nWorkDim0     : UDINT:=0;             // It designates the first dimension in the MultiArray being processed. (e.g. 1..channels)
    nWorkDim1     : UDINT:=1;             // It designates the second dimension in the MultiArray being processed.
    pStartIndex   : POINTER TO UDINT;     (* optional: default:0-> internally handled; It designates the index of the first MultiArray element to be copied.
                                             If allocated it must point to a onedimensional array of UDINT with so many elements as dimensions of the MultiArray.
                                             Upon successful completion of the copy, corresponding StartIndex is incremented by the number of copied elements. *)
    nOptionPars   : DWORD;                // option mask
END_VAR
VAR_OUTPUT
    bNewResult    : BOOL;                 // TRUE every time when outgoing MultiArray was calculated and sent to transfer tray.
    bError        : BOOL;                 // TRUE if an error occurs.
    hrErrorCode   : HRESULT;              // '< 0' = error; '> 0' = info; '0' = no error/info
END_VAR

pDataIn: Der Datenpuffer muss die Daten von allen Kanälen enthalten.
eElementType: Dieser Eingang ist vom Typ E_MA_ElementTypeCode. Der Elementtyp des spezifizierten MultiArray Puffers (Initialisierungsparameter) muss mit dem Elementtyp des angegebenen externen Datenpuffers übereinstimmen.
nWorkDim0: Definiert die Dimension, welche der Anzahl Kanäle entspricht. Im Allgemeinen ist das MultiArray auch zweidimensional und nWorkDim0 := 0, aber das MultiArray kann auch zusätzliche Dimensionen haben, die dann jedoch nicht verarbeitet werden dürfen.
Z.B.: Wenn der erste Index des angegebenen Datenpuffers für die Kanäle steht, aber die zweite Dimension des MultiArray die Kanäle aufzählt, dann setzen Sie nWorkDim0:=1.
nWorkDim1: Definiert die Dimension, in welcher die Daten angesammelt werden. Im Allgemeinen ist das MultiArray auch zweidimensional und nWorkDim1 := 1, aber das MultiArray kann auch zusätzliche Dimensionen haben, die dann aber nicht verarbeitet werden dürfen.
Z.B.: Wenn der zweite Index des angegebenen Datenpuffers für die gesammelten Daten steht, aber die erste Dimension des MultiArray die Daten sammelt, dann setzen Sie nWorkDim1 := 0.
pStartIndex: Dies ist ein optionaler Parameter, der dann nützlich ist, wenn das MultiArray mehr als zwei Dimensionen erhalten hat. Gibt den Index des ersten zu kopierenden MultiArray Elements an. Wenn zugewiesen, dann muss es auf ein eindimensionales Array von UDINT zeigen, das so viele Elemente hat, wie das MultiArray Dimensionen hat. Im Anschluss an einen erfolgreichen Kopiervorgang wird der entsprechende Start-Index um die Anzahl der kopierten Elemente inkrementiert.
bError: Dieser Ausgang ist TRUE, wenn ein Fehler auftritt.
hrErrorCode: Tritt ein Fehler auf, dann wird ein beschreibender Fehlercode vom Typ HRESULT angezeigt. Mögliche Werte sind in der Liste der Fehlercodes definiert. Dieser Ausgang ist gleich dem Rückgabewert der Methode.

Input2DStd():

Schreibt Daten von einem externen zweidimensionalen Datenpuffer in ein MultiArray. Jedes Mal wenn neue Eingangsabtastungen vorliegen, muss diese Methode aufgerufen werden, normalerweise zyklisch.

Diese Methode verwendet Standardwerte für die Parameter nWorkDim0 := 0, nWorkDim1 := 1 und pStartIndex := 0.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Input2DStd : HRESULT
VAR_INPUT
    pDataIn       : POINTER TO BYTE;      // address of data buffer (e.g. oversampling data) as twodimensional array (e.g.[1..channels,1..oversamples] )
    nDataInSize   : UDINT;                // size of data buffer in bytes
    eElementType  : E_MA_ElementTypeCode;
    nOptionPars   : DWORD;                // option mask
END_VAR
VAR_OUTPUT
    bNewResult    : BOOL;                 // TRUE every time when outgoing MultiArray was calculated and sent to transfer tray.
    bError        : BOOL;                 // TRUE if an error occurs.
    hrErrorCode   : HRESULT;              // '< 0' = error; '> 0' = info; '0' = no error/info
END_VAR

pDataIn: Der Datenpuffer muss die Daten von allen Kanälen enthalten.
eElementType: Dieser Eingang ist vom Typ E_MA_ElementTypeCode. Der Elementtyp des spezifizierten MultiArray Puffers (Initialisierungsparameter) muss mit dem Elementtyp des angegebenen externen Datenpuffers übereinstimmen.
bError: Dieser Ausgang ist TRUE, wenn ein Fehler auftritt.
hrErrorCode: Tritt ein Fehler auf, dann wird ein beschreibender Fehlercode vom Typ HRESULT angezeigt. Mögliche Werte sind in der Liste der Fehlercodes definiert. Dieser Ausgang ist gleich dem Rückgabewert der Methode.

Input3D():

Schreibt Daten von einem externen dreidimensionalen Datenpuffer in ein MultiArray. Jedes Mal wenn neue Eingangsabtastungen vorliegen, muss diese Methode aufgerufen werden, normalerweise zyklisch.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Input2D : HRESULT
VAR_INPUT
    pDataIn       : POINTER TO BYTE;      // address of data buffer (e.g. oversampling data) as twodimensional array (e.g.[1..channels,1..oversamples] )
    nDataInSize   : UDINT;                // size of data buffer in bytes
    eElementType  : E_MA_ElementTypeCode;
    nWorkDim0     : UDINT:=0;             // It designates the first dimension in the MultiArray being processed. (e.g. 1..channels)
    nWorkDim1     : UDINT:=1;             // It designates the second dimension in the MultiArray being processed.
    nWorkDim2     : UDINT:=2;             // It designates the third dimension in the MultiArray being processed.
    pStartIndex   : POINTER TO UDINT;     (* optional: default:0-> internally handled; It designates the index of the first MultiArray element to be copied.
                                             If allocated it must point to a onedimensional array of UDINT with so many elements as dimensions of the MultiArray.
                                             Upon successful completion of the copy, corresponding StartIndex is incremented by the number of copied elements. *)
    nOptionPars   : DWORD;                // option mask
END_VAR
VAR_OUTPUT
    bNewResult    : BOOL;                 // TRUE every time when outgoing MultiArray was calculated and sent to transfer tray.
    bError        : BOOL;                 // TRUE if an error occurs.
    hrErrorCode   : HRESULT;              // '< 0' = error; '> 0' = info; '0' = no error/info
END_VAR

pDataIn: Der Datenpuffer muss die Daten von allen Kanälen enthalten.
eElementType: Dieser Eingang ist vom Typ E_MA_ElementTypeCode. Der Elementtyp des spezifizierten MultiArray Puffers (Initialisierungsparameter) muss mit dem Elementtyp des angegebenen externen Datenpuffers übereinstimmen.
nWorkDim0: Definiert die Dimension, welche der Anzahl Kanäle entspricht. Im Allgemeinen ist das MultiArray auch zweidimensional und nWorkDim0 := 0, aber das MultiArray kann auch zusätzliche Dimensionen haben, die dann jedoch nicht verarbeitet werden dürfen.
Z.B.: Wenn der erste Index des angegebenen Datenpuffers für die Kanäle steht, aber die zweite Dimension des MultiArray die Kanäle aufzählt, dann setzen Sie nWorkDim0 := 1.
nWorkDim1: Definiert die Dimension, welche der Anzahl Unterkanäle entspricht. Im Allgemeinen ist das MultiArray auch dreidimensional und nWorkDim0 := 0 und nWorkDim1 := 1, aber das MultiArray kann auch zusätzliche Dimensionen haben, die dann jedoch nicht verarbeitet werden dürfen.
Z.B.: Wenn der zweite Index des angegebenen Datenpuffers für die Unterkanäle steht, aber die dritte Dimension des MultiArray die Unterkanäle aufzählt, dann setzen Sie nWorkDim1 := 2.
nWorkDim2: Definiert die Dimension, in welcher die Daten angesammelt werden. Im Allgemeinen ist das MultiArray auch zweidimensional und nWorkDim1 := 1, aber das MultiArray kann auch zusätzliche Dimensionen haben, die dann aber nicht verarbeitet werden dürfen.
Z.B.: Wenn der zweite Index des angegebenen Datenpuffers für die gesammelten Daten steht, aber die erste Dimension des MultiArray die Daten sammelt, dann setzen Sie nWorkDim1 := 0.
pStartIndex: Dies ist ein optionaler Parameter, der dann nützlich ist, wenn das MultiArray mehr als zwei Dimensionen erhalten hat. Gibt den Index des ersten zu kopierenden MultiArray Elements an. Wenn zugewiesen, dann muss es auf ein eindimensionales Array von UDINT zeigen, das so viele Elemente hat, wie das MultiArray Dimensionen hat. Im Anschluss an einen erfolgreichen Kopiervorgang wird der entsprechende Start-Index um die Anzahl der kopierten Elemente inkrementiert.
bError: Dieser Ausgang ist TRUE, wenn ein Fehler auftritt.

hrErrorCode: Tritt ein Fehler auf, dann wird ein beschreibender Fehlercode vom Typ HRESULT angezeigt. Mögliche Werte sind in der Liste der Fehlercodes definiert. Dieser Ausgang ist gleich dem Rückgabewert der Methode.

Input3DStd():

Schreibt Daten von einem externen dreidimensionalen Datenpuffer in ein MultiArray. Jedes Mal wenn neue Eingangsabtastungen vorliegen, muss diese Methode aufgerufen werden, normalerweise zyklisch.

Diese Methode verwendet Standardwerte für die Parameter nWorkDim0 := 0, nWorkDim1 := 1, nWorkDim2 := 2 und pStartIndex := 0.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Input2DStd : HRESULT
VAR_INPUT
    pDataIn       : POINTER TO BYTE;      // address of data buffer (e.g. oversampling data) as twodimensional array (e.g.[1..channels,1..oversamples] )
    nDataInSize   : UDINT;                // size of data buffer in bytes
    eElementType  : E_MA_ElementTypeCode;
    nOptionPars   : DWORD;                // option mask
END_VAR
VAR_OUTPUT
    bNewResult    : BOOL;                 // TRUE every time when outgoing MultiArray was calculated and sent to transfer tray.
    bError        : BOOL;                      // TRUE if an error occurs.
    hrErrorCode   : HRESULT;              // '< 0' = error; '> 0' = info; '0' = no error/info
END_VAR

pDataIn: Der Datenpuffer muss die Daten von allen Kanälen und Unterkanälen enthalten.
eElementType: Dieser Eingang ist vom Typ E_MA_ElementTypeCode. Der Elementtyp des spezifizierten MultiArray Puffers (Initialisierungsparameter) muss mit dem Elementtyp des angegebenen externen Datenpuffers übereinstimmen.
bError: Dieser Ausgang ist TRUE, wenn ein Fehler auftritt.

Init():

Üblicherweise ist diese Methode in einer Condition Monitoring Applikation nicht notwendig. Sie bietet eine Alternative zur Bausteininitialisierung. Die Init() Methode darf nur während der Initialisierungsphase der SPS aufgerufen werden. Sie kann nicht während der Laufzeit verwendet werden. Es sei auf die Verwendung von einer FB_init Methode oder dem Attribut 'call_after_init' hingewiesen (siehe TwinCAT SPS Referenz). Hiermit wird zudem die Bausteinkapselung erleichtert.

Die Eingangsparameter der Bausteininstanz dürfen nicht bei der Deklaration zugewiesen werden, falls die Initialisierung mit der Init() Methode erfolgen soll.

Rückgabewert: Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD Init : HRESULT
VAR_INPUT
    stInitPars     : ST_MA_MultiArray_InitPars;       // init parameter
    nOwnID         : UDINT;                           // ID for this FB instance
    aDestIDs       : ARRAY[1..cCMA_MaxDest] OF UDINT; // IDs of destinations for output
    nResultBuffers : UDINT := 4;                      // number of MultiArrays which should be initialized for results (0 for no initialization)
END_VAR

stInitPars: Funktionsbausteinspezifische Struktur der Initialisierungsparameter vom Typ ST_MA_MultiArray_InitPars. MultiArray Puffer werden für die Ergebnispuffer spezifiziert. Diese Parameter müssen mit der obigen Definition der Ausgangspuffer übereinstimmen.
nOwnID: Identifiziert die Bausteininstanz mit einer eindeutigen ID. Diese muss immer größer als null sein. Eine bewährte Vorgehensweise ist die Definition einer Enumeration für diesen Zweck.
aDestIDs: Legt die Ziele durch Angabe derer IDs fest, zu denen die Ergebnisse weitergeleitet werden sollen. Die Definition des Ausgangspuffers (wie oben beschrieben) muss mit der Definition des Eingangspuffers jedes gewählten Zieles übereinstimmen.
nResultBuffers: Der Funktionsbaustein initialisiert einen Transfer Tray Stream mit der gegebenen Anzahl an MultiArray Puffern. Der Defaultwert ist vier.

ResetData():

Die Methode löscht alle bereits hinzugefügten Datensätze, um den aktuellen Ausgangspuffer (MultiArray) erneut von Beginn an befüllen zu können. Sollten beim Befüllen externe Indizes (pStartIndex Parameter) genutzt werden, so müssen diese explizit zurückgesetzt werden.

Rückgabewert : Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD ResetData : HRESULT
VAR_INPUT
END_VAR

ResetAnalysisChain():

Durch Aufruf dieser Methode wird automatisch ein Reset aller Algorithmen der vollständigen Analysekette durchgeführt. Intern wird jeweils ein ResetData() vor der Übernahme des neuen Datensatzes ausgeführt. Folglich impliziert dies auch ein ResetData() am FB_CMA_Source.

Soll die Analysekette nur für einen bestimmten Zeitraum aktiv sein, so bietet diese Methode die Möglichkeit alle Algorithmen vor der nächsten Ausführung zurückzusetzen.

Es können Fehler beim Aufruf einer Input Methode auftreten und Unterbrechungen der Zeitreihensammlung verursachen. Falls die folgenden Algorithmen der Analysekette Spektren berechnen, so kann im Falle eines Fehlers beim Aufruf einer Input Methode die ResetAnalysisChain() Methode aufgerufen werden. Denn es ist nicht möglich korrekte Spektren anhand zerstückelter Zeitreihen zu berechnen.

Rückgabewert : Falls ein Fehler auftritt, wird ein entsprechender Fehlercode vom Typ HRESULT ausgegeben. Mögliche Werte sind in der Liste der Fehlercodes erläutert.

METHOD ResetAnalysisChain : HRESULT
VAR_INPUT
END_VAR

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT v3.1.4022.25	PC or CX (x86, x64)	Tc3_CM, Tc3_CM_Base, Tc3_MultiArray