Analog Device DDT

Introduction

This topic describes the Control Expert Analog Device DDT. The instance default naming is described in Device DDT Instance Naming Rule.

Regarding the device DDT, its name contains the following information:

platform with:
- U for unified structure between Modicon X80 module and Quantum
device type (ANA for analog)
function (STD for standard)
- STD for standard
- TEMP for temperature
direction:
- IN
- OUT
max channel (2, 4, 8)

Example: For a Modicon X80 module with 4 standard inputs and 2 outputs the Device Derived Data Type is T_U_ANA_STD_IN_4_OUT_2

Adjustment Parameter limitation

In Quantum EIO and M580 RIO, adjustment parameters cannot be changed from the PLC application during operation (no support of READ_PARAM, WRITE_PARAM, SAVE_PARAM, RESTORE_PARAM).

The concerned analog input parameters are:

FILTER_COEFF

Value of filter coefficient
ALIGNMENT_OFFSET

Alignment offset value

The concerned analog output parameters are:

FALLBACK

Fallback value
ALIGNMENT

Alignment value

List of Implicit Device DDT

The following table shows the list of device DDT and their X80 modules:

Device DDT Type	Modicon X80 Devices
`T_U_ANA_STD_IN_4`	BMX AMI 0410
`T_U_ANA_STD_IN_8`	BME AHI 0812 BMX AMI 0800 BMX AMI 0810
`T_U_ANA_STD_OUT_2`	BMX AMO 0210
`T_U_ANA_STD_OUT_4`	BME AHO 0412 BMX AMO 0410
`T_U_ANA_STD_OUT_8`	BMX AMO 0802
`T_U_ANA_STD_IN_4_OUT_2`	BMX AMM 0600
`T_U_ANA_TEMP_IN_4`	BMX ART 0414
`T_U_ANA_TEMP_IN_8`	BMX ART 0814

Implicit Device DDT Description

The following table shows the T_U_ANA_STD_IN_x and the T_U_ANA_STD_OUT_y status word bits:

Standard Symbol	Type	Meaning	Access
MOD_HEALTH	BOOL	0 = the module has a detected error	read
MOD_HEALTH	BOOL	1 = the module is operating correctly	read
MOD_FLT	BYTE	internal detected errors byte of the module	read
ANA_CH_IN	ARRAY [0...x-1] of `T_U_ANA_STD_CH_IN`	array of structure	–
ANA_CH_OUT	ARRAY [0..y-1] of `T_U_ANA_STD_CH_OUT`	array of structure	–

The following table shows the T_U_ANA_STD_IN_x_OUT_y status word bits:

Standard Symbol	Type	Meaning	Access
MOD_HEALTH	BOOL	0 = the module has a detected error	read
MOD_HEALTH	BOOL	1 = the module is operating correctly	read
MOD_FLT	BYTE	internal detected errors byte of the module	read
ANA_CH_IN	ARRAY [0..x-1] of `T_U_ANA_STD_CH_IN`	array of structure	–
ANA_CH_OUT	ARRAY [x..x+y-1] of `T_U_ANA_STD_CH_OUT`	array of structure	–

The following table shows the T_U_ANA_TEMP_IN_x status word bits:

