I_RAW: Raw value analog input

Original instructions

Function description

The function provides analog input values as raw values of the data type.

and can be configured as additional parameters.

Representation in FBD

Representation:

Representation in LD

Representation:

Representation in IL

Representation:

LD InputChannel
I_RAW
ST RawValue

Representation in ST

Representation:

RawValue := I_RAW (InputChannel) ;

Parameter description

Description of input parameters:

Parameter	Data type	Meaning
InputChannel	ANL_IN	Input channel

Description of output parameters:

Parameter	Data type	Meaning
RawValue	WORD	Raw value

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.
if there is an input range violation.

NOTE: For a list of all block error codes and values, seeAnalog 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