Beckhoff TF6120 User manual

Manual | EN
TF6120
TwinCAT 3 | OPC DA
2022-02-28 | Version: 1.1

Table of contents
TF6120 3Version: 1.1
Table of contents
1 Foreword ....................................................................................................................................................5
1.1 Notes on the documentation..............................................................................................................5
1.2 Safety instructions .............................................................................................................................6
1.3 Notes on information security ............................................................................................................7
2 Product description...................................................................................................................................8
3 Installation..................................................................................................................................................9
3.1 System requirements.........................................................................................................................9
3.2 Installation .........................................................................................................................................9
3.3 Licensing .........................................................................................................................................12
3.4 Setup OPC XML-DA on Windows XP .............................................................................................17
3.5 Setup OPC XML-DA on Windows 7 ................................................................................................21
4 Configuration ...........................................................................................................................................27
4.1 OPC DA Server ...............................................................................................................................27
4.1.1 OPC DA Server ............................................................................................................... 27
4.1.2 General ............................................................................................................................ 27
4.1.3 Data Access..................................................................................................................... 33
4.1.4 Conversion....................................................................................................................... 41
4.1.5 Simulation ........................................................................................................................ 44
4.1.6 Item Properties ................................................................................................................ 47
4.1.7 Data exchange via network ............................................................................................. 48
4.2 OPC XML-DA Server.......................................................................................................................51
4.2.1 OPC XML DA................................................................................................................... 51
4.2.2 Status information............................................................................................................ 52
5 Appendix ..................................................................................................................................................53
5.1 OPC Compliance Certificate............................................................................................................53
5.2 DCOM..............................................................................................................................................54
5.2.1 Overview.......................................................................................................................... 54
5.2.2 Prerequisites.................................................................................................................... 56
5.2.3 Client................................................................................................................................ 59
5.2.4 Server .............................................................................................................................. 65
5.2.5 DCOM Permissions ......................................................................................................... 70

Table of contents
TF61204 Version: 1.1

Foreword
TF6120 5Version: 1.1
1 Foreword
1.1 Notes on the documentation
This description is only intended for the use of trained specialists in control and automation engineering who
are familiar with applicable national standards.
It is essential that the documentation and the following notes and explanations are followed when installing
and commissioning the 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®, TwinCAT/BSD®, TC/BSD®, EtherCAT®, EtherCAT G®, EtherCAT G10®, EtherCAT P®,
Safety over EtherCAT®, TwinSAFE®, XFC®, XTS® and XPlanar® 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, EP1456722, EP2137893, DE102015105702
with corresponding applications or registrations in various other countries.
EtherCAT® is a registered trademark and patented technology, licensed by Beckhoff Automation GmbH,
Germany
Copyright
© Beckhoff Automation GmbH & Co. KG, Germany.
The reproduction, distribution and utilization of this document as well as the communication of its contents to
others without express authorization are prohibited.
Offenders will be held liable for the payment of damages. All rights reserved in the event of the grant of a
patent, utility model or design.

Foreword
TF61206 Version: 1.1
1.2 Safety instructions
Safety regulations
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 symbols
In this documentation the following symbols are used with an accompanying safety instruction or note. The
safety instructions must be read carefully and followed without fail!
DANGER
Serious risk of injury!
Failure to follow the safety instructions associated with this symbol directly endangers the life and health of
persons.
WARNING
Risk of injury!
Failure to follow the safety instructions associated with this symbol endangers the life and health of per-
sons.
CAUTION
Personal injuries!
Failure to follow the safety instructions associated with this symbol can lead to injuries to persons.
NOTE
Damage to the environment or devices
Failure to follow the instructions associated with this symbol can lead to damage to the environment or
equipment.
Tip or pointer
This symbol indicates information that contributes to better understanding.

Foreword
TF6120 7Version: 1.1
1.3 Notes on information security
The products of Beckhoff Automation GmbH & Co. KG (Beckhoff), insofar as they can be accessed online,
are equipped with security functions that support the secure operation of plants, systems, machines and
networks. Despite the security functions, the creation, implementation and constant updating of a holistic
security concept for the operation are necessary to protect the respective plant, system, machine and
networks against cyber threats. The products sold by Beckhoff are only part of the overall security concept.
The customer is responsible for preventing unauthorized access by third parties to its equipment, systems,
machines and networks. The latter should be connected to the corporate network or the Internet only if
appropriate protective measures have been set up.
In addition, the recommendations from Beckhoff regarding appropriate protective measures should be
observed. Further information regarding information security and industrial security can be found in our
https://www.beckhoff.com/secguide.
Beckhoff products and solutions undergo continuous further development. This also applies to security
functions. In light of this continuous further development, Beckhoff expressly recommends that the products
are kept up to date at all times and that updates are installed for the products once they have been made
available. Using outdated or unsupported product versions can increase the risk of cyber threats.
To stay informed about information security for Beckhoff products, subscribe to the RSS feed at https://
www.beckhoff.com/secinfo.

