Skip to main content

Aufruf einer externen Funktion

Mit diesem Mechanismus lässt sich in einer IEC-Applikation über einen Unix Domain Socket eine externe Funktion aufrufen. Dadurch können eigene Funktionalitäten erstellt werden. Gleichzeitig wird eine Prozesstrennung erreicht. Als Schnittstelle in IEC wird der Funktionsbaustein EXTAPI.UDSExternalFunction in der Bibliothek ExtensionAPI mitgeliefert. In Python dient dafür die Klasse ExternalFunctionBase, die im mitgelieferten Beispiel bereitgestellt wird.

Auch die Verwendung des Mechanismus wird anhand dieses Beispiels erklärt, das in C:\\Users\\<Benutzer>\\CODESYS Control SL Extension Package\\<Version>\\Examples\\ExternalCall abgelegt ist. Das Beispiel enthält ein IEC-Projekt mit implementiertem Aufruf einer externen Funktion. Weiter enthält das Beispiel die Implementierung der aufgerufenen Funktion myExternalFunction in Python.

Beispiel, IEC-Applikation

Im Beispielprojekt UDSExternalCallExample.project wird ein neuer Funktionsbaustein myExternalFunction erstellt. Dieser erweitert den FB EXTAPI.UDSExternalFunction um Ein- und Ausgänge vom Typ DINT. Auch andere Datentypen sind möglich. Zu Beginn muss der Name der in Python aufzurufenden Funktion übergeben werden. Dieser muss eindeutig sein.

Mit folgendem Code werden die Eingänge der externen Funktion der Schnittstelle hinzugefügt:

Result := THIS^.AddParameter('parameterIn1', 'DINT', TO_STRING(diIn1));

Mit folgendem Code wird dann die externe Funktion aufgerufen:

Result := THIS^.Call();

Mit folgendem Code wird der Rückgabewert der in Python implementierten Funktion abgefragt:

Result := THIS^.GetParameter('parameterOut', 'DINT', ADR(sValue));

Die Parameter sind vom Typ String. Entsprechend muss in den gewünschten Datentyp gecastet werden.

Beispiel, Python-Skript

Das mitgelieferte Beispiel uds_external_function.py bietet die Klasse ExternalFunctionBase, die die Unix Domain Socket-Kommunikation mit dem Laufzeitsystem für diese Funktionalität ermöglicht.

Die im Beispiel implementierte Klasse myExternalFunction erweitert die Klasse ExternalFunctionBase. Notwendig ist die Funktion Call(), die von dem Mechanismus aus IEC aufgerufen wird. Ein- und Ausgabeparameter werden in Form von Tupeln von Strings übergeben.

Beispiel: {'parameterIn1': ('DINT', '11'), 'parameterIn2': ('DINT', '22')}

Im Beispiel implementiert die Call()-Funktion ein einfaches Addieren der zwei Eingangsparameter:

def Call(self, dictParams):
    in1 = int(dictParams['parameterIn1'][1])
    in2 = int(dictParams['parameterIn2'][1])

    dictRetParams = {}
    dictRetParams['parameterOut'] = 'DINT', in1 + in2

    return dictRetParams

Verwendung der Schnittstelle nur als Mitglied der Linux-Benutzergruppe codesysuser

JA

Prozesstrennung

JA