【EdgeHub·03】WebAPI、MQTT与Modbus出口怎么选
把数据送到已有系统,而不是要求项目全部重建
很多项目已经有 MES、能源平台或传统上位机,新增采集层的价值在于让这些系统用上现场数据。WebAPI 适合业务软件按需查询,MQTT 适合消息分发,北向 Modbus TCP 则让只支持寄存器读取的既有系统继续工作。EdgeHub 将这些出口建立在统一变量之上,减少多套软件分别访问设备。
例如产线运行状态同时进入操作画面和 MES,能源累计量进入报表,关键报警触发 Flow 处理。数据出口可以不同,设备身份、单位与时间含义仍需一致。团队可以围绕现有系统选择连接方式,逐步增加应用,不必先替换整套业务软件。
设备接入完成后,下一步往往是三个不同要求:MES要主动查询,消息平台要接收变化,老上位机只会读Modbus寄存器。若每个系统都重新连接PLC,通讯配置和点位解释就会重复维护。
EdgeHub提供WebAPI、实时订阅、MQTT转发与北向Modbus等出口。合理的选择取决于消费方式、数据含义和维护团队,而不是哪一种协议名字更新。
先问上层系统怎样使用数据
| 上层需求 | 优先评估的出口 | 对接前需要确认 |
|---|---|---|
| 打开设备详情页时读取状态 | WebAPI快照 | 点名、认证、逐点结果和更新时间 |
| 业务页面随变化刷新 | 实时订阅或MQTT | 订阅范围、断连恢复、初始值和消息格式 |
| 企业已有MQTT消息基础设施 | MQTT转发 | Broker权限、主题、负载字段与重连行为 |
| 老系统只接受寄存器读取 | 北向Modbus TCP | 地址映射、数据类型、字节顺序和访问网络 |
| 报表读取一个历史区间 | 历史查询接口或已配置的数据源 | 归档条件、时区、范围限制和缺测 |
这张表描述的是起步方向,不能把“支持MQTT”推导为所有云平台报文无需适配。也不要用当前值订阅代替必须逐条保存的生产事件。
WebAPI:让应用从业务点名开始
对已有Web后端的团队,快照接口通常是容易核对的起点。客户端先认证、确认元数据,再提交需要的tagName;检查每个结果的success、value、quality、timestamp和error。快照读取网关当前缓存,不会因为网页刷新就强制PLC重新采样。
请求可以同时包含多个点,但仍需遵守单次限制并处理部分失败。一个温度读取成功、另一个点位停用时,页面不能把整个响应统一渲染为“全部正常”。服务端接口访问权限与MES内部设备权限也不是同一层,业务后端仍需限制用户能看哪些设备。

