接入一台 Modbus TCP 设备
以内置的灌装产线 PLC 为例,从添加 Modbus TCP 设备、设置站号与字节序,到用调试工具读出真实寄存器值并排错。
视频教程 · 灵犀·Studio 从入门到精通 · 第 3 集 6:14
接入第一台 PLC:Modbus TCP 实战
你将完成
读完本篇你将完成:
- 添加一台 Modbus TCP 设备并正确设置站号、字节序等专属参数;
- 看懂地址写法(
0、x=2;0、x=4;100、s=2;0),知道它们对应哪个寄存器区、哪个功能码; - 用调试工具直连设备读出寄存器值,并对照报文排错。
开始之前
- 已完成添加设备,知道分组、下发的基本操作;
- 有一台 Modbus TCP 设备。没有实物时,可以用内置仿真产线:采集系统 → PLC 模拟器 里的灌装产线 PLC,地址
host.docker.internal,端口15022。
Modbus 的四个数据区#
Modbus 设备的数据分四个区:线圈、离散输入、保持寄存器、输入寄存器。本产品不使用 40001、30010 这类传统地址,而是直接写起始地址,需要切区时在地址前面加 x= 前缀:
| 本产品写法 | 数据区 | 传统地址 | 功能码 | 读写 |
|---|---|---|---|---|
0(bool 点位) | 线圈 | 00001 起 | 01 读,05 / 0F 写 | 读写 |
x=2;0 | 离散输入 | 10001 起 | 02 读 | 只读 |
0(word 点位) | 保持寄存器 | 40001 起 | 03 读,06 / 10 写 | 读写 |
x=4;0 | 输入寄存器 | 30001 起 | 04 读 | 只读 |
同一个地址 0,点位数据类型是 bool 就读线圈,是 ushort / short 等字类型就读保持寄存器。换算传统地址时去掉区号再减一:40010 即「地址从 0 开始」为「是」时的 9。
地址前面还可以带更多前缀:s=2;0 表示这一条用站号 2 去读,format=DCBA;0 表示这一条按 DCBA 字节序解析,x=7;w=8;0 表示读用功能码 7、写用功能码 8,100.1 表示读保持寄存器 100 的第 1 位。
添加设备#
打开对话框并选择协议#
按添加设备的操作打开对话框。协议保持默认的 常规 Modbus-TCP 客户端(DeviceType ModbusTcpClient),默认端口 502。
设置 Modbus 专属参数#
协议卡片下方有四个 Modbus 参数:
| 参数 | 说明 | 默认值 |
|---|---|---|
| 站号 | 设备标识符,0–255,需与设备侧一致 | 1 |
| 地址从 0 开始 | 绝大多数设备从 0 开始;少数设备从 1 开始(即 40001 对应地址 0)时选「否」 | 是 |
| 高低字节排列顺序 | 4 字节及以上类型(int / uint / long / ulong / float / double)的字节排列,需与设备一致 | CDAB |
| 字符串两两字节颠倒 | 解析 string 类型时是否按两字节交换 | 否 |
- 1站号
- 2地址起点
- 3字节顺序
字节序以设备手册为准
不同厂家的 32 位数据排列习惯不同。填错时单寄存器(16 位)读数正常,32 位数据读出来是完全不合理的值。拿不准时先用调试工具读一个已知值试出正确排列。
填 IP、端口并保存#
以内置仿真设备为例:设备名称 灌装测试,IP host.docker.internal,端口 15022,站号 1。点 测试连接 验证握手,成功后 添加设备,再点顶栏 下发。
用调试工具读值#
设备下发后,用调试工具直连它读寄存器,不需要先配点位:
新建调试连接#
打开 采集系统 → 调试工具,默认进入 PLC 调试。点 新建调试,在弹窗里确认协议为常规 Modbus-TCP 客户端,填 IP、端口、站号(与设备一致),点 建立连接。
- 1填 IP
- 2填端口
- 3点击连接
会话 10 分钟无操作自动断开
为避免长期占用设备资源,调试会话在 10 分钟无读写后自动关闭;读写操作会自动续期。
读一个保持寄存器#
连接成功后进入 临时读写 页签:地址填 0,数据类型选 ushort,点 读取。以内置灌装产线为例,读到当前瓶数 45,报文区可以看到原始帧:
REQ 00 03 00 00 00 06 01 03 00 00 00 01
RSP 00 03 00 00 00 05 01 03 02 00 2D
帧里的 01 03 就是「站号 1、功能码 03」,00 00 是起始地址 0,00 01 是读 1 个寄存器;应答里的 00 2D 就是十六进制的 45。
再读线圈与输入寄存器#
把地址换成 x=1;0、数据类型 bool,读到启动命令 False(帧里功能码为 01);换成 x=4;100、数据类型 ushort,功能码变为 04(输入寄存器)。三个区都读通,这台设备的地址体系就验证完了。
- 1填地址 0
- 2点击读取
- 3读到的值与原始报文(REQ/RSP 帧)都在这里
预期结果
三个数据区都能读出值、报文的站号与功能码与预期一致,说明 IP、端口、站号、地址体系全部正确。接下来就可以放心配置采集点位,把需要长期采集的地址建成点位。
关于合并读取
为减少通讯次数,采集引擎默认会把地址相邻的点位合并成一次读。平台内置的仿真设备为规避仿真器的边界问题将合并读取关闭、按逐点读取运行;合并与否不影响点位地址写法,也不需要在设备表单里设置。
常见问题#
读设备一直超时,通信列显示失败#
先确认 IP、端口、站号与设备侧一致;用调试工具直连排除平台配置问题——调试工具连不上就是网络或设备侧的问题(防火墙、Modbus TCP 服务未开启、网线网段)。建连超时默认 2000 ms,高延时链路(4G DTU 等)可调大。
值总是差一个地址(读到 40011 的数)#
「地址从 0 开始」与设备约定不符。设备的 40001 对应地址 0 时选「是」;设备把 40001 当第一个地址(从 1 开始)时选「否」,改完下发。
16 位值正常,32 位值(float / int)完全不对#
字节序不匹配。用调试工具给同一个地址加前缀试:format=ABCD;0、format=CDAB;0、format=BADC;0、format=DCBA;0,哪个读出的值符合预期,就把设备参数里的「高低字节排列顺序」改成对应项。
报错 Data read out of bounds#
读的地址超出了设备实际开放的点表范围。核对设备手册里该数据区的最大地址;内置仿真设备的点表范围较小,读高位地址会触发此错。
下一步#
这篇文档对你有帮助吗?