Analog Control Blocks > Analog Tracking (AT) function block

Analog Tracking function block parameters

The following table lists the system parameters for the Analog Tracking function block:

Table: Analog Tracking Function Block System Parameters
Parameter Units Description

ABNORM_ACTIVE

None

The indication that a block error condition not selected in BAD_MASK (on the function block level) is True (Active) or the indication that an error condition (at the module level) not selected in MERROR_MASK is True (Active) or a module status not selected in MSTATUS_MASK is True (Active).

ALGO_OPTS

None

When AbortOnReadErrors is selected, the expression algorithm aborts after a read error. When the expression aborts, the value and status of T_OUT_Dn and T_PRE_OUT_Dn remain unchanged.

ARM_TRAP

None

When ARM_TRAP is non-zero, it enables the first out trap mechanism.

BAD_ACTIVE

None

The indication that a block error condition selected in BAD_MASK (at the function block level) is True (Active) or the indication that an error condition (at the module level) selected in MERROR_MASK is True (Active) or a module status selected in MSTATUS_MASK is True (Active).

BAD_MASK

None

The set of active error conditions that triggers a user-defined Bad condition. Select a subset of block error (BLOCK_ERR) conditions in the BAD_MASK parameter. When any of these conditions are True, the BAD_ACTIVE parameter becomes True. When any of the BLOCK_ERR conditions that are not included in BAD_MASK are True, ABNORM_ACTIVE becomes True.

BLOCK_ERR

None

The summary of active error conditions associated with the block. The block error for the Analog Tracking function block is:
  • Configuration Error - The expression is empty

DESC

None

Contains the description of the first condition that evaluates to True when a trap occurs.

DISABLE_ACT

None

The output value that represents the logical OR of the T_DISABLEn parameters.

ERROR_OPT

None

Specifies how the block behaves when a read error occurs. The value of T_PRE_OUT_Dn is False, True, or the last value prior to the read error as defined in ERROR_OPT (unless Abort on Read Errors is set in ALGO_OPTS, then ERROR_OPT does not apply). The status of T_PRE_OUT_Dn is BadNoComm when a read error occurs

FDBK_IN

None

Value of the command from the downstream analog block. FDBK_IN latches conditions and arms the trap of the first tracking condition and automatically resets the first tracking indication

FIRST_OUT

None

The bit value of the highest priority condition (lowest condition number) that is currently active. If another condition that has a different track value (T_VALn) and a higher priority becomes active, FIRST_OUT changes to the bit value of the newly active condition

When FDBK_IN status is bad, the FIRST_OUT trap occurs immediately when the condition becomes True and ARM_TRAP is True.

OUT

None

This analog output value equals the T_VALn parameter associated with the active or latched tracking condition (T_OUT_Dn or T_L_OUT_Dn is True) having the smallest condition number.

When all conditions clear, OUT retains its last value.

OUT_D

None

The logical OR of the T_L_OUT_Dn OR T_OUT_Dn parameters.

OUT_HYS

None

The trap of the first tracking condition and condition latching is enabled when the command of the downstream block (FDBK_IN) is outside the limits set by OUT +/- OUT_HYS.

The automatic reset of the first tracking condition is possible when the parameter FDBK_IN is beyond the limits set by OUT +/- OUT_HYS.

OUT_INT

None

The unsigned 32-bit binary weighted output value that represents the bit combination of the T_L_OUT_Dn or T_OUT_Dn parameters.

For example, if only T_OUT_D1 and T_OUT_D3 are True, OUT_INT = 5.

RESET_D

None

When transitioning from zero to non-zero, RESET_D
  • clears FIRST_OUT, and

  • unlatches the T_L_OUT_Dn parameters that are True and for which the T_RESET_REQDn is True and the T_OUT_Dn parameters are False.

The block sets RESET_D back to zero at the end of each scan.

RESET_D does not re-arm the trap. FIRST_OUT remains cleared until the trap occurs again.

The unlatched T_L_OUT_Dn parameters remain False until one or more T_OUT_Dn parameters transition to True and for which the T_RESET_REQDn parameters are True.

RESET_REQD

None

When all tracking conditions evaluate to False (including conditions that are True but Disabled) but at least one condition is latched, RESET_REQD is set to True.

T_DELAY_OFFn

Seconds

The number of seconds before T_PRE_OUT_Dn becomes False after condition n clears. If condition n reoccurs before the delay time is reached, T_PRE_OUT_Dn remains True and the timer is reset. Every time condition n is detected, the timer resets.

T_DELAY_ONn

Seconds

The number of seconds before T_PRE_OUT_Dn becomes True after condition n is True. If condition n clears before the delay time is reached, T_PRE_OUT_Dn remains False and the timer is reset. Every time condition n clears, the timer resets.

T_DESCn

None

User-specified description of the tracking conditions.

T_DISABLEn

None

Enables/disables the conditions (True = disable, False = enable).

T_EXPn

None

The configurable expression n whose evaluation determines if the condition is True (active).

T_HIGHER_MNGn

None

Enables/disables the ability to disable a condition using T_DISABLEn. When T_HIGHER_MNGn is True, T_DISABLEn has no effect on T_OUT_Dn.

T_HOLD_MANn

None

Puts the downstream block in Manual mode when these conditions are all true:
  • OUT_INT is non-zero (there is at least one condition active or latched)
  • The T_HOLD_MANn parameter associated with the current active or latched tracking condition is TRUE
  • FDBK_IN > OUT + OUT_HYS or FDBK_IN < OUT - OUT_HYS (the downstream block that has to track has an output value that is outside the limits set by the AT block tracking value [OUT] +/- output hysteresis [OUT_HYS]).

T_L_OUT_Dn

None

The latched value of T_OUT_Dn when T_RESET_REQDn is True and FDBK_IN is outside the limits set by OUT +/- OUT_HYS when FDBK_IN status is not Bad.

When T_RESET_REQDn is False, T_L_OUT_Dn is a copy of T_OUT_Dn.

T_OUT_Dn

None

The value copied from T_PRE_OUT_Dn when condition n is not disabled.

When condition n is disabled, T_OUT_Dn is False.

T_PRE_OUT_Dn

None

The value set when T_EXPn evaluates to True for a period longer than T_DELAY_ONn. T_PRE_OUT_Dn ignores the T_DISABLEn value.

T_RESET_REQDn

None

Enables the latching of T_OUT_Dn when True.

When T_L_OUT_Dn is latched, a reset is required to unlatch it when T_OUT_Dn is False. A reset is required to avoid the OUT_D parameter returning to False without an action to acknowledge that an active condition was present.

T_TIMERn

Seconds

The elapsed time since condition n transitioned to True.

T_TIMERn resets when T_PRE_OUT_Dn transitions to False.

T_USED_CND

None

Sets the number of analog tracking conditions evaluated by the analog tracking logic.

T_USED_CND can take any value between 0 and 16.

T_VALn

None

Analog value configured for condition n.

TGT_BLK_NAME

None

In control loop modules this read-only runtime parameter indicates the downstream block wired to OUT_D whose mode is set to MAN when both T_L_OUT_Dn and T_HOLD_MANn of any condition are True. If multiple downstream blocks are wired, only the first block wired is reported.

Validation of the wired connection is performed during download.