Warning

You are reading an old version of this documentation. If you want up-to-date information, please have a look at 2024.12 .

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

Fig. 151 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:

Fig. 152 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

1. Restart in configuration mode.

2. Select I/O,right click on Devices and select Scan.

Fig. 153 Scan for devices

3. Validate the HINT.

Fig. 154 Validate the Hint

4. Select the new I/O Device found.

Fig. 155 Select the new I/O Device found

5. Validate the Scan for boxes.

Fig. 156 Validate the Scan for boxes

6. Activate Free Run.

Fig. 157 Activate Free Run

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

Fig. 158 Confirm the creation of the Gateway

Link I/O

1. Activate the configuration.

2. Select all dbGateway input variables in the instances of your PLC project except the last one (HR_ETHERCAT_COMMUNICATION_STATUS).

3. Right click on the list and choose Change Multi Link…

Fig. 159 Change Multi Link

4. In the new window, check All Types.

Fig. 160 Check All Types

5. 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.

Fig. 161 Select and link

6. 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.

Fig. 162 Link state

7. 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.

8. 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.

Fig. 163 Example of integration