pymodbus库中read_coils()方法的位序问题解析

问题背景

在工业自动化领域，Modbus协议是最常用的通信协议之一。pymodbus作为Python实现的Modbus协议栈，被广泛应用于各种工业自动化项目中。近期在pymodbus 3.9.0版本中发现了一个关于read_coils()方法的重要问题：该方法返回的线圈状态位序出现了错误。

问题现象

当使用read_coils()方法读取多个线圈状态时，3.8.6版本返回的位序是正确的，而3.9.0版本则出现了字节内位序反转的问题。具体表现为：

• 设备实际线圈状态：true, false, true, false, true, true...
• 3.8.6版本返回：[True, False, True, False, True, True...]
• 3.9.0版本返回：[True, True, True, True, True, False...]

技术分析

根据Modbus应用协议1.1b规范第6.1节的规定，数据字节应该按照以下方式解析：

1. 从第一个字节开始顺序解析
2. 每个字节内部从最低有效位(LSB)开始解析

以实际设备返回的两个字节0xf5和0xff为例：

• 第一个字节0xf5(二进制11110101)应该解析为：true(1), false(0), true(1), false(0), true(1), true(1), true(1), true(1)
• 第二个字节0xff(二进制11111111)应该解析为：true(1), true(1), true(1), true(1), true(1), true(1), true(1), true(1)

问题根源

这个问题源于pymodbus 3.9.0版本中的一次代码变更(commit d47dc65)。该变更原本是为4.0版本准备的特性，其中位序将从LSB到MSB跨字节报告，但意外地被包含在了3.9.0版本中。

影响范围

该问题影响所有使用pymodbus 3.9.0版本进行线圈读取的应用。特别是那些依赖精确位序的自动化控制系统，可能会导致逻辑判断错误。

解决方案

项目维护者已经确认这是一个bug，并将在3.9.1版本中修复。同时，这个特性将被保留到4.0版本中作为正式功能。

临时解决方案

对于必须使用3.9.0版本的用户，可以采取以下临时解决方案：

1. 降级到3.8.6版本
2. 在应用层对读取结果进行位序调整
3. 等待3.9.1版本的发布

最佳实践建议

1. 在升级Modbus库版本时，务必进行充分的回归测试
2. 对于关键控制系统，考虑实现数据校验机制
3. 关注官方发布的版本更新说明
4. 对于新项目，可以考虑直接等待4.0稳定版的发布

这个问题提醒我们，在工业通信协议实现中，位序处理是一个需要特别注意的细节问题，任何微小的变更都可能对系统行为产生重大影响。