ST_IEC870_5_101HashTableKey

Application object database lookup key. The key can be used for locating and modifying the hash table entries.

Syntax

TYPE ST_IEC870_5_101HashTableKey :
STRUCT
    eType       : E_IEC870_5_101TcTypeID := ASDU_TYPEUNDEF;
    asduAddr    : DWORD := 0;
    objAddr     : DWORD := 0;
    group       : DWORD := 0;
    lookup      : DWORD := IEC870_LOOKUP_KEY_ALL_ON;
END_STRUCT
END_TYPE

eType: IEC 60870-5-101/104 ASDU type ID (e.g.: M_SP_NA_1 for single-point or M_DP_NA_1 for double point etc.).

asduAddr: Common ASDU address (CAA).

objAddr: Information object address (IOA).

group: Object group configuration flags. The flags can be combined with an OR operation. If this parameter is null the group parameters are ignored.

lookup: Additional lookup key parameters. The available parameters are declared as constants (see table below). They can be combined with an OR operation.

Constant

Value

Description

IEC870_LOOKUP_KEY_ALL_ON

0

All parameters are considered in the search (eType, asduAddr, objAddr, group).

IEC870_LOOKUP_KEY_TYPE_OFF

1

The eType parameter is ignored in the search.

IEC870_LOOKUP_KEY_ASDUADDR_OFF

2

The asduAddr parameter is ignored in the search.

IEC870_LOOKUP_KEY_GROUP_OFF

4

The group parameter is ignored in the search.

IEC870_LOOKUP_KEY_OBJADDR_OFF

8

The objAddr parameter is ignored in the search. This parameter is not recommended because all data points must be identifiable via a unique object address.

Sample in ST:

See function description: F_iecLookupTableEntry, F_iecRemoveTableEntry, F_iecGetPosOfTableEntry.

Requirements

Development environment

Target system type

PLC libraries to be linked (category group)

TwinCAT v3.1.4012.0

PC oder CX (x86, x64, ARM)

Tc2_IEC60870_5_10x (Communication->IEC60870)
Tc2_SerialCom (Communication->Serial)
Tc2_TcpIp (Communication->TcpIp)
Tc2_Utilities (System)