FB_AddRouteEntry

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

	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.

VAR_INPUT

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

sNetID: 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 (Typ: T_AmsNetID). Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

stRoute: Strukturelement mit Parametern der neuen Verbindung (Typ: ST_AmsRouteEntry).

bExecute: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

tTimeout: Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

VAR_OUTPUT

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

bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError: Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.

nErrId: Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.

Beispiel:

Auf dem lokalen TwinCAT System soll eine neue AMS Router Verbindung mit dem Verbindungsnamen: "TEST", TwinCAT Netzwerkadresse: "172.16.6.111.1.1", IP-Adresse: "172.16.6.111" und dem Transportweg: "TCP/IP" hinzugefügt werden.

PROGRAM P_TEST3
VAR
    fbAddRoute  : FB_AddRouteEntry;
    bExecute    : BOOL;
    bBusy       : BOOL;
    bError      : BOOL;
    nErrID      : UDINT;
    stRoute     : ST_AmsRouteEntry := ( sName := 'TEST',
                                        sNetID := '172.16.6.111.1.1',
                                        sAddress := '172.16.6.111',
                                        eTransport := eRouteTransport_TCP_IP );
END_VAR

Die benötigten Verbindungsparameter werden bereits im Deklarationsteil initialisiert. Bei einer steigenden Flanke an der bExecute-Variablen wird die neue Verbindung hinzugefügt.

FB_AddRouteEntry 3:

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (x86, x64, ARM)	Tc2_Utilities (System)