FB_TlsSocketSetPsk
Mit dem Funktionsbaustein FB_TlsSocketSetPsk kann ein Pre-Shared-Secret für ein existierendes Socket-Handle konfiguriert werden. Programmierbeispiele zur Verwendung dieses Funktionsbausteins finden Sie in unseren Samples.
Eingänge
VAR_INPUT
sSrvNetId : T_AmsNetId:='';
hSocket : T_HSOCKET;
sIdentity : STRING(TCPADS_TLS_PSK_IDENTITY_SIZE):='';
pskKey : PVOID:=0;
pskKeyLen : UDINT(0..TCPADS_TLS_MAX_PSK_KEY_SIZE):=0;
bExecute : BOOL;
tTimeout : TIME:=T#5s;
END_VAR
Name | Typ | Beschreibung |
|---|---|---|
sSrvNetId | T_AmsNetId | String mit der Netzwerkadresse des TwinCAT TCP/IP Connection Servers. Für den lokalen Rechner (default) kann auch ein Leerstring angegeben werden. |
hSocket | T_HSOCKET | Socket-Handle. |
sIdentity | STRING(TCPADS_TLS_PSK_IDENTITY_SIZE) | Eine frei wählbare Identity für das PSK. |
pskKey | PVOID | Pointer auf ein Byte-Array, welches das PSK enthält. |
pskKeyLen | UDINT(0..TCPADS_TLS_MAX_PSK_KEY_SIZE) | Länge von pskKey. |
bExecute | BOOL | Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert. |
tTimeout | TIME | Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf. |
Ausgänge
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrId : UDINT;
END_VAR
Name | Typ | Beschreibung |
|---|---|---|
bBusy | BOOL | Bei aktiviertem Funktionsbaustein ist diese Ausgabe aktiv. Sie bleibt bis zur Quittierung aktiv. |
bError | BOOL | Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde. |
nErrId | UDINT | Dieser Parameter liefert bei einem gesetzten bError-Ausgang die TwinCAT TCP/IP Connection Server Fehlernummer. |
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken (Kategoriegruppe) |
|---|---|---|
TF6310 v3.3.15.0 oder neuer TwinCAT v3.1.0 | PC oder CX (x86, x64, ARM) | Tc2_TcpIp (Communication) |