ItpGetGeoInfoAndHParamEx

The function block ItpGetGeoInfoAndHParamEx reads information of the currently active segment, as well as past and future segments. These include block number, H-parameter and residual path length on the segment.

/ Inputs/Outputs

VAR_IN_OUT
    sNciToPlc           : NCTOPLC_NCICHANNEL_REF;
END_VAR

Name	Type	Description
sNciToPlc	NCTOPLC_NCICHANNEL_REF	The structure of the cyclic channel interface from the NCI to the PLC. This structure is read-only (type: NCTOPLC_NCICHANNEL_REF).

Outputs

VAR_OUTPUT
    stTab               : ST_ItpPreViewTabEx;
    nErrId              : UDINT;
END_VAR

Name	Type	Description
stTab	ST_ItpPreViewTabEx	Structure containing the segment data. See ST_ItpPreViewTabEx.
nErrId	UDINT	Contains the command-specific error code of the most recently executed command. Is reset to 0 by the execution of a command at the inputs. The error numbers in `nErrId` can be looked up in the ADS error documentation or in the NC error documentation (error codes above 0x4000).

ST_ItpPreViewTabEx

TYPE ST_ItpPreViewTabEx :
STRUCT
    nDcTime               : UDINT := 0;
    nReserved             : UDINT := 0;
    arrLines              : ARRAY[1..NCI_MAX_PREVIEWTABLINES] OF ST_ItpPreViewTabLine;
END_STRUCT
END_TYPE

Name	Type	Description
nDcTime	UDINT	Current timestamp in ns. This timestamp can be used in synergy with the `Tc2_NciXFC` library.
nReserved	UDINT
arrLines	ARRAY[1..NCI_MAX_PREVIEWTABLINES] OF ST_ItpPreViewTabLine	Array of segment-related information (size 20). The entry at position 11 of the array corresponds to the currently active segment. Segments that have already been processed are displayed at positions 1-10 of the array, future segments at positions 12-20. See ST_ItpPreViewTabLine.

ST_ItpPreViewTabLine

TYPE ST_ItpPreViewTabLine :
STRUCT
    fLength               : LREAL := 0.0;
    nBlockNo              : UDINT := 0;
    nHParam               : UDINT := 0;
    nEntryID              : UDINT := 0;
    nReserved             : UDINT := 0;
END_STRUCT
END_TYPE

Name	Type	Description
fLength	LREAL	Remaining segment length. For segments that are not yet active this corresponds to the total segment length. For past segments the distance moved since the end of the segment is specified.
nBlockNo	UDINT	Block number programmed by the user
nHParam	UDINT	Value of the H-parameter that is active from the start of the next segment.
nEntryID	UDINT	Command ID generated by the system
nReserved	UDINT

Requirements

Development environment	Target platform	PLC libraries to be linked
TwinCAT v3.1.0	PC or CX (x86 or x64)	Tc2_NCI