|
|
本帖最后由 骑猪逛大街 于 2026-11-18 11:06 编辑
一、这是什么
一个给火山视窗用的工控通讯合集模块。装一次,Modbus、OPC UA、MQTT、普通串口、HTTP、TCP/UDP Socket 全部到位,不用为了一个协议去拼三个模块。
模块以源码方式静态集成第三方库,编译和发布都不需要额外的 DLL:libmodbus 3.1.12、open62541 1.4.17、Mongoose 7.21。只链接 Windows 自带的 ws2_32 / iphlpapi / advapi32。
当前版本 v22,包名 火山.工控模块,类库面板里显示为「工控通讯模块」。
二、能力清单
· Modbus TCP:客户端 创建TCP,服务端 创建TCP。主/从都支持。
· Modbus RTU:客户端 创建RTU,服务端 创建RTU。串口参数走 串口校验 常量。
· Modbus ASCII:客户端 创建ASCII,服务端 创建ASCII。覆盖 01/02/03/04/05/06/15/16 等常用功能码,另有 17/22/23。
· OPC UA:OPCUA客户端 / OPCUA服务端。匿名与用户名登录、浏览、读写、订阅节点变化、批量读写、方法调用、本地历史缓存。
· MQTT:MQTT客户端。连接、订阅、发布、取消订阅、Retain、QoS、保活。
· 普通串口:串口助手。HEX 与 ASCII 两种收发格式。
· HTTP:HTTP助手。GET / POST / 自定义方法,Basic 与 Bearer 认证。
· TCP / UDP:Socket助手。TCP 客户端、TCP 服务端、UDP 收发,编码支持 HEX / UTF8 / ASCII / GBK。
Modbus 这块做的是"能直接用"的程度:int / word / float 等类型直接读写,字序(高字在前 / 低字在前)和字节排列都做成了常量,不需要再在外面拼二次转换。
三、怎么装
方式一:文件夹式(和以前一样)
把 industrial_control_volcano 整个目录复制到:
火山安装目录\plugins\vprj_win\classlib\user\
然后在工程的「配置项目所使用模块」里勾上「工控通讯模块」。
方式二:安装包式(新,推荐)
工具 → 安装模块 → 选 industrial_control_volcano_v22.vcip → 看签名信息 → 确定
卸载:工具 → 卸载模块(只能卸用户自己装的模块)
两种方式效果一样,安装包多一层签名校验,省得手工拷目录拷错层。
注意:src 和 third_party 两个目录一个都不能少。模块里是这么引的——@视窗.外部源文件 = "third_party\libmodbus\src\modbus.c,...",少了它们,模块装上去也会在编译时报找不到文件。
四、五分钟上手
先说结论:不要一上来找方法,先选类。每个能力只有一个推荐入口,最短顺序都是「创建 → 设置参数 → 连接/启动 → 收发 → 查状态 → 关闭 → 释放」。
1、Modbus 主站(读 PLC、仪表)
变量 客户端 <类型 = Modbus客户端>
如果 (客户端.创建TCP ("127.0.0.1", 502))
{
客户端.设置从站 (1)
如果 (客户端.连接 ())
{
如果 (客户端.读保持寄存器 (0, 2) > 0)
{
调试输出 (客户端.取寄存器值 (0))
}
客户端.关闭 ()
}
客户端.释放 ()
}
RTU / ASCII 只把第一步换成 创建RTU / 创建ASCII,校验参数用 串口校验.无 / 串口校验.偶 / 串口校验.奇。
2、Modbus 从站(让本程序假装一台设备,给 ModScan / PLC 读)
变量 服务端 <类型 = Modbus服务端>
如果 (服务端.创建TCP (1502))
{
服务端.设置从站 (1)
服务端.设置保持寄存器 (0, 100)
如果 (服务端.启动 ())
{
调试输出 ("Modbus server started")
}
}
要抓报文做协议分析,再用 启动队列 / 取报文队列;普通模拟用 启动 就够。
3、MQTT
变量 客户端 <类型 = MQTT客户端>
客户端.连接 ("mqtt://127.0.0.1:1883", "my-client")
如果 (客户端.是否已连接 ())
{
客户端.订阅 ("factory/device1/status", MQTT服务质量.最多一次)
客户端.发布 ("factory/device1/cmd", "start", MQTT服务质量.至少一次, 假)
}
这里有个坑要提前说:连接() 返回成功,只代表连接流程启动了。必须确认 是否已连接() 为真,或 取状态() 返回 connected,之后的订阅、发布才算数。
4、OPC UA
变量 客户端 <类型 = OPCUA客户端>
客户端.创建 ()
客户端.设置服务器地址 ("opc.tcp://127.0.0.1:4840")
客户端.设置匿名登录 ()
如果 (客户端.连接 ())
{
调试输出 (客户端.读取节点文本 ("ns=2;s=Tag1"))
客户端.断开 ()
}
客户端.释放 ()
服务端三行起一个模拟器:创建(4840) → 添加整数节点("ns=1;s=Counter", "Counter", 0, 真) → 启动()。批量场景用 批量添加节点 / 批量读取节点 / 批量写节点 / 删除节点。
5、HTTP
变量 请求 <类型 = HTTP助手>
请求.GET ("https://postman-echo.com/get?name=test")
调试输出 (请求.查询状态 ())
调试输出 (请求.取结果 ())
POST JSON 用 请求.POST (地址, HTTP内容类型.JSON, "", 5000, 0, "", "{...json...}");需要认证时用 HTTP认证类型.Bearer 或 HTTP认证类型.Basic。
6、TCP / UDP Socket 与普通串口
变量 通讯 <类型 = Socket助手>
通讯.打开TCP客户端 ("127.0.0.1", 9000, 0, Socket编码.UTF8)
通讯.发送 ("Hello", Socket编码.UTF8)
调试输出 (通讯.取报文队列 ())
通讯.关闭 ()
变量 串口 <类型 = 串口助手>
串口.打开 ("COM3", 9600, 串口校验.无, 8, "1", "HEX")
串口.发送 ("01 03 00 00 00 02 C4 0B", "HEX")
调试输出 (串口.取报文队列 ())
串口.关闭 ()
Socket 发布前可以先调一次 一键自测():它临时跑本机 TCP/UDP loopback,跑完释放测试 socket,不影响当前连接。
五、类库怎么分层(避免第一次就点错)
· 能力类(业务只用这些):Modbus客户端、Modbus服务端、OPCUA客户端、OPCUA服务端、MQTT客户端、串口助手、HTTP助手、Socket助手
· 常量类(别记裸数字裸字符串):串口校验、Modbus功能码、Modbus字序、Modbus字节排列、MQTT服务质量、HTTP方法、HTTP认证类型、HTTP内容类型、Socket编码、Socket模式、OPCUA值类型、OPCUA消息安全模式
· 信息类(查内置库版本):Modbus信息、OPCUA信息、MQTT信息
· 内部类(不要直接用):串口助手系统、HTTP助手系统、Socket助手系统
名字带「系统」的三个类,是为了火山跨类调用才保持公开的内部执行器,参数是内部动作协议,不作为对外契约。它们的说明里写着"内部",就别从那里入手。
六、几条设计约定
· 生命周期七步走:创建/打开 → 设置参数 → 连接/启动 → 收发 → 查状态或错误 → 关闭/停止 → 释放。中途失败也要 关闭 + 释放。
· 自动轮询和自动监听不能同时开:开始自动轮询() 用于正常读寄存器/线圈,开始自动监听() 用于原始报文,二者互斥;关闭()、释放() 和对象析构都会自动停线程并放开 socket/串口。
· 参数用常量:QoS 用 MQTT服务质量.最多一次 / 至少一次 / 恰好一次,不要再写 0/1/2;字序用 Modbus字序.高字在前 / 低字在前。
· 状态要自己查:串口、HTTP、Socket 都是"动作 + 查询"两段式,返回值只表示动作有没有发出去,结果要 查询状态() / 取结果() / 取报文队列() 拿。
七、已知边界(先说清楚,省得来回试)
· 普通串口、HTTP、Socket 的底层目前是模块级共享执行器:同一进程里不要指望多个同类对象各自独立并发。
· OPC UA 的证书/安全策略接口会检测当前内置 open62541 是否启用加密插件,默认源码包未启用;完整的 Historical Access 服务端数据库也没做,只有本地历史缓存。
· Modbus TCP / RTU / ASCII 已在主工程完成现场测试,这部分不会再主动重构。
· MQTT 已完成连接、订阅、发布、取消订阅、Retain、QoS、保活验证。
八、模块打开失败?先对这几条
· 解压后多套了一层目录,.vgrp 不在你选中的那一层;
· .wsv 被别的编辑器存成了带 BOM 或 GBK —— 火山要求 UTF-8 无 BOM;
· .vgrp 里 file.name 和实际文件名对不上(改过名、挪过位置);
· IDE 版本太旧(这批代码在 1.0.0.26 上编写并编译通过);
· 直接双击 .wsv 单独打开 —— 应该走「打开解决方案」或者「配置项目所使用模块」。
还是打不开,就把报错原文或截图 + 你的火山版本号贴上来,我照着定位。
九、许可
模块本身随便用;内置的第三方库各自带着许可:
· libmodbus:LGPL-2.1-or-later。静态链接发布时,要给可重链接方式、目标文件或对应源码。
· open62541:MPL-2.0。保留许可声明,提供对应源码与修改说明。
· Mongoose:GPL-2.0-only。闭源或商业发布 MQTT 功能前,要买商业授权或换实现。
内部测试、开源项目随便用;要闭源商用 MQTT 的,请先看第三条。
十、反馈
跟帖就行。为了让问题能定位,麻烦带上:火山版本、32/64 位、现场设备型号或模拟器名称、报错原文或截图、最小复现代码片段。
工控上还缺什么协议、什么设备,也可以直接跟帖说,需求集中的我抽空继续封。
|
|