Metadata-Version: 2.1
Name: pyads
Version: 3.2.1
Summary: Python wrapper for TwinCAT ADS library
Home-page: https://github.com/MrLeeh/pyads
Author: Stefan Lehmann
Author-email: Stefan.St.Lehmann@gmail.com
License: UNKNOWN
Description: pyads - Python package
        ======================
        
        [![Build Status](https://travis-ci.org/stlehmann/pyads.svg?branch=master)](https://travis-ci.org/stlehmann/pyads)
        [![Coverage Status](https://coveralls.io/repos/github/stlehmann/pyads/badge.svg?branch=master)](https://coveralls.io/github/stlehmann/pyads?branch=master)
        [![Documentation Status](https://readthedocs.org/projects/pyads/badge/?version=latest)](http://pyads.readthedocs.io/en/latest/?badge=latest)
        [![PyPI version](https://badge.fury.io/py/pyads.svg)](https://badge.fury.io/py/pyads)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        [![Downloads](https://pepy.tech/badge/pyads)](https://pepy.tech/project/pyads)
        [![Downloads](https://pepy.tech/badge/pyads/week)](https://pepy.tech/project/pyads/week)
        
        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](http://infosys.beckhoff.com/english.php?content=../content/1033/tcadsdll2/html/tcadsdll_api_overview.htm&id=20557).
        
        
        Documentation: http://pyads.readthedocs.io/en/latest/index.html
        
        # Installation
        
        From PyPi:
        
        ```bash
        $ pip install pyads
        ```
        
        From Github:
        
        ```bash
        $ 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 DUTs (structures) from the plc
        * notification callbacks
        
        ## Basic usage
        
        ```python
        import pyads
        
        # add route to remote plc
        pyads.add_route("192.168.1.12.1.1", "192.168.1.12")
        
        # connect to plc and open connection
        plc = pyads.Connection('127.0.0.1.1.1', pyads.PORT_SPS1)
        plc.open()
        
        # read int value by name
        i = plc.read_by_name("GVL.int_val", pyads.PLCTYPE_INT)
        
        # write int value by name
        plc.write_by_name("GVL.int_val", i, pyads.PLCTYPE_INT)
        
        # close connection
        plc.close()
        ```
        
        [0]: https://infosys.beckhoff.de/english.php?content=../content/1033/TcSystemManager/Basics/TcSysMgr_AddRouteDialog.htm&id=
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Operating System :: POSIX :: Linux
Provides: pyads
Description-Content-Type: text/markdown
