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. 153 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. 154 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. 155 Scan for devices

3. Validate the HINT.

Fig. 156 Validate the Hint

4. Select the new I/O Device found.

Fig. 157 Select the new I/O Device found

5. Validate the Scan for boxes.

Fig. 158 Validate the Scan for boxes

6. Activate Free Run.

Fig. 159 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. 160 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. 161 Change Multi Link

4. In the new window, check All Types.

Fig. 162 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. 163 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. 164 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. 165 Example of integration