pycomm技术文档

pycomm技术文档

安装指南

通过GitHub安装

1. 使用Git克隆pycomm仓库到本地：

   git clone https://github.com/ruscito/pycomm.git
   

2. 进入项目目录，并执行Python的安装脚本（需要管理员权限）：

   cd pycomm
   sudo python setup.py install
   

通过PyPI安装

对于Python 3用户，推荐使用pycomm3，但请注意此文档主要基于原始的pycomm说明，不过安装过程相似。

pip install pycomm

若要安装支持Python 3的更新版本，请查找对应的pycomm3指令。

项目的使用说明

pycomm库提供了用于与Allen-Bradley系列PLC进行通讯的模块，特别是ab_comm子模块，它包含了对接Rockwell PLCs的类。

配置日志

在使用前，建议配置日志以便于调试：

import logging
logging.basicConfig(filename="example.log", format="%(levelname)-10s %(asctime)s %(message)s", level=logging.DEBUG)

与ControlLogix PLC通讯示例

from pycomm.ab_comm.clx import Driver as ClxDriver

c = ClxDriver()
if c.open('172.16.2.161'):
    print(c.read_tag(['ControlWord']))
    # 写读操作
    c.write_tag('Counts', -26, 'INT')
    print(c.read_tag('Counts'))
    c.close()

与Micrologix PLC通讯示例

from pycomm.ab_comm.slc import Driver as SlcDriver

c = SlcDriver()
if c.open('172.16.2.160'):
    print(c.read_tag('S:1/5'))
    # 执行写入后读取验证
    c.write_tag('N7:0', 21)
    print(c.read_tag('N7:0', 10))
    c.close()

项目API使用文档

主要类：Driver (位于ab_comm.clx 和 ab_comm.slc)

• open(ip_address): 连接到指定IP地址的PLC。
• close(): 断开与PLC的连接。
• read_tag(tag_name[, count]): 读取单个或多个标签。
• write_tag(tag_path, value[, data_type]): 写入标签值。
• read_array(tag, start_index[, size]): 读取数组的一部分。
• write_array(tag, values[, data_type]): 写入数组数据。
• read_string(tag): 读取字符串标签。
• write_string(tag, value): 写入字符串值。

数据类型支持

支持多种Rockwell PLC的数据类型，如INT, DINT, REAL, STRING等，确保正确匹配PLC中的实际数据类型。

注意事项

• 确保您的Python环境兼容pycomm或pycomm3的版本要求。
• 在生产环境中测试代码之前，务必在安全的测试环境下充分验证所有通讯逻辑。

pycomm项目持续发展，未来将添加更多驱动器以支持更广泛的设备，开发者社区的反馈和贡献对它的成长至关重要。请遵循MIT许可协议使用此软件，并考虑回馈社区。