ST_TopologyDataEx

The structure ST_TopologyDataEx contains information on EtherCAT topology and hot-connect groups.

TYPE ST_TopologyDataEx:
STRUCT
   nOwnPhysicalAddr  :  UINT;
   nOwnAutoIncAddr   :  UINT;
   stPhysicalAddr    :  ST_PortAddr;
   stAutoIncAddr     :  ST_PortAddr;
   aReserved1        :  ARRAY [0..3] OF UDINT;
   nStatusBits       :  DWORD;
   nHCSlaveCountCfg  :  UINT; (*nStatusBits.0 = TRUE: DcSupprt;.1 = TRUE: DC64Supprt; .2=TRUE: SlavePresent following hot connect info requires runtime >= TC 2.11 R3 B2246 nStatusBits.3 = TRUE: HotConnectGroupStart; .4 = HotConnectSlave; .5 = TRUE: HotCOnnectInvalidB; .6 = TRUE: HotConnectInvalidC; .7 = TRUE: HotConnectInvalidD*)
   nHCSlaveCountAct  :  UINT;
   aReserved2        :  ARRAY [0..4] OF UDINT;
END_STRUCT
END_TYPE

Name

Type

Description

nOwnPhysicalAddr

UINT

Dedicated physical EtherCAT address of the EtherCAT slave device

nOwnAutoIncAddr

UINT

Dedicated auto-increment EtherCAT address of the EtherCAT slave device

stPhysicalAddr

ST_PortAddr

Physical address information of the EtherCAT slave devices at port A…D

stAutoIncAddr

ST_PortAddr

Auto-increment address information of the EtherCAT slave devices at port A…D

aReserved1

ARRAY [0..3] OF UDINT

Reserved

nStatusBits

DWORD

nStatusBits.0 = TRUE: Distributed clock is supported
nStatusBits.1 = TRUE: Distributed Clock is supported (64-bit)
nStatusBits.2 = TRUE: slave is present
nStatusBits.3 = TRUE: slave is start node of a Hot Connect group
nStatusBits.4 = TRUE: slave is in a Hot Connect group
nStatusBits.5 = TRUE: Hot Connect is invalid at port B
nStatusBits.6 = TRUE: Hot Connect is invalid at port C
nStatusBits.7 = TRUE: Hot Connect is invalid at port D

nHCSlaveCountCfg

UINT

Configured number of Hot Connect group devices

nHCSlaveCountAct

UINT

Found number of Hot Connect group devices

aReserved2

ARRAY [0..4] OF UDINT

Reserved

Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.0

PC or CX (x86, x64, ARM)

Tc2_EtherCAT