SaveRetainData block
Short summary
Name |
|
→POU type |
|
Category |
more system blocks, persistence blocks, block with internal error diagnostic |
Graphical interface |
|
Available since |
The block is supported for the platform |
Functionality
The block saves the values of the →retentive variables persistently to a CSV file. Compare SaveRetainDataFast
block for an alternative.
Restriction
|
Recommendation on usage Use the block only once in a →program with a →task for which a corresponding long cycletime has been defined. Moreover, best practice is to trigger the block call by a variable declared in the program (see |
Inputs, outputs, return value
|
Identifier |
Description |
|
---|---|---|---|
Inputs: |
|
|
name of the file where the values of the variables are stored |
Outputs: |
|
|
return code:
|
Return value: |
– |
|
returns the return code of |
Input EN
and output ENO
are available when →calling the block. See "Execution control: EN, ENO" for information on input EN
and output ENO
.
See:
-
"Blocks for safe logic" whether this block is supported for developing safety-relevant applications.
-
"Highlighting safe logic in the FBD-editor" for the effects when using the block as a block for safe logic.
Internal error diagnostic for block
The block checks the following error cases:
-
The system service has not been loaded.
-
The return code of the function call equates to an error (output
RC
≠ value 0).
In such an error case, the output ENO
of the block is set to value FALSE
(or an equivalent).
Example for usage within ST-editor
See LoadRetainData
block.
When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.