FB_NLinkWrite
Dieser Funktionsbaustein sendet Daten vom lokalen TwinCAT System zum Fremdsystem (WRITE-Dienst).
VAR_IN_OUT
VAR_IN_OUT
hLink : T_HNLINK;
END_VAR
hLink : Netzwerkverbindungshandle (Typ: T_HNLINK). Hier übergeben Sie die Instanz der Variablen die bei der Verbindungsherstellung von dem FB_NLinkOpen-Funktionsbaustein verwendet wurde.
VAR_INPUT
VAR_INPUT
devAddr : BYTE := 2;
eArea : E_NLinkArea := eNLinkArea_DB;
nDB : WORD := 0;
nOffset : WORD := 0;
cbBuffer : UDINT(0..MAX_NLink_DATALENGTH) := 0;
pBuffer : POINTER TO BYTE := 0;
nOpt : DWORD := 0;
bExecute : BOOL;
tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
devAddr: Geräteadresse, MPI-Adresse der Komponente auf dem Fremdsystem oder die PROFIBUS-Adresse.
eArea: SPS Datenbereich auf dem Fremdsystem (Eingänge, Ausgänge, Datenbaustein usw.) in den Daten geschrieben werden sollen (Typ: E_NLinkArea).
nDB: Datenbausteinnummer auf dem Fremdsystem. In diesen Baustein sollen Daten geschrieben werden (nur relevant beim Zugriff auf Datenbausteine und erweiterte Datenbausteine).
nOffset: Die Start-Byteadresse oder Wortadresse ab der auf dem Fremdsystem Daten geschrieben werden sollen. Ob Byte- oder Wortadresse angegeben werden soll ist abhängig von dem Typ der verwendeten Fremdsteuerung/Protokoll und dem Datenbereich auf den Sie zugreifen möchten. Weitere Informationen finden Sie hier: S5/S7 SPS-Datenbereich-Parameterwerte.
cbBuffer: Maximale Bytelänge der Daten die vom Quelldatenpuffer auf dem lokalen TwinCAT System zum Fremdsystem übertragen werden soll. Auch beim Zugriff auf Wortadressen wird hier die Bytelänge angegeben!
pBuffer: Pointer/Adresse auf den Quelldatenpuffer. Daten aus diesem Puffer werden zum Fremdsystem übertragen. Die Adresse kann mit dem ADR-Operator ermittelt werden. Der Quelldatenpuffer darf nicht kleiner sein als die angegebene Länge der zu sendenden Daten.
nOpt: Reserviert für zukünftige Anwendungen.
bExecute: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout: Gibt die Timeout-Zeit an, die bei der Annahme des Kommandos nicht überschritten werden darf.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrID : UDINT;
cbWrite : UDINT := 0;
END_VAR
bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt. Während Busy = TRUE wird an den Eingängen kein neuer Befehl angenommen. Bitte beachten Sie, dass nicht die Ausführung des Kommandos, sondern nur dessen Annahme zeitlich überwacht wird.
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 Fehlernummer.
cbWrite: Bei Erfolg Anzahl der erfolgreich geschriebenen Datenbytes.
Beispiel:
Siehe unter Beispiele.
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS-Bibliotheken |
---|---|---|
TwinCAT v3.1.4016 oder höher | PC oder CX (x86, x64, ARM) | Tc2_S5S7Com (Communication->TcpIp) |