ESI File Management

ESI files which are referenced from a project's EtherCAT devices are stored in the project.

  • Upon opening a project the ESI files are copied to the local folder.

    Figure 1: Opening — Upon opening a KAS project, the project's ESI files are compared to the internal library. If there are conflicts, you are prompted to resolve them.

  • Adding or deleting ESI files from KAS-IDE affects the internal library

    Figure 2: Adding/Deleting — Adding or deleting an ESI file from the KAS-IDE affects KAS's internal library of ESI files.

  • Upon saving a project the ESI files are copied to (project folder)\Controller\ESI.

    Figure 3: Saving — When a KAS project is saved, a copy of the ESI file(s) is included in the project file.


  • The ESI files are stored along with the project so the project can easily be moved to another location and it will still compile. It still compiles because the ESI files are copied back to the local folder.


  • There is the possibility that the names and/or contents of files can be conflicting. The system checks the files before adding them. You will be prompted to chose the correct file should any conflicts be found.


  • WARNING: Replacing an ESI file changes the configuration of any associated device to the new file.
    You are prompted to confirm or cancel replacing an ESI file and the associated device configurations.

ESI files are replaced when:

  • Opening a project file that contains an ESI file that is different from the file in the KAS Internal Library of ESI files stored on the PC.
    • You are prompted to select either:
      • term_A (use the version in the project).
        Selecting term_A overwrites the ESI Internal Library version.
      • term_B (use the ESI Internal Library version).
  • Click the Add button in the ESI Files tab view and import an ESI file that either:
    • Already exists in the KAS Internal Library of ESI Files stored on the PC.
    • Contains duplicate device information that already exists in the KAS Internal Library of ESI Files stored on the PC.

  • It is strongly recommended that you do not add or remove ESI files while multiple instances of the KAS-IDE are open.
    Doing so modifies a global cache of ESI files.
    Changes to the global ESI file cache from one instance of the KAS-IDE could create unexpected consequences in another instance.