Product description
TF61208 Version: 1.1
2 Product description
The described product is replaced by the product TF6100 TC3 OPC UA.
OPC stands for "Openess Productivity and Collaboration" and describes an initiative for standardisation of
data exchange in automation. Beckhoff is an active member of the OPC Foundation. (More information
about OPC may be obtained under www.opcfoundation.org ) The OPC standard specifies the
communication of industrial process data between sensors, instruments, controllers and software systems.
An OPC-Server is a software component, which offers an OPC interface to other applications. The TwinCAT
3 Function TF6120 OPC-DA contains such an OPC-Server and provides the following features:
• OPC Specification 1.0a and 2.0
• Free choice of TwinCAT devices (ADS devices): PLC / IO / NC / CAM / ...
• Access via TwinCAT PLC / TwinCAT I/O or bus controller to all the fieldbusses supported by TwinCAT
(Lightbus / Profibus DP / Interbus-S / CANopen / DeviceNet / ...)
• Access to TwinCAT variables by address / by name / by generic ADS IndexGroup and IndexOffset
• Optimal access to data from the OPC server on TwinCAT variables
• Simulation mode (sinus, ramp, random) for variables
(i.e. testing an OPC client/server communication without access to physical I/O)
• Easy, one-time only configuration by XML
• OPC XML DA Server
Integration into the TwinCAT system
The OPC server creates the connection to the TwinCAT system as a gateway via ADS, and offers OPC
clients the specified OPC-DA / AE interface.
What is included
The installation version includes
• TwinCAT OPC server (DataAccess and Alarm & Events)
• TwinCAT OPC XML DA Server
• OPC Test client (for local access to the OPC server)

Installation
TF6120 9Version: 1.1
3 Installation
3.1 System requirements
The following chapter lists the system requirements.
The TS6120 supplement or the TF6120 function is no longer being further developed and is there-
fore not released for newer operating systems. The so-called UA Gateway in the product TS6100/
TF6100 OPC UA is available to you as a free OPC DA interface:
https://infosys.beckhoff.com/content/1033/tf6100_tc3_opcua/9007200762490123.html
OPC DA Server
• Operating systems:
• Windows XP Pro SP3
• Windows Server 2008 R2
• Windows Server 2012
• TwinCAT:
• TwinCAT 3 XAE Build 3100 (or higher)
• TwinCAT 3 XAR Build 3100 (or higher)
OPC XML DA Server
• Operating systems:
• Windows XP Pro SP3
• TwinCAT:
• TwinCAT 3 XAE Build 3100 (or higher)
• TwinCAT 3 XAR Build 3100 (or higher)
• Other:
• Internet Information Services 5.1, 6.0, 7.0 and 7.5
3.2 Installation
The following section describes how to install the TwinCAT3Function for Windows-based operating
systems.
üThe TwinCAT3Function setup file was downloaded from the Beckhoff website.
1. Run the setup file as administrator. To do this, select the command Run as administrator in the context
menu of the file.
ðThe installation dialog opens.

Installation
TF612010 Version: 1.1
2. Accept the end user licensing agreement and click Next.
3. Enter your user data.

Installation
TF6120 11Version: 1.1
4. If you want to install the full version of the TwinCAT3Function, select Complete as installation type. If
you want to install the TwinCAT3Function components separately, select Custom.
5. Select Next, then Install to start the installation.
ðA dialog box informs you that the TwinCAT system must be stopped to proceed with the installation.

Installation
TF612012 Version: 1.1
6. Confirm the dialog with Yes.
7. Select Finish to exit the setup.
ðThe TwinCAT3Function has been successfully installed and can be licensed (see Licensing [}12]).
3.3 Licensing
The TwinCAT3Function can be activated as a full version or as a 7-day test version. Both license types can
be activated via the TwinCAT 3 development environment (XAE).
The licensing of a TwinCAT3Function is described below. The description is divided into the following
sections:
•Licensing a 7-day test version [}12]
•Licensing a full version [}14]
Further information on TwinCAT 3 licensing can be found in the “Licensing” documentation in the Beckhoff
Information System (TwinCAT3>Licensing).
Licensing a 7-day test version
1. Start the TwinCAT 3 development environment (XAE).
2. Open an existing TwinCAT 3 project or create a new project.

Installation
TF6120 13Version: 1.1
3. If you want to activate the license for a remote device, set the desired target system. To do this, select
the target system from the Choose Target System drop-down list in the toolbar.
ðThe licensing settings always refer to the selected target system. When the project is activated on
the target system, the corresponding TwinCAT 3 licenses are automatically copied to this system.
4. In the Solution Explorer, double-click License in the SYSTEM subtree.
ðThe TwinCAT 3 license manager opens.
5. Open the Manage Licenses tab. In the AddLicense column, check the check box for the license you
want to add to your project (e.g.“TF6420: TC3 Database Server“).
6. Open the Order Information (Runtime) tab.
ðIn the tabular overview of licenses, the previously selected license is displayed with the status
“missing”.

