SETPR, SETPI, SETPB – Blocks for remote parameter setting

Block SymbolsLicensing group: STANDARD
PIC PIC PIC

Function Description
The SETPR, SETPI, SETPB and SETPS blocks are used for setting the parameters of other blocks in the model remotely. The only difference among the three blocks is the type of parameter which they are setting. The SETPR block is used for setting real parameters, the SETPI block for integer parameters, the SETPB block for Boolean parameters and the SETPS block for string parameters.

The blocks operate in two modes, which are switched by the SETF parameter. For SETF = off the remote parameter sc is set to the value of the input signal p (or ip, P) at the start and every time when the input changes. If the SETF parameter is set to on, then the blocks work in one-shot write mode. In that case the remote parameter is set only when rising edge (off on) occurs at the SET input. Successful modification of the remote parameter is indicated by zero error output E = off and the output y (or k, Y) is set to the value of the modified parameter. The error output is set to E = on in case of write error.

The name of the remote parameter is determined by the string parameter sc (string connection), which has the form <block_path:parameter_name>. It is also possible to access individual items of array-type parameters (e.g. the tout parameter of the ATMT block). This can be achieved using the square brackets and item number, e.g. .ATMT:touts[2]. The items are numbered from zero, thus the string connection stated above refers to the third element of the array.

The path to the block whose parameter should be set can contain hierarchic levels separated by dots followed by the block name. The path can be either relative or absolute:

  • Relative – starts at the level where the SETPR block (or SETPI, SETPB, SETPS) is located. The string has to be prefixed with ’.’ in this case. Examples of relative paths: ".GAIN:k", ".Motor1.Position:ycn".
  • Relative to task – starts at the root level of the task where the SETPR block (or SETPI, SETPB, SETPS) is located. The string has to be prefixed with ’%’ in this case. Examples of paths: "%GAIN:k", "%Motor1.Position:ycn".
  • Absolute – complete sequence of hierarchic levels down to the block. For referring to blocks located in the driver task (see the IOTASK block for details on configuration) the ’&’ followed by the driver’s name is used at the beginning of the absolute path. Examples of absolute paths: "task1.inputs.lin1:u2", "&EfaDrv.measurements.DER1:n".

The order and names of individual hierarchic levels are displayed in a tree structure in the REXYGEN Diagnostics program.

Inputs

p

Desired parameter value at the SETPR block input

Double (F64)

ip

Desired parameter value at the SETPI block input

Long (I32)

P

Desired parameter value at the SETPB block input

Bool

SET

Input for initiating one-shot parameter write (off on)

Bool

Outputs

y

Parameter value (the SETPR block)

Double (F64)

k

Parameter value (the SETPI block)

Long (I32)

Y

Parameter value (the SETPB block)

Bool

E

Error flag

Bool

off ..

No error

on ...

An error occurred

Parameters

sc

String connection to the remote parameter respecting the above mentioned notation

String

SETF

Continuous or one-shot mode

Bool

off ..

Remote parameter is continuously updated

on ...

One-shot mode, the remote parameter is updated only when forced to by the SET input (rising edge)

2022 © REX Controls s.r.o., www.rexygen.com