7.9 OPC UA Variable Mapping to PtFunctionType Properties

Table 54 lists the OPC UA Variables and the drive properties represented by Variables which are components of ObjectTypes specified above.

The Variables listed are components of a parent folder which belongs to the Object. The parent folder is specified in the row preceding the rows specifying the Variables which belong to this very folder.

The "Modelling Rule" columns have an entry for each ObjectType supporting the Variable listed in the respective row. If an ObjectType does not support the Variable, the respective column is empty. The modelling rules "optional" and "optional placeholder" are not distinguished.

Table 54 - Powertrain - Functional Model Properties represented by OPC UA Variables
PtFrequencyDriveAxisTypePtVelocityDriveAxisTypePtPositioningDriveAxisTypePtVelocityServoDriveAxisTypePtPositionServoDriveAxisTypePtTorqueServoDriveAxisTypePtEncoderAxisTypePtGearAxisType
BrowseNameModelling RuleDescription
Monitoring
AccelerationActualValueOOOOOOCurrent acceleration of motor or axis.
AccelerationCommandAdditiveValueOOOOAdditional additive value for AccelerationSetpoint (e.g. precontrol value from motion controller).
AccelerationSetpointOOOOOAcceleration setpoint as input for motor/axis control algorithm.
AxisTorqueForceOOOOOOOActual force or torque that is provided at the end of the full drive train. Differentiation via unit e.g. Nm or N. Shall be provided only if it differs from TorqueForceActualValue (e.g. a gear following the motor and the drive control command value refers to the motor and not to the powertrain output).
AxisOutputVelocityOOOOOOOActual velocity that is provided at the end of the full drive train. Can be interpreted as rotational velocity or linear velocity. Differentiation via unit e.g. rpm or m/s. Shall be provided only if it differs from VelocityActualValue (e.g. a gear following the motor and the velocity or drive control command value refers to the motor and not to the powertrain output).
AxisStateMMMMMMActual state of the Powertrain Axis Object' internal state machine, e.g. S2, encoded as 0:MultiStateValueDiscreteType. The content of the EnumStrings lookup table Property is defined in Table 20.
BrakeStateOOOOOOOActual brake status encoded as PtBrakeStateVariableType. The Variable shall not be provided if the Drive Axis has no brake.
ControlModeOOOOOOActive control function in the overall control cascade, e.g. SPEED_CONTROL_MODE, encoded as 0:MultiStateValueDiscreteType. The content of the EnumStrings lookup table Property is defined in Table 20.
ControlPriorityMMMMMMMOLeading control context, e.g. Fieldbus or Local, of the Powertrain Axis Object encoded as PtControlPriorityVariableType.
DeviceTemperatureOOOOOOOOActual device temperature. May be used if no separate motor and converter temperature is available.
<EncoderxTemperature>OOOOOOActual temperature of encoder feedback sensor.
FrequencyCommandValueMCommanded frequency value, transmitted from the controller to the drive by Fieldbus communication or analogue input clamp.
FrequencySetpointMOOOOOFrequency setpoint as input for motor/axis control algorithm.
GearInputShaftTurningDirectionOOOOOOOTurning direction of gear input shaft, encoded as PtShaftTurningDirectionVariableType.
GearInputTorqueOOOOOOOActual torque that is provided/measured to/at the gearbox input shaft.
GearInputVelocityOOOOOOOActual velocity that is provided/measured to/at the gearbox. Most commonly a rotational velocity.
GearOutputShaftTurningDirectionOOOOOOOTurning direction of gear output shaft, encoded as PtShaftTurningDirectionVariableType.
GearOutputTorqueOOOOOOOActual torque that is provided/measured at the end of the gearbox (classical rotational output)
GearOutputVelocityOOOOOOOActual rotational velocity that is provided/measured at the output shaft of the gearbox.
GearRatioOOOOOOMIf gear ratio is adjustable, active ratio should be shown here. Gear factor represented as ratio of input turns / output turns.
GearStateOOOOOOOIf there are multiple gear stages that can be switched the current "state" should be presented here. It is encoded as PtGearStateVariableType.
GearTemperatureOOOOOOOActual temperature for monitoring the gearbox. E.g. oil sump.
HomingStateMOOOHoming state (NOT_REFERENCED, REFERENCED).
MotorTemperatureOOOOOOActual motor temperature.
OverrideOActive override factor on programmed velocity in percent (100% == programmed velocity).
PositionActualValueOMOMMMCurrent position of motor or axis.
PositionCommandValueOMCommanded position of the controller.
PositionFollowingErrorOOActual difference between PositionSetpoint and PositionActualValue.
PositionSetpointOOSetpoint as input for motor/axis control algorithm.
ShaftTurningDirectionOOOOOOOOTurning direction of the shaft, encoded as PtShaftTurningDirectionVariableType.
TorqueForceActualValueOOOOOOActual axis torque. Means torque for a rotatory axis and force for a linear axis.
TorqueForceCommandAdditiveValueOOOOOAdditional value for commanded torque/force of the controller, transmitted by associated signal, or fixed offset value e.g. for compensation of weight or constant process forces.
TorqueForceCommandValueOOOCommanded torque/force value, transmitted from the controller to the drive by Fieldbus communication or analogue input clamp.
CurrentTorqueCommandValueOOOCommanded torque related current of the controller, transmitted by the associated Telegram Signal.
TorqueForceSetpointOOOOOTorque/Force setpoint as input for motor/axis control unit.
TraversingTaskMCurrent active/executed traversing task. May be commanded via fieldbus by PLC or is commanded by drive internal program execution. Details are visible at referenced PtTraversingTaskType Object.
VelocityActualValueOMMMMOOCurrent velocity of axis. Corresponds to VelocityCommandValue.
VelocityCommandAdditiveValueOOOAdditional additive value for Velocity Setpoint (e.g. precontrol value from motion controller).
VelocityCommandValueMMOCommanded velocity value, transmitted from the controller to the drive by Fieldbus communication or analogue input clamp.
VelocityFollowingErrorOOOOActual difference between VelocitySetpoint and VelocityActualValue.
VelocitySetpointMOOMVelocity setpoint as input for motor/axis control algorithm.
<VibrationSensor_x>OOOOOOOOPtVibrationSensorType Object representing an attached vibration sensor.
Maintenance
GearBacklashOOOOOOOMeasured value of wear.
GearMaintenanceStatusOOOOOOOOStatus indicator with the values "Green", "Yellow", "Red", encoded as PtMaintenanceStatusVariableType. Provided if no Gear x Object present.
GearOilRemainingUsefulLifetimeOOOOOOOORemaining hours until scheduled maintenance, in hours or percentage. Provided if no Gear x Object present.
<Gear_x>
MaintenanceStatus
OOOOOOOOStatus indicator with the values "Green", "Yellow", "Red", encoded as PtMaintenanceStatusVariableType.
<Gear_x>
OilRemainingUsefulLifetime
OOOOOOOORemaining hours until scheduled maintenance, in hours or percentage.
<Motor_x>, <Converter>, <Encoder_x> ,<Brake_x>, <Gear_x>
PowerOnDuration
OOOOOOOOActual duration of the power-on-state of motor x in milliseconds.
<Motor_x> , <Converter>, <Encoder_x> ,<Brake_x>, <Gear_x>
OperationDuration
OOOOOOOOActual duration of performing effective operation of motor x in milliseconds.
<Motor_x> , <Converter>, <Encoder_x> ,<Brake_x>, <Gear_x>
OperationCycleCounter
OOOOOOOONumber of switches of motor x between power-on and operation.
<Motor_x>PeakUtilizationOOOOOOOOUtilization of motor (converter) capacity, in % of converter load limit (0% - 100%), applies for motor x. Provide if global PeakUtilization Variable is not provided or not adequate.
<Motor_x>
RemainingUsefulLifetime
OOOOOOOORemaining hours until scheduled maintenance, in hours or percentage, applies for motor x. Provide if global RemainingUsefulLifetime Variable is not provided or not adequate.
<Motor_x>
ThermalCapacityUtilization
OOOOOOOOUtilization of motor thermal capacity, in % of motor load limit (0% - 100%), applies for motor x. Provide if global ThermalCapacityUtilization Variable is not provided or not adequate.
OperationCycleCounterOOOOOOOONumber of switches between power-on and operation.
OperationDurationOOOOOOOOActual duration of performing effective operation of the Powertrain Axis Object (e.g. the Drive's motor "works") in milliseconds.
PeakUtilizationOOOOOOOOUtilization of motor (converter) capacity, in % of converter load limit (0% - 100%).
PowerOnDurationOOOOOOOOActual duration of the power-on-state in milliseconds of the Powertrain Axis Object.
RemainingUsefulLifetimeOOOOOOOORemaining hours until scheduled maintenance, in hours or percentage.
ThermalCapacityUtilizationOOOOOOOOUtilization of motor (converter) thermal capacity, in % of converter load limit (0% - 100%).
CharacteristicsMotorAndControl
FeedbackModeOOOOOOSensing device used by closed loop control of the Powertrain Axis Object, e.g. FEEDBACK_SENSOR_1, encoded as 0:MultiStateValueDiscreteType. The content of the EnumStrings lookup table Property is defined in Table 20.
MotorForceRatedOOOOOORated force of a linear moving axis.
MotorPowerRatedMMMMMMRated power of the motor.
MotorSpeedRatedOOOOOORated speed of rotatory motor. If the motor of the axis does not work rotatory, the Variable shall not be provided.
MotorTorqueRatedOOOOOORated torque of the motor.
MotorTypeMMMMMMKind of motor, e.g. STEPPER, INDUCTION_ROTATORY, etc. encoded as 0:MultiStateValueDiscreteType. The content of the EnumStrings lookup table Property is defined in Table 20.
PositionFollowingErrorLimitOOOOOOMaximum allowed position deviation in the position closed loop control. Exceeding this limit causes position following error.
SpeedMaxConfiguredOOOOOOMaximum speed determined by configuration data.
TimePeriodPositionControlOOTime period for calculation of position control.
TimePeriodTorqueControlOOOOOTime period for calculation of torque control.
TimePeriodTrajectoryInterpolationOTime period for delivering of new trajectory setpoint.
TimePeriodVelocityControlOOOOOTime period for calculation of velocity control
TorqueMaxConfiguredOOOOOOMaximum torque determined by configuration data.
TrajectoryInterpolationModeOInterpolation mode of trajectory interpolator
VelocityFollowingErrorLimitOOOOOOMaximum allowed velocity deviation in the velocity closed loop control. Exceeding this limit causes velocity following error.
LimitSupervisionOOMOOO
SoftwarePosLimitHighMOMOSoftware upper position limit.
SoftwarePosLimitLowMOMOSoftware lower position limit.
TorqueLimitOOOOMOTorque limit of the motor.
TorqueLimitHighOOOMOOUpper torque limit of the motor.
TorqueLimitingOOOOIndicates if torque limiting is active.
TorqueLimitLowOOOMOOLower torque limit of the motor.
VelocityProfileMMMMM
JogPosInc1OOJogging position increment 1.
JogPosInc2OOJogging position increment 2.
JogSpeed1OOOOOOJogging setpoint 1 value (see [PDP], chapter 6.3.3.3.4).
JogSpeed2OOOOOOJogging setpoint 2 value (see [PDP], chapter 6.3.3.3.4).
MaximumVelocityOOOOOOHighest speed of the ramp-function.
MinimumVelocityOOOOOOLowest speed of the ramp-function.
NominalSpeedMMMMMOReference value for ramp up (down) used to calculate ramp acceleration (deceleration)
QuickStopVelocityRampDecelerationMMMMMOQuick stop ramp deceleration.
QuickStopVelocityRampDownTimeMMMMMOQuick stop ramp down time, in seconds.
VelocityRampAccelerationMMActual ramp acceleration.
VelocityRampDecelerationMMMMMOActual ramp deceleration.
VelocityRampDownTimeMMMMMOActual ramp down time of the RFG (see RfgRampUpTime above), in seconds
VelocityRampUpTimeMMActual ramp up time of the Ramp Function Generator (RFG), see [PDP], chapter 6.3.3, in seconds
CharacteristicsMechanicsOOOO
GearFactorPreciseOOOOOOOMay be used if GearRatio is not precise enough. Structure representing the Gear factor as ratio of input turns / output turns. Mechanical movement at the input to mechanical movement at the output (transmission factor).
GearRatioOOOOOOORotation to rotation transmission factor. Mechanical movement at the input to mechanical movement at the output (transmission factor). Shall be provided if a gear is present in the Powertrain Axis Object.
SpindlePitchOOOORotation to linear transmission factor. Mechanical movement at the input to mechanical movement at the output (transmission factor).
HomingMMMM
HomingDirectionOOHoming direction (POSITIVE or NEGATIVE)
HomingModeMOMOActive homing mode (ABSOLUTE, REF_MARK, DIST_CODE, FLY).
HomingPointOffsetOOHome position shift for adjustment of axis mechanical zero.
HomingSpeedToCamOOSpeed when moving to cam.
HomingSpeedToMarkOOSpeed when moving to mark.
Diagnosis
LogbookMMMMMMOOPtLogbookType mapping the content of the Powertrain Axis Object diagnosis system.
LogObjectOOOOOOOO0:LogObjectType (specified in OPC 10000-26) mapping the content of the Powertrain Axis Object diagnosis system.