Installation
TF612014 Version: 1.1
7. Click7-DayTrialLicense... to activate the 7-day trial license.
ðA dialog box opens, prompting you to enter the security code displayed in the dialog.
8. Enter the code exactly as it appears, confirm it and acknowledge the subsequent dialog indicating
successful activation.
ðIn the tabular overview of licenses, the license status now indicates the expiration date of the license.
9. Restart the TwinCAT system.
ðThe 7-day trial version is enabled.
Licensing a full version
1. Start the TwinCAT 3 development environment (XAE).
2. Open an existing TwinCAT 3 project or create a new project.
3. If you want to activate the license for a remote device, set the desired target system. To do this, select
the target system from the Choose Target System drop-down list in the toolbar.
ðThe licensing settings always refer to the selected target system. When the project is activated on
the target system, the corresponding TwinCAT 3 licenses are automatically copied to this system.
4. In the Solution Explorer, double-click License in the SYSTEM subtree.
ðThe TwinCAT 3 license manager opens.

Installation
TF6120 15Version: 1.1
5. Open the Manage Licenses tab. In the AddLicense column, check the check box for the license you
want to add to your project (e.g.“TE1300:TC3ScopeViewProfessional”).
6. Open the Order Information tab.
ðIn the tabular overview of licenses, the previously selected license is displayed with the status
“missing”.
A TwinCAT 3 license is generally linked to two indices describing the platform to be licensed:
System ID: Uniquely identifies the device
Platform level: Defines the performance of the device
The corresponding System Id and Platform fields cannot be changed.

Installation
TF612016 Version: 1.1
7. Enter the order number (License Id) for the license to be activated and optionally a separate order
number (Customer Id), plus an optional comment for your own purposes (Comment). If you do not
know your Beckhoff order number, please contact your Beckhoff sales contact.
8. Click the GenerateFile... button to create a License Request File for the listed missing license.
ðA window opens, in which you can specify where the License Request File is to be stored. (We
recommend accepting the default settings.)
9. Select a location and click Save.
ðA prompt appears asking whether you want to send the License Request File to the Beckhoff license
server for verification:
• Click Yes to send the License Request File. A prerequisite is that an email program is installed on your
computer and that your computer is connected to the internet. When you click Yes, the system
automatically generates a draft email containing the License Request File with all the necessary
information.
• Click No if your computer does not have an email program installed on it or is not connected to the
internet. Copy the License Request File onto a data storage device (e.g.a USB stick) and send the file
from a computer with internet access and an email program to the Beckhoff license server
([email protected]) by email.
10. Send the License Request File.
ðThe License Request File is sent to the Beckhoff license server. After receiving the email, the server
compares your license request with the specified order number and returns a License Response File
by email. The Beckhoff license server returns the License Response File to the same email address
from which the License Request File was sent. The License Response File differs from the License
Request File only by a signature that documents the validity of the license file content. You can view
the contents of the License Response File with an editor suitable for XML files (e.g.“XML Notepad”).
The contents of the License Response File must not be changed, otherwise the license file becomes
invalid.
11. Save the License Response File.

Installation
TF6120 17Version: 1.1
12. To import the license file and activate the license, click License Response File... in the Order
Information tab.
13. Select the License Response File in your file directory and confirm the dialog.
ðThe License Response File is imported and the license it contains is activated.
Existing demo licenses will be removed.
14. Restart the TwinCAT system.
ðThe license becomes active when TwinCAT is restarted. The product can be used as a full version.
During the TwinCAT restart the license file is automatically copied to the directory ...
\TwinCAT\3.1\Target\License on the respective target system.
3.4 Setup OPC XML-DA on Windows XP
All necessary files for OPC XML-DA will be automatically installed by the setup routine. This chapter
describes the required IIS (Internet Information Services) configuration for OPC XML DA on Windows XP
Please note: The configuration may be different in other Windows Operating Systems, for example
Windows 7 [}21].
Step 1: Create "Virtual Directory" in IIS (Internet Information Service)
• Open "Internet Information Services" (under "Control Panel/Administrative Tools/").
• Right click on "Default Web Site"
• Select "New" and "Virtual Directory..."

Installation
TF612018 Version: 1.1
• Everybody is welcome, so just click next.
• Please enter the alias "TcOpcXmlDa" and click "Next"

Installation
TF6120 19Version: 1.1
• With "Browse..." you have to specify the folder which contains the TwinCAT OPC Xml DA Server. By
default the folder should be like "C:\TwinCAT\OPC\Server XMLDA". Select "Next" to proceed.
• Check options "Read", "Run scripts" and "Execute" and click "Next".

Installation
TF612020 Version: 1.1
• Select "Finish" to finish the configuration of TwinCAT OPC XML DA Server.
Step 2 : Testing the configuration
The URL of the OPC-XML-DA server on the PC system can be checked locally or from a remote PC: In both
cases open the Internet explorer and enter the URL of the OPC Server XML DA on PC system like :
http://<ip-adress or name of PC device>/tcopcxmlda/tcopcxmlda.dll
Sample :
http://192.16.17.5/tcopcxmlda/tcopcxmlda.dll