/pyads

Python wrapper for TwinCAT ADS

Primary LanguagePythonMIT LicenseMIT

pyads - Python package

PyPI version Anaconda-Server Badge Anaconda-Server Badge

CI Coverage Status Documentation Status Downloads Downloads

This is a python wrapper for TwinCATs ADS library. It provides python functions for communicating with TwinCAT devices. pyads uses the C API provided by TcAdsDll.dll on Windows adslib.so on Linux. The documentation for the ADS API is available on infosys.beckhoff.com.

Documentation: http://pyads.readthedocs.io/en/latest/index.html

Installation

From PyPi:

pip install pyads

From conda-forge:

conda install pyads

From source:

git clone https://github.com/MrLeeh/pyads.git --recursive
cd pyads
python setup.py install

Features

  • connect to a remote TwinCAT device like a plc or a PC with TwinCAT
  • create routes on Linux devices and on remote plcs
  • supports TwinCAT 2 and TwinCAT 3
  • read and write values by name or address
  • read and write DUTs (structures) from the plc
  • notification callbacks

Basic usage

import pyads

# connect to plc and open connection
plc = pyads.Connection('127.0.0.1.1.1', pyads.PORT_TC3PLC1)
plc.open()

# read int value by name
i = plc.read_by_name("GVL.int_val")

# write int value by name
plc.write_by_name("GVL.int_val", i)

# close connection
plc.close()

Contributing guidelines

Contributions are very much welcome. pyads is under active development. However it is a side-project of mine so please have some patience when creating issues or PRs. Here are some main guidelines which I ask you to follow along:

  • Create PRs based on the master branch.
  • Add an entry to the Changelog.
  • Keep PRs small (if possible), this makes reviews easier and your PR can be merged faster.
  • Address only one issue per PR. If you want to make additional fixes e.g. on import statements, style or documentation which are not directly related to your issue please create an additional PR that adresses these small fixes.