Beckhoff.TwinCAT.Ads.AdsRouterConsole
5.0.0-preview1
Prefix Reserved
The AdsRouterConsole is now open source and is maintained under
https://github.com/Beckhoff/TF6000_ADS_DOTNET_V5_Samples/tree/main/Sources/RouterSamples/AdsRouterConsoleApp
dotnet add package Beckhoff.TwinCAT.Ads.AdsRouterConsole --version 5.0.0-preview1
NuGet\Install-Package Beckhoff.TwinCAT.Ads.AdsRouterConsole -Version 5.0.0-preview1
<PackageReference Include="Beckhoff.TwinCAT.Ads.AdsRouterConsole" Version="5.0.0-preview1" />
paket add Beckhoff.TwinCAT.Ads.AdsRouterConsole --version 5.0.0-preview1
#r "nuget: Beckhoff.TwinCAT.Ads.AdsRouterConsole, 5.0.0-preview1"
// Install Beckhoff.TwinCAT.Ads.AdsRouterConsole as a Cake Addin
#addin nuget:?package=Beckhoff.TwinCAT.Ads.AdsRouterConsole&version=5.0.0-preview1&prerelease
// Install Beckhoff.TwinCAT.Ads.AdsRouterConsole as a Cake Tool
#tool nuget:?package=Beckhoff.TwinCAT.Ads.AdsRouterConsole&version=5.0.0-preview1&prerelease
Description
The package 'Beckhoff.TwinCAT.Ads.AdsRouterConsole' contains a lean TCP ADS Router as binary. It is a simple console application 'ready-to-run'.
It can be used in scenarios where no standard TwinCAT router is established or available and is running in UserMode only (no realtime characteristics) and contains no further functionality than distributing the ADS Frames (e.g. no Port 10000, no ADS Secure). It is just used to route ADS frames locally between AdsServers and to/from remote ADS devices.
Requirements
- .NET Core 3.0, .NET Framework 4.8 or .NET Standard 2.0 installed on the machine.
- No other System allocating the same port (e.g. a regular TwinCAT installation)
Installation
dotnet add package Beckhoff.TwinCAt.Ads.AdsRouterConsole
This will install the AdsRouterConsole application. For the .NET FullFramework (Version 4.8) the package contains the TwinCAT.Ads.AdsRouterConsole.exe which acts as Console application directly. For other platforms (.NET Core and .NET Standard) it contains the TwinCAT.Ads.AdsRouterConsole.dll which is indirectly started by the .NET CLI:
Together with the package deployment, there comes a "StaticRoutes.xml" file. This file is loaded Router and must contain the Local AmsNetId (can be chosen, but must be unique) and the RemoteConnections that will be available from the outside.
An example of the local "StaticRoutes.xml" is given here:
<?xml version="1.0" encoding="utf-8"?>
<TcConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="C:\TwinCAT3\Config\TcConfig.xsd">
<Local>
<Name>MyLocalSystem</Name>
<NetId>192.168.1.22.1.1</NetId>
</Local>
<RemoteConnections>
<Route>
<Name>MyRemoteSystem</Name>
<Address>RemoteSytem</Address>
<NetId>192.168.1.21.1.1</NetId>
<Type>TCP_IP</Type>
</Route>
</RemoteConnections>
</TcConfig>
This file must be edited to configure the ADS Router. It is not reloaded during the runtime of the AdsRouterConsole.
To enable ADS Communication, the following settings have to be made:
- Select the Local AmsNetId and the Route Name of the System in the local "StaticRoutes.xml"
- Add Remote Connections to the local StaticRoutes
- Add the "Backroute" from the Remote system linking to the our system (via AmsNETId) running the AdsRouteConsole. This can be done via SystemManager / SystemService System Tray or 'StaticRoutes.xml' on the remote systems.
First Steps
Running as Full Framework Application
dotnet run .\TwinCAT.Ads.AdsRouterConsole.dll
Running as .NET Core or .NET Standard application
TwinCAT.Ads.AdsRouterConsole.exe
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 is compatible. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 is compatible. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETCoreApp 3.0
- Beckhoff.TwinCAT.Ads.TcpRouter (>= 5.0.0-preview1)
- Microsoft.Extensions.Logging (>= 3.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 3.0.0)
- Microsoft.Extensions.Logging.Console (>= 3.0.0)
-
.NETFramework 4.8
- Beckhoff.TwinCAT.Ads.TcpRouter (>= 5.0.0-preview1)
- Microsoft.Extensions.Logging (>= 3.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 3.0.0)
- Microsoft.Extensions.Logging.Console (>= 3.0.0)
-
.NETStandard 2.0
- Beckhoff.TwinCAT.Ads.TcpRouter (>= 5.0.0-preview1)
- Microsoft.Extensions.Logging (>= 3.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 3.0.0)
- Microsoft.Extensions.Logging.Console (>= 3.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|
Alpha version of the ADS Version 5.0.0 Version branch. Don't use for productive code.