Standard Symbol	Type	Meaning	Access
MOD_HEALTH	BOOL	0 = the module has a detected error	read
MOD_HEALTH	BOOL	1 = the module is operating correctly	read
MOD_FLT	BYTE	internal detected errors byte of the module	read
ANA_CH_IN	ARRAY [[0..x-1] of `T_U_ANA_TEMP_CH_IN`	array of structure	–

The following table shows the T_U_ANA_STD_CH_IN[0..x-1] structure status word bits:

Standard Symbol		Type	Bit	Meaning	Access
FCT_TYPE		WORD	–	0 = channel is not used	read
FCT_TYPE		WORD	–	1 = channel is used	read
CH_HEALTH		BOOL	–	0 = the channel has a detected error	read
CH_HEALTH		BOOL	–	1 = the channel is operating correctly	read
CH_WARNING		BOOL	–	not used	–
ANA		STRUCT	–	`T_U_ANA_VALUE_IN`	read
MEASURE_STS [INT]	CH_ALIGNED	BOOL	0	aligned channel	read
	LOWER_LIMIT	BOOL	5	measurement within lower tolerance area	read
	UPPER_LIMIT	BOOL	6	measurement within upper tolerance area	read
	INT_OFFSET_ERROR	BOOL	8	internal offset detected error	read
	IN_REF_ERROR	BOOL	10	internal reference detected error	read
	POWER_SUP_ERROR	BOOL	11	not used	read
	SPI_COM_ERROR	BOOL	12	SPI communication detected error	read

The following table shows the T_U_ANA_STD_CH_OUT[0..y-1] status word bits:

Standard Symbol	Type	Meaning	Access
FCT_TYPE	WORD	0 = channel is not used	read
FCT_TYPE	WORD	1 = channel is used	read
CH_HEALTH	BOOL	0 = the channel has a detected error	read
CH_HEALTH	BOOL	1 = the channel is operating correctly	read
ANA	STRUCT	`T_U_ANA_VALUE_OUT`	read

The following table shows the T_U_ANA_VALUE_IN[0..x-1] and T_U_ANA_VALUE_OUT[0..y-1] structure status word bits:

Standard Symbol	Type	Bit	Meaning	Access
VALUE	INT	–	if FORCE_CMD = 1 then VALUE = FORCED_VALUE	read⁽¹⁾
VALUE	INT	–	if FORCE_CMD = 0 then VALUE = TRUE_VALUE	read⁽¹⁾
FORCED_VALUE	INT	–	forced value of the channel	read / write
FORCE_CMD	BOOL	–	0 = Un-force command	read / write
FORCE_CMD	BOOL	–	1 = force command	read / write
FORCE_STATE	BOOL	–	0 = value is not forced	read
FORCE_STATE	BOOL	–	1 = value is forced	read
TRUE_VALUE⁽²⁾	INT	–	True value of the channel (from the sensor)	read
1 `VALUE` of the `T_U_ANA_VALUE_OUT` structure word can be accessed in read / write 2 `TRUE_VALUE` of the `T_U_ANA_VALUE_OUT` is the value calculated from the application.

The following table shows the T_U_ANA_TEMP_CH_IN[0..x-1] structure status word bits:

Standard Symbol	Type	Bit	Meaning	Access
FCT_TYPE	WORD	–	0 = channel is not used	read
FCT_TYPE	WORD	–	1 = channel is used	read
CH_HEALTH	BOOL	–	0 = the channel has a detected error	read
CH_HEALTH	BOOL	–	1 = the channel is operating correctly	read
CH_WARNING	BOOL	–	not used	–
ANA	STRUCT	–	`T_U_ANA_VALUE_IN`	read
MEASURE_STS	INT	–	measurement status	read
CJC_VALUE	INT	–	Cold junction compensation value (1/10 °C)	read

Use and Description of DDT for Explicit Exchange

The following table shows the DDT type used for the variables connected to dedicated EFB parameter to perform an explicit exchange:

DDT	Description
T_M_ANA_STD_CH_STS	Structure to read the channel status of an analog module.	Depending on the I/O module location, the DDT can be connected to the STS output parameter of the EFB: READ_STS_QX when the module is located in Quantum EIO. READ_STS_MX when the module is located in a M580 local rack or in M580 RIO drops.
T_M_ANA_STD_CH_IN_STS	Structure to read the channel status of an analog output module.
T_M_ANA_STD_CH_OUT_STS	Structure to read the channel status of an analog output module.
T_M_ANA_TEMP_CH_STS	Structure to read the channel status of an analog temperature input module.
T_M_ANA_STD_CH_IN_PRM	Structure for adjustment parameters of a channel of an analog input module in a M580 local rack.	The DDT can be connected to the PARAM output parameter of the EFB: READ_PARAM_MX to read module parameters. WRITE_PARAM_MX to write module parameters. SAVE_PARAM_MX to save module parameters. RESTORE_PARAM_MX to restore the new parameters of the module.
T_M_ANA_STD_CH_OUT_PRM	Structure for adjustment parameters of a channel of an analog output module in a M580 local rack.
NOTE: Targeted channel address (ADDR) can be managed with ADDMX EF (connect the output parameter OUT to the input parameter ADDR of the communication functions).

NOTE: For more details about EF and EFB, refer to EcoStruxure™ Control Expert, I/O Management, Block Library and EcoStruxure™ Control Expert, Communication, Block Library.

The following table shows the DDT structure for T_M_ANA_STD_CH_STS, T_M_ANA_STD_CH_IN_STS, T_M_ANA_STD_CH_OUT_STS and T_M_ANA_TEMP_CH_STS:

Standard Symbol		Type	Bit	Meaning	Access
CH_FLT [INT]	SENSOR_FLT	BOOL	0	detected sensor faults	read
	RANGE_FLT	BOOL	1	detected range fault	read
	CH_ERR_RPT	BOOL	2	channel detected error report	read
	INTERNAL_FLT	BOOL	4	internal detected error: module out of order	read
	CONF_FLT	BOOL	5	detected configuration fault: different hardware and software configurations	read
	COM_FLT	BOOL	6	detected problem communicating with the PLC	read
	APPLI_FLT	BOOL	7	detected application fault	read
	COM_FLT_ON_EVT⁽¹⁾	BOOL	8	detected communication fault on event	read
	OVR_ON_CH_EVT⁽¹⁾	BOOL	9	detected overrun fault on CPU event	read
	OVR_ON_CH_EVT⁽¹⁾	BOOL	10	detected overrun fault on channel event	read
CH_FLT_2 [INT]	NOT_READY	BOOL	0	Channel not ready	read
	COLD_JUNCTION_FLT⁽²⁾	BOOL	1	Cold junction compensation detected error	read
	CALIB_FLT	BOOL	2	detected calibration fault	read
	INT_OFFS_FLT	BOOL	3	detected internal offset error	read
	IN_REF_FLT	BOOL	4	detected internal reference fault	read
	INT_SPI_PS_FLT	BOOL	5	detected internal serial link or power supply error	read
	RANGE_UNF	BOOL	6	recalibrated channel or range underflow	read
	RANGE_OVF	BOOL	7	aligned channel or range overflow	read
(1) Only available with T_M_ANA_STD_CH_IN_STS and T_M_ANA_STD_CH_OUT_STS. (2) Only available with T_M_ANA_TEMP_CH_STS.

The following table shows the T_M_ANA_STD_CH_IN_PRM DDT structure:

Standard Symbol	Type	Bit	Meaning	Access
FILTERCOEFF	INT	–	Value of filter coefficient	read/write
ALIGNMENT_OFFSET	INT	–	Alignment offset value	read/write
THRESHOLD0	INT	–	Reserved for evolution.	–
THRESHOLD1	INT	–	Reserved for evolution.	–

The following table shows the T_M_ANA_STD_CH_OUT_PRM DDT structure:

Standard Symbol	Type	Bit	Meaning	Access
FALLBACK	INT	–	fallback value	read/write
ALIGNMENT	INT	–	alignment value	read/write