<think>由于用户之前的问题提到了“参考站内引用”，但未提供具体引用内容，且最新查询是获取适配pymodbus 3.11版本的代码示例，我将直接针对该请求进行回答。 注意：pymodbus是一个Modbus协议的Python实现，3.11指的是Python版本。pymodbus库本身有多个版本，应使用与Python 3.11兼容的pymodbus版本（例如pymodbus 2.5.3或更高版本支持Python 3.7-3.11）。 我将提供一个简单的示例，展示如何使用pymodbus（库版本>=2.5.3）在Python 3.11上实现一个Modbus TCP客户端和服务器。 由于pymodbus 2.x版本与之前的1.x版本有较大变化，因此代码需要按照新版本编写。 如果用户没有特别说明，我将给出两个示例： 1. Modbus TCP 服务器示例（同步） 2. Modbus TCP 客户端示例（同步读取保持寄存器） 注意：在运行之前，请确保安装了pymodbus库，可以使用以下命令安装： pip install pymodbus==2.5.3 # 或者更高版本，如3.0.0以上（注意3.x版本可能有API变化） 目前（2023年）最新的稳定版本是3.x，但3.x版本可能有一些API调整。这里我选择2.5.3，因为它被广泛使用且稳定支持Python3.11。 但是请注意，pymodbus 3.x版本也支持Python3.11，如果用户想使用3.x版本，代码会有不同。但用户问题中并未指定pymodbus库的具体版本，仅指定Python3.11。因此，我选择较为常见的2.5.3版本代码示例。 如果用户需要3.x版本的示例，请明确。 由于问题中没有指定，我将给出2.5.3版本的示例。并额外说明如何修改为3.x版本。 一、Modbus TCP 服务器示例（pymodbus 2.5.3） 二、Modbus TCP 客户端示例（pymodbus 2.5.3） 另外，pymodbus 3.x版本已经发布，如果用户希望使用3.x，可以在安装时指定版本（如pip install pymodbus==3.1.0），但3.x版本可能不兼容2.x。因此，我会在相关问题中加入关于3.x版本的说明。 现在，提供代码示例： 注意：在运行服务器和客户端时，确保端口502未被防火墙阻止，且在同一台机器上运行时使用localhost。 </think> 以下是针对 `pymodbus` 3.11+ 版本的代码示例（兼容 Python 3.11）。当前最新 `pymodbus` 为 3.x 系列，API 与旧版差异较大，以下提供两种常见场景的代码： --- ### 📡 Modbus TCP 客户端示例 ```python from pymodbus.client import ModbusTcpClient # 连接设备 client = ModbusTcpClient( host="192.168.1.100", # 设备IP port=502, # 默认端口 timeout=3 # 超时(秒) ) try: # 建立连接 client.connect() # 读取保持寄存器 (地址0开始，读取5个寄存器) result = client.read_holding_registers( address=0, count=5, slave=1 # 从机地址 ) if result.isError(): print(f"读取错误: {result}") else: print(f"寄存器值: {result.registers}") # 输出数值列表 # 写入单个寄存器 (地址10，写入值255) write_result = client.write_register( address=10, value=255, slave=1 ) print(f"写入成功? {not write_result.isError()}") except Exception as e: print(f"通信异常: {str(e)}") finally: # 关闭连接 client.close() ``` --- ### 💻 Modbus RTU 客户端示例 (串口通信) ```python from pymodbus.client import ModbusSerialClient # 配置串口 client = ModbusSerialClient( method="rtu", # 通信协议 port="/dev/ttyUSB0", # Linux示例, Windows使用 "COM1" baudrate=19200, # 波特率 stopbits=1, # 停止位 bytesize=8, # 数据位 parity="N", # 无校验 timeout=1 # 超时(秒) ) try: client.connect() # 读取线圈状态 (地址0开始，读取10个线圈) result = client.read_coils( address=0, count=10, slave=1 ) if result.isError(): print(f"读取错误: {str(result)}") else: print(f"线圈状态: {result.bits}") # 输出布尔值列表 except Exception as e: print(f"串口错误: {str(e)}") finally: client.close() ``` --- ### 🔑 关键说明 1. **安装要求** 使用以下命令安装兼容版本： ```bash pip install pymodbus==3.3.2 # 推荐版本 (支持Python 3.11) ``` 2. **API 变更注意** - 新版不再使用 `SyncModbusTcpClient`，统一用 `ModbusTcpClient`[^1] - 所有方法返回 `ModbusResponse` 对象，需用 `.isError()` 判断状态[^2] 3. **数据类型处理** - `read_holding_registers()` 返回整数列表 - 浮点数需自行转换，例如： ```python from pymodbus.payload import BinaryPayloadDecoder decoder = BinaryPayloadDecoder.fromRegisters(result.registers, byteorder='>') float_value = decoder.decode_32bit_float() ``` --- ### 📚 完整文档参考 [pymodbus 3.x Official Documentation](https://pymodbus.readthedocs.io/en/latest/)