用Python构建Modbus从站模拟器的全流程指南
在工业自动化领域，Modbus协议因其简单可靠而成为设备通信的事实标准。许多工程师习惯使用商业软件如Modbus Slave进行测试，但这类工具往往价格昂贵，导致部分用户转向非授权版本。其实，借助Python生态中的PyModbus库，我们可以轻松构建功能完整的虚拟从站，不仅完全合法，还能根据项目需求灵活定制。
1. 环境准备与基础概念
Modbus协议诞生于1979年，最初为PLC通信设计，如今已发展出RTU、ASCII和TCP三种主要变体。无论哪种形式，其核心都是主从架构下的寄存器读写机制。作为从站模拟器，我们需要实现以下基础功能单元：
- 线圈（Coils）：1位可读写布尔值，常用于表示开关状态
- 离散输入（Discrete Inputs）：1位只读布尔值，模拟传感器输入
- 保持寄存器（Holding Registers）：16位可读写数值，存储设备参数
- 输入寄存器（Input Registers）：16位只读数值，反映实时测量值
安装所需环境仅需两条命令：
pip install pymodbus==3.1.3 pip install pyserial==3.5 # 如需RTU模式需额外安装提示：建议使用Python 3.8+环境，某些旧版本可能存在兼容性问题。虚拟环境能有效隔离依赖，避免与其他项目冲突。
2. 构建基础从站服务器
我们先从TCP模式的从站实现开始，这是最易上手的方式。以下代码创建了一个包含所有四种数据类型的从站：
from pymodbus.server import StartTcpServer from pymodbus.datastore import ModbusSequentialDataBlock from pymodbus.datastore import ModbusSlaveContext, ModbusServerContext def run_server(): # 初始化数据存储 coils = ModbusSequentialDataBlock(0, [False]*100) # 100个线圈 inputs = ModbusSequentialDataBlock(0, [True]*100) # 100个离散输入 hr = ModbusSequentialDataBlock(0, [0]*100) # 100个保持寄存器 ir = ModbusSequentialDataBlock(0, [0]*100) # 100个输入寄存器 # 创建从站上下文 slave_context = ModbusSlaveContext( di=inputs, co=coils, hr=hr, ir=ir, zero_mode=True # 地址从0开始计数 ) # 注册到服务器上下文 context = ModbusServerContext(slaves={1: slave_context}, single=False) # 启动TCP服务器 StartTcpServer(context=context, address=("0.0.0.0", 502)) if __name__ == "__main__": run_server()启动后，这个服务会监听502端口（Modbus TCP标准端口），响应单元ID为1的所有请求。我们可以使用Modbus Poll等主站工具进行测试：
| 功能码 | 地址范围 | 操作类型 | 示例值 |
|---|---|---|---|
| 01 | 0-99 | 读线圈 | 0x0001 |
| 02 | 0-99 | 读离散输入 | 0x0000 |
| 03 | 0-99 | 读保持寄存器 | 0x1234 |
| 04 | 0-99 | 读输入寄存器 | 0x5678 |
| 05 | 0-99 | 写单个线圈 | 0xFF00 |
| 06 | 0-99 | 写单个寄存器 | 0xABCD |
3. 高级功能实现
基础从站能满足简单测试需求，但真实场景往往需要更复杂的功能。下面我们实现几个实用特性：
3.1 动态数据模拟
保持寄存器中的静态数据缺乏真实感，我们可以添加周期性变化：
from threading import Timer import random def simulate_dynamic_data(context): slave_context = context[1] values = [random.randint(0, 100) for _ in range(100)] slave_context.setValues(3, 0, values) # 3表示保持寄存器 Timer(1.0, simulate_dynamic_data, [context]).start()在run_server()的StartTcpServer调用前添加：
simulate_dynamic_data(context)3.2 多从站支持
PyModbus支持在单个服务器实例中托管多个从站，只需扩展上下文配置：
slaves = { 1: ModbusSlaveContext(...), # 单元ID 1 2: ModbusSlaveContext(...), # 单元ID 2 3: ModbusSlaveContext(...) # 单元ID 3 } context = ModbusServerContext(slaves=slaves, single=False)3.3 异常响应与日志
完善的从站应该正确处理异常并记录通信日志：
from pymodbus.exceptions import ModbusException from pymodbus.pdu import ExceptionResponse class CustomDataBlock(ModbusSequentialDataBlock): def validate(self, address, count=1): if address + count > len(self.values): raise ModbusException(f"地址越界 {address}") return True def getValues(self, address, count=1): self.validate(address, count) return super().getValues(address, count)4. 串行通信（RTU/ASCII）实现
对于硬件测试，串行通信模式更为常见。RTU模式的服务器配置与TCP类似：
from pymodbus.server import StartSerialServer def run_rtu_server(): # ...相同的上下文配置... StartSerialServer( context=context, port='/dev/ttyUSB0', # 串口设备 framer=ModbusRtuFramer, baudrate=19200, timeout=0.005 )关键参数配置建议：
| 参数 | 典型值 | 注意事项 |
|---|---|---|
| baudrate | 9600/19200/38400 | 需与主站一致 |
| parity | 'N'/'E'/'O' | 无/偶/奇校验 |
| stopbits | 1/2 | 通常为1 |
| bytesize | 7/8 | ASCII模式用7，RTU用8 |
| timeout | 0.005-0.1 | 过小可能导致响应丢失 |
5. 实战：PLC联调案例
假设我们需要测试一个温控系统的PLC程序，该程序会：
- 读取温度传感器值（输入寄存器40001）
- 比较设定值（保持寄存器40002）
- 控制加热器（线圈00001）
对应的从站模拟器可以这样增强：
def simulate_heating_system(context): slave = context[1] while True: # 当前温度模拟（带随机波动） current_temp = 25 + random.uniform(-2, 2) slave.setValues(4, 0, [int(current_temp * 10)]) # 4=输入寄存器 # 读取设定温度 set_temp = slave.getValues(3, 1)[0] / 10 # 3=保持寄存器 # 控制逻辑 heater_on = current_temp < set_temp - 0.5 slave.setValues(1, 0, [heater_on]) # 1=线圈 time.sleep(1)这个案例展示了如何构建有业务逻辑的智能从站，远超商业软件的固定模式。通过Python的灵活性，我们可以模拟设备的各种特殊行为和异常场景，这在真实测试中非常宝贵。