图:既有演示界面。开发者先在网关核对数据,再比较接口结果,能够减少把通讯问题归因于前端代码的情况。
实时值、元数据单位和业务设备编号可以在自己的服务中组合。例如,API结果中返回温度点名和值,元数据提供℃,MES映射表提供工位编号。不要假设每一个接口响应都携带同样完整的字段。
MQTT:把连接问题和消息处理分开
MQTT适合让已有消息系统持续消费设备数据。联调时先订阅一个测试主题,保存一份脱敏负载,确认里面的值类型、点名、时间和质量,再编写消费者。主题名与负载应以实际配置和当前版本为准,不从文章示例猜测生产Topic。
| 检查层 | 要回答的问题 | 留下什么证据 |
|---|---|---|
| 连接 | 网关是否连接到正确Broker | 节点与Broker连接状态 |
| 订阅 | 消费者是否订阅了授权主题 | 一个测试点的实际消息 |
| 解析 | 类型、单位和时间是否解释正确 | 原始消息与业务转换结果 |
| 恢复 | 重连后能否识别重复、缺口和最新状态 | 断开前后记录及消费者处理日志 |
协议QoS与企业业务只处理一次并不是同一个保证。业务可能在“已写数据库、未确认消息”之间中断,消费者需要自己的幂等和状态记录。平台可靠上报到IoT的特定链路,也不能直接等同于任意MQTT消费者的投递承诺。
Modbus:为老系统提供明确的寄存器合同
老上位机需要寄存器而不是JSON时,可以评估北向Modbus映射。要把每个业务点映射到明确的寄存器地址、类型、顺序与倍率,再核对服务启用和重启要求。北向地址是对外合同,不必与原始PLC地址相同。
例如,压力可约定以整数720表示720 kPa,或以浮点0.72表示MPa;两种都能用于项目,但双方必须一致。一个值能正常读出,不表示消费者同时知道数据质量和时间。如果老系统需要这些信息,应另外设计状态寄存器或辅助接口,并说明这是项目设计,不是默认自动生成。
优先完成只读路径。允许北向写入时,需要明确哪些映射可写、谁能访问网络、如何记录和核对现场反馈。Modbus与WebAPI的认证能力不同,不能认为WebAPI账号设置会自然保护所有协议入口。
一个同时服务新MES和老上位机的组合
设想项目保留老上位机,同时新建MES设备页。可以让EdgeHub接入一组代表点,MES通过快照读取,老上位机读取北向映射,企业消息平台按需消费MQTT。三条出口分别联调,不需要为了统一技术而先重写所有消费系统。
检查同一压力值时,先固定测试输入,再分别记录API原始结果、MQTT实际负载和Modbus读取结果。将它们还原到同一单位后比较;时间不同造成的差异要按源时间解释,不强求三个独立请求在任意时刻都得到完全相同的瞬时值。
项目合同还应写明停用点位后的行为。JSON可以保留错误和质量字段,Modbus消费者可能只看到数值,因此后者需要约定额外状态或其他故障识别方式。没有状态通道时,应在接入设计中明确这一限制,而不是让老系统长期使用最后一次正常值却不知情。
这类方案体现的是平台的适配价值:设备通讯集中维护,上层系统按自己的能力消费数据。后续替换其中一个应用时,可以先验证新的出口消费者,保留其他系统已确认的接入方式。
多出口共用,仍然只维护一份含义
同一压力点可能在SCADA显示0.72 MPa、MQTT负载保留原值与单位、Modbus使用整数倍率。共享数据来源不意味着每条传输格式一样,需要的是可追踪的转换约定。
交付时给出“业务点 → 网关点名 → 各出口表达 → 消费者字段”的映射,附一个正常值、一个不可用状态和一个恢复场景。新增系统时先沿这张表接入,减少反复猜测地址与单位。IndustrialSphere提供设备侧与通用出口,团队继续掌握自己产品的业务模型和应用界面。
技术交流
IndustrialSphere 围绕设备连接、数据管理与工业应用,分享产品能力、设计思路和应用实践。
欢迎加入 IndustrialSphere 技术交流群,交流设备采集、SCADA、流程编排、大屏报表及 MES / MOM 集成等项目中的技术问题与应用方案。
QQ群:1128988613
本系列阅读目录
- 【EdgeHub·01】总览与目录:设备采集与开放接口
- 【EdgeHub·02】PLC点表、类型与字节序联调
- 【EdgeHub·03】WebAPI、MQTT与Modbus出口怎么选
- 【EdgeHub·04】实时、历史与补传队列的边界
- 【EdgeHub·05】一份点表贯通采集、组态与MES
- 【EdgeHub·06】MES接入:采集层与业务层如何分工
- 【EdgeHub·07】数据质量、时间戳与断线补传
- 【EdgeHub·08】开放数据服务:让自研应用连接现场设备
- 【EdgeHub·09】历史趋势:从运行变化到异常追溯
- 【EdgeHub·10】设备写入:权限、回读与执行确认
- 【EdgeHub·11】自定义协议接入:让特殊设备复用整套工业应用
- 【EdgeHub·12】跨平台与持续运行:怎样选择现场网关部署方式
浙公网安备 33010602011771号