====== Create an ENI File ======
===== Purpose of the ENI File ======

The ENI file describes the EtherCAT network.
This file describes the topology in which all slaves in the network are connected. It also describes which values are exchanged periodically.

In addition to the topology, the type of slaves must also be known. The different types of EtherCAT slaves are described in the ESI files.

See [[embedded_systems:ethercat:understanding_ethercat|Understanding EtherCAT]] for more information.


===== Requirements =====
To create an ENI file the following is required:
  - ESI files describing the slaves, see [[embedded_systems:ethercat:understanding_ethercat#ENI_and_ESI_files|]]
  - An EtherCAT Master that can scan the network
  - Software that can create an ENI file

Items 2 and 3 can be covered with the software [[https://www.acontis.com/eng/products/ethercat/ec-engineer/index.php | EC-Engineer]]. This software already includes a software EtherCAT master. The EtherCAT network can then be attached to the Ethernet port of the PC and scanned by the software. Please make sure to run the program with administrator rights.

Alternatively, you can download the free software [[https://www.elmomc.com/product/easii/ | EASII]] (Elmo Application Studio 2) from Elmo.  In this case you need a hardware EtherCAT master from Elmo, e.g. the [[https://www.elmomc.com/product/gold-maestro/ | Gold Maestro]] from Elmo.

===== Create ENI file ======
The exact procedure depends on the hardware and software used. The following procedure describes using Elmo drives but can be adapted to other drives:

  - Use ClassA master
  - Select a slave
  - The EASII already has all ESI files for the Elmo Drives. If the required ESI file is not yet available:
    - Get the ESI file from the manufacturer
    - Import the ESI file 
  - Attach a slave to the EC master (If EC-Engineer is used by Acontis, attach the slave to the PC)
  - The slave must be supplied with power.
  - Scan the network
  - The slave should be detected
  - Test if you can read an encoder value
  - Connect the complete EC network and scan again
  - Define the period duration for PDOs (typically 1msec)
  - Define all variables which are to be sent or received with the PDOs from the slaves.
  - Export the ENI file

If one of the following properties changes, then the ENI file must be rebuilt:
  * Topology
  * Period duration
  * Exchanged variables via PDO

With EC-Engineer you can switch to //Diagnosis Mode// where you can plot selected values in realtime.