智能制造与工业软件 / 系统课时

将不同协议地址映射为标准点位

将不同协议地址映射为标准点位

同一台设备的温度与运行状态,可能分别来自 Modbus 寄存器和 OPC UA 节点。本课建立协议地址到业务点位的映射规则,统一类型、单位与标识,使下游在设备改地址或 OPC UA 索引变化后仍能识别同一个测点。

学习目标

  • 为设备和测点制定稳定的 deviceId、pointCode 与 pointId。
  • 正确解释 Modbus 寄存器偏移与 OPC UA 节点身份,并确定类型及单位。
  • 运行归一化示例,验证比例换算、布尔值和错误输入的处理方式。

先定义不会随连接变化的业务身份

以产线上的 Machine01 为例,设备身份不使用 IP、网关连接名或 OPC UA 节点地址。建议使用全厂唯一的 deviceId,再为设备内部每个测点分配唯一且稳定的 pointCode。两者组成 pointId,例如 Machine01.temperature。

标准点位 业务含义 标准类型 单位
Machine01.temperature 设备温度 float °C
Machine01.running 设备是否运行 bool 无

点位编码表达业务含义,尽量不包含寄存器号或协议名。现场设备从 Modbus 改接 OPC UA 时,只修改来源映射,不改变 pointId;若传感器含义从轴承温度变为炉膛温度,则应新建点位,不能复用旧编码掩盖语义变化。

把协议定位信息和解码规则成对保存

映射表至少记录连接器标识、协议地址、原始类型、转换规则、标准点位和单位。以下是教学示例,地址与类型均须以真实设备点表核对。

来源 协议定位 解码与映射
Modbus,mb-m01 功能码 03,Holding 寄存器 PDU 偏移 0 按有符号 16 位整数解释,乘 0.1,映射 Machine01.temperature
OPC UA,ua-line-a 命名空间 URI urn:example:line-a;字符串标识符 Machine01.Running 按 Boolean 读取,映射 Machine01.running

Modbus 设备手册常把第一个 Holding 寄存器标为 40001,但功能码 03 的请求地址从 0 开始;部分手册使用另一套编号,不能直接将纸面编号作为请求偏移。单寄存器是 16 位,若点表注明 Float32,还必须规定连续两个寄存器的字序,不能套用这里的整数换算。

OPC UA 的 ns=2;s=Machine01.Running 中,2 是当前服务端 NamespaceArray 的索引,不是持久业务键。连接或重连时,用已配置的命名空间 URI 查出当前索引,再组合字符串标识符定位节点;标识符及 URI 均需保留大小写。

看清两路原始值如何变成统一点位

Modbus 与 OPC UA 源地址归一化为标准点位的数据流

建议将映射配置与实时采样分离:采集器负责得到原始值,映射器负责定位、解码和生成标准字段,发布器再附加采样时间与质量状态。这样换驱动或修改设备 IP 时,不需要改写消费者对 pointId 的查询逻辑。

运行一个可验证的归一化示例

以下 Python 3 示例使用模拟采样值,不连接真实 PLC 或 OPC UA 服务器。字典键是本项目定义的“连接器标识+源定位”;它不是任何协议库的内置 API。

python
import json

# 用连接器标识与源地址定位,避免把 IP 写进业务主键
MAPPINGS = {
    ("mb-m01", "holding", 0): {
        "deviceId": "Machine01", "pointCode": "temperature",
        "valueType": "float", "unit": "°C", "decode": "int16_x0.1",
    },
    ("ua-line-a", "urn:example:line-a", "Machine01.Running"): {
        "deviceId": "Machine01", "pointCode": "running",
        "valueType": "bool", "unit": None, "decode": "boolean",
    },
}

def normalize(source_key, raw):
    cfg = MAPPINGS[source_key]  # 未登记的地址必须报错,不可默认为 0
    if cfg["decode"] == "int16_x0.1":
        if type(raw) is not int or not 0 <= raw <= 65535:
            raise ValueError("Modbus 寄存器值必须为 0..65535 的整数")
        # 将16位寄存器内容按有符号二进制补码解释
        signed = raw - 65536 if raw >= 32768 else raw
        value = round(signed * 0.1, 1)
    else:
        if type(raw) is not bool:
            raise ValueError("OPC UA 运行状态必须是布尔值")
        value = raw
    return {
        "pointId": f'{cfg["deviceId"]}.{cfg["pointCode"]}',
        "deviceId": cfg["deviceId"],
        "pointCode": cfg["pointCode"],
        "value": value,
        "valueType": cfg["valueType"],
        "unit": cfg["unit"],
    }

# 模拟驱动读到的原始值,不需要连接真实设备
samples = [
    (("mb-m01", "holding", 0), 253),
    (("ua-line-a", "urn:example:line-a", "Machine01.Running"), True),
]
for source_key, raw in samples:
    print(json.dumps(normalize(source_key, raw), ensure_ascii=False))

预期输出:

text
{"pointId": "Machine01.temperature", "deviceId": "Machine01", "pointCode": "temperature", "value": 25.3, "valueType": "float", "unit": "°C"}
{"pointId": "Machine01.running", "deviceId": "Machine01", "pointCode": "running", "value": true, "valueType": "bool", "unit": null}

用边界测试避免映射静默出错

核对映射时至少执行三项测试:把示例温度原始值 253 换成 65286,应得到 -25.0 °C,验证有符号解码;把运行状态 True 换成整数 1,应抛出 ValueError,不能让 Python 将整数和布尔值混用;把寄存器偏移 0 换成 1,应产生 KeyError,不能误写到邻近测点。

上线时还要检查同一 deviceId + pointCode 是否被两个有效来源同时写入。如果存在 Modbus 与 OPC UA 双路采集,明确主备优先级和切换条件;不要仅靠“最后到达的值”覆盖。映射配置应有版本并持久保存,重连后重新解析 OPC UA 的命名空间索引,复查点位的数据类型、单位及量程,再恢复发布。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将不同协议地址映射为标准点位

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通