PyModbus 3.9.0版本中read_coils()方法的位序问题解析

问题背景

PyModbus是一个广泛使用的Python Modbus协议实现库。在3.9.0版本中，用户报告了一个关于read_coils()方法返回位序不正确的问题。这个问题在3.8.6版本中表现正常，但在3.9.0版本中出现了异常。

问题现象

当读取从地址0x100开始的线圈状态时：

• 3.8.6版本返回正确的位序：[True, False, True, False, True, True...]
• 3.9.0版本返回错误的位序：[True, True, True, True, True, True...]

实际设备返回的数据是0xf5和0xff两个字节，按照Modbus协议规范，应该从第一个字节的最低有效位(LSB)开始解析。

技术分析

Modbus协议规范

根据Modbus应用协议1.1b文档第6.1节规定：

1. 数据字节应按顺序解析，从第一个字节开始
2. 每个字节内的位应从最低有效位(LSB)开始解析

问题根源

问题出现在commit d47dc65a7995a19e9d004318ff7b050d8f82f2a5中，这个提交修改了位序处理逻辑。在3.9.0版本中，实现方式与协议规范不符，导致字节内的位序被错误处理。

影响范围

这个问题影响所有使用PyModbus 3.9.0版本读取线圈状态的应用程序。特别是那些依赖精确位序的应用可能会受到严重影响。

解决方案

项目维护者已经确认这是一个bug，并计划在3.9.1版本中修复。值得注意的是，这个修改实际上是计划在4.0版本中实现的功能，其中位序将按照从LSB到MSB的方式跨字节报告。

开发者建议

对于受此问题影响的开发者：

1. 暂时可以回退到3.8.6版本
2. 等待3.9.1版本的发布
3. 如果必须使用3.9.0版本，可以考虑在应用层对读取结果进行位序调整

总结

这个案例提醒我们，在升级库版本时需要特别注意协议实现的变更。即使是看似微小的位序变化，也可能对应用程序的正确性产生重大影响。开发者在使用PyModbus时应当充分测试线圈读取功能，确保位序符合预期。

对于Modbus协议实现来说，位序处理是一个需要特别注意的细节，不同的设备厂商可能有不同的实现方式，因此在开发Modbus相关应用时，充分理解协议规范和实际设备行为非常重要。