Adding routes

If you want to add a new route, this is done via the Add Route dialog.

Adding routes 1:

Search for target systems:

Enter Host Name / IP	Enter a host name or IP address in the input field and press the button to search for a TwinCAT target system or a remote system in the network (subnet).
Refresh Status	Updates the list of potential target systems.
Broadcast Search	Search for all TwinCAT systems connected to the current subnet. The targets must be in TwinCAT configuration mode or run mode.

List of target systems

Host Name	Name of the target or remote system found
Connected	Shows the status of the connection to the target system.
Address	Address of the device The type of address depends on the transport protocol used. In the case of "TCP/IP" it is the TCP/IP address.
AmsNetId	The TwinCAT identification address of the device for the TwinCAT Router
TwinCAT	Version and build number of the TwinCAT target system
OS Version	Operating system on the target
Comment	Free comment that can be set on the target system, e.g. to identify the target system more easily.

Data of the selected target system

When a target is selected from the list, these fields display the associated connection data. The fields can be edited.

Route Name (Target)	Name of the selected target system
AmsNetId	AmsNetId of the selected target system
Virtual AmsNetId (NAT)
Transport Type	Transport type of the selected target system
Address Info	Either the name or the IP address of the corresponding target system in the network. If the name cannot be recognized, switch to the IP address.
Host Name	Selection that the route should be saved by target system name.
IP Adress	Selection that the route should be saved by IP address.
Connection Timeout (s)	Setting the connection timeout in seconds
Max Fragment Size (kByte)	Max. fragment size of the Ams commands. If this size is exceeded, the Ams command is automatically split into several fragments by the router.

Route related settings

Route Name (Remote)	Name with which the route is entered on the remote system.
Target Route	Route from the local system to the target system Project Static Temporary
Remote Route	Route from remote system to local system None Static Temporary
Project	Saves the route in the project.
Static	Saves the route on the system (project-independent).
None	Only Secure ADS routes can be added. These are stored on the target system as a server with the corresponding certificate or preshared key (PSK).
Temporary	Route is saved only until the next restart of the target system.
Advanced Settings	Displays or hides the route settings described in this chapter.
Unidirectional	Create a directed ADS communication (ADS command calls received from the opposite system).

Adding route

Add Route	Adds the selected target system with the settings made to the "Routes" (list of configured target systems).
Close	Closes the dialog box.

Login Information

To access and configure a target system, you must be logged on to it. After clicking the button Add Route you can enter user name and password. This data is stored in the route, so you only have to enter it once. If you use a TwinCAT version > 3.1.4024 or if you do not want to use Secure ADS, the dialog for entering the login information is as follows:

Adding routes 2:

User	User name with administrator rights, which should add the route.
Password	User password

Starting from a TwinCAT 3.1.4024 version, if the option Secure ADS is switched on, the dialog appears as follows:

Further information can be found in the documentation Secure ADS.

Secure ADS offers three ways of providing the keys required for the encryption:

Self Signed Certificate
Shared Certificate Authority (CA)
Preshared Key (PSK)

The configuration of a Secure ADS Route is described in the documentation Secure ADS.