AmsConfigurationRouterLoopbackEndPoint Property
Gets or sets the default router IPEndPoint.
Namespace: TwinCAT.Ams
Assembly: TwinCAT.Ads.Abstractions (in
TwinCAT.Ads.Abstractions.dll) Version:
7.0.0+e56d35ccc4675faac24789a4aab60071fc61d470
Syntax
C#
public static IPEndPoint RouterLoopbackEndPoint { get; set; }Property Value
IPEndPoint
The IPEndPoint used by
Ams Clients/Servers.
Remarks
This setting allows to change the Router Endpoint - which listens by default on IPAddress 127.0.0.1, Port 0xBF02. An application for this could be to move the router to a different (virtual) system, separated from the system running the AdsServer or AdsClient. This endpoint can only be changed process wide and should be done before the first access to the Router occurs (e.g. getting the local NetId).
ATTENTION: Bending this Endpoint is not possible with the standard TwinCAT Router. As security feature the TwinCAT Router only accepts Loopback connections to 127.0.0.1, connection requests from the outside will be closed immediately.
The simplistic .NET Core Router implementation in class 'TwinCAT.Ads.AdsRouter.AmsTcpIpRouter' from nuget package 'Beckhoff.TwinCAT.Ads.TcpRouter' or the 'Beckhoff.TwinCAT.Ads.AdsRouterConsole' doesn't have that restriction and can be used more flexible for use with virtual environments like VirtualMachines or Docker. flexible.
The following sample demonstrates how to configure the
(internal) RouterEndPoint to IPAddress 1.2.3.4:42 . This must be
done before AdsServer or AdsClient are instantiated.
AmsConfiguration.RouterEndPoint = new
IPEndpoint(IPAddress.Parse("1.2.3.4"),42);