Description

Original instructions

Function description

The function block sets the information for the analog output channels ().

This block enables all scaling blocks of this library to be used.

NOTE: The function block is only required if there is no specific block for a specific analog module available.

and can be configured as additional parameters.

Representation in FBD

Representation:

Representation in LD

Representation:

Representation in IL

Representation:

CAL O_SET_Instance (OUT_REG:=RawValueRegister,
    MN_RAW:=MinRawValue, MX_RAW:=MaxRawValue,
    MN_PHYS:=MinPhysValue, MX_PHYS:=MaxPhysValue,
    DIV10:=DivideBy10, ST_CH:=ChannelNumber,
    ST_REG:=StatusRegisterNumber, ST_MODE:=StatusMode,
    ST_HIGH:=StatusInHighByte, CHANNEL=>ChannelInformation)

Representation in ST

Representation:

O_SET_Instance (OUT_REG:=RawValueRegister,
    MN_RAW:=MinRawValue, MX_RAW:=MaxRawValue,
    MN_PHYS:=MinPhysValue, MX_PHYS:=MaxPhysValue,
    DIV10:=DivideBy10, ST_CH:=ChannelNumber,
    ST_REG:=StatusRegisterNumber, ST_MODE:=StatusMode,
    ST_HIGH:=StatusInHighByte,
    CHANNEL=>ChannelInformation) ;

Parameter description

Description of the input parameters:

Parameter	Data type	Meaning
OUT_REG	UINT	Number of the raw value register (%MW)
MN_RAW	DINT	0 % raw value (e.g. 0)
MX_RAW	DINT	100% raw value (e.g. 4095)
MN_PHYS	INT	lowest output value (e.g. 0 V as 0)
MX_PHYS	INT	greatest output value (e.g. +10 V as 10)
DIV10	BOOL	MN_PHYS and MX_PHYS divided by 10
ST_CH	UINT	channel number (1n) (e.g. 4)
ST_REG	UINT	Number of the Status register (%IW)
ST_MODE	UINT	Status mode (e.g. 3=ACO_STATUS_MODE)
ST_HIGH	BOOL	Status byte found in high byte of the register

Description of the output parameters:

Parameter	Data type	Meaning
CHANNEL	ANL_OUT	channel information to be described

Runtime error

The following error messages can be triggered:

Error message	Meaning
E_EFB_USER_ERROR_1	The input OUT_REG is not connected with the number of an output word (%MW).
E_EFB_USER_ERROR_2 with the parameters of the faulty number	The input OUT_REG is connected with an invalid number of an output word (%MW).
E_EFB_USER_ERROR_3 with parameter MN_RAW	MN_RAW ≥ MX_RAW
E_EFB_USER_ERROR_4 with parameter MN_PHYS	Unknown value for MN_PHYS
E_EFB_USER_ERROR_5 with parameter MX_PHYS	Unknown value for MX_PHYS
E_EFB_USER_ERROR_11	ST_REG not entered
E_EFB_USER_ERROR_12	ST_REG too large
E_EFB_USER_ERROR_13	ST_CH not entered

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".

UINT

UINT is the abbreviation of the Unsigned INTeger format (encoded in 16 bits). The upper/lower limits are as follows: 0 to (2 to the power of 16) - 1.

Example:

0, 65535, 2#1111111111111111, 8#177777, 16#FFFF.

DINT

DINT is the abbreviation of Double INTeger (encoded in 32 bits).

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

Example:

-2147483648, 2147483647, 16#FFFFFFFF.

INT

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.

Example:

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

BOOL

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.

ANL_OUT

ANL_OUT is an internal data type that is used between Quantum specific FFBs. For instance, an ACO130 FFB provides the channel structures of the module as ANL_OUT types, which are used as input of an O_PHYS 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)