4. 设备连接与协议适配

在 ThingWorx 边缘网关中，设备接入并不是“把线插上”就结束，而是要把现场设备的通信协议、数据语义和平台的数据模型三者对齐。现场设备可能使用 Modbus RTU/TCP、OPC UA、MQTT 等不同协议，每种协议在寻址方式、数据类型、连接参数和会话机制上都有差异。边缘网关的作用，就是把这些差异屏蔽掉，向上以统一的 ThingWorx 数据模型暴露设备属性、事件和服务。

本节围绕三个核心动作展开：协议接入、设备模板配置、数据点映射与连接测试。理解这三者的关系，比记住某个界面的按钮位置更重要。

一、协议接入：先看“怎么连”，再看“连什么”

Modbus 是最常见的现场总线协议之一，分为 RTU（串口）和 TCP（以太网）两种形态。接入时首先要确认物理层参数：RTU 需要串口号、波特率、数据位、停止位、校验位，例如 COM3, 9600, 8, 1, None；TCP 则需要 IP 和端口，默认 502。Modbus 的寻址以“从站地址 + 功能码 + 寄存器地址”为核心，常见功能码包括 03（读保持寄存器）、04（读输入寄存器）、06（写单个寄存器）、16（写多个寄存器）。需要注意的是，很多设备手册给出的地址是从 1 开始的“逻辑地址”，而协议帧中使用的是从 0 开始的“物理地址”，两者通常相差 1，配置时必须确认清楚。

OPC UA 的接入方式与 Modbus 不同。它不直接暴露寄存器，而是通过信息模型暴露节点（Node），每个节点有 NodeId、BrowseName、DataType 等属性。接入时需要填写 Endpoint URL，例如 opc.tcp://192.168.1.50:4840，并选择安全策略和用户身份。OPC UA 的优势在于语义清晰、支持复杂数据类型和订阅机制，适合数控机床、高端控制器等设备。

MQTT 则是一种轻量级的发布/订阅协议，适合传感器、远程 IO 等低带宽场景。接入参数包括 Broker 地址、端口（通常 1883 或 8883）、ClientId、用户名密码、KeepAlive 以及 Topic 订阅列表。MQTT 的数据点映射通常基于 Topic 和 Payload 格式，例如 factory/line1/temp 对应温度值，Payload 可能是 JSON 或纯数值。

二、设备模板配置：定义“设备长什么样”

设备模板是 ThingWorx 中设备类型的抽象定义，它规定了这类设备有哪些属性（Property）、事件（Event）和服务（Service）。例如，为一个“温度变送器”定义模板时，可以包含属性 temperature（Number，单位 ℃）、status（String）、事件 HighTemperatureAlarm、服务 reset。模板配置的关键在于：属性名要稳定、数据类型要准确、单位要统一，否则后续映射和展示都会出问题。

模板配置完成后，每个具体设备通过“Thing 实例”来体现，实例继承模板的属性、事件和服务，并绑定具体的协议连接参数和数据点映射。这样，同一类设备只需要维护一个模板，新增设备时只需创建实例并填写地址信息，大幅减少重复配置。

三、数据点映射：把“地址”翻译成“属性”

数据点映射是协议接入中最容易出错、也最需要细心的一步。它的本质是建立“协议地址”与“ThingWorx 属性”之间的对应关系，并处理数据类型转换、缩放、字节序等问题。

以 Modbus 为例，假设 PLC 的保持寄存器 40001 存放温度值，实际温度 = 寄存器值 × 0.1，单位 ℃。映射配置可以写成：

属性名: temperature
协议地址: 40001 (功能码 03, 从站地址 1)
数据类型: INT16
缩放系数: 0.1
偏移量: 0
单位: ℃
读写权限: 只读

如果寄存器值读到 253，则实际温度为 25.3 ℃。若设备使用浮点数，还需要注意字节序（大端/小端）和寄存器顺序（高低字交换），否则会出现“数值完全不对”的情况。OPC UA 的映射相对简单，直接选择 NodeId 并指定属性名即可，但要注意 DataType 是否匹配。MQTT 的映射则需要解析 Payload，例如 JSON 中的 {"temp": 25.3, "hum": 60}，可以分别映射到 temperature 和 humidity 两个属性。

四、连接测试：用“读值”验证链路是否打通

配置完成后，必须进行连接测试。测试的目标不是“看到界面变绿”，而是确认三件事：协议层能通信、数据点能读到正确值、写入操作能生效。

对于 Modbus，可以先使用网关自带的诊断工具或第三方 Modbus Poll 工具，直接读取寄存器，确认物理链路和从站地址正确。然后在网关中触发一次属性读取，观察返回值是否与预期一致。如果读不到，依次检查：串口是否被占用、IP 端口是否可达、从站地址是否正确、功能码是否匹配、寄存器地址是否偏移。

对于 OPC UA，重点检查 Endpoint 是否可达、安全策略是否匹配、用户权限是否足够。对于 MQTT，重点检查 Broker 连接状态、Topic 是否订阅成功、Payload 格式是否与映射一致。连接测试通过后，还应该做一次“断线重连”测试：拔掉网线或重启设备，观察网关是否能自动恢复连接并继续上报数据。

五、常见问题与判断依据

实际接入中，最常见的问题包括：读到的值始终为 0、数值明显偏大或偏小、数据跳变、写入无效。值始终为 0 通常说明地址错误或功能码不匹配；数值偏大偏小多半是缩放系数或字节序问题；数据跳变可能是寄存器被其他逻辑占用或轮询周期过短；写入无效则要检查权限、功能码以及设备是否处于远程可写状态。判断时，先用独立工具确认设备侧数据，再回到网关侧排查映射和模板配置，可以避免在错误的方向上浪费时间。

协议接入、模板配置、数据点映射和连接测试是一个整体：协议决定“怎么连”，模板决定“连成什么”，映射决定“连到哪”，测试决定“连得对不对”。四者环环相扣，任何一环出错，都会表现为“设备连不上”或“数据不对”。掌握这套方法后，面对不同品牌、不同协议的设备，都能按同样的思路快速完成接入。