ST_IEC870_5_101HashTableKey
From product version: TwinCAT PLC Library IEC60870-5-104 controlling station v1.0.0 and higher.
Application object database lookup key. The key can be used for locating and modifying the hash table entries.
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: Application object type, ASDU identifier (e.g.: M_SP_NA_1 for single-point or M_DP_NA_1 for double-point etc.).
asduAddr: Common ASDU address.
objAddr : Object address, freely selectable.
group: Object group configuration flags. A description of all group flags can be found here. The flags can be combined with an OR operation. If this parameter is zero 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. |
Example in ST:
See function description: F_iecLookupTableEntry, F_iecRemoveTableEntry, F_iecGetPosOfTableEntry.
Requirements
Development Environment | Target System | PLC Libraries to include |
|---|---|---|
TwinCAT v2.10.0 Build >= 1301 | PC or CX (x86, ARM) | TcIEC870_5_101.Lib |