Plugin installation and configuration

The plugin is delivered in a .zip folder. Unzip it and you will find the following elements.

PluginBeckhoffEthercatAsycube.library
dbGateway.xml

../../../_images/content_of_the_library_cc_link.png — Abb. 166 Content of the library

Installation of the library

Open the Library Repository and install the PluginBeckhoffEthercatAsycube library (PLC Menu-> Library Repository -> Install…).

Once you have installed the library, add it to your references (Right click on References -> Add Library). You can now use all the function blocks in your program.

Before you start using it, you must also add a Global Variable List (GVL). Right click on the GVL folder and choose Import PLCopenXML. Select the file dbGateway.xml. Activate the configuration on your target system to display the inputs and outputs in the instances of your PLC project:

../../../_images/list_of_input_output_registers.png — Abb. 167 Lists of input and output registers

If you have several Gateways and Asycube, import one GVL for every Asycube.

Add the Gateway in the configuration

Restart in configuration mode.
Select I/O,right click on Devices and select Scan.

Abb. 168 Scan for devices

Validate the HINT.

Abb. 169 Validate the Hint

Select the new I/O Device found.

Abb. 170 Select the new I/O Device found

Validate the Scan for boxes.

Abb. 171 Validate the Scan for boxes

Activate Free Run.

Abb. 172 Activate Free Run

Confirm the creation of the Gateway (NT 100-RE/ECS) and its corresponding TxPDO and RxPDO in the I/O.

Abb. 173 Confirm the creation of the Gateway

Link I/O

Activate the configuration.
Select all dbGateway input variables in the instances of your PLC project except the last one (HR_ETHERCAT_COMMUNICATION_STATUS).
Right click on the list and choose Change Multi Link…

Abb. 174 Change Multi Link

In the new window, check All Types.

Abb. 175 Check All Types

Select the 42 input bytes of the Gateway and press OK. This will link the input variables in the dbGateway GVL to the inputs of the Gateway.

Abb. 176 Select and link

To create the link to the last register, right click on this register (HR_ETHERCAT_COMMUNICATION_STATUS), click on Change link… and select the state of the Gateway.

Abb. 177 Link state

Do the same operation with the 66 output bytes of the Gateway. This will link the output variables in the dbGateway GVL to the outputs of the Gateway.
Activate the configuration to validate the links.

Connect the registers to the FB

Here is an example of an application with the input and output registers filled in.

../../../_images/example_of_integration_ethercat.png — Abb. 178 Example of integration