Skip to content

Latest commit

 

History

History
80 lines (70 loc) · 3.24 KB

README.md

File metadata and controls

80 lines (70 loc) · 3.24 KB
Raw

This library is intended to provide easy use as ADS client applications running on non-windows systems (e.g. FreeBSD, Linux, ...) to communicate with TwinCAT devices via TCP/IP.

To build this library a recent compiler with C++14 support is required.

Currently (2023-11-08) tested with:

host os host target compiler
Alpine 3.16 amd64 amd64 gcc 11.2.1
Arch Linux amd64 amd64 gcc 13.2.1
Debian 12 amd64 amd64 clang 14.0.6
Debian 12 amd64 i686 gcc 12.2.0
Debian 12 amd64 mips gcc 12.2.0
Debian 12 amd64 win32 gcc 5.5.0
Debian 12 amd64 win64 clang-cl 14.0.6
Debian 12 amd64 riscv64 gcc 12.2.0
Debian 12 arm64 arm64 gcc 12.2.0
TC/BSD 13 amd64 amd64 clang 14.0.5
Windows 10 amd64 win64 msvc 19.36.32537

Compile & usage

# clone the repository
git clone https://github.com/Beckhoff/ADS.git
# change into root of the cloned repository
cd ADS
# configure meson to build the library into "build" dir
meson setup build
# let ninja build the library
ninja -C build

Prepare your target to run the example

  • Download your PLC project to your target e.g. "PLC-TestProject" of our GitHub repository.
  • Authorise your ADS client for the TwinCAT target by adding an AMS route.

    • TwinCAT Engineering: Go to the tree item SYSTEM/Routes and add a static route.

    • TwinCAT Systray: Open the context menue by right click the TwinCAT systray icon. (not available on Windows CE devices)

    • TC2: Go to Properties/AMS Router/Remote Computers and restart TwinCAT

    • TC3: Go to Router/Edit routes.

    • TcAmsRemoteMgr: Windows CE devices can be configured locally (TC2 requires a TwinCAT restart). Tool location: /Hard Disk/System/TcAmsRemoteMgr.exe

    • IPC Diagnose: Beckhoff IPC’s provide a web interface for diagnose and configuration. Further information: http://infosys.beckhoff.de/content/1033/devicemanager/index.html?id=286

Sample AMS route:

  Name:           MyAdsClient
  AMS Net Id:     192.168.0.1.1.1 # NetId of your ADS client, derived from its IP address or set by bhf::ads:SetLocalAdress().
  Address:        192.168.0.1     # Use the IP of the ADS client, which is connected to your TwinCAT target
  Transport Type: TCP/IP
  Remote Route:   None / Server
  Unidirectional: false
  Secure ADS:     false

Prepare your client to run the example/example.cpp

  • set "remoteNetId" to the AMS NetId of your TwinCAT target (this is the AMS NetId found in the "About TwinCAT System window" e.g. "192.168.0.2.1.1").
  • set "remoteIpV4" to the IP Address of your TwinCAT target (e.g. 192.168.0.2)
  • (optional) enable bhf::ads::SetLocalAddress() and set to the AMS NetId you choose for the ADS client (e.g. 192.168.0.1.1.1).
# configure meson to build example into "build" dir
meson example/build example
# let ninja build the example
ninja -C example/build
# and run the example
./example/build/example

ADS/AMS Specification: https://infosys.beckhoff.com/content/1033/tc3_ads_intro/index.html