IF_ConfigurationAdvanced - ModifyCoordinateSystem (Method)

Overview

Type:	Method
Available as of:	V1.0.0.0

This chapter provides information on:

Task
Description
Interface
Diagnostic Messages

Task

Modifying the robot coordinate system.

Description

With the method ModifyCoordinateSystem(…), the robot coordinate system can be modified.

Execution sequence of the shift or rotation of the output coordinate system (robot coordinate system) CS0:

1.	Shifting the coordinate system CS0 by the offsets X, Y, Z. This creates the coordinate system CS1.

2.	Rotation of the coordinate system CS1 around its X axis. This creates the coordinate system CS2.

3.	Rotation of the coordinate system CS2 around its Y axis. This creates the coordinate system CS3.

4.	Rotation of the coordinate system CS3 around its Z axis. This creates the coordinate system CS4.

The coordinate system CS4 corresponds to the shifted and rotated coordinate system.

Interface

Input	Data type	Description
i_etName	ROB.ET_CoordinateSystem	Name of the coordinate system that has to be modified.
i_stOffset	PDL.ST_Vector3D	Describes the shifting of the coordinate system in relation to the world coordinate system. Unit: [Units]
i_stOrientation	PDL.ST_Vector3D	Describes the rotation of the coordinate system in relation to the world coordinate system. Unit: [°]
i_xInvertDirectionX	BOOL	Invert the positive X direction of the coordinate system.
i_xInvertDirectionY	BOOL	Invert the positive Y direction of the coordinate system.
i_xInvertDirectionZ	BOOL	Invert the positive Z direction of the coordinate system.

Output	Data type	Description
q_etDiag	GD.ET_Diag	General library-independent statement on the diagnostic. A value not equal to ET_Diag.Ok corresponds to a diagnostic message.
q_etDiagExt	ET_DiagExt	POU-specific output on the diagnostic. q_etDiag = ET_Diag.Ok -> Status message q_etDiag <> ET_Diag.Ok -> Diagnostic message
q_sMsg	STRING[80]	Event-triggered message that gives additional information on the diagnostic state.

Output

Data type

Description

q_etDiag

GD.ET_Diag

General library-independent statement on the diagnostic.

A value not equal to ET_Diag.Ok corresponds to a diagnostic message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnostic.

q_etDiag = ET_Diag.Ok -> Status message

q_etDiag <> ET_Diag.Ok -> Diagnostic message

q_sMsg

STRING[80]

Event-triggered message that gives additional information on the diagnostic state.

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
OK	Ok	0	Ok
ExecutionAborted	ExternalPositionSourceConfigured	357	The external position source is configured.
	InMotion	84	The robot is in motion.
	TrackingActive	270	Tracking is active.
	TransformationMissing	172	The transformation is unavailable.
InputParameterInvalid	CoordinateSystemInvalid	93	The coordinate system is invalid.
	InvertDirectionXInvalid	255	InvertDirectionX is invalid.
	InvertDirectionYInvalid	256	InvertDirectionY is invalid.
	InvertDirectionZInvalid	257	InvertDirectionZ is invalid.
	OffsetInvalid	253	The Offset is invalid.
	OrientationInvalid	254	The orientation is invalid.

CoordinateSystemInvalid

Enumeration name:	CoordinateSystemInvalid
Enumeration value:	93
Description:	The coordinate system is invalid.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	The value transferred at the input i_etName is invalid.	At the input i_etName, a value of ROB.ET_CoordinateSystem must be transferred.

ExternalPositionSourceConfigured

Enumeration name:	ExternalPositionSourceConfigured
Enumeration value:	357
Description:	The external position source is configured.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	An external position source for the robot components cartesian, orientation and auxiliary axes is configured.	The modification of a tracking coordinate system of the robot is not possible when an external position source for the robot components is configured. NOTE: Do not modify a tracking coordinate system of the robot.

InMotion

Enumeration name:	InMotion
Enumeration value:	84
Description:	The robot is in motion.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	A motion is active in the coordinate system that has to be modified.	Do not call ModifyCoordinateSystem(...) while the robot is in motion.

InvertDirectionXInvalid

Enumeration name:	InvertDirectionXInvalid
Enumeration value:	255
Description:	InvertDirectionX is invalid.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	A two-dimensional transformation, in the YZ plane, is configured.	Ensure that the input i_xInvertDirectionX is set to FALSE.

InvertDirectionYInvalid

Enumeration name:	InvertDirectionYInvalid
Enumeration value:	256
Description:	InvertDirectionY is invalid.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	A two-dimensional transformation, in the XZ plane, is configured.	Ensure that the input i_xInvertDirectionY is set to FALSE.

InvertDirectionZInvalid

Enumeration name:	InvertDirectionZInvalid
Enumeration value:	257
Description:	InvertDirectionZ is invalid.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	A two-dimensional transformation, in the XY plane, is configured.	Ensure that the input i_xInvertDirectionZ is set to FALSE.

OffsetInvalid

Enumeration name:	OffsetInvalid
Enumeration value:	253
Description:	The Offset is invalid.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	A two-dimensional transformation, in the XY plane, is configured.	Ensure that the input i_stOffset.lrZ is set to 0.
	A two-dimensional transformation, in the XZ plane, is configured.	Ensure that the input i_stOffset.lrY is set to 0.
	A two-dimensional transformation, in the YZ plane, is configured.	Ensure that the input i_stOffset.lrX is set to 0.

Ok

Enumeration name:	Ok
Enumeration value:	0
Description:	Ok

The modification of a coordinate system of the robot was successful.

OrientationInvalid

Enumeration name:	OrientationInvalid
Enumeration value:	254
Description:	The orientation is invalid.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	A two-dimensional transformation, in the XY plane, is configured.	Ensure that the inputs i_stOrientation.lrX and i_stOrientation.lrY are set to 0.
	A two-dimensional transformation, in the XZ plane, is configured.	Ensure that the inputs i_stOrientation.lrX and i_stOrientation.lrZ are set to 0.
	A two-dimensional transformation, in the YZ plane, is configured.	Ensure that the inputs i_stOrientation.lrY and i_stOrientation.lrZ are set to 0.

TrackingActive

Enumeration name:	TrackingActive
Enumeration value:	270
Description:	Tracking is active.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	The robot is still in tracking and not in coordinate system ROB.ET_CoordinateSystem.CSR.	Do not call ModifyCoordinateSystem(...) while the robot is in tracking.

TransformationMissing

Enumeration name:	TransformationMissing
Enumeration value:	172
Description:	The transformation is unavailable.

Issue	Cause	Solution
The modification of a coordinate system of the robot was not successful.	There is no transformation of the robot configured.	Ensure that the transformation of the robot is configured before modifying the coordinate system.