pyModbusTCP 项目使用教程

1. 项目的目录结构及介绍

pyModbusTCP 项目的目录结构如下：

pyModbusTCP/
├── pyModbusTCP/
│   ├── client.py
│   ├── server.py
│   ├── utils.py
│   └── __init__.py
├── examples/
│   ├── client_minimal.py
│   ├── client_read_coils.py
│   ├── client_read_holding_registers.py
│   ├── client_write_coils.py
│   ├── client_add_float.py
│   ├── client_polling_thread.py
│   ├── server_basic_usage.py
│   └── server_with_custom_functions.py
├── tests/
│   └── test_client.py
├── setup.py
├── README.md
└── LICENSE

目录结构介绍

• pyModbusTCP/: 包含项目的主要模块，如客户端 (client.py)、服务器 (server.py) 和工具函数 (utils.py)。
• examples/: 包含多个示例脚本，展示如何使用客户端和服务器功能。
• tests/: 包含测试脚本，用于测试客户端功能。
• setup.py: 用于安装项目的脚本。
• README.md: 项目说明文档。
• LICENSE: 项目许可证文件。

2. 项目的启动文件介绍

项目的启动文件主要是 client.py 和 server.py。

client.py

client.py 文件定义了 ModbusClient 类，用于创建和管理 Modbus/TCP 客户端连接。以下是 client.py 的基本使用示例：

from pyModbusTCP.client import ModbusClient

try:
    c = ModbusClient(host='localhost', port=502)
    c.open()
    if c.is_open:
        print("Connection successful")
    else:
        print("Connection failed")
except ValueError as e:
    print(f"Error: {e}")

server.py

server.py 文件定义了 ModbusServer 类，用于创建和管理 Modbus/TCP 服务器。以下是 server.py 的基本使用示例：

from pyModbusTCP.server import ModbusServer

try:
    server = ModbusServer(host='localhost', port=502, no_block=True)
    server.start()
    print("Server is running")
except Exception as e:
    print(f"Error: {e}")

3. 项目的配置文件介绍

pyModbusTCP 项目没有明确的配置文件，但可以通过代码中的参数进行配置。例如，在创建 ModbusClient 或 ModbusServer 实例时，可以指定主机地址和端口号。

客户端配置

from pyModbusTCP.client import ModbusClient

c = ModbusClient(host='192.168.1.1', port=502)

服务器配置

from pyModbusTCP.server import ModbusServer

server = ModbusServer(host='0.0.0.0', port=502, no_block=True)

通过这些参数，可以灵活地配置客户端和服务器的运行环境。

---

以上是 pyModbusTCP 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置方法。希望这些内容能帮助你更好地理解和使用该项目。