6.3Support and Service ........................................................................................................................96
EPI3xxx, ERI3xxx4Version: 1.2
Foreword
1Foreword
1.1Notes on the documentation
Intended audience
This description is only intended for the use of trained specialists in control and automation engineering who
are familiar with the applicable national standards.
It is essential that the documentation and the following notes and explanations are followed when installing
and commissioning these components.
It is the duty of the technical personnel to use the documentation published at the respective time of each
installation and commissioning.
The responsible staff must ensure that the application or use of the products described satisfy all the
requirements for safety, including all the relevant laws, regulations, guidelines and standards.
Disclaimer
The documentation has been prepared with care. The products described are, however, constantly under
development.
We reserve the right to revise and change the documentation at any time and without prior announcement.
No claims for the modification of products that have already been supplied may be made on the basis of the
data, diagrams and descriptions in this documentation.
Trademarks
Beckhoff®, TwinCAT®, EtherCAT®, Safety over EtherCAT®, TwinSAFE®, XFC® and XTS® are registered
trademarks of and licensed by Beckhoff Automation GmbH.
Other designations used in this publication may be trademarks whose use by third parties for their own
purposes could violate the rights of the owners.
Patent Pending
The EtherCAT Technology is covered, including but not limited to the following patent applications and
patents: EP1590927, EP1789857, DE102004044764, DE102007017835 with corresponding applications or
registrations in various other countries.
The TwinCAT Technology is covered, including but not limited to the following patent applications and
patents: EP0851348, US6167425 with corresponding applications or registrations in various other countries.
EtherCAT® is registered trademark and patented technology, licensed by Beckhoff Automation GmbH,
Germany
Please note the following safety instructions and explanations!
Product-specific safety instructions can be found on following pages or in the areas mounting, wiring,
commissioning etc.
Exclusion of liability
All the components are supplied in particular hardware and software configurations appropriate for the
application. Modifications to hardware or software configurations other than those described in the
documentation are not permitted, and nullify the liability of Beckhoff Automation GmbH & Co. KG.
Personnel qualification
This description is only intended for trained specialists in control, automation and drive engineering who are
familiar with the applicable national standards.
Description of instructions
In this documentation the following instructions are used.
These instructions must be read carefully and followed without fail!
DANGER
Serious risk of injury!
Failure to follow this safety instruction directly endangers the life and health of persons.
WARNING
Risk of injury!
Failure to follow this safety instruction endangers the life and health of persons.
CAUTION
Personal injuries!
Failure to follow this safety instruction can lead to injuries to persons.
NOTE
Damage to environment/equipment or data loss
Failure to follow this instruction can lead to environmental damage, equipment damage or data loss.
Tip or pointer
This symbol indicates information that contributes to better understanding.
EPI3xxx, ERI3xxx6Version: 1.2
Foreword
1.3Documentation issue status
VersionModifications
1.2• Chapter "Process data" added
1.1• Update connection assignment
• Update structure
• Update chapter "Connection IO-Link Master"
1.0• First publication
0.5• First preliminary version
Firm and hardware version
The documentation refers to the firm and hardware status that was valid at the time it was prepared.
The properties of the modules are subject to continuous development and improvement. Modules having
earlier production statuses cannot have the same properties as modules with the latest status. Existing
properties, however, are always retained and are not changed, so that these modules can always be
replaced by new ones.
The firmware and hardware version (delivery state) can be found in the batch number (D number) printed at
the side of the IO-Link box module.
Syntax of the batch number (D number)
D: WW YY FF HH
WW - week of production (calendar week)
YY - year of production
FF - firmware version
HH - hardware version
Example with D No. 29 10 02 01:
29 - week of production 29
10 - year of production 2010
02 - firmware version 02
01 - hardware version 01
EPI3xxx, ERI3xxx7Version: 1.2
Product overview
2Product overview
2.1Module overview EPI3xxx, ERI3xxx
Analog input modules, 24V
ModuleNumber of analog
EPI3174-0002
[}8]
ERI3174-0002
[}8]
inputs
44 x M12Industrial housingfour configurable analog differential in-
44 x M12Die-cast zinc housingfour configurable analog differential in-
DC
Signal connectionHousingComment
2.2EPI3174-0002, ERI3174-0002
2.2.1Introduction
puts
puts
Fig.1: EPI3174-0002, ERI3174-0002
IO-Link box with four configurable analog differential inputs
The EP3174-0002 and ERI3174-0002 IO-Link boxes have four analog inputs which can be individually
parameterized, so that they process signals either in the -10V to +10V range or the 0/4mA…20mA range.
The voltage or input current is digitized with a resolution of 16bits, and is transmitted (electrically isolated) to
the higher-level automation device.
The four input channels have differential inputs and possess a common, internal ground potential. The input
filter and therefore the conversion times are configurable in a wide range. The inputs can, if required, be
scaled differently, and automatic limit value monitoring is also available. Parameterization is done via IOLink. The parameters are stored in the module.
The IO-Link box modules with die-cast zinc housing (ERI series) can be used in extremely challenging
industrial and process environments. The fully sealed design and the metal surface of the ERI series make it
ideal for applications requiring enhanced load capacity and protection against welding spatter, for example.
EPI3xxx, ERI3xxx8Version: 1.2
2.2.2Technical data
Technical dataEPI3174-0002ERI3174-0002
CommunicationIO-Link
Data transfer rate230.4kBaud (COM 3)
IO-Link connection1 x M12 connector, a-coded
Specification versionIO-Link V1.1, Class B
Requirements for IO-Link
master
Number of inputs4
Input connections [}22]
Connection technologytwo-wire, four-wire
Signal typeConfigurable:
Internal resistance>200kΩ (typ. 85Ω + diode voltage)
Common-mode voltage
U
CM
Resolution16bit (including sign)
Input filterConfigurable
Input filter limit frequency 5kHz
Conversion time~ 100µs
Measuring error< ±0.3% (relative to full scale value)
Number of outputs0
Current consumption of
the module circuitry
Supply of the module
electronics
Sensor supply2L+, DC, freely selectable up to 30V
Process imageInputs: 4 x 16bit, status: 4 x 16bit
Electrical isolationL+/2L+: yes
HousingIndustrial housing (polyamide PA6)Die-cast zinc housing
Weighttyp. 165gtyp. 250g
Permissible ambient
temperature during
operation
Permissible ambient
temperature during
storage
Vibration / shock
resistance
EMC immunity/emission conforms to EN 61000-6-2 / EN 61000-6-4
Protection classIP65, IP66, IP67 (conforms to EN 60529)
Installation positionvariable
ApprovalsCE, UL
V1.1
4 x M12 socket, screwable
0V…+10V
-10V…+10V
0mA…20mA
4mA…20mA
max. 35V
typically 100mA from L
L
+
+
-25°C ... +60°C
-40°C ... +85°C
conforms to EN 60068-2-6 / EN 60068-2-27
See also chapter General operating conditions [}94]
Product overview
EPI3xxx, ERI3xxx9Version: 1.2
Product overview
2.2.3Process image
Channel1 Status and Channel1 Value
The IO-Link device is connected to IO-Link port1 of the IO-Link master (EP6224-2022).
• Under Channel1 Status you will find the status information (16bits) of the first analog channel. (here
as an example the process image of the EPI3174-0002).
• Under Channel1 Value you will find the analog value (16bits) of the first analog channel.
• Channels2 to 4
The data of analog channels 2 to 4 have the same structure as those of the 1st channel.
Fig.2: EPI3174-0002 - Process image in tree and list view
Also see about this
2 EPI3xxx, ERI3xxx - Process data [}60]
EPI3xxx, ERI3xxx10Version: 1.2
IO-Link basics
3IO-Link basics
IO-Link represents a communication system for the connection of intelligent sensors and actuators to an
automation system in the IEC61131-9 standard under the designation "Single-drop digital communication
interface for small sensors and actuators" (SDCI).
The electrical connection data and the communication protocol are standardized and summarized in the IO-Link specification.
IO-Link specification
The development of the EP6224-xxxxxx was based on IO-Link specification 1.1. At the time of the
preparation of this documentation, the IO-Link specification is entering the IEC standardization and
will be adopted in extended form as IEC61131-9. The new designation SDCI will be introduced at
the same time. As a member of the respective committee, Beckhoff supports the development of
IO-Link and reflects changes to the specification in its products.
3.1IO-Link system configuration
An IO-Link system consists of an IO-Link master, one or more IO-Link devices and sensors or actuators. The
IO-Link master provides the interface to the higher-level controller and controls the communication with the
connected IO-Link devices. The EP6224-xxxx IO-Link master module from Beckhoff has four IO-Link ports,
each of which can be connected to an IO-Link-Device. IO-Link is therefore not a fieldbus, but a peer-to-peer
connection (see figure below).
EPI3xxx, ERI3xxx11Version: 1.2
IO-Link basics
Fig.3: IO-Link overview: Peer-to-peer communication
EPI3xxx, ERI3xxx12Version: 1.2
IO-Link basics
The connected IO-Link devices have individual parameter information, which is detected during automatic
scanning with TwinCAT and transferred to the System Manager (see chapter "Basic function principles",
integration of IO-Link devices). Module-specific information can be imported offline in the form of an IO-Link
Device Description (IODD) and transferred to TwinCAT.
• How to manually configure (physically non-existent) IO-Link masters and devices in TwinCAT is
described under the following two links: Offline configuration settings - TwinCAT (master) [}26], 1.
Importing the device description IODD [}53]
• How to configure physically existent IO-Link masters and devices in TwinCAT is described under the
following two links: Online configuration settings - TwinCAT (master) [}32], 2. Automatic scanning of
the IO-Link ports [}56]
3.2Establishment of IO-Link communication
Establishment of IO-Link communication
The establishment of the IO-Link communication is illustrated in Fig. Establishment of IO-Link
communication. This illustrates in particular the sequence when automatically scanning [}56] the IO-Link
port.
Fig.4: Establishment of IO-Link communication
• If an IO-Link device is connected to a master port, the master attempts to establish communication. A
defined signal level, the WakeUp pulse, signals to the slave that UART bytes are to be sent from now
on.
From this point on, all data will be interpreted by the IO-Link slave as UART bytes.
• The master runs through all baud rates [}15], starting with the fastest baud rate (COM3 = 230
kbaud). A successful connection has been established when the slave responds to the WakeUp pulse.
• First of all the master reads the basic parameters (Vendor ID, Device ID, process data length,
telegram type and cycle time) and compares them with the existing configuration.
EPI3xxx, ERI3xxx13Version: 1.2
IO-Link basics
• If no connection could be established to the slave, or if the saved parameters differ from those read,
the corresponding error is output.
• If the saved parameters differ from those read, the IO-Link device changes to the PREOP state.
If the IO-Link device specification is V1.1, the parameter server [}14] is now executed. If the IO-Link
device specification is V1.0, this step is omitted and the device changes directly to OP.
• Finally the cycle time is written and the device changes to OP. After that the master cyclically
exchanges data with the slave.
3.3Device description IODD
IO-Link devices possess individual system information in the form of an IO device description (IODD), which
contains:
• Communication features
• Device parameters with value range and default values
• Identification, process and diagnostic data
• Device data
• Text description
• Picture of the device
• Vendor's logo
If the IODD is imported, then the device data are automatically detected during automatic scanning [}56]
with TwinCAT and adopted in the System Manager (cf. integration of the IO-Link devices).
3.4Parameter server
In order to be able to use the functionality of the parameter server, both the IO-Link master and the IO-Link
device must be specified to V1.1. The IO-Link revision of the device can be read for the individual port under
Settings [}62]. The Beckhoff IO-Link master supports specification V1.1 from FW 07.
• The parameter server in the IO-Link master contains parameter data that are saved in the IO-Link
device. The memory capacity is max. 2kbyte (including header).
If the IO-Link-Device is exchanged, then the data are loaded from the parameter server into the new
device. The requirement for this is that the device is of the same type (VendorID & DeviceID must be
the same).
• If a new IO-Link-Device is configured, then the IO-Link master loads the parameters from the IO-LinkDevice into the parameter server when starting for the first time.
Data from other IO-Link devices that are already configured (VendorID & DeviceID do not correspond
to the configured device) are overwritten.
• At each further start the IO-Link master uses a checksum to check whether the data in the parameter
server correspond to those on the IO-Link-Device and if necessary downloads them to the device.
• If the parameters change during the device runtime, this can be reported via the Master's special
event. The master then starts the parameter server with an upload.
• By default the event is not set each time the parameters are written, therefore the end of the
parameterization procedure has to be reported to the IO-Link device.
The IO-Link-Device then sends the corresponding event to the master. The data are loaded into the
parameter server.
• In the case of a pre-programmed IO-Link-Device, no download takes place from the parameter server
to the device.
EPI3xxx, ERI3xxx14Version: 1.2
IO-Link basics
3.5Data transfer rate
An IO-Link master according to specification V1.1 supports all three transmission types and automatically
adjusts the data transfer rate to that of the IO-Link device.
An IO-Link device usually supports only one data transfer rate. IO-Link devices with different data transfer
rate can be connected to the various ports of the master.
• COM1 = 4.8kbaud
• COM2 = 38.4kbaud
• COM3 = 230.4kbaud
EPI3xxx, ERI3xxx15Version: 1.2
Mounting and connection
4Mounting and connection
4.1Mounting
4.1.1Dimensions
Fig.5: Dimensions of the IO-Link box modules
All dimensions are given in millimeters.
Housing features
IO-Link box modulesNarrow housingWide housing
Housing materialPA6 (polyamide) for EPIxxxx or die-cast zinc for ERIxxxx
Sealing compoundPolyurethane
Mountingtwo fastening holes Ø3mm forM3two fastening hole Ø3mm for M3
two fastening holes Ø4.5mm for M4
Metal partsBrass, nickel-plated
ContactsCuZn, gold-plated
Installation positionvariable
Protection classIP65, IP66, IP67 (conforms to EN60529) when screwed together
Dimensions (HxWxD)approx. 126 x 30 x 26.5mmapprox. 126 x 60 x 26.5mm
Weightapprox. 125g, depending on
module type
approx. 250g, depending on module type
EPI3xxx, ERI3xxx16Version: 1.2
Mounting and connection
4.1.2Fixing
Protect connectors against soiling
Protect all connections from contamination during module installation! Protection class IP65 can
only be guaranteed if all cables and connectors are connected! Unused connections must be protected with the appropriate connectors! Connector sets see catalog.
Modules with narrow housing are installed with two M3 screws.
Modules with wide housing are installed with two M3 screws in the mounting holes in the corners or two M4
screws in the central fastening holes.
The bolts must be longer than 15mm. The fastening holes in the modules have no thread.
Note when mounting that the overall height is increased further by the fieldbus connections. See the
Accessories section.
Mounting Rail ZS5300-0001
The mounting rail ZS5300-0001 (500 mm x 129 mm) allows the time saving assembly of modules.
The rail is made of stainless steel, 1.5 mm thick, with already pre-made M3 threads for the modules. The rail
has got 5.3 mm slots to mount it via M5 screws to the machine.
Fig.6: Mounting Rail ZS5300-000
The mounting rail is 500 mm long, that way 15 narrow modules can be mounted with a distance of 2 mm
between two modules. The rail can be cut to length for the application.
Mounting Rail ZS5300-0011
The mounting rail ZS5300-0011 (500 mm x 129 mm) has in addition to the M3 treads also pre-made M4
treads to fix 60 mm wide modules via their middle holes.
Up to 14 narrow or 7 wide modules may be mixed mounted.
EPI3xxx, ERI3xxx17Version: 1.2
Mounting and connection
4.1.3Tightening torque for connectors
M8 connector
We recommend fastening the M8 connector with a torque of 0.4Nm.
Fig.7: IO-Link box with M8 and M12 connectors
M12 connector
We recommend fastening the M12 connector with a torque of 0.6Nm.
Fig.8: IO-Link box with M12 connectors
Torque wrench
Fig.9: Torque wrench, ZB8801
Ensure the proper torque is used
Use the torque wrenches available from Beckhoff to tighten the plug connectors! You will find them
under the following link.
IP67 Box - Accessories [}95]
EPI3xxx, ERI3xxx18Version: 1.2
Mounting and connection
4.2IO-Link connection
4.2.1IO-Link master connection
IO-Link interface
The IO-Link specification defines various IO-Link pin assignment, which are described in the following
section.
The switching and communication line is marked with (C/Q).
Port Class A (type A): The function of pin 2 and pin 5 is not preset. The vendor can assign an additional
digital channel to pin 2. Port Class B (type B): Pin 2 and Pin 5 are used for an additional power supply. The
information regarding the pin assignment of your module can be found in the chapter "Introduction".
Fig.10: Pin assignment Port Class A, Pin 2 not connected
In the case of Class A modules an additional digital input or output (I/Q) can be connected to Pin 2.
Fig.11: Pin assignment Port Class A, Pin 2 connected
Port Class B (type B): For devices with higher current demand, an additional power supply is provided via pin
2 and pin 5.
Fig.12: Pin assignment Port Class B
The IO-Link master (EP622x-xxxx) has an A-coded M12 socket for the outgoing IO-Link connection.
EPI3xxx, ERI3xxx19Version: 1.2
Mounting and connection
Fig.13: IO-Link connection, master
Wire colors
The wire colors of the IO-Link cable with corresponding pin assignment of the IO-Link connector:
PinWire color
1brown
2white
3blue
4black
5grey
IO-Link cable
Fig.14: Example IO-Link cable: male to female
The cables available from Beckhoff for the IO-Link system can be found under the following link under
"Accessories": https://beckhoff.de/english/fieldbus_components_accessories/m12_sensor_5w.htm?
id=51657421126830456
IO-Link cable
A 3-core IO-Link cable may be sufficient for Class A masters/devices from Beckhoff. A Class B
master/device requires a 5-wire IO-Link cable.
EPI3xxx, ERI3xxx20Version: 1.2
Mounting and connection
4.2.2Connection IO-Link Device
The IO-Link box (EPIxxxx,ERIxxxx) has an A-coded M12 connector for the incoming IO-Link connection.
IO-Link connection, Device (narrow housing)
IO-Link connection, Device (wide housing)
4.2.3IO-Link status LED
IO-Link Device status LED (narrow housing)
LED display
LEDDisplayMeaning
IO-Link status LED (X1)offIO-Link communication inactive
flashes green (1Hz)IO-Link communication active
red illuminatedShort circuit on C/Q line or overheating
IO-Link Device status LED (wide housing)
4.3Status LEDs for power supply
The IO-Link module contains 2 diagnostic LEDs for the power supply and a Diagnostic object (0x0A00) for
more accurate diagnosis. The description of the diagnostic parameters (Index 0x0A00 [}90]) is described in
the section Object description and parameterization.
Fig.15: Status LEDs for power supply
LED display
LEDDisplayMeaning
24VoffVoltage L+ non-existent
greenvoltage L+ ok
redVoltage L+ too low
right LEDgreenVoltage 2L+ ok
offVoltage 2L+ too low, short-circuit
EPI3xxx, ERI3xxx21Version: 1.2
Mounting and connection
4.4Signal connection
Analog voltage inputs M12, -10V to +10V
The input voltage is measured as a differential signal. One differential input is available for each socket.
Fig.16: Pin assignment, analog voltage inputs M12
Analog current inputs M12, 0 mA to 20 mA or 4 mA to 20 mA
The input current is measured as a differential signal. One differential input is available for each socket.
Fig.17: Pin assignment, analog current inputs M12
GND connections
If several sensors are connected to a box whose GND connections are not electrically isolated,
GND must be connected to GND 2M.
Status LEDs on M12 connections 1 to 4 (inputs)
Fig.18: Status LEDs - M12 connections, analog input
EPI3xxx, ERI3xxx22Version: 1.2
Mounting and connection
Connection
M12
socket 1-4Rleft
Correct function is indicated if the green Run LED is on and the red Error LED is off.
LEDDisplayMeaning
offNo data transfer to the A/D converter
greenData transfer to A/D converter
E
right
offFunction OK
redError: Broken wire or measured value outside the measuring
range
EPI3xxx, ERI3xxx23Version: 1.2
Mounting and connection
4.5UL Requirements
The installation of UL-certified IP67 Box modules must meet the following requirements.
Supply voltage
CAUTION
CAUTION!
• from an isolated source protected by a fuse of max. 4A (according to UL248) or
• from a voltage supply complying with NEC class 2.
An NEC class 2 voltage source must not be connected in series or parallel with another NEC class 2
voltage source!
CAUTION
CAUTION!
In order to comply with UL requirements, the IP67 Box modules must not be connected to unlimited voltage
sources!
Networks
CAUTION
CAUTION!
In order to comply with UL requirements, the IP67 Box modules must not be connected to telecommunications networks!
Ambient temperature
CAUTION
CAUTION!
In order to comply with UL requirements, the IP67 Box modules must only be operated in an ambient temperature range between 0 and 55 °C!
Marking for UL
All UL (Underwriters Laboratories) certified IP67 Box modules have the following markings.
Fig.19: UL marking
EPI3xxx, ERI3xxx24Version: 1.2
Mounting and connection
4.6Cabling
A list of EtherCAT cables, power cables, sensor cables, IO-Link cables, Ethernet/EtherCAT connectors and
field-configurable connectors can be found under the following link: https://beckhoff.de/english/ethercat-
box/ethercat_box_cables.htm?id=690338951657421
IO-Link cable
The IO-Link master is connected to the IO-Link device by an unshielded 3, 4 or 5-core (type A) or 5-core
(type B) cable with a maximum length of 20m. The IO-Link cables are available as straight and angled
versions. Further information about the IO-Link connection can be found under: IO-Link master connection
[}19]
Fig.20: Example IO-Link cable: male to female
Sensor cable
Fig.21: Selection of sensor cables available from Beckhoff
EPI3xxx, ERI3xxx25Version: 1.2
Commissioning/configuration of IO-Link master/device
In this part of the documentation is the manual configuration of the IO-Link master in TwinCAT described.
Distinction between Online and Offline
The distinction between online and offline refers to the presence of the actual I/O environment (drives,
terminals, box-modules).
• Offline
If the configuration is to be prepared in advance of the system configuration as a programming system,
e.g. on a laptop, this is only possible in “Offline configuration” mode. In this case all components have
to be entered manually in the configuration, e.g. based on the electrical design (as described under 1.Importing the device description IODD [}53]).
• Online
If the designed control system is already connected to the EtherCAT system and all components are
energized and the infrastructure is ready for operation, the TwinCAT configuration can simply be
generated through “scanning” from the runtime system. This is referred to as online configuration. In
any case, during each startup the EtherCAT master/ IO-Link master checks whether the devices it finds
match the configuration. This test can be parameterized in the extended device settings.
To take advantage of the current features/settings of the master, the latest version of the ESI file should
always be downloaded. Therefore it is necessary to consider the following note first.
Installation of the latest ESI-XML device description
The TwinCAT System Manager needs the device description files for the devices to be used in order to generate the configuration in online or offline mode. The device description is contained in
the so-called ESI files (EtherCAT Slave Information) in XML format. These files can be requested
from the respective manufacturer and are made available for download. The ESI files for Beckhoff
EtherCAT devices are available on the Beckhoff website. The ESI files should be saved in the TwinCAT installation directory (default: C:\TwinCAT\IO\EtherCAT). The files are read (once) when a new
System Manager window is opened. A TwinCAT installation includes the set of Beckhoff ESI files
that was current at the time when the TwinCAT build was created. For TwinCAT 2.11 and higher,
the ESI directory can be uploaded from the System Manager, if the programming PC is connected
to the internet (TwinCAT → EtherCAT-Devices → Update Device Description…) see following figure.
EPI3xxx, ERI3xxx26Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.22: Update Device Descriptions
Appending a module manually
• The EtherCAT system must be in a safe, de-energized state before the EtherCAT modules are
connected to the EtherCAT network!
• Switch on the operating voltage, open the TwinCAT System Manager [}38] (Config mode)
• Append a new I/O device. In the dialog that appears select the device EtherCAT (Direct Mode), and
confirm with OK.
Fig.23: Appending a new I/O device (I/O Devices -> right-click -> Append Device...)
EPI3xxx, ERI3xxx27Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.24: Selecting the device EtherCAT
• Append a new box.
Fig.25: Appending a new box (Device -> right-click -> Append Box...)
• In the dialog that appears select the desired box (e.g. EP6224-2022), and confirm with OK.
EPI3xxx, ERI3xxx28Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.26: Selecting a Box (e.g. EP6224-2022)
EPI3xxx, ERI3xxx29Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.27: Appended Box in the TwinCAT tree
In this section is described, how to configure the IO-Link master in TwinCAT and the integration of IO-Link
devices.
Configuration of the IO-Link master
Configuration of the IO-Link master requires a plug-in, which is usually supplied with the TwinCAT
installation. When the IO-Link master is added to the TwinCAT System Manager (see section Offline [}26] /
Online [}32] configuration settings - TwinCAT (master)) an additional tab called IO-Link is created (see
following figure). If the tab is not displayed, the associated System Manager extension is missing. You can
install it separately. Please contact support [}96].
EPI3xxx, ERI3xxx30Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.28: "IO-Link" tab
EPI3xxx, ERI3xxx31Version: 1.2
Commissioning/configuration of IO-Link master/device
In this part of the documentation is the configuration of a physically existing IO-Link master in TwinCAT
described.
Online configuration “Scan” (TwinCAT 3.x)
Distinction between Online and Offline
The distinction between online and offline refers to the presence of the actual I/O environment (drives,
terminals, box-modules).
• Offline
If the configuration is to be prepared in advance of the system configuration as a programming system,
e.g. on a laptop, this is only possible in “Offline configuration” mode. In this case all components have
to be entered manually in the configuration, e.g. based on the electrical design (as described under 1.Importing the device description IODD [}53]).
• Online
If the designed control system is already connected to the EtherCAT system and all components are
energized and the infrastructure is ready for operation, the TwinCAT configuration can simply be
generated through “scanning” from the runtime system. This is referred to as online configuration. In
any case, during each startup the EtherCAT master/ IO-Link master checks whether the devices it finds
match the configuration. This test can be parameterized in the extended device settings.
To take advantage of the current features/settings of the master, the latest version of the ESI file should
always be downloaded. Therefore it is necessary to consider the following note first.
Installation of the latest ESI-XML device description
The TwinCAT System Manager needs the device description files for the devices to be used in order to generate the configuration in online or offline mode. The device description is contained in
the so-called ESI files (EtherCAT Slave Information) in XML format. These files can be requested
from the respective manufacturer and are made available for download. The ESI files for Beckhoff
EtherCAT devices are available on the Beckhoff website. The ESI files should be saved in the TwinCAT installation directory (default: C:\TwinCAT\IO\EtherCAT). The files are read (once) when a new
System Manager window is opened. A TwinCAT installation includes the set of Beckhoff ESI files
that was current at the time when the TwinCAT build was created. For TwinCAT 2.11 and higher,
the ESI directory can be uploaded from the System Manager, if the programming PC is connected
to the internet (TwinCAT → EtherCAT-Devices → Update Device Description…) see following figure.
EPI3xxx, ERI3xxx32Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.29: Update Device Descriptions
The following conditions must be met before a configuration can be set up:
• the real EtherCAT and IO-Link hardware (devices, couplers, drives) must be present and installed
• the master/devices must be connected via EtherCAT cables and IO-Link cables in the same way as
they are intended to be used later
• the devices/modules be connected to the power supply and ready for communication
• TwinCAT must be in CONFIG mode on the target system.
The online scan process consists of:
• detecting the EtherCAT device (Ethernet Port at the IPC)
• detecting the connected EtherCAT devices. This step can be carried out independent of the preceding
step.
• troubleshooting
The scan with existing configuration can also be carried out for comparison.
Detecting/scanning of the EtherCAT device
The online device search can be used if the TwinCAT system is in CONFIG mode (blue TwinCAT icon or
blue indication in the System Manager).
Fig.30: TwinCAT CONFIG mode display
EPI3xxx, ERI3xxx33Version: 1.2
Commissioning/configuration of IO-Link master/device
Online scanning in Config mode
The online search is not available in RUN mode (production operation).
Note the differentiation between TwinCAT programming system and TwinCAT target system. The
TwinCAT icon next to the Windows clock always shows the TwinCAT mode of the local IPC. The
System Manager window shows the TwinCAT state of the target system.
Right-clicking on “I/O Devices” in the configuration tree opens the search dialog.
Fig.31: Scan Devices
This scan mode not only tries to find EtherCAT devices (or Ethernet ports that can be used as such), but
also NOVRAM, fieldbus cards, SMB etc. Not all devices can be found automatically.
Fig.32: note for automatic device scan
Ethernet ports with installed TwinCAT real-time driver are shown as “RT Ethernet” devices. An EtherCAT
frame is sent to these ports for testing purposes. If the scan agent detects from the response that an
EtherCAT slave is connected, the port is shown immediately as an “EtherCAT Device”.
EPI3xxx, ERI3xxx34Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.33: detected Ethernet devices
After confirmation with “OK” a device scan is suggested for all selected devices, see following figure.
Detecting/Scanning the EtherCAT devices
Online scan functionality
During a scan the master queries the identity information of the EtherCAT slaves from the slave
EEPROM. The name and revision are used for determining the type. The respective devices are located in the stored ESI data and integrated in the configuration tree in the default state defined
there.
If an EtherCAT device was created in the configuration (manually or through a scan), the I/O field can be
scanned for devices/slaves.
Fig.34: scan query after automatic creation of an EtherCAT device
The configuration has been build and directly shifted into the online state (OPERATIONAL). The EtherCAT
system should then be in a functional cyclic state, as shown in the following figure.
EPI3xxx, ERI3xxx35Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.35: online display example
Please note:
• all slaves should be in OP state
• the EtherCAT master should be in “Actual State” OP
• “frames/sec” should match the cycle time taking into account the sent number of frames
• no excessive “LostFrames” or CRC errors should occur
The configuration is now complete. It can be modified as described under the offline procedure.
The connected IO-Link master (EP6224-2022) is displayed in the TwinCAT structure as you can see in the
figure below.
Fig.36: Master display after scan for boxes
Troubleshooting
Various effects may occur during scanning.
• An unknown device is detected, i.e. an EtherCAT slave for which no ESI XML description is available.
In this case the System Manager offers to read any ESI that maybe stored in the device.
EPI3xxx, ERI3xxx36Version: 1.2
Commissioning/configuration of IO-Link master/device
• Devices are not detected properly
Possible reasons include:
◦ faulty data links, resulting in data loss during the scan
◦ slave has invalid device description
The connections and devices should be checked in a targeted manner, e.g. via the emergency
scan.
Then re-run the scan.
Scan over existing configuration
If a scan is initiated for an existing configuration, the actual I/O environment may match the configuration
exactly or it may differ. This enables the configuration to be compared.
Fig.37: identical configuration
If differences are detected, they are shown in the correction dialog, so that the user can modify the
configuration as required.
Fig.38: correction dialog
It is advisable to tick the “Extended Information” check box to reveal differences in the revision.
ColourExplanation
greenThis EtherCAT slave matches the entry on the other side. Both type and revision match.
blueThis EtherCAT slave is present on the other side, but in a different revision. If the found revision is higher than the
light blueThis EtherCAT slave is ignored („Ignore“ button).
redThis EtherCAT slave is not present on the other side.
configured revision, the slave maybe used provided compatibility issues are taken into account. If the found revision
is lower than the configured revision, it is likely that the slave cannot be used. The found device may not support all
functions that the master expects based on the higher revision number.
EPI3xxx, ERI3xxx37Version: 1.2
Commissioning/configuration of IO-Link master/device
Device selection based on revision, compatibility
The ESI description also defines the process image, the communication type between master and
slave/device and the device functions, if applicable. The physical device (firmware, if available) has
to support the communication queries/settings of the master. This is backward compatible, i.e.
newer devices (higher revision) should be supported if the EtherCAT master addresses them as an
older revision. The following compatibility rule of thumb is to be assumed for Beckhoff EtherCAT
Terminals/Boxes:
device revision in the system >= device revision in the configuration
This also enables subsequent replacement of devices without changing the configuration (different
specifications are possible for drives). Example: If an EL2521-0025-1018 is specified in the configuration, an EL2521-0025-1019 or higher (-1020, -1021) can be used in practice.
If current ESI descriptions are available in the TwinCAT system, the last revision offered in the selection dialog matches the Beckhoff state of production. It is recommended to use the last device revision when creating a new configuration, if current Beckhoff devices are used in the real application. Older revisions should only be used if older devices from stock are to be used in the application.
Fig.39: correction dialog with modifications
Once all modifications have been saved or accepted, click “OK” to transfer them to the real *.tsm
configuration.
5.1.3Configuration via TwinCAT - explanation tabs
In the left-hand window of the TwinCAT System Manager, click on the IO-Link Box branch you wish to
configure.
EPI3xxx, ERI3xxx38Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.40: Branch of the IO-Link Box to be configured
In the right-hand window of the TwinCAT System Manager various tabs for configuring the IO-Link Box are
now available.
General tab
Fig.41: General tab
NameName of the IO-Link master
IdNumber of the IO-Link master
TypeIO-Link master type
CommentHere you can add a comment (e.g. regarding the system).
DisabledHere you can deactivate the IO-Link master.
Create symbolsAccess to this IO-Link master via ADS is only available if this control box is activated.
EPI3xxx, ERI3xxx39Version: 1.2
Commissioning/configuration of IO-Link master/device
EtherCAT tab
Fig.42: EtherCAT tab
TypeIO-Link master device type
Product/RevisionProduct and revision number of the IO-Link master
Auto Inc Addr.Auto increment address of the IO-Link master. The auto increment address can be
used for addressing each EtherCAT device or each IO-Link master in the
communication ring through its physical position. Auto increment addressing is used
during the start-up phase when the IO-Link master allocates addresses to the
EtherCAT devices or IO-Link masters. With auto increment addressing the first
EtherCAT device in the ring has the address 0000
address is decremented by 1 (FFFF
, FFFE
hex
hex
. For each further slave the
hex
etc.).
EtherCAT Addr.Fixed address of an EtherCAT device/IO-Link master. This address is allocated by
the EtherCAT device/IO-Link master during the start-up phase. Tick the control box
to the left of the input field in order to modify the default value.
Previous PortName and port of the EtherCAT device/IO-Link master to which this device is
connected. If it is possible to connect this device with another one without changing
the order of the EtherCAT devices/IO-Link masters in the communication ring, then
this combination field is activated and the EtherCAT device or the IO-Link master to
which this device is to be connected can be selected.
Advanced SettingsThis button opens the dialogs for advanced settings.
The link at the bottom of the tab points to the product page for this IO-Link master on the web.
Process Data tab
Indicates the configuration of the process data. The input and output data of the IO-Link master are
represented as CANopen process data objects (PDO). The user can select a PDO via PDO assignment and
modify the content of the individual PDO via this dialog, if the IO-Link master supports this function.
EPI3xxx, ERI3xxx40Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.43: Process Data tab
Sync Manager
Lists the configuration of the Sync Manager (SM).
If the IO-Link master has a mailbox, SM0 is used for the mailbox output (MbxOut) and SM1 for the mailbox
input (MbxIn).
SM2 is used for the output process data (outputs) and SM3 (inputs) for the input process data.
If an input is selected, the corresponding PDO assignment is displayed in the PDO Assignment list below.
PDO Assignment
PDO assignment of the selected Sync Manager. All PDOs defined for this Sync Manager type are listed
here:
• If the output Sync Manager (outputs) is selected in the Sync Manager list, all RxPDOs are displayed.
• If the input Sync Manager (inputs) is selected in the Sync Manager list, all TxPDOs are displayed.
The selected entries are the PDOs involved in the process data transfer. In the tree diagram of the System
Manager these PDOs are displayed as variables of the IO-Link master. The name of the variable is identical
to the Name parameter of the PDO, as displayed in the PDO list. If an entry in the PDO assignment list is
deactivated (not selected and greyed out), this indicates that the input is excluded from the PDO assignment.
In order to be able to select a greyed out PDO, the currently selected PDO has to be deselected first.
Activation of PDO assignment
• the IO-Link master has to run through the PS status transition cycle (from pre-operational to
safe-operational) once (see Online tab [}46]),
• and the System Manager has to reload the IO-Link master ( button)
EPI3xxx, ERI3xxx41Version: 1.2
Commissioning/configuration of IO-Link master/device
PDO list
List of all PDOs supported by this IO-Link master. The content of the selected PDOs is displayed in the PDO
Content list. The PDO configuration can be modified by double-clicking on an entry.
ColumnDescription
IndexPDO index.
SizeSize of the PDO in bytes.
NameName of the PDO.
If this PDO is assigned to a Sync Manager, it appears as a variable of the slave with this
parameter as the name.
FlagsFFixed content: The content of this PDO is fixed and cannot be changed by the System
Manager.
MMandatory PDO. This PDO is mandatory and must therefore be assigned to a Sync
Manager! Consequently, this PDO cannot be deleted from the PDO Assignment list
SMSync Manager to which this PDO is assigned. If this entry is empty, this PDO does not take part
in the process data traffic.
SUSync unit to which this PDO is assigned.
PDO Content
Indicates the content of the PDO. If flag F (fixed content) of the PDO is not set the content can be modified.
Download
If the device is intelligent and has a mailbox, the configuration of the PDO and the PDO assignments can be
downloaded to the device. This is an optional feature that is not supported by all IO-Link masters.
PDO Assignment
If this check box is selected, the PDO assignment that is configured in the PDO Assignment list is
downloaded to the device on startup. The required commands to be sent to the device can be viewed in the
Startup [}42] tab.
PDO Configuration
If this check box is selected, the configuration of the respective PDOs (as shown in the PDO list and the
PDO Content display) is downloaded to the IO-Link master.
Startup tab
The Startup tab is displayed if the IO-Link master has a mailbox and supports the CANopen over EtherCAT
(CoE) or Servo drive over EtherCAT protocol. This tab indicates which download requests are sent to the
mailbox during startup. It is also possible to add new mailbox requests to the list display. The download
requests are sent to the master in the same order as they are shown in the list.
Fig.44: Startup tab
EPI3xxx, ERI3xxx42Version: 1.2
Commissioning/configuration of IO-Link master/device
ColumnDescription
TransitionTransition to which the request is sent. This can either be
• the transition from pre-operational to safe-operational (PS), or
• the transition from safe-operational to operational (SO).
If the transition is enclosed in "<>" (e.g. <PS>), the mailbox request is fixed and cannot be
modified or deleted by the user.
ProtocolType of mailbox protocol
IndexIndex of the object
DataDate on which this object is to be downloaded.
CommentDescription of the request to be sent to the mailbox
Move UpThis button moves the selected request up by one position in the list.
Move DownThis button moves the selected request down by one position in the list.
NewThis button adds a new mailbox download request to be sent during startup.
DeleteThis button deletes the selected entry.
EditThis button edits an existing request.
CoE - Online tab
The additional CoE - Online tab is displayed if the IO-Link master supports the CANopen over EtherCAT
(CoE) protocol. This dialog lists the content of the object list of the slave (SDO upload) and enables the user
to modify the content of an object from this list. Details for the objects of the individual IO-Link devices can
be found in the device-specific object descriptions.
EPI3xxx, ERI3xxx43Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.45: CoE - Online tab
Object list display
ColumnDescription
IndexIndex and sub-index of the object
NameName of the object
FlagsRWThe object can be read, and data can be written to the object (read/write)
ROThe object can be read, but no data can be written to the object (read only)
PAn additional P identifies the object as a process data object.
ValueValue of the object
Update ListThe Update list button updates all objects in the displayed list
Auto UpdateIf this check box is selected, the content of the objects is updated automatically.
AdvancedThe Advanced button opens the Advanced Settings dialog. Here you can specify which
objects are displayed in the list.
EPI3xxx, ERI3xxx44Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.46: Advanced Settings
Online
- via SDO Information
Offline
- via EDS File
Diag History tab
Logged diagnosis messages from the controller protocol can be read out on the "Diag History" tab. The
diagnosis buffer operates as a ring buffer with a current maximum size of 1000 entries.
If this option button is selected, the list of the objects included in the object list of
the device is uploaded from the master via SDO information. The list below can
be used to specify which object types are to be uploaded.
If this option button is selected, the list of the objects included in the object list is
read from an EDS file provided by the user.
Fig.47: DiagHistory tab
EPI3xxx, ERI3xxx45Version: 1.2
Commissioning/configuration of IO-Link master/device
Any events that occur are categorized according to type (information, warning, error), flag (N = unconfirmed,
Q = confirmed), time stamp and message (port number & event code).
The meaning of the individual messages can be taken from the vendor documentation. The IO-Link device
can be directly allocated on the basis of the port number. The events occurring can be managed using the
various buttons.
• Update History: if the "Auto Update" field is not selected, then the current events can be displayed via
the "Update History" button
• Auto Update: if this field is selected, then the list of events occurring is automatically updated
• Only new Messages: if this field is selected, then only those messages that have not yet been
confirmed are displayed
• Ack. Messages: an event is reported via the Device Diag bit (Index 0xF101:10). Confirming the
message will reset the bit to 0.
• Export Diag History: the events that have occurred can be exported as a "txt" file and thus archived.
• Advanced: This field has no function for the IO-Link master terminals/boxes.
Online tab
Fig.48: Online tab
EPI3xxx, ERI3xxx46Version: 1.2
Commissioning/configuration of IO-Link master/device
Table1: State Machine
InitThis button attempts to set the IO-Link master to the Init state.
Pre-OpThis button attempts to set the IO-Link master to the pre-operational state.
OpThis button attempts to set the IO-Link master to the operational state.
BootstrapThis button attempts to set the IO-Link master to the Bootstrap state.
Safe-OpThis button attempts to set the IO-Link master to the safe-operational state.
Clear ErrorThis button attempts to delete the fault display. If an IO-Link master fails during change
of state it sets an error flag.
Example: An IO-Link master is in PREOP state (pre-operational). The master now
requests the SAFEOP state (safe-operational). If the master fails during change of state
it sets the error flag. The current state is now displayed as ERR PREOP. When the
Clear Error button is pressed the error flag is cleared, and the current state is displayed
as PREOP again.
Current StateIndicates the current state of the IO-Link master.
Requested StateIndicates the state requested for the IO-Link master.
EPI3xxx, ERI3xxx47Version: 1.2
Commissioning/configuration of IO-Link master/device
5.1.4Restoring the delivery state of an EtherCAT device
To restore the delivery state for backup objects of the EP6224-xxxx (IO-Link Master), the CoE object
“Restore default parameters”, “Subindex 001” can be selected in the TwinCAT System Manager (Config
mode) (see following figure).
Fig.49: Selecting the Restore default parameters PDO
Double-click on “SubIndex 001” to enter the “Set Value dialog” (see following figure). Enter the value
1684107116 in field “Dec” or the value 0x64616F6C in field “Hex” and confirm with OK.
All backup objects are reset to the delivery state.
Fig.50: Entering a restore value in the Set Value Dialog
5.2Accessing IO-Link parameters
The exchange of the acyclic data takes place via a specified index and subindex range that is device-specific
and can be read about in the corresponding vendor documentation.
EPI3xxx, ERI3xxx48Version: 1.2
Commissioning/configuration of IO-Link master/device
Parameter data exchange
An intelligent IO-Link sensor/actuator (in the previous figure marked "Sensor (IO-Link Device)") can support
parameterization by SPDU (Service Protocol Data Units). The PLC must explicitly query or, when marked as
such, send these acyclic service data.
SPDU access
TwinCAT supports access via ADS and via the EP6224-xxxxxx CoE directory.
The respective parameter is addressed via the so-called SPDU index. The following ranges are available:
The use of the implementation of these ranges is the responsibility of the sensor/actuator vendor. In the
interest of clarity, only a few possible indices with names are listed here. Please refer to the corresponding
chapter "Object description and parameterization".
IndexName
0010Vendor Name
0011Vendor Text
0012Product Name
0013Product ID
0015Serial Number
0016Hardware Revision
0017Firmware Revision
......
ADS
Communication relating to IO-Link demand data is initiated via an ADS command. An ADS address always
consists of a NetID and PortNo. TwinCAT forwards an ADS command to the EP6224 Box module via AoE
(ADS over EtherCAT). From where the command is relayed to the IO-Link master section and therefore to
the data channel.
AoE-NetID
The EP6224 is assigned a dedicated AoE-NetID for communication with the IO-Link master section. This is
assigned by the configuration tool (see the figure below).
EPI3xxx, ERI3xxx49Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.51: AoE-NetID allocation
PortNo
The individual IO-Link ports for the master are allocated via the port number. The port numbers are allocated
in ascending order from 0x1000. I.e. IO-Link Port1===PortNo 0x1000 and IO-Link Portn===PortNo
0x1000 + n-1.
The following specification applies for the EP6224 (4-port IO-Link master):
IO-Link Port1 === PortNo 0x1000
IO-Link Port2 === PortNo 0x1001
IO-Link Port3 === PortNo 0x1002
IO-Link Port4 === PortNo 0x1003
ADS Indexgroup
As for CoE, the Indexgroup of an ADS command is specified as 0xF302 for the IO link data channel.
ADS Indexoffset
The IO link addressing with index and subindex is coded in the Indexoffset. The Indexoffset has a size of 4
bytes and is subdivided as follows: 2-byte index, 1-byte reserve, 1-byte subindex.
• Example: Indexoffset 0x12340056 corresponds to index 0x1234 and subindex 56
Example with ADS monitor
Reading of the Application-Specific Name, index 0x0018 subindex 0x00 (see figure below).
EPI3xxx, ERI3xxx50Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.52: Reading of the Application-Specific Name
Example showing the principle in the code
Reading of Application-Specific Name, index 0x0018 subindex 0x00 at IO-Link Port2.
AmsAddr adsAdr;
adsAdr.netId.b[0] = 0x0A; //AoE-NetID of EP6224
adsAdr.netId.b[1] = 0x03; //AoE-NetID of EP6224
adsAdr.netId.b[2] = 0x02; //AoE-NetID of EP6224
adsAdr.netId.b[3] = 0x16; //AoE-NetID of EP6224
adsAdr.netId.b[4] = 0x02; //AoE-NetID of EP6224
adsAdr.netId.b[5] = 0x03; //AoE-NetID of EP6224
adsAdr.port = 0x1001; //IO-Link Port2
errCode = AdsSyncReadReq(&adsAdr, 0xF302, 0x00180000, 100, &pReadBuffer);
5.3IO-Link device
5.3.1Configuration of the IO-Link devices
IO-Link extension
The IO-Link extension for the EP6224-xxxxxx can be used from TwinCAT version 2.10, build 1325
and is required up to version 2.10, build 1330. If your System Manager version or TwinCAT3 does
not yet provide this support, it can be installed later if necessary. Please contact our Support.
[}96]
EPI3xxx, ERI3xxx51Version: 1.2
Commissioning/configuration of IO-Link master/device
Integrating IO-Link devices
The catalog supports the IO-Link device description (IODD). The IODDs for the EPIxxxx, ERIxxxx IO-Link
Box modules from Beckhoff can be downloaded via the following link: Download IODD. The downloaded zip
file contains the IODD device description files for the Beckhoff EPIxxxx, ERIxxxx IO-Link Box modules.
No manual copying of the XML files
Do not copy the files directly into the folder; read them in via Import Devicedescription instead! Important checks will otherwise be bypassed!
The integration of the IODD file should always be the first step, since this enables the breakdown of the
individual process data of the IO-Link devices as well as the display of the parameters.
There are several ways of integrating an IO-Link device:
1. Importing the IODD file (offline & online) via
◦ button Import Devicedescription [}53] (A) or
◦ button IODD Finder [}53] (B)
2. Automatic scanning of the IO-Link ports (online) via
◦ button Scan devices [}56] (C)
3. Manual insertion (offline & online) via
◦ menu Create Device [}59] (D)
Fig.53: Creating IO-Link devices
If the IODD is not available, the IO-Link device should be integrated online by scanning. Manual integration
of the IO-Link devices via Create Device should only be carried out if the IODD of the vendor and the IO-Link
device are not available at the time of project creation.
Configuration of the IO-Link ports as digital inputs/outputs
If the IO-Link port is to be used as a simple digital input or output, the selection "Std-I/O" -> "dig in" or "dig
out" can be made in the IO-Link Device Catalog. After restarting the EtherCAT system or reloading the
configuration in Config mode (F4), the corresponding process data are created.
EPI3xxx, ERI3xxx52Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.54: Configuration of Port 2 as digital input
Removal of the IO-Link devices
To remove a previously configured IO-Link device, right-click to open the context menu and select Delete.
After restarting the EtherCAT system or reloading the configuration in Config mode (F4), the already created
process data are removed.
5.3.1.11. Importing the device description IODD
Importing the device description simplifies the integration of the IO-Link devices. The individual process data
are broken down, enabling simple parameterization of the sensor. The IODD only needs to be imported
during the initial commissioning of a new IO-Link device. The import is port-independent. Proceed as follows
to import the IODD:
• Button "Import Devicedescription“
◦ Press the Import Devicedescription button in the IO-Link tab
◦ Select the .xml file of the desired sensor.
◦ After pressing the Open button, the imported files are stored in the following folder:
- for TwinCAT 2.x: \TwinCAT\IO\IOLink
- for TwinCAT 3.x: \TwinCAT\3.X\Config\IO\IOLink.
◦ The imported device descriptions are listed in a tree structure in the Catalog field, sorted by
vendor.
No manual copying of the XML files
Do not copy the files directly into the folder; read them in via Import Devicedescription instead! Important checks will otherwise be bypassed!
• Button "IODD Finder“
◦ Press the IODD Finder button in the IO-Link tab
◦ Searching for the desired IO-Link sensor/device by entering them in the search mask; see the
figure below (1)
◦ Selecting the desired IO-Link sensor/device. Move the mouse pointer over the figure of the desired
IO-Link sensor/device. A blue download icon appears, see the following figure (2).
EPI3xxx, ERI3xxx53Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.55: IODD Finder, selection and import of the .xml file
◦ After clicking the download symbol, the .xml file of the selected IO-Link sensor/device is imported
and stored in the following folder:
- for TwinCAT 2.x: \TwinCAT\IO\IOLink
- for TwinCAT 3.x: \TwinCAT\3.X\Config\IO\IOLink
◦ When moving the mouse pointer over the IO-Link sensor/device, a green icon now indicates (see
the following figure (3)) that the .xml file already exists.
Fig.56: IODD Finder, display of an already imported device description
◦ The imported device descriptions are listed in a tree structure in the Catalog field of the IO-Link
tab, sorted by vendor.
• Online configuration: once the IO-Link device has been connected, it is automatically detected and
created with the corresponding parameters by pressing the Scan devices button.
If several devices are stored in the IODD file, the first entry is always selected here. Grouping in the
IODD is usually carried out by the vendor if the process data are the same and there are only
mechanical differences (e.g. other material).
• Offline configuration: The Catalog field shows the IO-Link device catalog, which lists the already
imported device descriptions in a tree structure, sorted by vendor. The IO-Link device can be selected
via drag & drop or by right-clicking on the product with "Add to Port n".
EPI3xxx, ERI3xxx54Version: 1.2
Commissioning/configuration of IO-Link master/device
• Restart the EtherCAT system or reload the configuration in Config mode (F4).
• The IO-Link devices are displayed, and the process data are created. If an error is found when
integrating the IO-Link device, e.g. wrong VendorID or no device connected, then this is indicated via
the status of the port (object state Ch.n 0xF100:0n).
EPI3xxx, ERI3xxx55Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.1.22. Automatic scanning of the IO-Link ports
This part of the documentation describes the configuration of the physically available IO-Link devices in
TwinCAT.
During automatic scanning of the IO-Link ports, the steps WakeUp pulse, Baud rate setting, Reading of thecommunication parameters, plus Parameter server and Cyclic data exchange, if applicable, are performed,
see Establishing the IO-Link communication [}13]. The corresponding IO-Link device must be connected to
the IO-Link port for this.
The connected devices are automatically detected and configured and a search is performed for the
associated IODD.
Finding connected IO-Link devices
The connected IO-Link devices can be found by clicking the Scan devices button (see the following figure
(C)).
Fig.57: Scan devices (C)
The information window lists the connected device for each of the four ports. Only port 2 of the master is
assigned an IO-Link device. Confirm with the OK button.
Fig.58: Information Scan devices
To be able to work with the devices, the button Reload Devices (F4) must be clicked.
Fig.59: Button: Reload Devices
EPI3xxx, ERI3xxx56Version: 1.2
Commissioning/configuration of IO-Link master/device
The IO-Link devices are now entered in the General display. The Port 2 Details field displays information
about the connected device.
Fig.60: Device at Port 2
Further details can be shown by right-clicking Port 2 in the Settings dialog (see also chapter Settings of theIO-Link devices [}62]).
Fig.61: Device Port2 settings
After double-clicking Port 2 the Parameters tab is displayed. The parameters of the respective IO-Link device
are listed here (see also chapter EPIxxxx, ERIxxxx - Setting the IO-Link device parameters [}68]).
EPI3xxx, ERI3xxx57Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.62: Parameter IO-Link device
EPI3xxx, ERI3xxx58Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.1.33. Manual insertion via Create Device
This part of the documentation describes the manual configuration of the IO-Link devices in TwinCAT.
The manual insertion of the IO-Link device should only be carried out if the IODD from the vendor and the
IO-Link device are not available.
The configuration can then be carried out manually. By saving the project, the settings for the individual ports
are saved. The devices that were created are not stored in the Catalog (see the figure below (A)).
• To insert the IO-Link devices manually via Create Device, proceed as follows:
• If the corresponding IODD of the IO-Link device is already present, the corresponding device can be
selected in the catalog (see the diagram below (A)), sorted by the vendor
• If no IODD is available, the device can be manually added. These data are not saved in the catalog
and must be manually entered for each port.
• Right-click on the port to open the context menu (see the figure below (B)) and select Create Device.
• In the Create Device dialog an IO-Link device with the basic communication parameters can be
created. The mandatory fields here are: For Vendor ID, Device ID and process data length see the
figure below (D). The values VendorID and DeviceID can be entered both in hexadecimal notation
(input format: 0xnnnn) and as decimal numbers (nnnn).
The communication parameters to be entered can be found in the information provided by the device
vendor.
• If the IO-Link device version is 1.1, then the parameter server is activated by the selection of the field.
• Restart the EtherCAT system or reload the configuration in Config mode (F4)
Fig.63: Manual creation of an IO-Link device via the "Create Device" dialog (D)
Reading the IODD
Even when manually creating and scanning, the IODD should always be read in as well in order to
display further sensor-specific information.
If the IO-Link device is created manually, some device settings can be implemented in the settings of the IOLink devices (see Settings of the IO-Link devices) [}62]
EPI3xxx, ERI3xxx59Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.2EPI3xxx, ERI3xxx - Process data
The System Manager shows the EPI3xxx/ERI3xxx process data which are arranged in the tree structure
under the associated Port (A) (in the following example EPI3174-0002 is connected to port 1).
The EPI3174-0002/ERI3174-0002 offer 16-bit status information and the analog value (16 bit) per channel
(B) for transmission.
Fig.64: Default process data of EPI3174-0002
A detailed representation of the structure is obtained by opening the tree structure of the Channel 1 status
(see A in the following figure).
Activation of the Show Sub Variables button (C) displays the detailed view of the different bit meanings (see
B in the following illustration). The plain text display of the bit meanings is particularly helpful not only in
commissioning, but also for linking to the PLC program.
EPI3xxx, ERI3xxx60Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.65: Process data of EPI3174-0002 represented with sub variables
By right-clicking on the Status variable in the configuration tree (A), the structure can be opened for linking.
Both the collective name e.g. Channel 1 Status and the individual bit variable e.g. Overrange can be linked,
but not both at the same time.
The bit meaning i.e. offset position can then be taken from the memory assignment display (E) on the basis
of the point notation, also taking into account the variable size (D).
Example:
163.1 means here that the 1st bit (counting method 0, 1, etc.) or 2nd bit (counting method 1, 2, etc.) in the
status word indicates the Overrange. The user requires this information in the PLC if the status word is to be
divided into its bit meanings.
EPI3xxx, ERI3xxx61Version: 1.2
Commissioning/configuration of IO-Link master/device
Control/status word
Status word
The status word (SW) is located in the input process image, and is transmitted from terminal to the controller.
BitSW.15SW.14SW.13SW.12SW.11SW.10SW.9SW.8
NameTxPDO Toggle TxPDO State Sync error-----
BitSW.7SW.6SW.5SW.4SW.3SW.2SW.1SW.0
Name-ERRORLimit 2Limit 1OverrangeUnderrange
Key
BitNameDescription
SW.15TxPDO Toggle1
SW.14TxPDO State1
SW.13Sync error1
SW.6ERROR1
SW.5Limit 21
SW.41
SW.3Limit 11
SW.21
SW.1Overrange1
SW.0Underrange1
Toggles with each new analog process value
bin
TRUE in the case of an internal error
bin
TRUE (DC mode): a synchronization error occurred in the expired cycle.
bin
General error bit, is set together with overrange and underrange
bin
See Limit [}75]
bin
0: Limit function is not active
bin
1: Value < Limit value in Index 0x08n0:13
2: Value > Limit value in Index 0x08n0:13
3: Value = Limit value in Index 0x08n0:13
See Limit [}75]
bin
0: Limit function is not active
bin
1: Value < Limit value in Index 0x08n0:14
2: Value > Limit value in Index 0x08n0:14
3: Value = Limit value in Index 0x08n0:14
Analog input signal lies above the upper permissible threshold for this terminal
bin
Analog input signal lies under the lower permissible threshold for this terminal
bin
Control word
The EPI3xxx/ERI3xxx boxes have no control word
5.3.3Settings of the IO-Link devices
To find the basic settings of the devices for each port, right-click the port and select Settings. A new tab
Portx:: Settings opens.
Fig.66: Context menu - Settings
EPI3xxx, ERI3xxx62Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.67: Settings of the IO-Link devices
1. Information
This field is for information only; the IODD that was read in is displayed under Device Description. Furthermore, the VendorID, DeviceID and the IO-Link revision(V 1.0 or V 1.1) of the IO-Link devices are
displayed. If the device is an IO-Link device V1.1, then the parameter server [}14] function is supported.
The following settings can be made in the settings for the IO-Link devices (see figure above):
2. Start-up checks
This parameter can be used to specify that the Vendor ID and Device ID should be checked when the
IO-Link device starts up. This avoids errors when exchanging IO-Link devices.
3. CycleTime
Specifies the cycle time for the IO-Link master
4. Communication mode
Selection of the mode in which the IO-Link port is to be operated.
◦ Communication: Default mode for IO-Link devices
◦ StdDigIn / StdDigOut: Mode for non-IO-Link devices, automatically selected if the port is
configured as a digital input or output [}52]
5. Error Reaction
◦ If the Set Input Data to 0 field is activated
-> input data are set to 0 in case of error
-> Status display: Error
6. Button "Advanced"
EPI3xxx, ERI3xxx63Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.68: Advanced settings
7. Data Storage
Pay attention to the sensor version
◦ V1.0 -> data storage is not supported
◦ V1.1 -> data are stored in the parameter server (preset)
8. Process Data Format
Adaptation of the process data format
◦ Field only Octet String selected
-> complex data types (process data) are created as octet strings
-> Advantage: simple further processing in the PLC
5.3.4Data stream and correction calculation
Data stream
The following flow chart illustrates the data stream of the EPI31xx, ERI31xx (processing of raw data).
Fig.69: Diagram showing the data stream in the EPI31xx, ERI31xx
EPI3xxx, ERI3xxx64Version: 1.2
Commissioning/configuration of IO-Link master/device
Correction calculation
The diagrams at the bottom show the correction calculation between the raw values and the output values if
the limit ranges are exceeded.
(+/- 10V or +/- 10mA)
Fig.70: Data flow with correction calculation for +/- 10V or +/- 10mA
(0…20mA)
Fig.71: Data flow with correction calculation for 0…20mA
(4…20mA)
Fig.72: Data flow with correction calculation for 4…20mA
EPI3xxx, ERI3xxx65Version: 1.2
Commissioning/configuration of IO-Link master/device
(0…10V)
Fig.73: Data flow with correction calculation for 0…10V
EPI3xxx, ERI3xxx66Version: 1.2
Commissioning/configuration of IO-Link master/device
Calibration
Vendor calibration, index 0x08n0:0B
Vendor calibration is enabled via index 0x0800:0B, with n=0 (ch. 1), with n=1 (ch. 2), …n=3 (ch. 4).
Parameterization takes place via the indices
• 0x08nF:01 vendor calibration: Offset
• 0x80nF:02 vendor calibration: Gain
User calibration, index 0x08n0:0A
The user calibration is enabled via index 0x80n0:0A. Parameterization takes place via the indices
• 0x08n0:17 user calibration: Offset
• 0x08n0:18 user calibration: Gain
User scaling, index 0x08n0:01
User scaling is enabled via index 0x08n0:01. Parameterization takes place via the indices
• 0x08n0:11 user scaling: Offset
• 0x08n0:12 user scaling: Gain
Vendor calibration
The vendor reserves the right to carry out the basic calibration of the terminal/box modules. Therefore, the vendor calibration cannot be changed.
Calculation of process data
The terminal/box continuously logs measured values and stores the raw values of its A/D converter in ADC
raw value object 0x08nE:01. After each logging of the analog signal a correction is calculated via the vendor
calibration values. This is followed (optionally) by user scaling:
YH= (X
) * AH measured value after vendor calibration (corresponds to X
ADC-BH
if index 0x08n0:0B inactive)
ADC
YA= (YH-BA) * AA measured value after user calibration (corresponds to YH if index 0x08n0:0A inactive)
YS= YA * AS * 2
-16
+ BS measured value after user scaling (corresponds to YA if index 0x08n0:01 is inactive)
Key
NameDesignationIndex
X
ADC
B
H
Output value of the A/D converter0x8nE:01
Vendor calibration offset (only changeable if the object Producer codeword F008
0x08nF:01
is set)
A
H
Vendor calibration gain (can only be changed if the object Producer codeword
0x08nF:02
F008 is set)
Y
H
B
A
A
A
Y
S
B
S
A
S
Y
S
Measured value after vendor calibrationUser calibration offset0x08n0:17
User calibration gain0x08n0:18
Measured value after user calibrationUser scaling offset (can be activated via index 0x80n0:01)0x08n0:11
User scaling gain (can be activated via index 0x80n0:01)0x08n0:12
Process data for control, measured value after user scaling-
EPI3xxx, ERI3xxx67Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.5EPIxxxx, ERIxxxx - Setting of the IO-Link device parameters
This chapter explains how to read out and set the IO-Link device parameters.
The number and type of the objects shown on the Parameters tab vary according to the type of sensor.
The default settings as stored in the IODD can initially be seen.
To open the Parameter tab
• click the IO-Link master (EP6224-xxxx) in the TwinCAT tree structure,
• click the IO-Link tab,
• select the port to which the IO-Link device is connected,
• open the Parameters tab by double-clicking or
• by right-clicking and selecting Parameters.
Fig.74: Opening the Parameters tab
Fig.75: Parameters IO-Link device
EPI3xxx, ERI3xxx68Version: 1.2
Commissioning/configuration of IO-Link master/device
The device parameters are listed in the tab. The buttons Compare, Read, Write, Set Default, Export/Import
and Store are located at the top of the tab.
The Read, Write and Store buttons are used to read out the parameters stored in the IO-Link device, load
them and store them in the parameter server of the master.
Different user roles can be selected from the drop-down menu. The default user role is Specialist. The
parameters are displayed in different representations and scopes.
Compare button
• By pressing the Compare button, the parameter data of the configuration are compared with the
parameter sets in the sensor and in the parameter server.
Read button
• The default values from the IODD file are always preset
• The current parameter values are not read until the Read button is pressed
Write button
• The default values from the IODD file are always preset
• Enter the desired value under Value
• The values are accepted by pressing the Enter key
• Press the Write button to write data to the device (offline configuration is possible)
Set Default button
• Pressing the Set Default button sets all parameter values to the default settings.
Export / Import button
• The set parameter values can be exported as a .vbs file and restored later via Import.
• Pressing the Export / Import button (see the diagram below (1)) opens the Import / Export dialog
• Specify the path under which you want to export or import the vbs file, see Fig. (2) below and confirm
with the Open button, see Fig. (4) below.
• In addition, the export options Attach Store Command and Enable Block Parametrization can be
selected as shown in Fig. (3) below
◦ Attach Store Command: The parameters are loaded into the parameter server after the script has
written all values.
◦ Enable Block Parametrization: Block parameterization is enabled. For some sensors, writing is
only possible when block parameterization is enabled.
• Press the Export or Import button
EPI3xxx, ERI3xxx69Version: 1.2
Commissioning/configuration of IO-Link master/device
• Click Store (data storage): The Beckhoff EP6224-xxxx IO-Link master (from firmware 10) stores the
parameters (0x0018) Application-Specific Tag, (0x08n0) Settings and 0x3800 Range Settings. If the
IO-Link device is exchanged for a similar module, the device can be restored.
EPI3xxx, ERI3xxx70Version: 1.2
Commissioning/configuration of IO-Link master/device
Standard Command (Index 0x0002)
The IO-Link master writes various IO-Link-specific commands to the Standard Command during startup.
Some of these commands are available in the TwinCAT interface (see figure below). In the parameter list of
the All Objects user role, click Standard Command, then double-click Standard Command in the right-hand
field. Select the desired value from the list of different options and use the Write button (as described above).
Device Reset: Restarts the IO-Link device.
Application Reset: No function.
Restore Factory Settings: Restoring the application parameters, i.e. the Settings parameter (0x0800).
Fig.77: Parameters IO-Link device Standard Command
Application Specific Tag (Index 0x0018)
Application-specific information can be entered and stored here. Click Application-Specific Tag in the
parameter list, then double-click Application-Specific Tag in the right-hand field. Enter application-specific
information and use the Write button and the Store button, if required (as described above).
EPI3xxx, ERI3xxx71Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.78: Parameters IO-Link device: Application Specific Tag
EPI3xxx, ERI3xxx72Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.6EPI31xx, ERI31xx - Setting of the IO-Link device parameters
5.3.6.1Selection of the analog signal type, index 0x3800:0n
In delivery state, all channels of the EPI31x4, ERI31x4 are set for analog voltage measurement (-10V…
+10V).
Setting the correct signal type before connecting the sensors
Set the correct signal type before connecting the sensors!
This setting can be set individually for each channel in parameter 0x3800:0n (see the figure below). Changes
become effective immediately after writing the parameter.
Fig.79: Selection of the analog signal type
EPI3xxx, ERI3xxx73Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.6.2Presentation, index 0x08n0:02
The measured value output is set in factory to two's complement representation (signed integer). Index
0x80n0:02 offers the possibility to change the method of representation of the measured value.
Signed integer representation
The negative output value is represented in two’s complement (negated + 1). Maximum representation range
for 16bits=-32768…+32767
Input signalValue
+/- 10V0…20mA4…20mA0…10VDecimalhexadecimal
10V20mA20mA10V327670x7FFF
5V10mA12mA5V163830x3FFF
0V4mA4mA0V00x0000
-5V----163830xC001
-10V----327670x8000
Overview of further representations
• Unsigned integer representation
The output value is represented with 15-bit resolution without sign, therefore polarity detection is no
longer possible. Maximum representation range for 16bits=0…+32767
• Absolute value with MSB as sign - representation
The output value is displayed in signed amount representation: MSB=1 (highest bit) in the case of
negative values. Maximum representation range for 16bits=-32768…+32767
dec
dec
dec
Input signal
(+/- 10V)
10V327670x7FFF327670x7FFF
5V163830x3FFF163830x3FFF
0V00x000000x0000
-5V163840x4000[-16384]0xC000
-10V327670x7FFF[-32767]0xFFFF
Unsigned integer representationAbsolute value with MSB as sign - representation
dechexdechex
Presentation types
The presentation types Unsigned integer and Absolute value with MSB as sign have no function for
unipolar modules. There is no change in the presentation in the positive range.
5.3.6.3Siemens bits, index 0x08n0:05
If this bit is set, status displays are superimposed on the lowest three bits. Bit 0 is set in the event of an
Overrange or Underrange error.
EPI3xxx, ERI3xxx74Version: 1.2
Commissioning/configuration of IO-Link master/device
Limit 1 (index 0x08n0:13) and Limit 2 (index 0x08n0:14)
Indices 0x08n0:07 and 0x08n0:08 are used to activate limit value monitoring.
If the limits of the values that can be entered in indices 0x08n0:13 and 0x80n0:14 are violated, the bits in the
indices are set accordingly (see the table and the example below).
ChannelIndex for Limit 1Index for Limit 2
10x60p0:030x60p0:04
20x60p0:0C0x60p0:0D
30x60p0:150x60p0:16
40x60p0:1E0x60p0:1F
With p=0 for Port1.... p=3 for Port4
Limit output (2bit):
0: Limit function not active
1: Value < limit value
2: Value > limit value
3: Value = limit value
Limit evaluation
The limit evaluation assumes a signed representation. The conversion to the desired representation
(index 0x80n0:02) only takes place after the limit evaluation.
Example limit evaluation for EPI3174
Port1, channel 1; Limit 1 and Limit 2 enabled, Limit 1=2.8V, Limit 2=7.4V, representation: signed integer
Input in index 0x0800:13 (limit 1):
(2.8V / 10V) * 216 / 2-1 = 9,174dec
Input in index 0x0800:14 (limit 2):
(7.4V / 10V) * 216 / 2-1 = 24,247dec
Output:
Input channel 1Limit1 index 0x6000:03Limit2 index 0x6000:04
1.8V0x01
2.8V0x03
4.2V0x02
8.5V0x02
Swap Limit Index 0x80n0:0E
, (Limit1, limit value undershot)0x01
hex
, (Limit1, limit value reached)0x01
hex
, (Limit1, limit value exceeded)0x01
hex
, (Limit1, limit value exceeded)0x02
hex
, (Limit2, limit value undershot)
hex
, (Limit2, limit value undershot)
hex
, (Limit2, limit value undershot)
hex
, (Limit2, limit value exceeded)
hex
The limit function can be inverted by SwapLimitBits in index 0x80n0:0E.
Output n (2bits):
SwapLimitBits settingValue
FALSE (default setting)• 0: not active
• 1: Value < limit value
• 2: Value > limit value
• 3: Value = limit value
TRUE• 0: not active
• 1: Value > limit value
• 2: Value < limit value
• 3: Value = limit value
EPI3xxx, ERI3xxx75Version: 1.2
Commissioning/configuration of IO-Link master/device
Linking in the PLC with 2-bit values
The limit information consists of 2bits. Limitn can be linked to the PLC or a task in the System Manager:
PLC: IEC61131-PLC contains no 2-bit data type that can be linked with this process data directly. In
order to transmit the limit information, therefore, define an input byte, e.g.
Link the limit to an existing variable.
Additional task: 2-bit variables can be created in the System Manager.
Linking of 2-bit variable to additional task
5.3.6.5Filter mode (FIR and IIR), Index 0x0800:06, 0x0800:15
The EPI31xx, ERI31xx and EPI4xxx, ERI4xxx modules are equipped with a digital filter, which, depending on
the setting, can assume the characteristics of:
• a filter with finite impulse response (Finite Impulse Response Filter, FIR filter) or
• a filter with infinite impulse response (Infinite Impulse Response Filter, IIR filter).
The filter is deactivated by default. Please observe the following note regarding activation with index
0x0800:06.
Activation of the filter with index 0x0800:06 and setting of the filter characteristics
via index 0x0800:15
The filter frequencies are set centrally for all channels of the EPI3xxx, ERI31xx / EPI4xxx, ERI4xxx
modules via index 0x0800:15 (channel 1).
• FIR filter
The filter works as a notch filter and determines the conversion time of the module. It is parameterized
via index 0x0800:15. The higher the filter frequency, the faster the conversion time. A 50Hz and a
60Hz filter are available.
Notch filter means that the filter has zeros (notches) in the frequency response at the filter frequency
and multiples thereof, i.e. it attenuates the amplitude at these frequencies.
The FIR filter operates as a non-recursive filter.
EPI3xxx, ERI3xxx76Version: 1.2
Commissioning/configuration of IO-Link master/device
Fig.80: typ. attenuation curve notch.filter at 50Hz
Filter data FIR filter (1- to 4-channel modules)
FilterAttenuationLimit frequency (-3dB)Conversion time
• IIR filter
The filter with IIR characteristics is a discrete time, linear, time invariant filter that can be set to eight
levels (level 1 = weak recursive filter, up to level 8 = strong recursive filter).
The IIR can be understood to be a moving average value calculation after a low-pass filter.
Filter characteristics for IIR filters
IIR filter~3dB limit frequency at 500µs sampling time
Commissioning/configuration of IO-Link master/device
5.3.6.6Diagnosis (Index 0x0A00)
The Diagnosis parameters vary between the different devices. The meaning of Diagnosis parameters (Index
0x0A00 [}90]) can be read in the respective chapter Object description and parameterization.
The Diagnosis parameters of the EPI3174-0002 are presented in the figure below.
Commissioning/configuration of IO-Link master/device
5.3.7Object overview - EPI3174-0002, ERI3174-0002
IO-Link IODD Device Description
The display corresponds to the display of the IO-Link device parameters. It is advisable to download
the latest IO-Link IODD device description files from the Download section of the Beckhoff website
and install them according to the installation instructions.
The following tables show the object overview of EPI3174-0002, ERI3174-002.
SubindexNameFlagsDefault value
0x0000:0Direct Parameters 1RO16
0x0000:01ReservedRO0
0x0000:02Master Cycle TimeRO0
0x0000:03Min Cycle TimeRO0
0x0000:04M-Sequence CapabilityRO0
0x0000:05IO-Link Version IDRO0
0x0000:06Process Data Input LengthRO0
0x0000:07Process Data Output LengthRO0
0x0000:08Vendor ID 1RO0
0x0000:09Vendor ID 2RO0
0x0000:0ADevice ID 1RO0
0x0000:0BDevice ID 2RO0
0x0000:0CDevice ID 3RO0
0x0000:0DReservedRO0
0x0000:0EReservedRO0
0x0000:0FReservedRO0
0x0000:10System CommandRO0
SubindexNameFlagsDefault value
0x0001:0Direct Parameters 2RW16
0x0001:01Device Specific Parameter 1RW0
0x0001:02Device Specific Parameter 2RW0
0x0001:03Device Specific Parameter 3RW0
0x0001:04Device Specific Parameter 4RW0
0x0001:05Device Specific Parameter 5RW0
0x0001:06Device Specific Parameter 6RW0
0x0001:07Device Specific Parameter 7RW0
0x0001:08Device Specific Parameter 8RW0
0x0001:09Device Specific Parameter 9RW0
0x0001:0ADevice Specific Parameter 10RW0
0x0001:0BDevice Specific Parameter 11RW0
0x0001:0CDevice Specific Parameter 12RW0
0x0001:0DDevice Specific Parameter 13RW0
0x0001:0EDevice Specific Parameter 14RW0
0x0001:0FDevice Specific Parameter 15RW0
0x0001:10Device Specific Parameter 16RW0
SubindexNameFlagsDefault value
0x0002Standard CommandWO0
SubindexNameFlagsDefault value
0x000C:0Device Access LocksRW2
0x000C:01Parameter (write) Access LockRW0
0x000C:02Data Storage LockRW0
0x000C:03Local Parameterization LockRW0
0x000C:04Local User Interface LockRW0
EPI3xxx, ERI3xxx79Version: 1.2
Commissioning/configuration of IO-Link master/device
IndexNameFlagsDefault value
0x0010Vendor NameROBeckhoff Automation GmbH & Co. KG
0x0011Vendor TextROwww.beckhoff.com
0x0012Product NameROEPI3174-0002, ERI3174-0002
0x0013Product IDROEPI3174-0002, ERI3174-0002
0x0014Product TextRO4 AI Modules
0x0015Serial NumberRO00000000
0x0016Hardware versionRO00
0x0017Firmware versionRO00
0x0018Application Specific TagRW0
SubindexNameFlagsDefault value
0x0050:0IO StatusRO4
0x0050:01StateRO0x0000 (0
0x0500:02Status codeRO0x0000 (0
SubindexNameFlagsDefault value
0x0800:0AI Settings Ch 1RW18
0x0800:01Enable User ScaleRW0x00 (0
0x0800:02PresentationRWSigned
0x0800:05Siemens bitsRW0x00 (0
0x0800:06Enable filterRW0x01 (1
0x0800:07Enable Limit 1RW0x00 (0
0x0800:08Enable Limit 2RW0x00 (0
0x0800:0AEnable User CalibrationRW0x00 (0
0x0800:0BEnable Vendor CalibrationRW0x01 (1
0x0800:0ESwap Limit BitsRW0x00 (0
0x0800:11User Scale OffsetRW0x0000 (0
0x0800:12User Scale GainRW0x00010000 (65536
0x0800:13Limit 1RW0x0000 (0
0x0800:14Limit 2RW0x0000 (0
0x0800:15Filter SettingsRW50HzFIR
0x0800:17User Calibration OffsetRW0x0000 (0
0x0800:18User Calibration GainRW0x4000 (16384
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
SubindexNameFlagsDefault value
0x080E:01ADC raw valueRO0x0000 (0
)
dec
SubindexNameFlagsDefault value
0x080F:0AI Vendor Data Ch 1RO12
0x080F:01R0 OffsetRO0x0000 (0
)
dec
0x080F:02R0 GainRO0x4000 (16384
0x080F:03R1 OffsetRO0x0000 (0
)
dec
0x080F:04R1 GainRO0x4000 (16384
0x080F:05R2 OffsetRO0x0000 (0
)
dec
0x080F:06R2 GainRO0x4000 (16384
)
dec
)
dec
)
dec
EPI3xxx, ERI3xxx80Version: 1.2
Commissioning/configuration of IO-Link master/device
SubindexNameFlagsDefault value
0x0810:0AI Settings Ch 2RW18
0x0810:01Enable User ScaleRW0x00 (0
0x0810:02PresentationRWSigned
0x0810:05Siemens bitsRW0x00 (0
0x0810:07Enable Limit 1RW0x00 (0
0x0810:08Enable Limit 2RW0x00 (0
0x0810:0AEnable User CalibrationRW0x00 (0
0x0810:0BEnable Vendor CalibrationRW0x01 (1
0x0810:0ESwap Limit BitsRW0x00 (0
0x0810:11User Scale OffsetRW0x0000 (0
0x0810:12User Scale GainRW0x00010000 (65536
0x0810:13Limit 1RW0x0000 (0
0x0810:14Limit 2RW0x0000 (0
0x0810:17User Calibration OffsetRW0x0000 (0
0x0810:18User Calibration GainRW0x4000 (16384
SubindexNameFlagsDefault value
0x081E:01ADC raw valueRO0x0000 (0
SubindexNameFlagsDefault value
0x081F:0AI Vendor Data Ch. 2RO12
0x081F:01R0 OffsetRO0x0000 (0
0x081F:02R0 GainRO0x4000 (16384
0x081F:03R1 OffsetRO0x0000 (0
0x081F:04R1 GainRO0x4000 (16384
0x081F:05R2 OffsetRO0x0000 (0
0x081F:06R2 GainRO0x4000 (16384
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
SubindexNameFlagsDefault value
0x0820:0AI Settings Ch. 3RW18
0x0820:01Enable User ScaleRW0x00 (0
)
dec
0x0820:02PresentationRWSigned
0x0820:05Siemens bitsRW0x00 (0
0x0820:07Enable Limit 1RW0x00 (0
0x0820:08Enable Limit 2RW0x00 (0
0x0820:0AEnable User CalibrationRW0x00 (0
0x0820:0BEnable Vendor CalibrationRW0x01 (1
0x0820:0ESwap Limit BitsRW0x00 (0
0x0820:11User Scale OffsetRW0x0000 (0
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
0x0820:12User Scale GainRW0x00010000 (65536
0x0820:13Limit 1RW0x0000 (0
0x0820:14Limit 2RW0x0000 (0
0x0820:17User Calibration OffsetRW0x0000 (0
0x0820:18User Calibration GainRW0x4000 (16384
)
dec
)
dec
)
dec
)
dec
SubindexNameFlagsDefault value
0x082E:01ADC raw valueRO0x0000 (0
)
dec
SubindexNameFlagsDefault value
0x082F:0AI Vendor Data Ch 3RO12
0x082F:01R0 OffsetRO0x0000 (0
0x082F:02R0 GainRO0x4000 (16384
0x082F:03R1 OffsetRO0x0000 (0
0x082F:04R1 GainRO0x4000 (16384
0x082F:05R2 OffsetRO0x0000 (0
0x082F:06R2 GainRO0x4000 (16384
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
EPI3xxx, ERI3xxx81Version: 1.2
Commissioning/configuration of IO-Link master/device
SubindexNameFlagsDefault value
0x0830:0AI Settings Ch 4RW18
0x0830:01Enable User ScaleRW0x00 (0
0x0830:02PresentationRWSigned
0x0830:05Siemens bitsRW0x00 (0
0x0830:07Enable Limit 1RW0x00 (0
0x0830:08Enable Limit 2RW0x00 (0
0x0830:0AEnable User CalibrationRW0x00 (0
0x0830:0BEnable Vendor CalibrationRW0x01 (1
0x0830:0ESwap Limit BitsRW0x00 (0
0x0830:11User Scale OffsetRW0x0000 (0
0x0830:12User Scale GainRW0x00010000 (65536
0x0830:13Limit 1RW0x0000 (0
0x0830:14Limit 2RW0x0000 (0
0x0830:17User Calibration OffsetRW0x0000 (0
0x0830:18User Calibration GainRW0x4000 (16384
SubindexNameFlagsDefault value
0x083E:01ADC raw valueRO0x0000 (0
SubindexNameFlagsDefault value
0x083F:0AI Vendor Data Ch 4RO12
0x083F:01R0 OffsetRO0x0000 (0
0x083F:02R0 GainRO0x4000 (16384
0x083F:03R1 OffsetRO0x0000 (0
0x083F:04R1 GainRO0x4000 (16384
0x083F:05R2 OffsetRO0x0000 (0
0x083F:06R2 GainRO0x4000 (16384
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
dec
)
dec
)
dec
dec
)
dec
dec
)
dec
dec
)
dec
)
)
)
)
SubindexNameFlagsDefault value
0x0A00:0DiagnosticsRO2
0x0A00:01OvertemperatureRO0
0x0A00:02Short detectedRO0
0x0A00:03L+ lowRO0
0x0A00:042L+ lowRO0
0x0A00:052L+ statRO0
0x0A00:06ReservedRO0
0x0A00:07ReservedRO0
0x0A00:08ReservedRO0
0x0A00:09ReservedRO0
0x0A00:0AReservedRO0
0x0A00:0BReservedRO0
0x0A00:0CReservedRO0
0x0A00:0DReservedRO0
0x0A00:0EReservedRO0
0x0A00:0EReservedRO0
0x0A00:10ReservedRO0
SubindexNameFlagsDefault value
0x3800:0AI Range SettingsRW10
0x3800:01Input type Ch10
0x3800:02Input type Ch2RW0x0000 (0
0x3800:03Input type Ch3RW0x0000 (0
0x3800:04Input type Ch4RW0x0000 (0
: -10V…+10V
dec
1
: 0mA…20mA
dec
2
: 4mA…20mA
dec
6
: 0V…+10V
dec
RW0x0000 (0
dec
dec
dec
dec
)
)
)
)
Key
Flags:
EPI3xxx, ERI3xxx82Version: 1.2
• RO (Read Only): this object can only be read.
• RW (Read/Write): this object can be read or written.
Commissioning/configuration of IO-Link master/device
EPI3xxx, ERI3xxx83Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.8EPI3174-0002, ERI3174-0002 - Object description and
parameterization
IO-Link IODD Device Description
The display corresponds to the display of the IO-Link device parameters. It is advisable to download
the latest IO-Link IODD device description files from the Download section of the Beckhoff website
and install them according to the installation instructions.
Parameter server (data storage)
The IO-Link boxes support the data storage functionality according to protocol revision 1.1. The parameters
0x0018 (application-specific tag) and 0x08n0 (settings) are secured with the IO-Link master. In order to use
this functionality, the IO-Link master must also support it. (e.g. with the Beckhoff EP6224-xxxx IO-Link
master from firmware 10) Changes to these parameters are saved by the IO-Link master and restored when
the box is replace with an identical IO-Link box. How to use the data storage functionality is explained in
chapter EPIxxxx, ERIxxxx - Setting of the IO-Link device parameters [}68].
0A00:01OvertemperatureOverheating of the IO-Link moduleBOOLEANRW0x00 (0
0A00:02Short detectedShort circuit on the IO-Link C/Q data lineBOOLEAN RW0x00 (0
0A00:03L+ lowPower supply voltage too low (<18V)BOOLEAN RW0x00 (0
0A00:042L+ lowAdditional power supply too low (<18V)BOOLEANRW0x00 (0
0A00:052L+ statAdditional power supply not available (<8V) BOOLEAN RW0x00 (0
0A00:06 0A00:10
NameMeaningData typeFlagsDefault
Reserved-BOOLEANRW0x00 (0
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
dec
)
)
)
dec
)
)
dec
)
)
dec
EPI3xxx, ERI3xxx90Version: 1.2
Commissioning/configuration of IO-Link master/device
Index 3800 Al range settings
Index
(hex)
3800:0Al Range SettingsMaximum subindexRW0x0A (10
3800:01Input type Ch1Input signal range for channel 1
3800:02Input type Ch2Input signal range for channel 2 (values see
3800:03Input type Ch3Input signal range for channel 3 (values see
3800:04Input type Ch4Input signal range for channel 4 (values see
NameMeaningData typeFlagsDefault
UINT16RW0x0000 (0
0: -10V...+10V
1: 0mA…20mA
2: 4mA…20mA
3: 0V…10V
UINT16RW0x0000 (0
channel1)
UINT16RW0x0000 (0
channel1)
UINT16RW0x0000 (0
channel1)
)
dec
)
dec
)
dec
)
dec
)
dec
EPI3xxx, ERI3xxx91Version: 1.2
Commissioning/configuration of IO-Link master/device
5.3.9Firmware update of the IO-Link device
Firmware update only possible with EtherCAT IO-Link master products
The firmware update of the IO-Link device is only possible with the EP6224-xxxx, EP6228-xxxx and
EL6224. A firmware update is not possible with the KL6224.
An update of the box firmware is currently supported via the EP622x-xxxx IO-Link master box and the
TwinCAT System Manager from version 2.11 R3 build 2248 or TwinCAT 3.1 build 4018.
The firmware update is performed directly via the IO-Link interface. To this end the box must be connected
to the EP622x-xxxx and in Operational state. The update is started in the Advanced dialog of the
corresponding IO-Link port (see the two figures below).
1. Select the EP622x-xxxx Box in the System Manager,
2. in the IO-Link tab, right click on the appropriate port
3. open the Settings tab,
4. select the Advanced button
5. Select IO-Link firmware files via the Download button (use the file extension *.efw).
The Firmware Update dialog is only displayed for supported Beckhoff IO-Link devices. Once the *.efw
file has been checked, the firmware update starts automatically. This process must not be interrupted!
After a successful update, the box is automatically restarted and therefore usually does not have to be
de-energized. Device-specific settings (Appl. -Specific Tag, Settings) will not be lost.
Commissioning/configuration of IO-Link master/device
The firmware version that is currently used can be obtained as follows (see the figure below):
1. Select the EP622x-xxxx Box in the System Manager,
2. In the IO-Link tab, right click on the appropriate port
3. open the Parameter tab,
4. select Index 0x017 (firmware version)
5. click the Read button
6. The firmware version is read out and displayed when IO-Link communication to the box is active.
Fig.83: IO-Link parameters - firmware version
EPI3xxx, ERI3xxx93Version: 1.2
Appendix
6Appendix
6.1General operating conditions
Protection degrees (IP-Code)
The standard IEC 60529 (DIN EN 60529) defines the degrees of protection in different classes.
1. Number: dust protection and
touch guard
0Non-protected
1Protected against access to hazardous parts with the back of a hand. Protected against solid
2Protected against access to hazardous parts with a finger. Protected against solid foreign ob-
3Protected against access to hazardous parts with a tool. Protected against solid foreign objects
4Protected against access to hazardous parts with a wire. Protected against solid foreign objects
5Protected against access to hazardous parts with a wire. Dust-protected. Intrusion of dust is not
6Protected against access to hazardous parts with a wire. Dust-tight. No intrusion of dust.
Definition
foreign objects of Ø50mm
jects of Ø12.5mm.
Ø2.5mm.
Ø1mm.
totally prevented, but dust shall not penetrate in a quantity to interfere with satisfactory operation
of the device or to impair safety.
2. Number: water* protectionDefinition
0Non-protected
1Protected against water drops
2Protected against water drops when enclosure tilted up to 15°.
3Protected against spraying water. Water sprayed at an angle up to 60° on either side of the ver-
4Protected against splashing water. Water splashed against the disclosure from any direction
5Protected against water jets
6Protected against powerful water jets
7Protected against the effects of temporary immersion in water. Intrusion of water in quantities
tical shall have no harmful effects.
shall have no harmful effects
causing harmful effects shall not be possible when the enclosure is temporarily immersed in water for 30min. in 1m depth.
*) These protection classes define only protection against water!
Chemical Resistance
The Resistance relates to the Housing of the Fieldbus/EtherCAT Box and the used metal parts. In the table
below you will find some typical resistance.
CharacterResistance
Steamat temperatures >100°C: not resistant
Sodium base liquor
(ph-Value > 12)
Acetic acidnot resistant
Argon (technical clean)resistant
at room temperature: resistant
> 40°C: not resistant
Key
• resistant: Lifetime several months
• non inherently resistant: Lifetime several weeks
• not resistant: Lifetime several hours resp. early decomposition
EPI3xxx, ERI3xxx94Version: 1.2
Appendix
6.2IP67 Box - Accessories
Fixing
Ordering informationDescription
ZS5300-0001Mounting rail (500mmx129mm)
Marking material, plugs
Ordering informationDescription
ZS5000-0000Fieldbus Box set M8 (contact labels, plugs)
ZS5000-0002Fieldbus Box set M12 (contact labels, plugs)
ZS5000-0010plugs M8, IP67 (50 pieces)
ZS5000-0020plugs M12, IP67 (50 pieces)
ZS5100-0000marking labels, not printed, 4 stripes at 10 pieces
ZS5100-xxxxprinted marking labels, on request
Tools
Ordering informationDescription
ZB8800torque socket wrench with ratchet wrench for M8 connectors (over molded)
ZB8800-0001ratchet wrench for M8 connectors (field assembly)
ZB8800-0002ratchet wrench for M12 connectors (over molded)
ZB8801torque wrench adjustable for M8 and M12 connectors
ZB8801-0001ratched wrench for M8 connectors (over molded)
ZB8801-0002ratched wrench for M8 connectors (field assembly) and M12 connectors (over
molded)
ZB8801-0003ratched wrench for M12 connectors (field assembly)
Further accessories
Further accessories may be found at the price list for Beckhoff fieldbus components and at the internet under http://www.beckhoff.de/english/fieldbus_box/data_sheets.htm?id=69033899254355.
EPI3xxx, ERI3xxx95Version: 1.2
Appendix
6.3Support and Service
Beckhoff and their partners around the world offer comprehensive support and service, making available fast
and competent assistance with all questions related to Beckhoff products and system solutions.
Beckhoff's branch offices and representatives
Please contact your Beckhoff branch office or representative for local support and service on Beckhoff
products!
The addresses of Beckhoff's branch offices and representatives round the world can be found on her internet
pages:
http://www.beckhoff.com
You will also find further documentation for Beckhoff components there.
Support offers you comprehensive technical assistance, helping you not only with the application of
individual Beckhoff products, but also with other, wide-ranging services:
• support
• design, programming and commissioning of complex automation systems
• and extensive training program for Beckhoff system components