### 如何在Python中使用pymodbus库 `pymodbus` 是一个完整的 Modbus 协议实现，适用于 Python 开发者。以下是关于 `pymodbus` 的基本使用方法以及一些典型应用场景。 #### 1. 安装 pymodbus 库 要开始使用 `pymodbus`，首先需要安装该库。可以通过 pip 工具轻松完成安装： ```bash pip install pymodbus ``` 如果需要支持串口通信功能，则还需要额外安装依赖包 `pyserial`： ```bash pip install pyserial ``` --- #### 2. 基本概念 Modbus 是一种工业标准协议，用于控制器之间的通信。`pymodbus` 提供了客户端和服务器两种模式的支持。常见的操作包括读取寄存器、写入寄存器等。 - **Modbus 寄存器类型** - 输入寄存器 (Input Registers) - 输出寄存器 (Holding Registers) - 离散输入 (Discrete Inputs) - 线圈状态 (Coils) 这些寄存器通常通过地址访问，具体取决于目标设备的配置[^1]。 --- #### 3. 使用示例：连接并读取 Holding Register 数据 以下是一个简单的例子，展示如何通过 TCP 连接到远程 Modbus 设备，并读取其 Holding Register 中的数据。 ```python from pymodbus.client.sync import ModbusTcpClient import time # 创建 ModbusTCP 客户端实例 client = ModbusTcpClient('192.168.1.99', port=502, timeout=1) if not client.connect(): print("无法连接到 Modbus 设备") else: try: while True: # 读取从地址 0 开始的 3 个 Holding Registers response = client.read_holding_registers(address=0, count=3, unit=1) if response.isError(): print(f"发生错误: {response}") else: registers = response.registers print(f"Holding Registers 数据: {registers}") time.sleep(1) except KeyboardInterrupt: print("程序被手动终止") finally: client.close() ``` 此代码片段展示了以下几个关键点： - 创建了一个同步的 Modbus TCP 客户端对象。 - 调用了 `read_holding_registers()` 方法来获取指定数量的寄存器值。 - 如果响应包含错误信息，则会打印出来；否则解析返回的结果[^3]。 --- #### 4. 其他常见用法 ##### （1）写入单个线圈状态 下面的例子演示了如何设置某个线圈的状态为 ON 或 OFF： ```python from pymodbus.client.sync import ModbusTcpClient client = ModbusTcpClient('192.168.1.99') if client.connect(): result = client.write_coil(address=1, value=True, unit=1) # 设置线圈 1 为 ON if result.isError(): print(f"写入失败: {result}") else: print("成功写入线圈状态") client.close() ``` ##### （2）批量写入多个寄存器 有时可能需要一次性更新一组寄存器的内容： ```python from pymodbus.payload import BinaryPayloadBuilder from pymodbus.constants import Endian from pymodbus.client.sync import ModbusTcpClient builder = BinaryPayloadBuilder(byteorder=Endian.Big, wordorder=Endian.Little) builder.add_32bit_float(75.0) # 添加浮点数 payload = builder.to_registers() client = ModbusTcpClient('192.168.1.99') if client.connect(): result = client.write_registers(address=0, values=payload, unit=1) if result.isError(): print(f"写入失败: {result}") else: print("成功写入寄存器组") client.close() ``` --- #### 5. 实际应用中的注意事项 - **超时时间**：在网络不稳定的情况下，建议适当增加 `timeout` 参数以避免频繁断开连接。 - **异常处理**：始终检查请求是否返回错误 (`isError`) 并妥善处理。 - **性能优化**：对于大批量数据传输，考虑减少交互次数，比如一次读取更多寄存器而不是多次单独调用[^2]。 --- #### 总结 以上介绍了 `pymodbus` 的基础用法及其部分高级特性。无论是作为客户端还是服务端运行，都可以利用它的强大功能简化 Modbus 协议开发过程。