首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >信创组态平台对接 Modbus TCP 温湿度变送器:接口规范与验收方案

信创组态平台对接 Modbus TCP 温湿度变送器:接口规范与验收方案

原创
作者头像
HONSOR盛世宏博
发布于 2026-11-16 15:29:17
发布于 2026-11-16 15:29:17
160
举报

信创组态平台对接 Modbus TCP 温湿度变送器:接口规范与验收方案

物联网 · 盛世宏博 · 信创适配 · 国产组态平台 · 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. CPU 架构差异:海光/兆芯是 x86_64,鲲鹏/飞腾是 ARM64(aarch64),龙芯是 LoongArch(mips64el/loongarch64)。组态软件的 Modbus 驱动如果是闭源 x86 二进制,在 ARM64 上根本跑不起来;如果是 Java 写的,要看 JVM 是否适配该架构
  2. 操作系统差异:麒麟(Kylin V10 SPx)、统信 UOS、欧拉 openEuler,glibc 版本、systemd 版本、防火墙(firewalld/ufw)、SELinux/AppArmor 策略都不同,socket 权限、端口绑定、服务自启都可能被拦
  3. 中间件与数据库:国产中间件(东方通 TongWeb、中创 InforSuite)、国产数据库(达梦 DM8、人大金仓 KingbaseES、OceanBase),驱动要落进这些容器里跑,JDBC/ODBC 驱动版本、字符集、数据类型映射都是坑
  4. 安全合规叠加:等保 2.0 + 国密要求下,明文 Modbus、默认 502 端口、community=public 都可能过不了测评,接口规范必须内置安全基线

信创对接的核心不是"能不能通",而是"在目标信创栈上,驱动能编译、能运行、能压住、能审计、能过等保"。接口规范和验收方案要把这四层都写进条款,否则交付时扯皮。


二、接口规范总体框架

接口规范应覆盖六个部分,逐条可测:

代码语言:javascript
复制
┌──────────────────────────────────────────────────────────┐
│ 1. 兼容性规范(OS/CPU/中间件/数据库 矩阵)               │
│ 2. 通信规范(传输层/协议层/安全层参数)                  │
│ 3. 数据规范(寄存器映射/字节序/缩放/质量位/点表)        │
│ 4. 驱动接口规范(驱动API/IO服务器/OPC UA 网关)          │
│ 5. 安全规范(等保/国密/ACL/审计)                        │
│ 6. 验收规范(测试用例/指标/方法/交付物)                 │
└──────────────────────────────────────────────────────────┘

三、兼容性规范:先定矩阵,再谈对接

3.1 目标环境声明(项目启动即锁定)

层级

项目

本项目选定版本

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 驱动)

3.2 驱动形态要求(写进采购条款)

  • 驱动必须以源码或目标架构二进制交付,不接受"仅 x86 Windows DLL"
  • Java 驱动:纯 Java 实现,不依赖 JNI 本地库(或同时提供 aarch64/loongarch64 的 .so)
  • C/C++ 驱动:提供 ARM64、LoongArch64、x86_64 三套 .so,或提供源码+CMakeLists
  • 依赖库静态链接或随包交付,不允许依赖发行版自带版本(glibc 兼容范围声明 ≥2.28)
  • 提供 uname -m 自检脚本,启动时校验架构匹配

3.3 兼容性验证清单

  • [ ] 驱动在目标 OS 上 ldd 无缺失依赖
  • [ ] file 确认 ELF 架构与目标一致
  • [ ] 服务以 systemd unit 托管,systemctl enable 开机自启
  • [ ] firewalld/ufw 放行 502(或自定义端口),SELinux 不拦截 bind
  • [ ] 达梦/金仓 driver 加载正常,连接池可建
  • [ ] TongWeb 部署 WAR 无 ClassNotFoundException
  • [ ] 中文字符集 UTF-8 全链路无乱码(点表中文名、报警文本)

四、通信规范

4.1 传输层

参数

规范值

说明

协议

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 通但服务死"

4.2 协议层约束

  • 功能码白名单:0x01/0x02/0x03/0x04/0x06/0x10,其余拒绝
  • Unit ID:范围 1~247,禁止默认全 1,同一 IP 段内唯一
  • 单帧读寄存器数 ≤125(0x03/0x04),写 ≤123(0x10)
  • 异常响应:功能码 | 0x80 + 异常码,驱动必须分类处理,不得一律当"离线"
  • 广播地址 0 仅允许写操作,且生产环境禁用自动发现广播

4.3 安全层(等保 2.0 + 国密)

要求

实现

身份鉴别

平台与传感器间 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(审计)


五、数据规范:点表是接口的核心交付物

5.1 寄存器映射表(标准模板)

以 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

5.2 字节序与数据类型约定

类型

