XFC_TimeOfPathPosition

The function block XFC_TimeOfPathPosition calculates the time at which an Nci group has traveled or will have traveled a preset relative path.

The function extrapolates the time in relation to the current path position and dynamics. Precise extrapolation is only possible over a short interval, since the Nci group dynamics may change.

The function block requires precisely one call in order to provide the result. It can therefore be used similar to a function, although as well as the time it may also return an error. This error must be analyzed in order to ensure that the calculated time DcTime is valid.

Inputs

VAR_INPUT
    GrpId        : UDINT;
    PathPosition : LREAL;
    Options      : ST_NcTimeConversionOptions;
END_VAR

Name	Type	Description
GrpId	UDINT	Group ID of the Nci group. This clearly identifies the requested Nci group in the system.
PathPosition	LREAL	Relative path
Options	ST_NcTimeConversionOptions	Data structure with options for the extrapolation of the relative path.

Outputs

VAR_OUTPUT
    DcTime  : T_DCTIME32; 
    Error   : BOOL;
    ErrorID : UDINT;
END_VAR

Name	Type	Description
DcTime	T_DCTIME32	Distributed clock system time at which the relative path PathPosition will have been travelled or at which this was passed. DcTime contains the lower 32 bits of the complete DcTime and covers a time range of +/- 2 seconds around the current time.
Error	BOOL	Becomes TRUE if an error occurs.
ErrorID	UDINT	If the error output is set, this parameter supplies the error number.

Name

Type

Description

DcTime

T_DCTIME32

Distributed clock system time at which the relative path PathPosition will have been travelled or at which this was passed.

DcTime contains the lower 32 bits of the complete DcTime and covers a time range of +/- 2 seconds around the current time.

Error

BOOL

Becomes TRUE if an error occurs.

ErrorID

UDINT

If the error output is set, this parameter supplies the error number.