Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fisothemes/labview-twincat-ads
Easy to use unofficial LabVIEW TwinCAT ADS API for communicating with Beckhoff PLCs via ADS. Features include Invoking Rpc Methods, Reading/Writing of PLC variables (including all Standard, Time, Strings, WStrings, Structs composed of the aforementioned, Nested STRUCTs and Multi-dimensional Arrays of the aforementioned datatypes) and more!
https://github.com/fisothemes/labview-twincat-ads
ads beckhoff industrial-automation labview twincat twincat-ads twincat3
Last synced: about 1 month ago
JSON representation
Easy to use unofficial LabVIEW TwinCAT ADS API for communicating with Beckhoff PLCs via ADS. Features include Invoking Rpc Methods, Reading/Writing of PLC variables (including all Standard, Time, Strings, WStrings, Structs composed of the aforementioned, Nested STRUCTs and Multi-dimensional Arrays of the aforementioned datatypes) and more!
- Host: GitHub
- URL: https://github.com/fisothemes/labview-twincat-ads
- Owner: fisothemes
- License: mit
- Created: 2022-06-19T11:53:31.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-04-08T03:47:09.000Z (9 months ago)
- Last Synced: 2024-04-08T04:38:36.501Z (9 months ago)
- Topics: ads, beckhoff, industrial-automation, labview, twincat, twincat-ads, twincat3
- Language: LabVIEW
- Homepage:
- Size: 50.5 MB
- Stars: 8
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LabVIEW TwinCAT ADS
[](https://www.vipm.io/package/fisothemes_lib_labview_twincat_ads/) [](https://www.vipm.io/package/fisothemes_lib_labview_twincat_ads/)
Easy-to-use Unofficial LabVIEW TwinCAT Toolkit for communicating with Beckhoff PLCs via ADS. Features include invoking RPC methods, reading/writing PLC variables (including all standard types, pointers, references, time, strings, wide strings, structs composed of the aforementioned, nested structs, and multi-dimensional arrays of the aforementioned datatypes), introspective capabilities (retrieve symbol and type information), the ability to build your own low-level VIs via extensions, and more.
# Minimum Requirements
* LabVIEW 2018 (32/64 bit) and above
* .NET Framework 4.6.2 (installed by default with LabVIEW)
* TwinCAT 3.1.4024.10 XAE/XAR and above (haven't tested below 4024.10 might work with lower versions)
# Changelog
New Features:
-------------
+ Added `Read PLC Type.vi`
+ Added Alias names to Notifications. This means you can listen for changes to the same symbol at different rates.
Improvements:
-------------
+ Speed of `Read Multiple.vi` and `Write Multiple.vi`
Fixes:
------
+ Issue reading/writing values of symbols of pointer types that didn't end with ^(dereference character).
+ Issue reading/writing non-jagged arrays.
+ Issue where writing dates for DT type didn't take into account daylight savings.
+ Issue reading and writing `REFERENCE TO` types greater than 4 or 8 bytes (depending on the bitness of the machine).
# Showcase
VIs included in the API:
# Examples
Invoke Method:
-
Event-Driven Reading:
-
Write Symbol:
-
Read Symbol:
-
Pointer Support:
-
High-Speed Reading:
-
# Developer Notes
Connection
----------
1. You may notice that the `Connect.vi` is slow in connection. This is normal.
The VI is simply caching the symbols and types in LabVIEW rather than keeping them in a .NET collection. The reason for this is that lookup times on the .NET Ads-XYZ-Collection are very slow. The further I moved away from making calls to any of Beckhoff's .NET libraries the faster operations became. The penalty for doing this is a slow connection.
2. Because of the caching system, online changes are currently not supported.
3. You do not need to disconnect before disposal. `Dispose.vi` VI will disconnect for you.
Read, Write and Invoke Method
---------------------------------
1. Operations involving `UNION`s and `INTERFACE` types are not yet supported.
2. To read and write to pointers simply add the dereferencing symbol to your symbol name e.g. `pValue^`.
3. First calls to an operation (Reading/Writing a symbol or Invoking a Method) will be slow.
Typical first call times for my RYZEN 3600X system with 1 isolated core are ~5ms for `ARRAY[0..999] OF LREAL` and ~40ms for `ARRAY[0..999] OF ST_STRUCT` where `ST_STRUCT` is:
```pascal
TYPE ST_STRUCT :
STRUCT
bVar : BOOL;
dtVar : DT;
fVar : LREAL;
END_STRUCT
END_TYPE
```
Subsequent calls resulted in read/write/method invoking times of 1-2ms for `ARRAY[0..999] OF LREAL` and ~20ms for `ARRAY[0..999] OF ST_STRUCT`. The task cycle time was 1ms.
4. When sending numbers, arrays of numbers or structs with numbers, enums, etc. The numbers will be coerced to the type defined in the PLC for that variable/parameter. This is by design. LabVIEW is a graphical language so switching between Single Precision Float and Doubles is an absolute pain.
5. LabVIEW Arrays don't need to be the same size as the PLC arrays to write them. Write what you need, the rest will be filled in with defaults.
Events
------
1. Online change is not supported. However, you can update variables on the PLC without needing to disconnect on the LabVIEW side via `Login with Download`, `Restart TwinCAT System` and `Activate TwinCAT Configuration`. All symbols will automatically be reloaded into memory.
*NOTE: Any reads or writes running during this process will produce errors, just ignore these errors until reconnection is complete. They will stop once that happens.*
2. Don't forget to close the Registration Refnum after you're done. User Events references are automatically closed on disposal.
Unit Testing
------
1. [JKI's Caraya Unit Test Framework](https://www.vipm.io/package/jki_lib_caraya/) is used for unit testing.
2. To run unit tests simply activate the PLC project located at [src/Test-PLC](./src/Test-PLC/), open the LabVIEW project and then run the `Run Tests` VI in the Tests virtual folder.
Other
------
1. When using extensions. Please only close the .NET references with an asterisk (*) on their label at the connector pane. The ones without an * are managed for you.
**Please feel free to contribute to the project or report bugs**
- - - -