FB_RobotPSeriesParameters - InitializeOrientationZ (Method)

Overview

Type:	Method
Available as of:	V2.19.0.0
Versions:	Current version

This chapter provides information on:

Task
Description
Interface
Diagnostic Messages

Task

Configure a drive mapping for OrientationZ.

Description

By calling up the method, the drive handed over at input i_ifDrive is used to configure a drive mapping for OrientationZ.

The drive handed over at input i_ifDrive is configured as ROB.ET_RobotComponent.AxisD for the robot and the OrientationZ (ROB.ET_RobotComponent.OrientationZ) is then mapped to AxisD.

NOTE: Use ET_RobotPSeriesComponent.RotationalAxis if you want to call the methods SetControlLoopParameter, GetControlLoopParameter or Calibration.

For further information, refer to the methods ROB.IF_RobotConfiguration.AddDrive (see Robotic, Library Guide), ROB.IF_RobotConfiguration.MapComponentToDrive (see Robotic, Library Guide), SER.IF_RobotPSeries.SetControlLoopParameter (see SchneiderElectricRobotics, Library Guide), SER.IF_RobotPSeries.GetControlLoopParameter (see SchneiderElectricRobotics, Library Guide), and SER.IF_RobotPSeriesCalibration (see SchneiderElectricRobotics, Library Guide)

Interface

Input	Data type	Description
i_ifDrive	SystemConfigurationItf.IF_Drive	Drive of a rotational axis.

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 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.

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 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.

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
OK	NoRotationalAxisRequired	11	There is no rotational axis required.
OK	Ok	0	Ok
ExecutionAborted	FourthAxisAlreadyConfigured	24	The fourth axis is already configured.
ExecutionAborted	RobotNotInitialized	6	The robot is not initialized.
InputParameterInvalid	DriveInvalid	4	The drive is invalid.

DriveInvalid

Enumeration name:	DriveInvalid
Enumeration value:	4
Description:	The drive is invalid.

Issue	Cause	Solution
The configuration of OrientationZ was unsuccessful	The interface transferred at the input i_ifDrive is invalid.	Ensure that the transferred interface is an interface of a valid drive. The following interfaces have to be implemented by the drive object: SystemConfigurationItf.IF_Mechanic SystemConfigurationItf.IF_SetLimits SystemConfigurationItf.IF_Motor SystemConfigurationItf.IF_ControlLoop SystemConfigurationItf.IF_RefActualValues SystemConfigurationItf.IF_ControlMode SystemConfigurationItf.IF_EncoderGear SystemConfigurationItf.IF_EncoderDirection SystemConfigurationItf.IF_Brake SystemConfigurationItf.IF_YoffsetGenerator

Issue

Cause

Solution

The configuration of OrientationZ was unsuccessful

The interface transferred at the input i_ifDrive is invalid.

Ensure that the transferred interface is an interface of a valid drive.

The following interfaces have to be implemented by the drive object:

SystemConfigurationItf.IF_Mechanic
SystemConfigurationItf.IF_SetLimits
SystemConfigurationItf.IF_Motor
SystemConfigurationItf.IF_ControlLoop
SystemConfigurationItf.IF_RefActualValues
SystemConfigurationItf.IF_ControlMode
SystemConfigurationItf.IF_EncoderGear
SystemConfigurationItf.IF_EncoderDirection
SystemConfigurationItf.IF_Brake
SystemConfigurationItf.IF_YoffsetGenerator

FourthAxisAlreadyConfigured

Enumeration name:	FourthAxisAlreadyConfigured
Enumeration value:	24
Description:	The fourth axis is already configured.

Issue	Cause	Solution
The configuration of OrientationZ was unsuccessful	A method to configure the fourth axis was already called successfully.	Call only one of the methods InitializeRotationalAxis or InitializeOrientationZ.
The configuration of OrientationZ was unsuccessful		Call the method InitializeOrientationZ only once.

NoRotationalAxisRequired

Enumeration name:	NoRotationalAxisRequired
Enumeration value:	11
Description:	There is no rotational axis required.

Configuring the rotational axis is not necessary.

Ok

Enumeration name:	Ok
Enumeration value:	0
Description:	Ok

The configuration of the rotational axis for OrientationZ was successful.

RobotNotInitialized

Enumeration name:	RobotNotInitialized
Enumeration value:	6
Description:	The robot is not initialized.

Issue	Cause	Solution
The configuration of OrientationZ was unsuccessful	The Lexium P Robot is not initialized.	Call the method InitializeRobot before calling the method InitializeOrientationZ.