Web-based EtherCAT® Configuration and Diagnosis Tool
EC-Engineer Web is a fully featured application for configuring, diagnosing, and troubleshooting EtherCAT® networks, with a user interface accessible via a web browser. Its modular and platform-independent architecture allows the software to be flexibly deployed on various operating systems (Windows, Linux, and macOS) as well as different CPU architectures (x64, Arm32, Arm64).
Architectures
In addition to multi-OS support, a major advantage of EC-Engineer Web is its modular software structure, which supports various architectures. By default, all modules are installed and run on a single device (e.g., a PC running Windows or Linux) (Architecture 1). The Business Logic integrates the MainDevice software EC-Master directly via the EC-Master API to access an optionally connected EtherCAT network. This enables, for example, a network scan for automatic detection of existing SubDevices and the topology.
If a PC running Windows or Linux is to be used to diagnose a MainDevice with EC-Master, communication takes place via a TCP/IP connection using the acontis RAS (Remote Access Service) protocol (Architecture 2). EC-Master provides the EC-Engineer Web with extensive diagnostic data via this interface, and—if enabled—data in the MainDevice and SubDevices can also be modified.
The business logic can also be installed and run directly on the MainDevice, provided that Microsoft .NET support is generally available on that system. This cross-platform framework is available for Windows, Linux, and macOS (Architecture 3). On the user interface device, no additional installation is required beyond the browser to configure the network or diagnose the entire system.
Configuration
EC-Engineer Web supports the complete configuration of all EtherCAT SubDevice types — based on the ESI files provided by device manufacturers.
Key configuration tasks:
- Import ESI files (ETG.2000), export ENI files (ETG.2100)
- Define cyclic process data (PDO selection and mapping)
- Set SubDevice startup parameters and init commands
- Define cabling topology and optional Hot Connect groups
- Configure Distributed Clocks (DC) synchronization
- Assign Station Alias Addresses
Configuration can be done offline (lab or office, without hardware) or online (connected to the real network). The Network Scan feature automatically detects connected SubDevices and the physical topology — regardless of whether SubDevices are connected to the local system (Windows or Linux) or to a remote EC-Master controller.
Diagnosis
EC-Engineer Web connects to any running EC-Master system over TCP/IP and provides full visibility into the live EtherCAT network — without requiring local access to the controller hardware. Once connected (only the IP address of the MainDevice is required), EC-Engineer Web retrieves all relevant information directly from the EC-Master, including the network configuration:
- Display and control of EC-Master and SubDevice states
- Live process (I/O) data — read and write
- ESC register access (read and write)
- EEPROM read and write
- Object Dictionary access for EC-Master and SubDevices
- SDO mailbox transfers (upload and download)
- Firmware upload and download
- Side-by-side comparison of configured vs. detected network topology .
Troubleshooting
EtherCAT networks provide extensive built-in diagnostics, and the acontis EC-Engineer Web is designed to make these accessible even without deep EtherCAT expertise. Errors in an EtherCAT network fall into three categories, each requiring different diagnostic approaches.
Category 1 covers permanent errors during network startup that prevent the network from reaching the Operational state. These include topology mismatches between the real network and the ENI configuration, SubDevice initialization failures, Distributed Clock synchronization problems, and complete frame loss despite correct cabling. The EC-Engineer's graphical topology view allows engineers to immediately compare the discovered network against the planned configuration, making it straightforward to identify missing or mismatched SubDevices.
Category 2 covers permanent errors while the network is Operational — cable disconnections at the MainDevice or between SubDevices, power loss, SubDevices dropping to a lower state, total SubDevice failure, or an unexpected device appearing on the network. Localizing the exact problem location within a potentially large network of hundreds of SubDevices is crucial for efficient troubleshooting. The EC-Engineer's topology view highlights exactly where in the chain communication is lost, allowing targeted intervention rather than time-consuming trial-and-error cable swapping.
Category 3 covers intermittent errors while the network stays Operational but with degraded quality — occasional frame loss and Working Counter Errors (WKC) in cyclic process data. These are the hardest to catch because they may appear only under specific conditions such as vibration, temperature changes, or electromagnetic interference. The EC-Engineer's "Self Test Scan" function sends large numbers of frames of varying lengths over a defined period, counts missing frames, and reads SubDevice error registers to identify vulnerabilities. By combining frame loss statistics with per-SubDevice error counter readouts, the EC-Engineer pinpoints marginal connections before they escalate into permanent failures.
EC-Engineer Web Software Development Kit (SDK)
EC-Engineer Web is a client server application, with the modern dark mode client user interface (UI) an Angular-CLI project communicating through a REST-API with the backend (ASP.NET Core). Using the available SDK all (or just a subset) of the EC-Engineer Web features can be integrated into another engineering application. Brand labeling and other customer specific enhancements can be achieved as well. All EC-Engineer core software components and modules are available for Windows and Linux. The user interface layers are based on the Microsoft® ASP .NET Core Angular project.
- ASP.NET Core Web Application
- Angular: Application design framework and development platform for creating single-page apps
- TypeScript: Is a strict syntactical superset of JavaScript
Features
As the EC-Engineer Web is a fully-featured tool for configuration, diagnosis, trouble-shooting with built-in EtherCAT MainDevice functions as well as EtherCAT SubDevice simulation, we can only show some highlight-features here, for a complete feature comparison, please check the online documentation.
General Features
- Configuration of multiple MainDevice systems within one project
- EtherCAT SubDevices connected to the Windows PC
- EtherCAT SubDevices connected to the control system
- Tree View and Topology View
- ESI and EMI Manager
- Multiple Languages
Configuration Features
- Import ESI (EtherCAT SubDevice Information) files according to ETG.2000
- Export ENI-(EtherCAT Network Information) files according to ETG.2100
- Automatic determination of the connected SubDevices (bus scan)
- SubDevice device copy and paste including all parameters
- PDO selection and configuration
- Adjustment and appending of EtherCAT SubDevice init commands
- Transparent integration of MDP (Modular Device Profile) SubDevices
- Fixed memory layout of SubDevices or
- Distributed Clocks (DC) Settings
- Definition of "Hot Connect" groups
- Programming Station Alias Address
- Other MainDevice and SubDevices parameters
Diagnosis and Monitoring Features
- EC-Master and SubDevice State (display and control)
- Process (I/O) data (display and control)
- ESC Register (read and write)
- EEPROM (read and write)
- EC-Master And SubDevice Object Dictionaries
- Mailbox transfers (Service Data Objects upload and download)
- Firmware upload and download
- Comparison of configuration and real network
More information
Please request additional information in our download area.