FUXA项目中的标签值脚本转换功能解析-优快云博客

FUXA项目中的标签值脚本转换功能解析

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

功能背景与需求

在工业自动化系统中，设备间的数据通信往往需要特定的格式转换。FUXA作为一款开源HMI/SCADA系统，其标签系统在处理设备数据时需要支持各种复杂的转换需求。传统的数据转换方式（如线性变换、毫秒转日期等）已无法满足某些特殊设备的通信协议要求。

以SEW MDX61B系列变频器为例，其MODBUS通信协议要求参数值必须编码为8字节序列，包含管理字节、参数子索引、参数索引和参数值等多个字段。这种复杂的编码方式超出了标准转换功能的能力范围。

解决方案设计

FUXA通过引入标签脚本转换功能解决了这一难题，主要实现了以下创新点：

双向脚本转换：支持为每个标签配置独立的读取和写入脚本
参数化设计：脚本可接收额外参数，提高复用性
异步处理：全面支持异步脚本执行
类型安全：严格定义输入输出数据类型

技术实现细节

脚本执行流程

写入流程：

用户界面值 → 原始值计算(tagRawCalculator) → 写入脚本转换 → 设备通信

读取流程：

设备原始值 → 读取脚本转换 → 标签值组合(tagValueCompose) → 用户界面显示

脚本接口规范

所有转换脚本必须遵循以下规范：

第一个参数必须命名为"value"，类型为"value"
可添加额外参数，参数值在标签配置中设置
必须返回单一值
需配置为SERVER类型脚本

MODBUS设备特殊处理

对于MODBUS设备，写入脚本返回的Buffer会被自动转换为16位整数数组：

// 示例：SEW变频器斜坡速度参数编码脚本
async function buildSewRampSpeedBuf(value) {
    const valBuf = Buffer.alloc(8, 0);
    valBuf.writeUInt8(0x32);          // 管理字节
    valBuf.writeUInt16BE(8470, 2);    // 参数索引
    valBuf.writeUInt32BE(value, 4);   // 参数值
    return valBuf;
}