IF_RobotConfiguration - GetLinearTrackingSystem (Method)

Overview

Type:

Method

Available as of:

V1.6.0.0

This chapter provides information on:

Task

Reading the data of a configured linear tracking system of the robot.

Description

With the method GetLinearTrackingSystem(...), the data of a configured linear tracking system of the robot can be read.

Interface

Input

Data type

Description

i_etName

ET_CoordinateSystem

Name of the linear tracking system from which the configured parameters have to be read.

Output

Data type

Description

q_etDiag

GD.ET_Diag

General, library-independent statement on the diagnostic.

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

q_etDiagExt

ET_DiagExt

POU-specific output for 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.

q_ifVelocitySource

SystemConfigurationItf.IF_IdentificationMandatory

Configured velocity source of the linear tracking system.

q_lencEncoder

SystemConfiguration.L_ENC

Configured logical encoder which is linked to the velocity source.

q_stOffset

PDL.ST_Vector3D

Configured shift of the origin of the linear tracking system in relation to the robot coordinate system ET_CoordinateSystem.CSR.

Unit: [mm]

q_etOrientationConvention

ET_OrientationConvention

Configured convention of the rotation angles of the orientation q_stOrientation.

q_stOrientation

PDL.ST_Vector3D

Configured rotation of the linear tracking system in relation to the robot coordinate system ET_CoordinateSystem.CSR.

Unit: [°]

q_xInvertDirectionX

BOOL

Invert the positive X direction of the linear tracking system.

q_xInvertDirectionY

BOOL

Invert the positive Y direction of the linear tracking system.

q_xInvertDirectionZ

BOOL

Invert the positive Z direction of the linear tracking system.

q_stDirectionEx

PDL.ST_Vector3D

Direction vector of the positive cartesian X axis of the linear tracking system in robot coordinate system ET_CoordinateSystem.CSR.

q_stDirectionEy

PDL.ST_Vector3D

Direction vector of the positive cartesian Y axis of the linear tracking system in robot coordinate system ET_CoordinateSystem.CSR.

q_stDirectionEz

PDL.ST_Vector3D

Direction vector of the positive cartesian Z axis of the linear tracking system in robot coordinate system ET_CoordinateSystem.CSR.

q_etTrackingDirection

ET_RobotComponent

Positive Cartesian axis of the tracking coordinate system which is used for tracking.

Diagnostic Messages

q_etDiag

q_etDiagExt

Enumeration value

Description

OK

Ok

0

Ok

ExecutionAborted

ExternalPositionSourceConfigured

205

The external position source is configured.

InputParameterInvalid

CoordinateSystemInvalid

117

The coordinate system is invalid.

InputParameterInvalid

CoordinateSystemNotConfigured

172

The coordinate system is not configured.

CoordinateSystemInvalid

Enumeration name:

CoordinateSystemInvalid

Enumeration value:

117

Description:

The coordinate system is invalid.

Issue

Cause

Solution

Reading a configured linear tracking system of the robot was unsuccessful.

The value transferred at the input i_etName is invalid.

At the input i_etName, a value of ET_CoordinateSystem must be transferred.

CoordinateSystemNotConfigured

Enumeration name:

CoordinateSystemNotConfigured

Enumeration value:

172

Description:

The coordinate system is not configured.

Issue

Cause

Solution

Reading a configured linear tracking system of the robot was unsuccessful.

The requested linear tracking system at the input i_etName is not configured.

If required, configure a linear tracking system with the configuration method IF_RobotConfiguration.AddLinearTrackingSystem first.

ExternalPositionSourceConfigured

Enumeration name:

ExternalPositionSourceConfigured

Enumeration value:

205

Description:

The external position source is configured.

Issue

Cause

Solution

Reading a configured linear tracking system of the robot was unsuccessful.

An external position source for the robot components cartesian, orientation and auxiliary axes is configured.

Reading the parameters of a linear tracking system of the robot is not possible when an external position source for the robot components is configured.

Do not read the parameters.

Ok

Enumeration name:

Ok

Enumeration value:

0

Description:

Ok

Reading a configured linear tracking system of the robot was successful.