https://github.com/numat/clickplc
Python driver for Koyo Ethernet ClickPLCs.
https://github.com/numat/clickplc
driver plc python
Last synced: 6 months ago
JSON representation
Python driver for Koyo Ethernet ClickPLCs.
- Host: GitHub
- URL: https://github.com/numat/clickplc
- Owner: numat
- License: gpl-2.0
- Created: 2017-10-04T21:02:06.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2026-01-15T21:59:59.000Z (6 months ago)
- Last Synced: 2026-01-16T01:01:53.079Z (6 months ago)
- Topics: driver, plc, python
- Language: Python
- Homepage: https://www.automationdirect.com/clickplcs/about-click/features
- Size: 612 KB
- Stars: 25
- Watchers: 11
- Forks: 12
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
clickplc
========
Python ≥3.8 driver and command-line tool for [Koyo Ethernet ClickPLCs](https://www.automationdirect.com/adc/Overview/Catalog/Programmable_Controllers/CLICK_Series_PLCs_(Stackable_Micro_Brick)).
Installation
============
```
pip install clickplc
```
Usage
=====
### Command Line
```
$ clickplc the-plc-ip-address
```
This will print all the X, Y, DS, and DF registers to stdout as JSON. You can pipe
this as needed. However, you'll likely want the python functionality below.
### Python
This uses Python ≥3.5's async/await syntax to asynchronously communicate with
a ClickPLC. For example:
```python
import asyncio
from clickplc import ClickPLC
async def get():
async with ClickPLC('the-plc-ip-address') as plc:
print(await plc.get('df1-df500'))
asyncio.run(get())
```
The entire API is `get` and `set`, and takes a range of inputs:
```python
>>> await plc.get('df1')
0.0
>>> await plc.get('df1-df20')
{'df1': 0.0, 'df2': 0.0, ..., 'df20': 0.0}
>>> await plc.get('y101-y316')
{'y101': False, 'y102': False, ..., 'y316': False}
>>> await plc.set('df1', 0.0) # Sets DF1 to 0.0
>>> await plc.set('df1', [0.0, 0.0, 0.0]) # Sets DF1-DF3 to 0.0.
>>> await plc.set('y101', True) # Sets Y101 to true
```
Currently, the following datatypes are supported:
| | | |
|---|---|---|
| x | bool | Input point |
| y | bool | Output point |
| c | bool | (C)ontrol relay |
| t | bool | (T)imer |
| ct | bool | (C)oun(t)er |
| ds | int16 | (D)ata register, (s)ingle signed int |
| dd | int32 | (D)ata register, (d)double signed int |
| df | float | (D)ata register, (f)loating point |
| td | int16 | (T)ime (d)elay register |
| ctd | int32 | (C)oun(t)er Current Values, (d)ouble int |
| sd | int16 | (S)ystem (D)ata register |
### Tags / Nicknames
Recent ClickPLC software provides the ability to export a "tags file", which
contains all variables with user-assigned nicknames. The tags file can be used
with this driver to improve code readability. (Who really wants to think about
modbus addresses and register/coil types?)
To export a tags file, open the ClickPLC software, go to the Address Picker,
select "Display MODBUS address", and export the file.
Once you have this file, simply pass the file path to the driver. You can now
`set` variables by name and `get` all named variables by default.
```python
async with ClickPLC('the-plc-ip-address', 'path-to-tags.csv') as plc:
await plc.set('my-nickname', True) # Set variable by nickname
print(await plc.get()) # Get all named variables in tags file
```
Additionally, the tags file can be used with the commandline tool to provide more informative output:
```
$ clickplc the-plc-ip-address tags-filepath
```