夕雅落1. 为什么放弃QModbusTcpClient？
最近在工业控制项目里遇到个头疼的问题——需要把原来的Modbus RTU通讯改成TCP协议。作为Qt开发者，第一反应当然是使用官方提供的QModbusTcpClient类。毕竟官方库用起来应该最省事对吧？结果现实给我狠狠上了一课。
读取数据倒是没问题，但只要执行写操作（比如writeCoil或writeRegister），TCP连接就会立即断开。我一开始怀疑是下位机的问题，但用Modbus Slave模拟器和专业的ModbusPoll工具测试都正常。于是我用Wireshark抓包对比发现：QModbusTcpClient发出的写请求报文格式根本不符合标准协议！多出来的那些字节直接把设备搞懵了。
更让人崩溃的是，网上能找到的Qt ModbusTCP示例代码全都有同样的问题。经过三天三夜的调试，我最终决定：既然官方库不靠谱，那就用QTcpSocket从零实现ModbusTCP协议！
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. ModbusTCP协议深度解析
2.1 协议帧结构剖析
ModbusTCP协议其实就是在TCP协议基础上包装了一层简单的应用层协议。一个标准的请求报文包含7字节的MBAP头（Modbus Application Protocol header）和后续的PDU（Protocol Data Unit）：
code复制[事务标识符 2字节][协议标识符 2字节][长度 2字节][单元标识符 1字节][功能码 1字节][数据 N字节]
关键字段说明：
- 事务标识符：用于匹配请求和响应，通常简单递增即可
- 协议标识符：ModbusTCP固定为0x0000
- 长度字段：从单元标识符开始计算后续所有字节数
- 单元标识符：相当于设备地址，TCP模式下通常用0xFF
2.2 功能码实现要点
最常用的四种写操作功能码：
- 0x05 写单个线圈
- 0x0F 写多个线圈
- 0x06 写单个寄存器
- 0x10 写多个寄存器
每个功能码对应的请求/响应格式都有细微差别。比如写多个线圈时，需要先把布尔数组压缩成字节数组，这个转换过程最容易出错。我在实现writeCoils()时就踩过坑——字节序处理和位序排列需要特别注意。