FB_CobotControllerFeedback - General Information

Overview

Type:	Function block
Available as of:	V1.0.1.0
Inherits from:	-
Implements:	IF_CobotControllerFeedback

This chapter provides information on:

Task
Description
Interface
Diagnostic Messages
Methods
Properties

Task

The function block is used to retrieve data from the Lexium Cobot.

Description

The function block provides several methods and properties to establish a TCP connection to a Lexium Cobot controller and to retrieve feedback data. The function block is implemented as a TCP client.

An individual instance of the function block must be instantiated for each Lexium Cobot controller to establish a TCP connection.

The Lexium Cobot controller sends the robot feedback data cyclically as soon as a TCP connection is established.

Interface

Input	Data type	Description
i_xEnable	BOOL	A rising edge FALSE –> TRUE activates and initializes the function block. A falling edge TRUE –> FALSE deactivates the function block. A deactivated function block does not execute any actions and all outputs are set to the default value.
i_xErrorQuit	BOOL	When an error is detected and reported at the diagnostic outputs of the function block, the machine enters an error state. A rising edge at this input resets the error and the diagnostic outputs. The function block resumes its working state.

Input

Data type

Description

i_xEnable

BOOL

A rising edge FALSE –> TRUE activates and initializes the function block.

A falling edge TRUE –> FALSE deactivates the function block.

A deactivated function block does not execute any actions and all outputs are set to the default value.

i_xErrorQuit

BOOL

When an error is detected and reported at the diagnostic outputs of the function block, the machine enters an error state.

A rising edge at this input resets the error and the diagnostic outputs.

The function block resumes its working state.

Output	Data type	Description
q_xActive	BOOL	TRUE: The POU is active and must continue its processing until FALSE. FALSE: The POU is inactive.
q_xReady	BOOL	TRUE: The POU is ready to operate and can accept user commands. FALSE: The function block is not ready to accept user commands.
q_xError	BOOL	Indicates TRUE if an error was detected. For details, refer to q_etResult and q_sResultMsg.
q_etResult	ET_Result	Provides diagnostic and status information as a numeric value. If q_xError = FALSE, q_etResult provides status information. If q_xError = TRUE, q_etResult provides diagnostic/error information.
q_sResultMsg	STRING[80]	Provides additional diagnostic and status information as a text message.

Diagnostic Messages

q_xError	q_etDiagExt	Enumeration value	Description
TRUE	AddressInUse	15	The requested address is already in use.
TRUE	CertificateInvalid	20	The certificate is invalid.
TRUE	CertificateNotFound	17	The certificate was not found.
TRUE	CertificateVerificationFailed	18	The verification of the certificate was not successful.
TRUE	CommandResponseCorrupt	13	The command response is invalid.
TRUE	ConnectionClosedByPeer	37	The connection is closed by peer.
TRUE	ConnectionRefused	16	The connection was refused.
TRUE	InitTlsContextFailed	19	The initialization of the TLS context was not successful.
TRUE	ResultUnknown	8	The result is undefined.
TRUE	Timeout	9	A timeout occurred.
FALSE	Disabled	1	The function block is disabled.
FALSE	WaitUntilDisabled	3	The function block is being disabled.
FALSE	Working	2	The function block is enabled and working.

AddressInUse

Enumeration name:	AddressInUse
Enumeration value:	15
Description:	The requested address is already in use.

Issue	Cause	Solution
The function block cannot execute operations.	The IP address / port combination is not unique.	Verify that the combination of IP address and port is unique and not used by another client. For FB_CobotControllerFeedback, port 10000 (refer to Gc_uiPortCobotControllerFeedback) is used to establish a connection to a Lexium Cobot controller.

Issue

Cause

Solution

The function block cannot execute operations.

The IP address / port combination is not unique.

Verify that the combination of IP address and port is unique and not used by another client.

For FB_CobotControllerFeedback, port 10000 (refer to Gc_uiPortCobotControllerFeedback) is used to establish a connection to a Lexium Cobot controller.

CertificateInvalid

Enumeration name:	CertificateInvalid
Enumeration value:	20
Description:	The certificate is invalid.

Issue	Cause	Solution
The function block cannot execute operations.	The certificate located in the folder Trusted Certificates in the Security Screen does not have a private key. For further information, refer to the Security Screen (Machine Expert > V2.0 > Software > Programming > Menu Commands Online Help > Security Screen ) in the Online Help.	Contact your Schneider Electric representative.

Issue

Cause

Solution

The function block cannot execute operations.

The certificate located in the folder Trusted Certificates in the Security Screen does not have a private key.

For further information, refer to the Security Screen (Machine Expert > V2.0 > Software > Programming > Menu Commands Online Help > Security Screen ) in the Online Help.

Contact your Schneider Electric representative.

CertificateNotFound

Enumeration name:	CertificateNotFound
Enumeration value:	17
Description:	The certificate was not found.

Issue	Cause	Solution
The function block cannot execute operations.	The certificate could not be found in the certificate store of the controller.	The certificate with the corresponding name must be in the folder Trusted Certificates in the Security Screen. For further information, refer to the Security Screen (Machine Expert > V2.0 > Software > Programming > Menu Commands Online Help > Security Screen ) in the Online Help.

Issue

Cause

Solution

The function block cannot execute operations.

The certificate could not be found in the certificate store of the controller.

The certificate with the corresponding name must be in the folder Trusted Certificates in the Security Screen.

For further information, refer to the Security Screen (Machine Expert > V2.0 > Software > Programming > Menu Commands Online Help > Security Screen ) in the Online Help.

CertificateVerificationFailed

Enumeration name:	CertificateVerificationFailed
Enumeration value:	18
Description:	The verification of the certificate was not successful.

