FB_AddRouteEntryEx

Mit dem Funktionsbaustein kann eine neue AMS-Router-Verbindung (Remote Route) zu einem TwinCAT System hinzugefügt werden.

Der Funktionsbaustein unterstützt mit der virtuellen AmsNetId die AmsNAT- Funktionalität. Diese ermöglicht das Herstellen von Routen zu zwei oder mehreren Steuerungen, welche die gleiche AmsNetId besitzen.

	AMS-Router-Verbindungsliste Beide Kommunikationspartner einer AMS-Router-Verbindung besitzen eine AMS-Router Verbindungsliste. Diese Listen enthalten AMS-Router-Verbindungen. Die Funktionsfähigkeit einer AMS-Router-Verbindung ist gegeben, wenn beide Kommunikationspartner sich gegenseitig in ihrer Verbindungsliste eingetragen haben. Bei Verwendung des Funktionsbaustein wird nur bei einem Kommunikationspartner dessen Liste erweitert.

Eingänge

VAR_INPUT
    sNetID   : T_AmsNetID;
    stRoute  : ST_AmsRouteEntry;
    bExecute : BOOL;
    tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Name	Typ	Beschreibung
sNetID	T_AmsNetID	Hier kann ein String mit der Netzwerkadresse des TwinCAT-Rechners angegeben werden, auf dem die AMS-Router Verbindungsliste um eine neue Verbindung ergänzt werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
stRoute	ST_AmsRouteEntry	Strukturelement mit Parametern der neuen Verbindung.
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout	TIME	Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

Ausgänge

VAR_OUTPUT
    bBusy  : BOOL;
    bError : BOOL;
    nErrId : UDINT;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError	BOOL	Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.
nErrId	UDINT	Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.4024	PC oder CX (x86, x64, Arm^®)	Tc2_Utilities (System) >= v3.3.41.0