FB_MBWriteRegs (Modbus-Funktion 16)
Diese Funktion wird zum Beschreiben von 1 bis 128 Ausgangs-Register (16 Bit) benutzt.
VAR_INPUT
VAR_INPUT
sIPAddr : STRING(15);
nTCPPort : UINT:= MODBUS_TCP_PORT;
nUnitID : BYTE:=16#FF;
nQuantity : WORD;
nMBAddr : WORD;
cbLength : UDINT;
pSrcAddr : UDINT;
bExecute : BOOL;
tTimeout : TIME;
END_VAR
sIPAddr: Ist ein String, der die IP-Adresse des Zielgerätes enthält.
nTCPPort: Portnummer des Zielgerätes.
nUnitID: Identifizierungsnummer eines Gerätes eines seriellen Sub-Netzwerkes. Wenn ein Gerät direkt über TCP/IP angesprochen wird, muss dieser Wert 16#FF entsprechen.
nQuantity: Anzahl der zu schreibenden Ausgangs-Register (Datenworte).
nMBAddr: Startadresse der zu schreibenden Ausgangs-Register (Wortoffset).
cbLength: Enthält die max. verfügbare Bytegröße des Quellpuffers der die zu schreibende Registerwerte enthält. Der Puffer muss mindestens die Bytegröße: nQuantity * 2 besitzen.
pSrcAddr: Enthält die Adresse des Quellpuffers, der die zu schreibenden Daten enthält. Der Puffer kann eine Einzelvariable, ein Array oder eine Struktur sein, dessen Adresse mit dem ADR - Operator ermittelt werden kann.
bExecute: Durch eine steigende Flanke an diesem Eingang wird der Funktionsbaustein 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.
Function specific ADS error code | Possible reason |
---|---|
0x8001 | Nicht implementierte Modbus-Funktion |
0x8002 | Ungültige Adresse oder Länge |
0x8003 | Ungültige Parameter: - falsche Registeranzahl |
0x8004 | Fehler im Modbus-Server |
Beispiel für den Aufruf des Bausteins in FBD:
PROGRAM Test
VAR
fbWriteRegs : FB_MBWriteRegs;
bWriteRegs : BOOL;
bWriteRegsBusy : BOOL;
bWriteRegsError : BOOL;
nWriteRegsErrorId : UDINT;
nWriteRegsCount : UDINT;
nQuantity : WORD := 3;
nMBAddr : WORD := 4;
arrData : ARRAY [1..3] OF WORD;
END_VAR
Nach steigender Flanke von "bExecute" und erfolgreicher Ausführung des ReadRegs-Befehls, wird der Inhalt des Arrays arrData in die Register 5-7 geschrieben.
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
---|---|---|
TwinCAT v2.8.0 | PC (i386) | TcModbusSrv.Lib |