Issue	Cause	Solution
The function block cannot execute operations.	The certificate of the Lexium Cobot is not trusted or is not valid.	The certificate with the corresponding name must be in the folder Trusted Certificates in the Security Screen. For further information, refer to the Security Screen (Machine Expert > V2.0 > Software > Programming > Menu Commands Online Help > Security Screen ) in the Online Help.

Issue

Cause

Solution

The function block cannot execute operations.

The certificate of the Lexium Cobot is not trusted or is not valid.

The certificate with the corresponding name must be in the folder Trusted Certificates in the Security Screen.

For further information, refer to the Security Screen (Machine Expert > V2.0 > Software > Programming > Menu Commands Online Help > Security Screen ) in the Online Help.

CommandResponseCorrupt

Enumeration name:	CommandResponseCorrupt
Enumeration value:	13
Description:	The command response is invalid.

Issue	Cause	Solution
The function block cannot execute operations.	The command response of Lexium Cobot controller is invalid and cannot be interpreted.	Contact your Schneider Electric representative.

ConnectionRefused

Enumeration name:	ConnectionRefused
Enumeration value:	16
Description:	The connection was refused.

Issue	Cause	Solution
The function block cannot execute operations.	The attempt to establish a connection is unsuccessful because the Lexium Cobot controller denied it.	Verify that only one connection to a Lexium Cobot controller is established.

ConnectionClosedByPeer

Enumeration name:	ConnectionClosedByPeer
Enumeration value:	37
Description:	The connection is closed by peer.

Issue	Cause	Solution
The function block cannot execute operations.	The established TCP connection is closed by the Lexium Cobot controller.	Re-establish the connection to the Lexium Cobot controller using the method Connect() or ConnectTLS().

Disabled

Enumeration name:	Disabled
Enumeration value:	1
Description:	The function block is disabled.

Issue	Cause	Solution
The method was not called successfully.	The function block is disabled. A disabled function block does not execute any actions and all outputs are set to the default value.	Ensure that the function block is enabled. Enable the function block by setting the input i_xEnable to TRUE. The function block will report TRUE at its outputs q_xActive and q_xReady after the enable routine is successfully finished.

Issue

Cause

Solution

The method was not called successfully.

The function block is disabled.

A disabled function block does not execute any actions and all outputs are set to the default value.

Ensure that the function block is enabled.

Enable the function block by setting the input i_xEnable to TRUE. The function block will report TRUE at its outputs q_xActive and q_xReady after the enable routine is successfully finished.

InitTlsContextFailed

Enumeration name:	InitTlsContextFailed
Enumeration value:	19
Description:	The initialization of the TLS context was not successful.

Issue	Cause	Solution
The function block cannot execute operations.	An internal error was detected while initializing the TLS context..	A maximum of 10 TLS connections can be established at the same time. Ensure that no more than 10 TCP sockets using TLS are open.

Issue

Cause

Solution

The function block cannot execute operations.

An internal error was detected while initializing the TLS context..

A maximum of 10 TLS connections can be established at the same time.

Ensure that no more than 10 TCP sockets using TLS are open.

ResultUnknown

Enumeration name:	ResultUnknown
Enumeration value:	8
Description:	The result is undefined.

Issue	Cause	Solution
The function block cannot execute operations.	A case instruction did not cover the reported result.	Contact your Schneider Electric representative.

Timeout

Enumeration name:	Timeout
Enumeration value:	9
Description:	A timeout occurred.

Issue	Cause	Solution
The function block cannot execute operations.	A timeout occurred while establishing a connection with the Lexium Cobot controller.	Re-establish the connection to the Lexium Cobot controller by calling the method Connect() or ConnectTLS().
The function block cannot execute operations.	A timeout occurred while retrieving the response to an assigned command from the Lexium Cobot controller. The established connection to the Lexium Cobot controller was disconnected.	Re-establish the connection to the Lexium Cobot controller by calling the method Connect() or ConnectTLS().

WaitUntilDisabled

Enumeration name:	WaitUntilDisabled
Enumeration value:	3
Description:	The function block is being disabled.

The input i_xEnable of the function block was set from TRUE to FALSE.

The function block is being disabled.

Working

Enumeration name:	Working
Enumeration value:	2
Description:	The function block is enabled and working.

Methods

Name	Description
Connect	Establishes a connection to the TCP server of a Lexium Cobot controller without using TLS encryption.
ConnectTLS	Establishes a connection to the TCP server of a Lexium Cobot controller using TLS encryption.
Disconnect	Disconnects an established connection from the TCP server of a Lexium Cobot controller.
RegisterLoggerPoint	Registers the function block to the Application Logger.

Properties

Name	Data type	Accessing	Description
etConnectionState	ET_ConnectionState	Read	Specifies the connection state of the function block to the Lexium Cobot controller.
rstData	REFERENCE TO ST_FeedbackData	Read	Specifies the data structure in which the robot feedback data is provided. The robot feedback data is updated when new data is available from the Lexium Cobot controller during each call of the function block. The Lexium Cobot controller sends the robot feedback data cyclically as soon as a TCP connection is established.
xTLSUsed	BOOL	Read	TRUE: A connection to the TCP server of a Lexium Cobot controller using TLS encryption is established.

Name

Data type

Accessing

Description

etConnectionState

ET_ConnectionState

Read

Specifies the connection state of the function block to the Lexium Cobot controller.

rstData

REFERENCE TO ST_FeedbackData

Read

Specifies the data structure in which the robot feedback data is provided.

The robot feedback data is updated when new data is available from the Lexium Cobot controller during each call of the function block.

The Lexium Cobot controller sends the robot feedback data cyclically as soon as a TCP connection is established.

xTLSUsed

BOOL

Read

TRUE: A connection to the TCP server of a Lexium Cobot controller using TLS encryption is established.