FB_AddRouteEntry

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. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

stRoute: Strukturelement mit Parametern der neuen Verbindung.

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 ADS-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 in FUP:

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.

Voraussetzungen