8 OPC UA Interface Types
8.1 Electric Properties Interface Types
The InterfaceTypes specified in this section cover electric properties specific for electric Drives. These InterfaceTypes are referenced using the 0:HasInterface ReferenceType by the folder Object instances containing the Variables the Interfaces specify.
Future versions of this specification might specify additional InterfaceTypes for different Drive types, such as pneumatic Drives or hydraulic Drives. However, instances shall always only reference the one Interface which is specific for the represented Drive type.
8.1.1 IMonitoringElectric Interface
The IMonitoringElectric Interface specifies the Variables representing electric properties which are components of the Monitoring Folder. Instances of the Monitoring folder shall reference this InterfaceType if the containing Powertrain Axis Object represents an electric Drive.
| Attribute | Value | ||||
| BrowseName | IMonitoringElectric | ||||
| IsAbstract | True | ||||
| References | Node Class | BrowseName | DataType | TypeDefinition | Other |
|---|---|---|---|---|---|
| Subtype of the 0:BaseInterfaceType defined in OPC 10000-5. | |||||
| 0:HasComponent | Variable | BleederTemperature | 0:Float | PtTemperatureVariableType | O, RO |
| 0:HasComponent | Variable | ConverterOutputCosPhi | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputCurrent | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputCurrentTorque | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputCurrentMagnetization | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputFrequency | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputPower | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputVoltage | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputVoltageMagnetization | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterOutputVoltageTorque | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | ConverterTemperature | 0:Float | PtTemperatureVariableType | O, RO |
| 0:HasComponent | Variable | DcBusVoltage | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | LineInputPower | 0:Float | 0:AnalogUnitType | O, RO |
| Conformance Units | |||||
|---|---|---|---|---|---|
| Powertrain Actual and Command Values |
The BleederTemperature Variable contains the actual temperature of the brake resistor.
The ConverterOutputCosPhi Variable contains the actual motor power factor.
The ConverterOutputCurrent Variable contains the actual current measured at the output converter clamp as rms value.
The ConverterOutputCurrentMagnetization Variable contains the motor magnetization related output current of the output converter as rms value.
The ConverterOutputCurrentTorque Variable contains the motor torque related output current of the output converter as rms value.
The ConverterOutputFrequency Variable contains the output frequency of the output converter.
The ConverterOutputPower Variable contains the actual power delivered to the motor.
The ConverterOutputVoltage Variable contains the output voltage RMS of the output converter as rms value.
The ConverterOutputVoltageMagnetization Variable contains the motor magnetization related output voltage of the output converter as rms value.
The ConverterOutputVoltageTorque Variable contains the motor torque related output voltage of the output converter as rms value.
The ConverterTemperature Variable contains the actual converter temperature.
The DcBusVoltage Variable contains the actual DC bus voltage value.
The LineInputPower Variable contains the actual input power consumption of the converter.
8.1.2 ICharacteristicsMotorAndControlElectric Interface
The ICharacteristicsMotorAndControlElectric Interface specifies the Variables representing electric properties which are components of the CharacteristicsMotorAndControl Folder. Instances of the CharacteristicsMotorAndControl folder shall reference this InterfaceType if the containing Powertrain Axis Object represents an electric Drive.
| Attribute | Value | ||||
| BrowseName | ICharacteristicsMotorAndControlElectric | ||||
| IsAbstract | True | ||||
| References | Node Class | BrowseName | DataType | TypeDefinition | Other |
|---|---|---|---|---|---|
| Subtype of the 0:BaseInterfaceType defined in OPC 10000-5. | |||||
| 0:HasComponent | Variable | MotorDcBrakingCurrent | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | DcBrakingTime | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | MotorMaxCurrent | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | MotorPeakCurrentConfigured | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | MotorRunUpVoltage | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | MotorThermalLoadLimitConfigured | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasProperty | Variable | MotorUfRatio | 0:Float | 0:PropertyType | O, RO |
| 0:HasComponent | Variable | TimePeriodCurrentControl | 0:Float | 0:AnalogUnitType | O, RO |
| Conformance Units | |||||
|---|---|---|---|---|---|
| Powertrain Actual and Command Values |
The MotorDcBrakingCurrent Variable contains the DC-current applied to the motor during braking.
The DcBrakingTime Variable contains the time needed in DC-braking mode until stand still if the braking current given by the MotorDcBrakingCurrent Variable is applied.
The MotorMaxCurrent Variable contains the maximum current the motor draws from the power supply.
The MotorPeakCurrentConfigured Variable contains the peak current of motor determined by configuration data.
The MotorRunUpVoltage Variable contains the voltage the motor creates at the feeder clamp during start-up.
The MotorThermalLoadLimitConfigured Variable contains the thermal load limit of motor determined by configuration data.
The MotorUfRatio Property contains the constant ratio of voltage and frequency.
The TimePeriodCurrentControl Variable contains the time period for calculation of current control.
8.1.3 ILimitSupervisionElectric
The ILimitSupervisionElectric Interface specifies the Variables representing electric properties which are components of the LimitSupervision Folder. Instances of the LimitSupervision folder shall reference this InterfaceType if the containing Powertrain Axis Object represents an electric Drive.
| Attribute | Value | ||||
| BrowseName | ILimitSupervisionElectric | ||||
| IsAbstract | True | ||||
| References | Node Class | BrowseName | DataType | TypeDefinition | Other |
|---|---|---|---|---|---|
| Subtype of the 0:BaseInterfaceType defined in OPC 10000-5. | |||||
| 0:HasComponent | Variable | MotorCurrentLimitLow | 0:Float | 0:AnalogUnitType | O, RO |
| 0:HasComponent | Variable | MotorCurrentLimitHigh | 0:Float | 0:AnalogUnitType | O, RO |
| Conformance Units | |||||
|---|---|---|---|---|---|
| Powertrain Actual and Command Values |
The MotorCurrentLimitHigh Variable contains the currently active upper motor current limit of the Powertrain Axis Object.
The MotorCurrentLimitLow Variable contains the currently active lower motor current limit of the Powertrain Axis Object.
8.2 InterfaceTypes for Export and use within other OPC UA models
This section specifies InterfaceTypes which are intended to be used by other companion specifications or for vendor specific models. These "Export"- Interfaces are the same then defined in the OPC UA for Machinery part 40001-5 IMachineryDriveAxisType and IMachineryServoDriveAxisType definitions and contain an extract of variables to be used as an easy PTS or drives model showing the basic states and information about a drive or servo drive axis. All variables in these interfaces are taken out of the complete PTS model specified in this companion specification.
8.2.1 IDriveAxis Interface
The IDriveAxis InterfaceType contains the basis states and information for a PTS variable speed or variable frequency drive axis type.
| Attribute | Value | ||||
| BrowseName | IDriveAxis | ||||
| IsAbstract | True | ||||
| References | Node Class | BrowseName | DataType | TypeDefinition | Other |
|---|---|---|---|---|---|
| Subtype of the 0:BaseInterfaceType defined in OPC 10000-5. | |||||
| 0:HasComponent | Variable | AxisType | 0:UInt16 | 0:MultiStateValueDiscreteType | O, RO |
| 0:HasComponent | Variable | ControlMode | 0:UInt16 | 0:MultiStateValueDiscreteType | O, RO |
| 0:HasComponent | Variable | AxisState | 0:UInt16 | 0:MultiStateValueDiscreteType | O, RO |
| 0:HasComponent | Variable | BrakeState | 0:UInt16 | 0:MultiStateValueDiscreteType | O, RO |
| 0:HasComponent | Variable | VelocityActualValue | 0:Float | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | VelocityFollowingError | 0:Float | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | TorqueForceActualValue | 0:Float | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | ShaftTurningDirection | 0:UInt16 | 0:MultiStateValueDiscreteType | O, RO |
| 0:HasComponent | Variable | AccelerationActualValue | 0:Float | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | MotorTemperature | 0:Float | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | ConverterTemperature | 0:Float | 0:BaseAnalogType | O, RO |
| Conformance Units | |||||
|---|---|---|---|---|---|
The AxisType Variable contains the mechanical drive type of the represented Powertrain Axis Object modelled as 0:MultiStateValueDiscreteType (Corresponds to the AxisType Variable of the PtDriveAxisType) . The content of the EnumValues lookup table Property is defined in Table 20.
For a description of the other Variables see Table 54.
8.2.2 IServoDriveAxis Interface
The IServoDriveAxis InterfaceType contains the basis states and information for a PTS positioning or servo drive axis type. This InterfaceType shall not be used if the axis is only operating as a spindle or variable speed drive without any positioning functionality. In case of a spindle with positioning functionality, which is currently operating in variable speed mode, the access to Variables of the interface related to the positioning mode, shall return the BAD StatusCode in this case.
| Attribute | Value | ||||
| BrowseName | IServoDriveAxis | ||||
| IsAbstract | True | ||||
| References | Node Class | BrowseName | DataType | TypeDefinition | Other |
|---|---|---|---|---|---|
| Subtype of the IDriveAxis InterfaceType. | |||||
| 0:HasComponent | Variable | HomingState | 0:UInt16 | 0:MultiStateValueDiscreteType | O, RO |
| 0:HasComponent | Variable | PositionActualValue | 0:Double | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | PositionFollowingError | 0:Float | 0:BaseAnalogType | O, RO |
| 0:HasComponent | Variable | PositionOffset | 0:Float | 0:BaseAnalogType | O, RO |
| Conformance Units | |||||
|---|---|---|---|---|---|
The PositionOffset Variable contains the home position shift for adjustment of axis mechanical zero (see HomingPointOffset Variable in the Homing Folder also).
For a description of the other Variables see Table 54.