FB_TlsSocketSetCert
The function block FB_TlsSocketSetCert can be used to configure a client/server certificate that is to be used for a specific socket handle. The certificates must be in PEM format. Programming samples for using this function block can be found in our samples.
Inputs
VAR_INPUT
sSrvNetId : T_AmsNetId:='';
hSocket : T_HSOCKET;
sCertPath : STRING(TCPADS_TLS_CERTIFICATE_PATH_SIZE):='';
sKeyPath : STRING(TCPADS_TLS_CERTIFICATE_PATH_SIZE):='';
sKeyPwd : STRING(TCPADS_TLS_KEY_PASSWORD_SIZE):='';
bExecute : BOOL;
tTimeout : TIME:=T#5s;
END_VAR
Name | Type | Description |
|---|---|---|
sSrvNetId | T_AmsNetId | String containing the network address of the TwinCAT TCP/IP Connection Server. For the local computer (default) an empty string may be specified. |
hSocket | T_HSOCKET | Socket handle. |
sCertPath | STRING(TCPADS_TLS_CERTIFICATE_PATH_SIZE) | Path to the file with the client/server certificate. |
sKeyPath | STRING(TCPADS_TLS_CERTIFICATE_PATH_SIZE) | Path to the file with the client/server private key. |
sKeyPwd | STRING(TCPADS_TLS_KEY_PASSWORD_SIZE) | Optional, if the private key is secured with a password. |
bExecute | BOOL | The function block is enabled by a positive edge at this input. |
tTimeout | TIME | Maximum time allowed for the execution of the function block. |
Outputs
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrId : UDINT;
END_VAR
Name | Type | Description |
|---|---|---|
bBusy | BOOL | This output is active if the function block is activated. It remains active until acknowledgement. |
bError | BOOL | If an error should occur during the transfer of the command, then this output is set once the bBusy output was reset. |
nErrId | UDINT | If an bError output is set, this parameter returns the TwinCAT TCP/IP Connection Server error number. |
Requirements
Development environment | Target platform | PLC libraries to be integrated (category group) |
|---|---|---|
TF6310 v3.3.15.0 or later TwinCAT v3.1.0 | PC or CX (x86, x64, ARM) | Tc2_TcpIp (Communication) |