===== Beckhoff/Twincat PLC Integration Guide =====

TransSECS supports direct integration of many PLCs including the Beckhoff Twincat Windows-based PLCs.

Support is via an "AddOn" module// Beckhoff_TransSECS.zip//.  Please contact ErgoTech for the module if required.

When you receive the module zip, save the file, but do not unzip it, but go to Help->Install Modules in TransSECS

{{:pasted:20210929-131437.png}}

then browse to the file.  TransSECS will install the module. After installing the module you will need to make a modification to the file "//TransSECSDevices.conf//" to add the folder that contains the //adstojava.dll//.  Open the file in a text editor, we recommend the very useful NotePad++ Editor which is a [[https://notepad-plus-plus.org/downloads/|free download]] 

Find the lines:  

<code>
# Java Library Path (location of Wrapper.DLL or libwrapper.so)
wrapper.java.library.path.1=../../MIStudio/lib
wrapper.java.library.path.2=./
</code>
and add the line pointing to the dll folder (the folder not the file).  You should now have lines like this:
<code>
# Java Library Path (location of Wrapper.DLL or libwrapper.so)
wrapper.java.library.path.1=../../MIStudio/lib
wrapper.java.library.path.2=./
wrapper.java.library.path.3=C:/TwinCAT/AdsApi/AdsToJava/x64
</code>

You then need to restart the TransSECS application.

You need to be running the "TransSECSDevices" executable, not the main "TransSECS" application.

{{:pasted:20210929-140552.png}}

**Adding Beckhoff servers**

Once the module is installed, you will be able to add a Beckhoff client.  Add the "Devices" node, if it does not already exist by right-clicking on the root of the tree and selecting "Add Devices"

{{:pasted:20210929-131800.png}}

The right-click on devices and add the Beckhoff PLC server

{{:pasted:20230911-163947.png}}

Configure the server as required and link the server to the GEM IDs as required.  Repeat the process for other data points.