ModbusTCP调试主从地址和数据块

Modbus TCP 调试的第一步不是写值，而是确认双方对“谁主动、谁提供数据、哪个地址对应哪个信号”有完全相同的理解。

Modbus 中的 client/master 负责发起请求，server/slave 负责响应。工具里经常直接使用 Master 或 Slave 名称，工程配置里又有主从、使能和转发节点，几套术语叠在一起很容易把角色配反。先画一张最小链路图：请求方、网络接口、端口、单元标识、目标数据区和被测控制器，确认每一步都由谁驱动。

地址是第二个高发点。线圈、离散输入、保持寄存器和输入寄存器属于不同数据区，读写功能码也不同。设备手册可能采用从 1 开始的编号，而实际报文常用从 0 开始的偏移；看到 40001 之类的文档编号时，尤其要确认需要填的是协议偏移还是表格编号。地址偏移错一位，读到的是相邻变量，数值有时甚至看起来“合理”。

先用一条单寄存器请求做闭环。写一个容易识别的测试值，在请求方、总线报文和接收端独立回读三个位置同时确认。再扩大到连续数据块，检查起始地址、数量、跨区边界和每个变量的数据类型。对 32 位整数或浮点数，还要确认字序和字节序。数组不是一串互不相关的标量，数量写错可能会覆盖相邻设备的数据。

若网络能连通但数据不刷新，检查事件任务、轮询周期、数据使能和共享内存映射。若只有一部分地址可读，检查数据块边界而不是反复更换 IP。若写入后马上恢复旧值，检查是否有另一主站或控制任务在持续覆盖。

测试记录应保存角色、端口、单元标识、功能码、起始地址、数量、数据格式、写入值、原始报文和接收端结果。敏感网络参数只需在受控交付资料中记录，不应出现在公开文章或截图里。

Modbus TCP 看似只是地址表，实际是对角色、数据模型和时间行为的一次端到端约定。把约定写清楚，调试才能从“试地址”变成可复现的协议验证。