WagoAppEtherNetIP Adapter
WagoAppEtherNetIP Adapter
WagoAppEtherNetIP_Adapter
Release 1.0.2.1
Contents
1 Description 1
3 29 Types 8
3.1 eEthernetNIC (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2 eFaultReaction (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.3 typDiagnosis (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4 80 Status 10
4.1 Status (GVL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2 eStatus (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5 ParameterList (PARAMS) 13
6 VersionHistory (GVL) 14
7 Library Reference 15
i
CHAPTER 1
Description
This document is automatically generated. Because of this, the chapter 30 Visualization is not shown in this
document. If you are interested in getting to know more about visualization, we refer to the library manager of
e!Cockpit.
Subject to Changes
WAGO Kontakttechnik GmbH Co. KG reserves the right to provide for any alterations or modifications. WAGO
Kontakttechnik GmbH Co. KG owns all rights arising from the granting of patents or from the legal protection
of utility patents. Third-party products are always mentioned without any reference to patent rights. Thus, the
existence of such rights cannot be excluded.
Personnel Qualification
All tasks that are carried out with libraries made for the e!COCKPIT software must only be performed by qualified
electrical specialists instructed in PLC programming according to IEC 61131-3.
All tasks that have an effect on the properties or the behavior of automation hardware or software products must
only be performed by qualified employees with a thorough knowledge of handling the products concerned.
Intended Use of e!COCKPIT Libraries
Libraries created for the e!COCKPIT software are used to simplify the development of application projects in the
IEC 61131-3 programming languages.
For automation tasks, WAGO offers programmable logic controllers in a wide variety of performance classes.
In combination with a wide range of I/O modules, the controllers can process standard types of field signals.
Controllers can be implemented centrally or in decentralized configurations. The controllers offer interfaces for
the most commonly used fieldbuses for use in decentralized configurations. Fieldbus independent I/O modules
are then linked via fieldbus couplers. WAGO controllers offer a runtime environment for user programs called
e!RUNTIME. Software projects for implementation in e!RUNTIME environments can be created in e!COCKPIT.
The programming environment in e!COCKPIT is based on the established CODESYS 3 industrial standard. Users
with a previous knowledge of CODESYS 3 will thus find this environment largely familiar. The following pro-
gramming languages of the IEC 61131-3 standard are available:
• Structured Text (ST)
• Ladder Diagram (LD)
• Function Block Diagram (FBD)
• Instruction List (IL)
• Sequential Function Chart (SFC)
• Continuous Function Chart (CFC)
The individual programming languages can also be combined as required during the development of the software.
A portfolio of prepared libraries can be accessed for many frequently used functions in order to make software de-
velopment more efficient. This document provides an overview of the WagoAppEtherNetIP_Adapter that WAGO
offers for e!COCKPIT.
1
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
1
This library provides an EtherNet/IP Adapter implementation.
Further library information are summerized here:
Company WAGO
Title WagoAppEtherNetIP_Adapter
Version 1.0.2.1
Categories WAGO BusinessView|Factory Automation; WAGO BusinessView|Process Automation;
WAGO FunctionalView|Connectivity|FieldBus; WAGO LayerView|App; Application
Namespace WagoAppEtherNetIP_Adapter
Author WAGO / u013773
Placeholder WagoAppEtherNetIP_Adapter
2
CHAPTER 2
Interface variables
3
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
Dependencies
Function Description
Note: Cycle time of e!COCKPIT task mus be at least as fast as the configured RPI. E.g. if the scanner uses a RPI
of 10ms, the cycle time of e!COCKPIT task must be at least 10ms.
This function block implements an EtherNet/IP Adapter which allows up to three parallel class 1 connections
(Exclusive Owner, Listen Only, Inputs Only) The maximum size of a connection is 500 Byte for each direction.
Behaviour:
Once the function block is called cyclically the output xIsIdle indicates that the adapter is ready to use. Other-
wise xError indicates that the initialization has failed due to an error (e.g. incompatible firmware version).
If xIsIdle is TRUE and the input xOpen transits from FALSE to TRUE the function block will try to start the
underlying EtherNet/IP stack. The output xIsOpen indicates that the start was successful and the function block
can receive connection request from a scanner. If the underlying EtherNet/IP stack could not be started the output
xError is set to TRUE and the output oStatus holds details about the reason.
When the input xOpen transits to FALSE again the function block will stop the underlying EtherNet/IP stack and
all connections are disconnected.
The current connection state of the adapter is indicated by the outputs xExclusiveOwnerIsConnected,
xListenOnlyIsConnected and xInputsOnlyIsConnected.
Example:
The connection size is determined by the size of the arrays aRxBuffer and aTxBuffer. The following decla-
ration will setup a connection size of 32 Byte.
Class Overview
The following classes are accessible:
Identity Object (Class Code: 01 Hex)
Instance 1
ID Access Name Data Type Description Default value
1 Get Vendor ID UINT Manufacturer 40 (16#0028)
identification
2 Get Device Type UINT Indication of gen- 12 (16#000C)
eral type of prod-
uct
3 Get Product Code UINT Identification of 2759 (16#0AC7)
the particular
product
Revision STRUCT of: 01 (16#01)
4 Get Major Revision USINT Revision
Minor Revision USINT 01 (16#00)
5 Get Status WORD Current status 0 (16#0000)
6 Get Serial Number UINT Serial number The last 4 digits
of MAC ID
7 Get Product Name SHORT_STRING Product name WAGO 2759-101
EN/IP
Assembly Object (Class Code: 04 Hex)
29 Types
8
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
80 Status
10
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
ParameterList (PARAMS)
13
CHAPTER 6
VersionHistory (GVL)
Name Type
ProjectInfo
Info
WagoAppEtherNetIP_Adapter.library
date version author change
30.01.2020 1.0.2.1 u013773 Add support for br2 and br3
25.01.2019 1.0.1.1 u013773 Update placeholder
08.01.2019 1.0.1.0 u015842 Properties: free placeholder added
28.10.2016 1.0.0.1 u013773 Update placeholder
04.10.2016 1.0.0.0 u013773 First release
Release Notes: Firmware version >= 02.05.23(08) for PFC100/PFC200 required Trigger mode “Change of State”
is not supported for EtherNet/IP connections
14
CHAPTER 7
Library Reference
Standard
Library Identification:
Placeholder: Standard
Default Resolution: Standard, * (System)
Namespace: Standard
Library Properties:
• LinkAllContent: False
• QualifiedOnly: False
• SystemLibrary: False
• Optional: False
SysTask
Library Identification:
Placeholder: SysTask
Default Resolution: SysTask, * (System)
Namespace: SysTask
Library Properties:
• LinkAllContent: False
• QualifiedOnly: False
• SystemLibrary: False
• Optional: False
WagoAppFileDir
Library Identification:
Placeholder: WagoAppFileDir
Default Resolution: WagoAppFileDir, * (WAGO)
Namespace: WagoAppFileDir
Library Properties:
15
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
• LinkAllContent: False
• QualifiedOnly: False
• SystemLibrary: False
• Optional: False
Library Parameter:
Parameter: STANDARDSCHEDULINGMODE = eSchedulingMode.Background
Parameter: STANDARDTIMEOUT = TIME#10s0ms
WagoAppString
Library Identification:
Placeholder: WagoAppString
Default Resolution: WagoAppString, * (WAGO)
Namespace: WagoAppString
Library Properties:
• LinkAllContent: False
• Optional: False
• QualifiedOnly: False
• SystemLibrary: False
• PublishSymbolsInContainer: True
WagoSysAsync
Library Identification:
Placeholder: WagoSysAsync
Default Resolution: WagoSysAsync, * (WAGO)
Namespace: WagoSysAsync
Library Properties:
• LinkAllContent: False
• QualifiedOnly: False
• SystemLibrary: False
• Optional: False
WagoSysBehaviourModels
Library Identification:
Placeholder: WagoSysBehaviourModels
Default Resolution: WagoSysBehaviourModels, * (WAGO)
Namespace: WagoSysBehaviourModels
Library Properties:
• LinkAllContent: False
• Optional: False
• QualifiedOnly: False
16
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
• SystemLibrary: False
• PublishSymbolsInContainer: True
WagoSysErrorBase
Library Identification:
Placeholder: WagoSysErrorBase
Default Resolution: WagoSysErrorBase, * (WAGO)
Namespace: WagoSysErrorBase
Library Properties:
• LinkAllContent: False
• QualifiedOnly: False
• SystemLibrary: False
• Optional: False
Library Parameter:
Parameter: RES_LOG_MAX_FILESIZE = 2000
Parameter: RES_LOG_MAX_FILES = 1
Parameter: RES_LOG_MAX_ENTRIES = 200
Parameter: RES_LOG_NAME = ‘WagoAppResultLogger’
WagoSysEtherNetIP_Adapter
Library Identification:
Placeholder: WagoSysEtherNetIP_Adapter
Default Resolution: WagoSysEtherNetIP_Adapter, * (WAGO)
Namespace: WagoSysEtherNetIP_Adapter
Library Properties:
• LinkAllContent: False
• QualifiedOnly: True
• SystemLibrary: False
• Optional: False
Library Parameter:
Parameter: BYCONFIGASSEMBLYID = 16#66
Parameter: BYCONSUMINGASSEMBLYID = 16#64
Parameter: BYDUMMYCONSUMINGASSEMBLY2ID = 16#C6
Parameter: BYPRODUCINGASSEMBLYID = 16#65
Parameter: BYDUMMYCONSUMINGASSEMBLY1ID = 16#C6
WagoSysVersion
Library Identification:
Name: WagoSysVersion
Version: 1.0.0.0
Company: WAGO
17
WagoAppEtherNetIP_Adapter, Release 1.0.2.1
Namespace: WagoSysVersion
Library Properties:
• LinkAllContent: False
• QualifiedOnly: False
• SystemLibrary: False
• Optional: False
WagoTypesCommon
Library Identification:
Placeholder: WagoTypesCommon
Default Resolution: WagoTypesCommon, * (WAGO)
Namespace: WagoTypes
Library Properties:
• LinkAllContent: False
• Optional: False
• QualifiedOnly: False
• SystemLibrary: False
• PublishSymbolsInContainer: True
© WAGO Kontakttechnik GmbH & Co. KG, Germany 2018 – All rights reserved. For the avoidance of doubt,
this copyright notice does not only apply to the information above but also and primarily to the described library
itself. Please note that third-party products are always mentioned without reference to intellectual property rights,
including patents, utility models, designs and trademarks, accordingly the existence of such rights cannot be
excluded. WAGO is a registered trademark of WAGO Verwaltungsgesellschaft mbH.
18