FC_OpenSlcCommunication - General Information

Overview

Type:	Function
Available as of:	V1.0.0.0
Versions:	Current version

Description

NOTE: This function is only supported by PacDrive LMC controllers.

The function FC_OpenSlcCommunication activates the required port rules for the controller firewall. This allows for communication of the programming software with the controller and for collecting messages for the logger (see the Safe Logger tab in the device editor of the PacDrive LMC controllers).

After a restart, the firewall is configured according to the default configuration file. Refer to How to Configure the Firewall for PacDrive LMC Controllers User Guide.

It is a good practice to keep the port rules activated only as long as needed. Use the FC_CloseSlcCommunication to deactivate the port rules after your communication to the SLC (Safety Logic Controller) is no longer needed.

WARNING
	UNAUTHENTICATED ACCESS AND SUBSEQUENT UNAUTHORIZED MACHINE OPERATION Evaluate whether your environment or your machines are connected to your critical infrastructure and, if so, take appropriate steps in terms of prevention, based on Defense-in-Depth, before connecting the automation system to any network. Limit the number of devices connected to a network to the minimum necessary. Isolate your industrial network from other networks inside your company. Protect any network against unintended access by using firewalls, VPN, or other, proven security measures. Monitor activities within your systems. Prevent subject devices from direct access or direct link by unauthorized parties or unauthenticated actions. Prepare a recovery plan including backup of your system and process information. Failure to follow these instructions can result in death, serious injury, or equipment damage.

WARNING

UNAUTHENTICATED ACCESS AND SUBSEQUENT UNAUTHORIZED MACHINE OPERATION

Evaluate whether your environment or your machines are connected to your critical infrastructure and, if so, take appropriate steps in terms of prevention, based on Defense-in-Depth, before connecting the automation system to any network.
Limit the number of devices connected to a network to the minimum necessary.
Isolate your industrial network from other networks inside your company.
Protect any network against unintended access by using firewalls, VPN, or other, proven security measures.
Monitor activities within your systems.
Prevent subject devices from direct access or direct link by unauthorized parties or unauthenticated actions.
Prepare a recovery plan including backup of your system and process information.

Failure to follow these instructions can result in death, serious injury, or equipment damage.

Interface

Input	Data type	Description
i_ifSafeLogic	SystemConfigurationItf.IF_SafeLogic	Specifies the SLC (Safety Logic Controller) for which the communication should be enabled.

Output	Data type	Description
q_etResult	ET_Result	Provides diagnostic and status information as an enumeration value.
q_sResultMsg	STRING [80]	Provides additional diagnostic and status information as a text message.

Return Value

Data type	Description
BOOL	TRUE = SLC connection settings were adapted successfully. FALSE = SLC connecting settings cannot be set.

Diagnostic Messages

The following elements of ET_Result are used for q_etResult.

Name	Data type	Value	Description
Ok	UDINT	0	Operation completed successfully.
FunctionNotSupported	UDINT	100	Function not available for this controller.
InvalidIfSafeLogic	UDINT	200	The interface assigned to i_ifSafeLogic must be provided by an instance of the Safety Logic Controller in the Devices tree of the project.