IF_TargetManager - AddTargetDistance (Method)

Overview

Type:	Method
Available as of:	V1.0.0.0
Versions:	Current version

Task

Create a target at a distance from the last target.

Description

Adds a target to the list of targets at i_lrDistance behind the last target. If another target has been entered, the zero position of the target belt is assumed as last target.

Interface

Input	Data type	Description
i_lrDistance	LREAL	Distance of the new target from the last entered target

Output	Data type	Description
q_etDiag	GD.ET_Diag	General, library-independent statement on the diagnosis. A value unequal GD.ET_Diag.Ok equates an error message.
q_etDiagExt	ET_DiagExt	POU-specific output on the diagnosis. q_etDiag = GD.ET_Diag.Ok -> status message q_etDiag <> GD.ET_Diag.Ok -> error message

Output

Data type

Description

q_etDiag

GD.ET_Diag

General, library-independent statement on the diagnosis.

A value unequal GD.ET_Diag.Ok equates an error message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnosis.

q_etDiag = GD.ET_Diag.Ok -> status message

q_etDiag <> GD.ET_Diag.Ok -> error message

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
OK	Ok	0	Ok
ExecutionAborted	MaxNrOfTargetsReached	74	The maximum number of manageable targets has been reached.
InputParameterInvalid	DistanceRange	34	Distance is outside the valid range.
UnexpectedProgramBehavior	BeltInvalid	13	The belt is invalid.

BeltInvalid

Enumeration name:	BeltInvalid
Enumeration value:	13
Description:	The belt is invalid.

Issue	Cause	Solution
-	An error occurred in the internal execution.	Please inform the support team about this error.

DistanceRange

Enumeration name:	DistanceRange
Enumeration value:	34
Description:	Distance is outside the valid range.

Issue	Cause	Solution
-	An invalid value has been transferred at the i_lrDistance input.	It must be made sure that a value greater than 0 is transferred at the input i_lrDistance.

MaxNrOfTargetsReached

Enumeration name:	MaxNrOfTargetsReached
Enumeration value:	74
Description:	The maximum number of manageable targets has been reached.

Issue	Cause	Solution
-	There was an attempt to add more than the maximum number of targets to the infeed distance.	At no time more than Gc_udiMaxNumberOfTargets targets may be defined for the infeed distance. The global parameter Gc_udiMaxNumberOfTargets must be set to a value that is greater than the maximum number of targets for the infeed distance.

Issue

Cause

Solution

There was an attempt to add more than the maximum number of targets to the infeed distance.

At no time more than Gc_udiMaxNumberOfTargets targets may be defined for the infeed distance.

The global parameter Gc_udiMaxNumberOfTargets must be set to a value that is greater than the maximum number of targets for the infeed distance.

Enumeration name:	Ok
Enumeration value:	0
Description:	Ok

The target has been added successfully.