feat: EtherCAT ESI support

package.json

@@ -67,6 +67,7 @@
     "electron-store": "^8.1.0",
     "electron-updater": "^6.1.4",
     "embla-carousel-react": "^8.0.0-rc17",
+    "fast-xml-parser": "^5.6.0",
     "i18next": "^24.2.2",
     "immer": "^10.1.1",
     "lodash": "^4.17.21",

src/App.tsx

@@ -27,7 +27,7 @@ import {
 import { StartScreen } from './frontend/screens/start-screen'
 import { WorkspaceScreen } from './frontend/screens/workspace-screen'
 import { openPLCStoreBase, useOpenPLCStore } from './frontend/store'
-import { editorPorts, setRuntimeIpAddress } from './middleware/editor-platform'
+import { editorPorts, setProjectPath, setRuntimeIpAddress } from './middleware/editor-platform'
 import { PlatformProvider } from './middleware/shared/providers'
 
 // Initialize system libraries at module load time (before first render)
@@ -66,6 +66,12 @@ export default function App() {
     setRuntimeIpAddress(runtimeIpAddress)
   }, [runtimeIpAddress])
 
+  // Sync project path to the platform adapter so the ESI port can access it
+  const projectPath = useOpenPLCStore((state) => state.project.meta.path)
+  useEffect(() => {
+    setProjectPath(projectPath)
+  }, [projectPath])
+
   return (
     <PlatformProvider ports={editorPorts}>
       <AppLayout>{path === '' ? <StartScreen /> : <WorkspaceScreen />}</AppLayout>

src/backend/editor/compiler/compiler-module.ts

@@ -9,6 +9,7 @@ import { join } from 'node:path'
 import { promisify } from 'node:util'
 
 import { getRuntimeHttpsOptions } from '@root/backend/editor/utils/runtime-https-config'
+import { generateEthercatConfig } from '@root/backend/shared/ethercat/generate-ethercat-config'
 import type { DeviceConfiguration, DevicePin } from '@root/backend/shared/types/PLC/devices'
 import type { PLCProjectData } from '@root/backend/shared/types/PLC/open-plc'
 import {
@@ -183,7 +184,13 @@ class CompilerModule {
 
   async #getBoardRuntime(board: string) {
     const halsFileContent = await CompilerModule.readJSONFile<HalsFile>(this.halsFilePath)
-    return halsFileContent[board]['compiler']
+    if (halsFileContent[board]) {
+      return halsFileContent[board]['compiler']
+    }
+
+    // Board not found in hals.json or installed VPP packages
+
+    throw new Error(`Board "${board}" not found in hals.json or installed VPP packages`)
   }
 
   #executeXml2st(args: string[]) {
@@ -1328,6 +1335,24 @@ class CompilerModule {
     }
   }
 
+  async handleGenerateEthercatConfig(
+    sourceTargetFolderPath: string,
+    projectData: PLCProjectData,
+    handleOutputData: HandleOutputDataCallback,
+  ): Promise<void> {
+    const ethercatConfig = generateEthercatConfig(projectData.remoteDevices)
+
+    if (ethercatConfig) {
+      const confFolderPath = join(sourceTargetFolderPath, 'conf')
+      await mkdir(confFolderPath, { recursive: true })
+      const configFilePath = join(confFolderPath, 'ethercat.json')
+      await writeFile(configFilePath, ethercatConfig, 'utf-8')
+      handleOutputData('Generated conf/ethercat.json', 'info')
+    } else {
+      handleOutputData('No EtherCAT devices configured, skipping ethercat.json generation', 'info')
+    }
+  }
+
   async embedCBlocksInProgramSt(
     sourceTargetFolderPath: string,
     handleOutputData: HandleOutputDataCallback,
@@ -1429,7 +1454,9 @@ class CompilerModule {
     })
 
     // --- Check for unsupported features on non-v4 targets ---
-    const isRuntimeV4 = boardTarget === 'OpenPLC Runtime v4'
+    // VPP boards with runtime-v4 target type use openplc-compiler and are also v4-capable
+    const isRuntimeV3 = boardTarget === 'OpenPLC Runtime v3'
+    const isRuntimeV4 = boardRuntime === 'openplc-compiler' && !isRuntimeV3
     const hasServers = projectData.servers && projectData.servers.length > 0
     const hasRemoteDevices = projectData.remoteDevices && projectData.remoteDevices.length > 0
 
@@ -1683,6 +1710,43 @@ class CompilerModule {
         message: 'Source files generated successfully at: ' + sourceTargetFolderPath,
       })
 
+      // Generate Runtime v4 conf/* files for BOTH compile-only and upload flows.
+      // Without this, compile-only never produces ethercat.json (and other configs),
+      // so users who only want the generated sources miss runtime configuration.
+      if (isRuntimeV4) {
+        try {
+          await this.cleanConfFolder(sourceTargetFolderPath, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+          await this.handleGenerateModbusSlaveConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+          await this.handleGenerateModbusMasterConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+          await this.handleGenerateS7CommConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+          await this.handleGenerateOpcUaConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+          await this.handleGenerateEthercatConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+        } catch (error) {
+          _mainProcessPort.postMessage({
+            logLevel: 'error',
+            message: `Error generating Runtime v4 configs: ${error instanceof Error ? error.message : String(error)}`,
+          })
+          _mainProcessPort.postMessage({
+            logLevel: 'error',
+            message: 'Stopping compilation process.',
+          })
+          _mainProcessPort.close()
+          return
+        }
+      }
+
       if (compileOnly) {
         _mainProcessPort.postMessage({
           logLevel: 'info',
@@ -1714,8 +1778,6 @@ class CompilerModule {
       }
 
       try {
-        const isRuntimeV3 = boardTarget === 'OpenPLC Runtime v3'
-
         let fileBuffer: Buffer
         let filename: string
         let contentType: string
@@ -1737,31 +1799,8 @@ class CompilerModule {
           filename = 'program.st'
           contentType = 'text/plain'
         } else {
-          // Clean conf folder from previous compilations to avoid stale config files
-          await this.cleanConfFolder(sourceTargetFolderPath, (data, logLevel) => {
-            _mainProcessPort.postMessage({ logLevel, message: data })
-          })
-
-          // Generate Modbus Slave config for Runtime v4
-          await this.handleGenerateModbusSlaveConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
-            _mainProcessPort.postMessage({ logLevel, message: data })
-          })
-
-          // Generate Modbus Master config for Runtime v4
-          await this.handleGenerateModbusMasterConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
-            _mainProcessPort.postMessage({ logLevel, message: data })
-          })
-
-          // Generate S7Comm config for Runtime v4
-          await this.handleGenerateS7CommConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
-            _mainProcessPort.postMessage({ logLevel, message: data })
-          })
-
-          // Generate OPC-UA config for Runtime v4
-          await this.handleGenerateOpcUaConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
-            _mainProcessPort.postMessage({ logLevel, message: data })
-          })
-
+          // Runtime v4 conf/* files were already generated above, before the
+          // compile-only early return, so compile-only flows also get them.
           _mainProcessPort.postMessage({
             logLevel: 'info',
             message: 'Compressing source files for OpenPLC Runtime v4...',