RESTORE_PARAM_MX: Restoring the Parameters in Local Rack

Original instructions

Description

The RESTORE_PARAM_MX function is used to restore the new parameters of a module declared in in the local rack. It performs an explicit exchange with the Modicon M580 CPU memory.

These parameters restore the values saved using SAVE_PARAM_MX.

The additional parameters and can also be configured.

FBD Representation

LD Representation

IL representation

Representation:

CAL RESTORE_PARAM_MX_Instance (ENABLE:=Enable, ABORT:=Abort, ADDR:=Address, CHANNEL:=Channel, DONE=>OperationSuccessful, ACTIVE=>OperationActiv, ERROR=>FaultyOperation, STATUS=>Status, PARAM_LEN=>NumberOfParamWords, PARAM=>Param)

ST representation

Representation:

RESTORE_PARAM_MX_Instance (ENABLE:=Enable, ABORT:=Abort, ADDR:=Address, CHANNEL:=Channel, DONE=>OperationSuccessful, ACTIVE=>OperationActiv, ERROR=>FaultyOperation, STATUS=>Status, PARAM_LEN=>NumberOfParamWords, PARAM=>Param);

Parameter Description

The following table describes the input parameters:

Parameter	Data Type	Significance
Enable	BOOL	Set to 1 to trigger the operation
Abort	BOOL	Set to 1 to abort the currently active operation
Address	ANY ARRAY OF INT	Array that contains the address result of ADDMX function (1) and identifies the rack which the module belongs to.
Channel	STRING	Identifies the channel to work on; it contains rack, slot and channel numbers (r.s.c)
(1) To address a module in the local rack, enter 0.0.10 (CPU main server address).

The following table describes the output parameters:

Parameter	Data Type	Significance
OperationSuccessful	BOOL	Operation terminated successfully
OperationActiv	BOOL	Operation active
FaultyOperation	BOOL	Operation terminated unsuccessfully
Status	WORD	Detected error identifier
NumberOfParamWords	INT	Number of parameter registers/words to read
Param	ANY	Parameter registers/words of the channel. Because, they are module-specific, refer to the module manual for a detailed description. A device DDT-type variable may be used

A Device DDT is a DDT predefined by the manufacturer and not modifiable by user. It contains the I/O language elements of an I/O module.

EN stands for ENable; it is an optional block input. When the EN input is enabled, an ENO output is set automatically.

If EN = 0, the block is not enabled; its internal program is not executed, and ENO is set to 0.

If EN = 1, the block's internal program is run and ENO is set to 1. If an error occurs, ENO is set to 0.

If the EN input is not connected, it is set automatically to 1.

ENO stands for Error NOtification; this is the output associated with the optional input EN.

An ARRAY is a table containing elements of a single type.

The syntax is as follows: ARRAY [<limits>] OF <Type>

ARRAY [1..2] OF BOOL is a one-dimensional table with two elements of type BOOL.

ARRAY [1..10, 1..20] OF INT is a two-dimensional table with 10x20 elements of type INT.

A STRING variable is a series of ASCII characters. The maximum length of a string is 65,534 characters.

BOOL is the abbreviation for the Boolean type. This is the basic data type in computing. A BOOL variable can have either of the following two values: 0 (FALSE) or 1 (TRUE).

A bit extracted from a word is of type BOOL, for example: %MW10.4.

The type WORD is encoded in a 16 bit format and is used to perform processing on series of bits.

This table shows the upper/lower limits of each of the bases that can be used:

Examples of representation

Base	Lower limit	Upper limit
Hexadecimal	16#0	16#FFFF
Octal	8#0	8#177777
Binary	2#0	2#1111111111111111

Data	Representation in one of the bases
0000000011010011	16#D3
1010101010101010	8#125252
0000000011010011	2#11010011

INT is the abbreviation of single INTeger (encoded in 16 bits).

The upper/lower limits are as follows: -(2 to the power of 15) to (2 to the power of 15) - 1.

-32768, 32767, 2#1111110001001001, 16#9FA4.

There is a hierarchy among the various data types. In the DFBs, it is sometimes possible to declare variables that can contain several types of values. In that case we use ANY_xxx types.