I_RAWSIM: Simulated raw value analog input

Original instructions

Function description

The procedure provides the option to simulate raw value analog inputs.

NOTE: Specify the processing sequence of functions and function blocks so that I_RAWSIM is processed before all other functions and function blocks that read the simulated raw value. Link the ENOoutput of I_RAWSIM to the EN inputs of all functions and function blocks that read the simulated raw value.

As additional parameters, and are projected.

Representation in FBD

Representation:

Representation in LD

Appearance:

Representation in IL

Appearance:

I_RAWSIM (CHANNEL:=SimulatedRowValue, SIM:=RawValue)

Representation in ST

Appearance:

I_RAWSIM (CHANNEL:=SimulatedRowValue, SIM:=RawValue) ;

Parameter description

Description of input parameters:

Parameter	Data type	Description
CHANNEL	ANL_IN	Simulated raw value
SIM	WORD	Input value

Example

The example shows a configuration with an analog input module (140 ACI 030) with a resolution of 12 bits, which corresponds with a value range (raw value) of 0...4096.

Using the scaling block I_SCALE this value range (raw value) is scaled to a physical value range of -20° C...+80° C.

The procedureI_RAWSIM provides the option to simulate and scale a raw value (e.g. 2048) of the analog input module (30.01221), without actually basing this value on the module.

Example configuration

Runtime error

An error message is returned

if the input channel is not configured. In this case, please check the connected I/O module EFB.

NOTE: For a list of all error codes and values of the module, see Analog I/O Scaling .

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

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

If ENO is set to 0 (because EN = 0 or in case of an execution error):

the status of the function block outputs remains the same as it was during the previous scanning cycle that executed correctly;
the output(s) of the function, as well as the procedures, are set to "0".

ANL_IN

ANL_IN is an internal data type that is used between Quantum specific FFBs. For instance, an ACI040 FFB provides the channels structures of the module as ANL_IN types, which are used as input of an I_FILTER FFB. This data type must not be used outside the Quantum specific FFBs.

Elements of the DDT:

Name	Type	Comment
valuePtr	UDINT	3x or 4x raw value register
rawControl	BYTE	Control Byte(internal use only)
rawSpecific	BYTE	Specific Byte (internal use only)
offset	INT	Offset Value
range	WORD	Input range (resolution)
channel	BYTE	Input Channel number
statusMode	BYTE	Status Mode (internal use only)
statusPtr	UDINT	Identifies high byte or low byte of status register
warnCode	BYTE	Warning Code (internal use only)

WORD

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:

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

Examples of representation

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