FUXA项目中Modbus写入脚本的Bug分析与修复

FUXA项目中Modbus写入脚本的Bug分析与修复

FUXA Web-based Process Visualization (SCADA/HMI/Dashboard) software 项目地址: https://gitcode.com/gh_mirrors/fu/FUXA

问题背景

在工业自动化领域，SCADA系统扮演着重要角色。FUXA作为一款开源的SCADA软件，提供了强大的脚本功能，特别是其"scale script"特性在处理时间调度等场景时非常实用。然而，在1.2.0-1815版本中，用户发现了一个影响Modbus写入功能的Bug。

问题现象

用户报告称，在使用FUXA与Modbus模拟器(如Open ModSim)配合时，读取操作(Read with scale script)工作正常，但尝试写入操作(Write with scale script)时会出现错误提示："ERR setValue script error, returned buffer invalid must be mod 2"。

技术分析

深入代码层面，问题出现在device-utils.js文件中的callScaleScript函数。该函数负责处理脚本的调用，但在写入操作时存在以下问题：

1. 运行时环境(runtime)未正确传递，导致条件判断if (scriptId && runtime !== undefined)始终为false
2. 函数直接返回输入值，没有执行预期的脚本转换逻辑
3. 写入路径的脚本执行流程被完全跳过

修复方案

开发团队在后续版本(1.2.0-1909)中修复了这个问题。主要改进包括：

1. 确保运行时环境正确传递到写入操作的处理流程
2. 完善了脚本调用的错误处理机制
3. 统一了读写操作的脚本执行路径

验证结果

修复后，用户确认：

1. 错误信息不再出现
2. 写入脚本能够正常执行
3. Modbus TCP通信功能完整恢复

技术启示

这个案例展示了工业自动化软件中几个关键点：

1. 脚本执行环境的一致性检查至关重要
2. 读写操作虽然相似，但实现路径可能有差异
3. 完善的错误处理能显著提升用户体验

对于SCADA系统开发者而言，这类问题的解决不仅修复了功能缺陷，也为后续类似功能的开发提供了参考模式。特别是在处理工业协议与脚本引擎的交互时，需要特别注意执行环境的完整性和一致性。

FUXA Web-based Process Visualization (SCADA/HMI/Dashboard) software 项目地址: https://gitcode.com/gh_mirrors/fu/FUXA