feat: EtherCAT ESI support (merge development sync)

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.5.11",
     "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 { 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,17 @@
 
   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
+    try {
+    } catch {
+      // ignore package manager errors
+    }
+
+    throw new Error(`Board "${board}" not found in hals.json or installed VPP packages`)
   }
 
   #executeXml2st(args: string[]) {
@@ -1328,6 +1339,24 @@
     }
   }
 
+  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 +1458,9 @@
     })
 
     // --- 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
 
@@ -1714,8 +1745,6 @@
       }
 
       try {
-        const isRuntimeV3 = boardTarget === 'OpenPLC Runtime v3'
-
         let fileBuffer: Buffer
         let filename: string
         let contentType: string
@@ -1762,6 +1791,11 @@
             _mainProcessPort.postMessage({ logLevel, message: data })
           })
 
+          // Generate EtherCAT config for Runtime v4
+          await this.handleGenerateEthercatConfig(sourceTargetFolderPath, projectData, (data, logLevel) => {
+            _mainProcessPort.postMessage({ logLevel, message: data })
+          })
+
           _mainProcessPort.postMessage({
             logLevel: 'info',
             message: 'Compressing source files for OpenPLC Runtime v4...',