物联网 · 盛世宏博 · 信创适配 · 国产组态平台 · Modbus TCP · 接口规范 · 验收

关键词:信创组态平台、国产操作系统、麒麟、统信UOS、海光、鲲鹏、飞腾、兆芯、龙芯、ARM64、LoongArch、国产中间件、达梦数据库、人大金仓、东方通TongWeb、中创、Modbus TCP驱动适配、字节序、大小端、缩放因子、寄存器映射、点表规范、功能码、IO服务器、OPC UA网关、国密SM2/SM3/SM4、等保2.0、接口验收、联调测试、压力测试、兼容性矩阵、边界值测试、异常注入、回归测试 标签:#物联网 #Modbus #TCP/IP #POE供电 #信创 #国产化 #组态软件 #以太网温湿度传感器 #机房监控
在 x86 + Windows + 商业组态软件的环境里,Modbus TCP 驱动是现成的,插上 IP 就能读。但信创环境多了四层变量,任何一层没对齐,就会出现"平台上离线、传感器明明在线"的经典场面:
信创对接的核心不是"能不能通",而是"在目标信创栈上,驱动能编译、能运行、能压住、能审计、能过等保"。接口规范和验收方案要把这四层都写进条款,否则交付时扯皮。
接口规范应覆盖六个部分,逐条可测:
┌──────────────────────────────────────────────────────────┐
│ 1. 兼容性规范(OS/CPU/中间件/数据库 矩阵) │
│ 2. 通信规范(传输层/协议层/安全层参数) │
│ 3. 数据规范(寄存器映射/字节序/缩放/质量位/点表) │
│ 4. 驱动接口规范(驱动API/IO服务器/OPC UA 网关) │
│ 5. 安全规范(等保/国密/ACL/审计) │
│ 6. 验收规范(测试用例/指标/方法/交付物) │
└──────────────────────────────────────────────────────────┘层级 | 项目 | 本项目选定版本 |
|---|---|---|
CPU 架构 | 服务器/客户端 | 鲲鹏 920 (ARM64) / 海光 3xxx (x86_64) |
操作系统 | 服务端 | 麒麟 V10 SP3 (aarch64) |
操作系统 | 客户端 | 统信 UOS 桌面版 V20 (x86_64) |
中间件 | 应用容器 | 东方通 TongWeb 7.0 |
数据库 | 时序/关系 | 达梦 DM8 + TDengine 3.x(信创版) |
JDK | 运行环境 | 毕昇 JDK 17 (aarch64) |
组态平台 | 版本 | XX国产组态 Vx.x(提供 Modbus TCP 驱动) |
uname -m 自检脚本,启动时校验架构匹配 ldd 无缺失依赖 file 确认 ELF 架构与目标一致 systemctl enable 开机自启 参数 | 规范值 | 说明 |
|---|---|---|
协议 | Modbus TCP(RFC 兼容) | MBAP + PDU |
端口 | 默认 502,生产建议改 1502/5020 | 避免扫描器默认探测 |
连接模式 | 长连接 + 连接池 | 禁止每次轮询新建 socket |
并发连接数 | 单传感器 ≤2(1 主 + 1 备) | 超出的平台走网关汇聚 |
超时 | connect 3s / read 3s | 分级超时 |
重试 | 2 次,间隔 1s | 指数退避上限 30s |
Keepalive | TCP keepalive 10s/5s/3 次 | 检测半开连接 |
应用层心跳 | 每 10s 读一次状态字 | 防"TCP 通但服务死" |
要求 | 实现 |
|---|---|
身份鉴别 | 平台与传感器间 ACL + Unit ID + 可选 IP-MAC 绑定 |
访问控制 | 交换机 ACL 仅放行组态服务器 IP → 传感器:502 |
通信加密(可选) | 前置国密网关,SM4 隧道承载 Modbus,或 VPN/IPSec SM4 |
完整性 | 关键配置写操作附带 SM3 摘要,平台侧校验 |
审计 | 所有写操作记录 操作人/源IP/旧值/新值/时间,落达梦库不可篡改 |
端口收敛 | 传感器关闭 HTTP/Telnet/SSH,仅留 502 |
等保条款 | 对应 GB/T 22239-2019 8.1.4(访问控制)、8.1.4.3(审计) |
以 16bit、缩放 ×0.1 为例,信创项目点表必须逐字段锁定,不允许"以实物为准":
序号 | 地址(0-based) | 数据项 | 功能码 | 类型 | 字节序 | 缩放 | 单位 | 量程 | 质量位规则 | 读写 |
|---|---|---|---|---|---|---|---|---|---|---|
1 | 0x0000 | 温度 | 0x03/0x04 | INT16 | AB | ×0.1 | ℃ | -40~85 | 超量程→BAD_VALUE | R |
2 | 0x0001 | 相对湿度 | 0x03/0x04 | UINT16 | AB | ×0.1 | %RH | 0~100 | >100→BAD_VALUE | R |
3 | 0x0002 | 露点温度 | 0x03/0x04 | INT16 | AB | ×0.1 | ℃ | -40~60 | 露点>温度→CONFLICT | R |
4 | 0x0003 | 设备状态字 | 0x03 | UINT16 | AB | 位域 | — | — | bit0探头断线/bit1故障/bit2缓存中/bit3校准中 | R |
5 | 0x0004 | 温度设定上限 | 0x03/0x06 | INT16 | AB | ×0.1 | ℃ | -40~85 | 越界拒绝写 | RW |
6 | 0x0005 | 温度设定下限 | 0x03/0x06 | INT16 | AB | ×0.1 | ℃ | -40~85 | 下限≥上限拒绝 | RW |
7 | 0x0006 | 湿度设定上限 | 0x03/0x06 | UINT16 | AB | ×0.1 | %RH | 0~100 | 越界拒绝写 | RW |
8 | 0x0007 | 湿度设定下限 | 0x03/0x06 | UINT16 | AB | ×0.1 | %RH | 0~100 | 下限≥上限拒绝 | RW |
9 | 0x0008~0x0009 | 设备运行秒数 | 0x03 | UINT32 | ABCD | ×1 | s | 0~4294967295 | 回绕检测 | R |
10 | 0x000A | 采样周期 | 0x03/0x06 | UINT16 | AB | ×1 | s | 5~3600 | <5 拒绝 | RW |
11 | 0x000B | 软件版本号 | 0x03 | UINT16 | AB | 高字节主/低字节次 | — | — | — | R |
12 | 0x000C | 温度传感器原始ADC | 0x03 | INT16 | AB | ×1 | — | 0~4095 | 用于现场比对 | R |
13 | 0x000D | 湿度传感器原始ADC | 0x03 | INT16 | AB | ×1 | — | 0~4095 | 用于现场比对 | R |
14 | 0x000E | CRC/校验和 | 0x03 | UINT16 | AB | — | — | — | 应用层完整性校验 | R |
15 | 0x000F | 控制寄存器 | 0x03/0x06 | UINT16 | AB | 位域 | — | — | bit0复位/bit1启校准/bit2清告警 | W |
类型 | 占用寄存器 | 字节序 | 说明 |
|---|---|---|---|
INT16/UINT16 | 1 | AB(大端) | Modbus 标准大端 |
INT32/UINT32 | 2 | ABCD | 高字在前 |
FLOAT32 | 2 | ABCD(默认)/ CDAB(可选) | 必须在点表中锁定,并提供"已知值校验法":写 25.5,读回 hex 比对 |
位域 | 1 | bit0 为最低位 | 状态字、控制字统一约定 |
TH01_Temp_C、TH01_Hum_pct 传感器状态 | 平台质量位 | 画面处理 |
|---|---|---|
正常 | GOOD | 正常着色、入库 |
超时/无响应(3次) | OFFLINE | 灰色+离线角标,不画旧值 |
值域越界/0xFFFF | BAD_VALUE | 红色闪烁,不入库 |
状态字 bit0 置位 | PROBE_FAULT | 黄色,提示换探头 |
露点>温度 | CONFLICT | 橙色,触发校准工单 |
连续 5min 值不变 | STALE | 虚线显示,提示"疑似僵值" |
驱动须实现以下标准接口,供组态平台装载:
驱动接口 IModbusDriver:
init(config) 加载节点表/点表/超时参数
connect(node_id) 建立长连接,返回句柄
read(tag_id) -> (value, quality, ts) 同步读,供扫描周期调用
write(tag_id, value) -> (result, readback) 写+回读
batch_read(tag_list) -> [(value, quality, ts)] 批量读,减少帧数
subscribe(tag_id, cb) 变化上报(可选,走事件)
health() -> {online, rtt, crc_err, timeout_cnt}
shutdown() 优雅关闭,释放 fd{
"driver": "modbus-tcp",
"nodes": [
{
"node_id": "TH-A01-01",
"ip": "192.168.110.21",
"port": 1502,
"unit_id": 11,
"poll_interval_ms": 5000,
"timeout_ms": 3000,
"retry": 2,
"tags": [
{"tag":"TH_A01_01_Temp","addr":0,"fc":3,"type":"INT16","scale":0.1,"unit":"℃"},
{"tag":"TH_A01_01_Hum","addr":1,"fc":3,"type":"UINT16","scale":0.1,"unit":"%RH"},
{"tag":"TH_A01_01_Dew","addr":2,"fc":3,"type":"INT16","scale":0.1,"unit":"℃"},
{"tag":"TH_A01_01_Stat","addr":3,"fc":3,"type":"UINT16","scale":1,"unit":""}
]
}
]
}要求:点表可批量导入/导出/版本化,导入时做地址冲突、量程越界、Unit ID 重复校验,报错定位到行。
信创环境下多平台并存(组态、SCADA、大数据、数字孪生),推荐在 Modbus 之上加一层 OPC UA 网关:
传感器(Modbus TCP) → OPC UA Gateway(信创部署) → {组态平台, SCADA, 时序库, 数字孪生}ns=2;s=TH_A01_01/Temp 编号 | 用例 | 方法 | 通过标准 |
|---|---|---|---|
A01 | 架构匹配 | file/uname -m | ELF 架构一致,无 x86 二进制 |
A02 | 依赖完整 | ldd 驱动.so | 无 not found |
A03 | 服务托管 | systemctl start/enable/reboot | 开机自启,状态 active |
A04 | 防火墙 | firewalld 放行规则 | 规则持久化,重启不丢 |
A05 | 数据库 | 达梦/金仓连接池 | 建连成功,中文无乱码 |
A06 | 中间件 | TongWeb 部署 | 无异常,页面可访问 |
编号 | 用例 | 方法 | 通过标准 |
|---|---|---|---|
B01 | 单点读值 | 平台读 15 个寄存器 | 与便携表比对:温度 ≤±0.3℃,湿度 ≤±2%RH |
B02 | 批量读 | batch_read 全点表 | 值与单点读一致,帧数 ≤ ceil(点数/125) |
B03 | 缩放正确 | 驱动输出值 vs 面板值 | 一致,无二次缩放 |
B04 | 字节序 | 写 25.5 读回 hex | 与约定 ABCD/CDAB 一致 |
B05 | 写+回读 | 写湿度上限 55.0 | 回读 550,面板同步显示 55.0 |
B06 | 写保护 | 写温度上限 999℃ | 拒绝,返回非法数据值,审计有记录 |
B07 | 状态字解析 | 拔探头 | bit0 置位,平台报 PROBE_FAULT |
B08 | 质量位 | 断网 3 个周期 | OFFLINE,画面不画旧值 |
B09 | 点表导入 | 导入 200 节点 CSV | 校验报错可定位到行,无静默丢弃 |
B10 | 单位与命名 | 检查变量名 | 后缀带单位,中文别名无乱码 |
编号 | 注入 | 预期 |
|---|---|---|
C01 | 温度 -40.0 / 85.0 | 边界值正常解析 |
C02 | 湿度 0.0 / 100.0 | 边界值正常 |
C03 | 返回 0xFFFF | BAD_VALUE,不入曲线 |
C04 | 返回 0x8000(INT16 最小) | -3276.8℃ → 判越界 BAD_VALUE |
C05 | 响应长度截断 | 帧长度不足,驱动丢弃不崩 |
C06 | 返回 0x83 02 | 记 PROTO_ERR,不标记离线 |
C07 | 返回功能码 0xFF | ILLEGAL_FUNCTION,不重连风暴 |
C08 | Unit ID 错 | 超时/无响应,3 次后 OFFLINE |
C09 | 粘包(两帧合一) | 按 MBAP length 正确拆帧 |
C10 | 半帧到达 | 缓存等待,不误判 |
C11 | 连接被 RST | 指数退避重连,不泄漏 fd |
C12 | 服务器发零窗 | 超时释放,不死锁 |
编号 | 场景 | 指标 |
|---|---|---|
D01 | 50 节点 × 5s 周期 | 采集成功率 ≥99.5% |
D02 | 200 节点 × 10s 周期 | CPU ≤40%(4 核 ARM64),内存无持续增长 |
D03 | 单节点连续 72h | 无 fd 泄漏(lsof 稳定)、无内存增长 |
D04 | 突发 1000 次写 | 回读一致率 100%,审计无丢失 |
D05 | 驱动崩溃 | systemd 自动拉起 ≤10s,数据断点 ≤1 周期 |
D06 | 传感器批量重启 | 重连收敛 ≤60s,无雪崩 |
编号 | 场景 | 通过标准 |
|---|---|---|
E01 | 拔网线 10min | 边缘缓存,恢复后按 collect_ts 补传 |
E02 | 补传去重 | 平台无重复点、曲线无竖线 |
E03 | NTP 偏差 | 节点与平台偏差 <1s |
E04 | 双写冲突 | 同一时刻两路写,回读终值唯一且可追溯 |
编号 | 场景 | 通过标准 |
|---|---|---|
F01 | 非白名单 IP 访问 502 | 被 ACL 拒绝 |
F02 | 未授权写 | 拒绝 + 审计留痕 |
F03 | 审计日志 | 字段完整,落达梦库,不可删改 |
F04 | 端口扫描 | 仅 502/1502 开放,其余关闭 |
F05 | 国密隧道(如采购) | SM4 隧道内 Modbus 正常收发 |
F06 | 等保条款核查 | 对应条款逐条有证据材料 |
指标 | 门槛 |
|---|---|
采集成功率 | ≥99.5% |
写回读一致率 | 100% |
温度比对偏差 | ≤±0.3℃ |
湿度比对偏差 | ≤±2%RH |
告警/质量位正确率 | 100%(用例全覆盖) |
72h 无重大缺陷 | 无崩溃、无 fd/内存泄漏 |
审计完整率 | 100% |
信创兼容性 | 矩阵内 100% 通过 |
信创组态平台对接 Modbus TCP 温湿度变送器,难不在协议本身——Modbus TCP 三十年前就定型了;难在把协议嵌进一套国产底座里还能保持工业级确定性:
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。