2.3.1. Generate ENI-File

As already mentioned, the master requires an EtherCAT Network Information (ENI) file. For this purpose, the EtherCAT coupler (including the input and output terminals) is temporarily connected to a computer on which Beckhoff TwinCAT 3 is installed, see Fig. 4. All other available tools can also be used to create ENI files.

Connect Hardware to Laptop

Fig. 4 Connect the EtherCAT devices to a laptop

You can either follow the general instructions in section “Export Configuration File…” of the Beckhoff TwinCAT3 Manual or follow this example guide below.

2.3.1.1. Open New Project

After opening TwinCAT 3 click on File -> New Project. Then fill out the names and provide a location to which the new project is saved. Confirm your entries by clicking OK, as seen in Fig. 5.

New Project

Fig. 5 Creating a new project

Afterwards, the following TcXaeShell window, Fig. 6, appears (it may take a short while).

TcXaeShell

Fig. 6 TcXaeShell for a new project

2.3.1.2. Scan for Devices

Expand the I/O section in the Solution Explorer by clicking the small triangle and select the Devices section. Afterwards, right-click on Devices and then click on Scan. The following pop-up appears, which you can accept with OK, as shown in Fig. 7.

ScanDevices

Fig. 7 Scan for EtherCAT devices

Once new devices are found (in this case I/O devices), a pop-up appears, as shown in Fig. 8. Select the devices you want to use in your project (most likely all) and continue by clicking OK.

foundDevices

Fig. 8 Found EtherCAT devices during scanning

The following pop-ups, which ask the user to scan for boxes and activate the free run, can both be answered with Yes. Once finished, the devices found (called Device 2 in this example) are listed under Devices. If they do not show up correctly, it might be necessary to download and add ESI files for your devices. Consult the manual of your device and the documentation of TwinCAT 3 in this case.

2.3.1.3. Export ENI-File

Double click to select Device 2. In the upper middle section of the TcXaeShell, which is named after the project (here DIO Example), select the middle tab, labeled EtherCAT. The following view, as seen in Fig. 9, should then appear.

exportENI

Fig. 9 Overview of the device

Now click on Export Configuration File… and save the eni.xml to a destination of your choice, see Fig. 10.

saveENI

Fig. 10 Save the ENI file

2.3.1.4. Reference ENI-File

You can download the created ENI file eni.xml for the EtherCAT bus structure described in this example.