FB_IEC870_5_101Master
Mit einer Instanz des Funktionsbausteins FB_IEC870_5_101Master kann in der TwinCAT SPS eine IEC 60870-5-101 Zentralstation (Master, High-Level) implementiert werden. Pro Instanz des Funktionsbausteins wird eine Verbindung zum Slave aufgebaut. Im Normalfall wird der Datenaustausch automatisch gestartet, nachdem die Verbindung hergestellt wurde. Standardmäßig ist der Funktionsbaustein auch so konfiguriert.
VAR_IN_OUT
VAR_IN_OUT
hSerial : T_HSERIALCTRL;
hTable : T_HAODBTable;
END_VAR
hSerial: Verbindungs-Handle zum FB_IEC870_SerialLineCtrl-Funktionsbaustein. Über diese Variable werden mit dem FB_IEC870_SerialLineCtrl-Funktionsbaustein die zu sendenden und empfangenen Daten ausgetauscht.
hTable: Applikationsobjekt-Datenbankhandle (Hash-Tabellenhandle). Das Tabellenhandle muss vor der Benutzung einmalig mit der Funktion F_iecCreateTableHnd initialisiert werden.
VAR_INPUT
VAR_INPUT
protPara : ST_IEC870_5_101ProtocolParams := := ( eType := eIEC870_101_MASTER );
sysPara : ST_IEC870_5_101SystemParams := ( bEndOfInit := FALSE );
acqPara : ST_IEC870_5_101AcquisitionParams;
pAOEntries : POINTER TO ARRAY[0..IEC870_ANYSIZE_ARRAY] OF ST_IEC870_5_101AODBEntry := 0;
cbAOEntries : UDINT := 0;
pInputs : PVOID := 0;
cbInputs : UDINT := 0;
pOutputs : PVOID := 0;
cbOutputs : UDINT := 0;
pMemory : PVOID := 0;
cbMemory : UDINT := 0;
pData : PVOID := 0;
cbData : UDINT := 0;
bEnable : BOOL := TRUE;
END_VAR
protPara: IEC 60870-5-101-Protocolparameter.
sysPara: Systemparameter.
acqPara: Parameter für die zyklische Datenerfassung.
pAOEntries: Adresse der ersten Applikationsobjekt-Datenbankvariablen.
cbAOEntries: Bytegröße der Applikationsobjekt-Datenbankvariablen.
pInputs: Adresse des SPS-Prozessdatenbereichs der Eingänge.
cbInputs: Bytegröße des SPS-Prozessdatenbereichs der Eingänge.
pOutputs: Adresse des SPS-Prozessdatenbereichs der Ausgänge.
cbOutputs: Bytegröße des SPS-Prozessdatenbereichs der Ausgänge.
pMamory: Adresse des SPS-Prozessdatenbereichs der Merker.
cbMamory: Bytegröße des SPS-Prozessdatenbereichs der Merker.
pData: Adresse des SPS-Datenbereichs.
cbData: Bytegröße des SPS-Datenbereichs.
bEnable: Aktiviert/Deaktiviert den Funktionsbaustein (Kommunikation und Verbindungen).
Die Adressen können mit dem ADR- und die Bytegrößen mit dem SIZEOF-Operator ermittelt werden.
VAR_OUTPUT
VAR_OUTPUT
system : ST_IEC870_5_101ExSystemInterface;
eState : E_IEC870_5_101SerialLinkState := eSERIALLINK_DISCONNECTED;
END_VAR
system: System-Interface. Diese Variable dient anderen IEC-Applikationsfunktionen als Kommunikationsschnittstelle zum IEC-Gerät (hier: Zentralstation).
- Membervariable system.device wird z.B. von der F_iecSetAOQuality-Funktion als VAR_IN_OUT-Parameter erwartet.
- Membervariable system.device.errors ist ein Gerätefehler-Fifo. Die registrierten Fehler können von der SPS-Applikation ausgelesen und ausgewertet werden.
eState: Status der Verbindung zum Slave.
Beispiele (High-Level Interface):
Weitere Beispiele:
Im folgenden Beispiel wird der Gerätefehler-Fifo zyklisch ausgelesen und die registrierten Fehler ins TwinCAT XAE->"Error List"-Fenster geschrieben.
...
fbClient : FB_IEC870_5_101Master; (* IEC 60870-5-101 control station function block instance *)
...
...
REPEAT
fbClient.system.device.errors.RemoveError();
IF fbClient.system.device.errors.bOk THEN
ADSLOGSTR( ADSLOG_MSGTYPE_ERROR OR ADSLOG_MSGTYPE_LOG, 'IEC 60870-5-101 master communication error: 0x%s',
DWORD_TO_HEXSTR( fbClient.system.device.errors.getError.nErrId, 8, FALSE) );
END_IF
UNTIL NOT fbClient.system.device.errors.bOk
END_REPEAT
...
Voraussetzungen
Entwicklungsumgebung |
Zielplattform |
Einzubindende SPS Bibliotheken (Kategoriegruppe) |
---|---|---|
TwinCAT v3.1.4012.0 |
PC oder CX (x86, x64, ARM) |
Tc2_IEC60870_5_10x (Communication->IEC60870) |