**pyModbusTCP技术文档**

pyModbusTCP技术文档

pyModbusTCP A simple Modbus/TCP library for Python 项目地址: https://gitcode.com/gh_mirrors/py/pyModbusTCP

pyModbusTCP是一个专为Python设计的简单Modbus/TCP客户端库。此库完全由纯Python代码构建，无需任何额外扩展模块。自0.1.0版本起，还提供了仅限测试使用的服务器功能（不建议在实际项目中应用）。支持Python 3.7至3.12版本，在Linux、Mac OS以及Windows系统上运行。

安装指南

通过PyPI安装（推荐）

稳定版的简便安装方法：

sudo pip install pyModbusTCP

指定版本安装（例如0.1.10）：

sudo pip install pyModbusTCP==v0.1.10

从GitHub直接安装

若要直接从GitHub源码安装特定版本（如0.1.10）：

sudo pip install git+https://github.com/sourceperl/pyModbusTCP.git@v0.1.10

注意事项：为了保证项目稳定性，请始终为您的项目指定使用某个确定版本的pyModbusTCP，避免因自动升级带来的潜在兼容性问题。详细版本变更可参考CHANGES文档。

项目使用说明

pyModbusTCP提供了灵活的API来交互Modbus设备。下面是一些基础示例。

初始化客户端

自动连接模式

确保每次调用modbus请求时TCP连接都是打开的：

from pyModbusTCP.client import ModbusClient
c = ModbusClient(host="localhost", port=502, unit_id=1, auto_open=True)

手动管理连接模式

每次读写请求前后手动控制连接状态：

c = ModbusClient(host="127.0.0.1", auto_open=True, auto_close=True)

常用操作示例

读取寄存器

读取两个连续的16位寄存器（地址从0开始）：

regs = c.read_holding_registers(0, 2)
if regs:
    print(regs)
else:
    print("读取错误")

写入寄存器

向地址10处写入值44和55：

if c.write_multiple_registers(10, [44,55]):
    print("写入成功")
else:
    print("写入错误")

项目API使用文档

完整API使用详情和高级功能，如更复杂的请求处理和异常管理，请参阅在线文档：https://pymodbustcp.readthedocs.io/。该文档涵盖了从基本到进阶的所有API调用和最佳实践，是深入理解和运用pyModbusTCP的强大资源。

---

通过以上文档，您应能快速开始使用pyModbusTCP进行Modbus/TCP通信。记住，对于复杂的项目，熟悉项目的CHANGES日志以了解不同版本间的变化至关重要，这有助于规避可能的兼容性问题并确保项目的稳定性。

pyModbusTCP A simple Modbus/TCP library for Python 项目地址: https://gitcode.com/gh_mirrors/py/pyModbusTCP