FB_TlsSocketAddCa

The FB_TlsSocketAddCa function block is used to configure the path to a CA certificate for an existing socket handle. The certificate file 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;
    sCaPath   : STRING(TCPADS_TLS_CERTIFICATE_PATH_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.
sCaPath	STRING(TCPADS_TLS_CERTIFICATE_PATH_SIZE)	Path to the CA's certificate file.
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)

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)