PyModbus数据块初始化中的地址偏移问题解析

概述

在使用PyModbus库时，开发者可能会遇到一个看似奇怪的现象：当使用ModbusSequentialDataBlock初始化数据块时，如果起始地址设置为0，实际读取时会发现第一个值被"跳过"了。这种现象并非bug，而是PyModbus设计上的一个特性，源于Modbus协议的历史实现方式。

问题现象

当开发者按照如下方式初始化数据块：

from pymodbus.datastore import ModbusSlaveContext, ModbusSequentialDataBlock

store = ModbusSlaveContext(
    hr=ModbusSequentialDataBlock(0, list(range(1, 11)))  # 10个保持寄存器
)

register_values = store.getValues(3, 0, 10)  # 功能码3表示读取保持寄存器

预期输出应该是[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]，但实际得到的却是[2, 3, 4, 5, 6, 7, 8, 9, 10]，第一个值1被跳过了。

原因分析

这种现象源于PyModbus内部的一个设计决策。在ModbusSlaveContext.getValues()方法中，会对请求的地址进行+1处理：

def getValues(self, fc_as_hex, address, count=1):
    address += 1  # 这里将所有访问地址向前偏移1
    return self.store[self.decode(fc_as_hex)].getValues(address, count)

这种偏移导致：

• 请求寄存器0实际上会访问寄存器1
• 初始化数据块的最后一个寄存器可能无法被访问到

历史背景

这种设计源于Modbus协议的历史实现方式。在Modbus协议中，不同类型的寄存器（如线圈和保持寄存器）有不同的地址空间和访问方式。特别是线圈寄存器，它们按位寻址但按寄存器存储（一个寄存器包含16个线圈），这导致了地址映射上的复杂性。

解决方案

正确初始化方式

为了避免这种偏移问题，正确的做法是在初始化数据块时使用1作为起始地址：

store = ModbusSlaveContext(
    hr=ModbusSequentialDataBlock(1, list(range(1, 11)))  # 从地址1开始
)

使用模拟器数据块

PyModbus提供了ModbusSimulatorContext，它的行为更符合直觉，不会出现这种偏移问题。对于新项目，可以考虑使用这个替代方案。

最佳实践

1. 始终从地址1开始初始化：除非有特殊需求，否则建议总是从地址1开始初始化数据块。

2. 注意数据块大小：由于地址偏移，确保你的数据块足够大以覆盖所有可能的请求地址。

3. 文档参考：仔细阅读PyModbus文档中关于地址映射的部分，理解不同类型寄存器的寻址方式差异。

4. 测试验证：在开发过程中，编写测试用例验证寄存器访问是否符合预期。

总结

PyModbus中的这种地址偏移行为虽然初看起来有些奇怪，但有其历史和技术原因。理解这一特性后，开发者可以通过正确的初始化方式避免问题。对于新接触PyModbus的开发者来说，建议从地址1开始初始化数据块，或者考虑使用模拟器数据块来获得更直观的行为。