占用寄存器

字节序

说明

INT16/UINT16

1

AB(大端)

Modbus 标准大端

INT32/UINT32

2

ABCD

高字在前

FLOAT32

2

ABCD(默认)/ CDAB(可选)

必须在点表中锁定,并提供"已知值校验法":写 25.5,读回 hex 比对

位域

1

bit0 为最低位

状态字、控制字统一约定

5.3 缩放与单位

  • 所有模拟量统一 ×0.1 整型传输,禁止浮点直传(避免不同平台浮点解析差异)
  • 缩放只在驱动层做一次,组态画面/数据库不再二次缩放
  • 平台侧变量名后缀带单位:TH01_Temp_C、TH01_Hum_pct

5.4 质量位映射(平台必须实现)

传感器状态

平台质量位

画面处理

正常

GOOD

正常着色、入库

超时/无响应(3次)

OFFLINE

灰色+离线角标,不画旧值

值域越界/0xFFFF

BAD_VALUE

红色闪烁,不入库

状态字 bit0 置位

PROBE_FAULT

黄色,提示换探头

露点>温度

CONFLICT

橙色,触发校准工单

连续 5min 值不变

STALE

虚线显示,提示"疑似僵值"


六、驱动接口规范

6.1 组态平台侧驱动接口(IO 服务器)

驱动须实现以下标准接口,供组态平台装载:

代码语言:javascript
复制
驱动接口 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

6.2 点表导入格式(统一 CSV/JSON)

