### GETPR, GETPI, GETPB – Blocks for remote parameter acquirement

Block SymbolsLicensing group: STANDARD

Function Description
The GETPR, GETPI and GETPB blocks are used for acquiring the parameters of other blocks in the model remotely . The only difference among the three blocks is the type of parameter which they are acquiring. The GETPR block is used for obtaining real parameters, the GETPI block for integer parameters and the GETPB block for Boolean parameters.

The blocks operate in two modes, which are switched by the GETF parameter. For $\mathtt{\text{GETF}}=\mathtt{\text{off}}$ the output y (or k, Y) is set to the value of the remote parameter at the start and every time when the remote parameter changes. If the $\mathtt{\text{GETF}}$ parameter is set to on, then the blocks work in single-shot read mode. In that case the remote parameter is read only when rising edge (off$\to$on) occurs at the GET input.

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 read 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 GETPR block (or GETPI, GETPB) is located. The string has to be prefixed with ’.’ in this case. Examples of relative 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.

Input

 GET Input for initiating one-shot parameter read (off$\to$on) Bool

Outputs

 y Parameter value, output of the GETPR block Double (F64) k Parameter value, output of the GETPI block Long (I32) Y Parameter value, output of the GETPB 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 GETF Continuous or one-shot mode Bool off .. Remote parameter is continuously read on ... One-shot mode, the remote parameter is read only when forced to by the GET input (rising edge)

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