代码语言:javascript
复制
{
  "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 重复校验,报错定位到行。

6.3 OPC UA 网关层(异构平台统一)

信创环境下多平台并存(组态、SCADA、大数据、数字孪生),推荐在 Modbus 之上加一层 OPC UA 网关:

代码语言:javascript
复制
传感器(Modbus TCP) → OPC UA Gateway(信创部署) → {组态平台, SCADA, 时序库, 数字孪生}
  • 网关须提供 ARM64/龙芯二进制,支持 OPC UA 1.04、SecurityPolicy Basic256Sha256
  • 地址空间映射:NodeId 命名规则 ns=2;s=TH_A01_01/Temp
  • 网关断线缓存 + 补传,避免下游多系统各自轮询打爆传感器

七、安全与审计规范

  • 传感器关闭一切非 502 服务,Web 管理口迁入管理 VLAN
  • ACL:仅组态服务器 IP + 运维跳板机 IP 可访问 502/1502
  • 写操作双因子:平台侧操作人账号 + 二次确认弹窗,写前记录旧值
  • 审计日志落达梦库,字段:时间、操作人、源IP、节点、寄存器、旧值、新值、回读值、结果
  • 审计表开启数据库审计(DM8 AUDIT),防篡改
  • 关键配置变更附 SM3 摘要,定期校验
  • 等保测评对应条款清单随验收文档一并提交

八、验收方案

8.1 验收环境

  • 与生产同构的信创环境(同 CPU 架构、同 OS、同中间件、同数据库)
  • 传感器数量:不少于 10 台(含 2 台边界型号、1 台旧固件)
  • 网络:独立动环 VLAN,交换机支持端口镜像(抓包取证)

8.2 验收用例矩阵

A. 兼容性验收

编号

用例

方法

通过标准

A01

架构匹配

file/uname -m

ELF 架构一致,无 x86 二进制

A02

依赖完整

ldd 驱动.so

无 not found

A03

服务托管

systemctl start/enable/reboot

开机自启,状态 active

A04

防火墙

firewalld 放行规则

规则持久化,重启不丢

A05

数据库

达梦/金仓连接池

建连成功,中文无乱码

A06

中间件

TongWeb 部署

无异常,页面可访问

B. 功能验收

编号

用例

方法

通过标准

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

单位与命名

检查变量名

后缀带单位,中文别名无乱码

C. 边界值与异常注入

编号

注入

预期

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

服务器发零窗

超时释放,不死锁

D. 性能与压力

编号

场景

指标

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,无雪崩

E. 断网与一致性

编号

场景

通过标准

E01

拔网线 10min

边缘缓存,恢复后按 collect_ts 补传

E02

补传去重

平台无重复点、曲线无竖线

E03

NTP 偏差

节点与平台偏差 <1s

E04

双写冲突

同一时刻两路写,回读终值唯一且可追溯

F. 安全与审计

编号

场景

通过标准

F01

非白名单 IP 访问 502

被 ACL 拒绝

F02

未授权写

拒绝 + 审计留痕

F03

审计日志

字段完整,落达梦库,不可删改

F04

端口扫描

仅 502/1502 开放,其余关闭

F05

国密隧道(如采购)

SM4 隧道内 Modbus 正常收发

F06

等保条款核查

对应条款逐条有证据材料

8.3 验收指标汇总(合同可引用)

指标

门槛

采集成功率

≥99.5%

写回读一致率

100%

温度比对偏差

≤±0.3℃

湿度比对偏差

≤±2%RH

告警/质量位正确率

100%(用例全覆盖)

72h 无重大缺陷

无崩溃、无 fd/内存泄漏

审计完整率

100%

信创兼容性

矩阵内 100% 通过


九、交付物清单

  1. 接口规范书:通信参数、寄存器映射表、字节序/缩放约定、点表模板
  2. 驱动交付包:目标架构二进制 + 源码(或源码托管证明)+ 依赖清单 + CMakeLists
  3. 兼容性矩阵:OS/CPU/中间件/数据库 × 驱动版本,逐格标注"已验证"
  4. 点表文件:CSV/JSON,含 node_id / IP / Unit ID / 地址 / 类型 / 缩放 / 单位
  5. OPC UA 网关配置(若采用):NodeId 映射表、安全策略配置
  6. 测试用例集:A~F 六类用例 + 执行记录 + 截图/pcap 证据
  7. 审计报告样例:写操作审计导出样张 + 达梦审计策略配置
  8. 等保对应表:条款 → 实现 → 证据
  9. 压测报告:72h 曲线、fd/内存趋势、重连收敛时间
  10. 运维手册:驱动部署、点表变更、固件升级、回滚步骤

十、典型踩坑与规避

  1. 驱动只有 x86 DLL:ARM64 服务器上直接不可用 → 采购阶段锁"源码+多架构二进制"
  2. glibc 版本过高:麒麟 V10 SP1(glibc 2.28)跑不了依赖 2.34 的二进制 → 声明最低 glibc 并静态链接
  3. Java 驱动 JNI 漏移植:纯 Java 部分正常,本地串口/加密库段错误 → 要求 JNI 库按架构交付
  4. 达梦字符集 GB18030:点表中文名入库乱码 → 库与连接统一 UTF-8
  5. 火绒/SELinux 拦 bind:驱动起不来,报 Permission denied → 预置 policy 或 setcap
  6. 组态软件二次缩放:驱动 ×0.1 后画面又 ÷10 → 缩放责任边界写进规范
  7. 点表"以实物为准":两台固件偏移不同,验收翻车 → 点表逐字段锁死 + 固件版本绑定
  8. 防火墙放行但 SELinux 拦:现象与网络故障一模一样 → 验收用例单列 A04
  9. OPC UA 网关单点:网关挂了全平台离线 → 网关双机 + 断线缓存
  10. 审计只落文件不落库:等保测评不认 → 审计必须进国产库并开启库审计

十一、收尾

信创组态平台对接 Modbus TCP 温湿度变送器,难不在协议本身——Modbus TCP 三十年前就定型了;难在把协议嵌进一套国产底座里还能保持工业级确定性:

  • 兼容性上,驱动要跨 x86_64 / ARM64 / LoongArch 三大架构,跨麒麟、统信、欧拉,跨达梦、金仓、TongWeb
  • 通信上,长连接、分级超时、功能码白名单、异常分类,一条不能省
  • 数据上,点表逐字段锁死:地址、类型、字节序、缩放、质量位,杜绝"以实物为准"
  • 安全上,ACL、国密隧道、SM3 摘要、数据库审计,对着等保条款逐条落证据
  • 验收上,六类用例 A~F 从架构匹配一路打到异常注入和 72h 压测,每一项都有量化门槛

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 信创组态平台对接 Modbus TCP 温湿度变送器:接口规范与验收方案
    • 一、信创环境下对接为什么比"普通组态"难
    • 二、接口规范总体框架
    • 三、兼容性规范:先定矩阵,再谈对接
      • 3.1 目标环境声明(项目启动即锁定)
      • 3.2 驱动形态要求(写进采购条款)
      • 3.3 兼容性验证清单
    • 四、通信规范
      • 4.1 传输层
      • 4.2 协议层约束
      • 4.3 安全层(等保 2.0 + 国密)
    • 五、数据规范:点表是接口的核心交付物
      • 5.1 寄存器映射表(标准模板)
      • 5.2 字节序与数据类型约定
      • 5.3 缩放与单位
      • 5.4 质量位映射(平台必须实现)
    • 六、驱动接口规范
      • 6.1 组态平台侧驱动接口(IO 服务器)
      • 6.2 点表导入格式(统一 CSV/JSON)
      • 6.3 OPC UA 网关层(异构平台统一)
    • 七、安全与审计规范
    • 八、验收方案
      • 8.1 验收环境
      • 8.2 验收用例矩阵
      • 8.3 验收指标汇总(合同可引用)
    • 九、交付物清单
    • 十、典型踩坑与规避
    • 十一、收尾
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档