The WirelessMachineToolPeripheralType provides information about the WMTP itself. This ObjectType is the entry point to the OPC UA interface of a WMTP. An instance of this ObjectType aggregates all information related to one system.
It is highly recommended that all instances of a WirelessMachineToolPeripheralType are referenced from the 3:Machines node defined in OPC 40001-1.
The WirelessMachineToolPeripheralType is formally defined in Table 15.
Table 15 – WirelessMachineToolPeripheralType Definition
|
Attribute |
Value |
||||
|
BrowseName |
WirelessMachineToolPeripheralType |
||||
|
IsAbstract |
False |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
Subtype of the BaseObjectType defined in OPC 10000-5 |
|||||
|
0:HasComponent |
Object |
DeviceConfiguration |
|
0:FolderType |
O |
|
0:HasComponent |
Object |
DeviceInformation |
|
0:FolderType |
M |
|
0:HasComponent |
Object |
WMTPWorkCycleData |
|
WMTPWorkCycleDataType |
O |
|
0:HasComponent |
Object |
WMTPServiceCycleData |
|
WMTPServiceCycleDataType |
O |
|
0:HasAddIn |
Object |
3:LifetimeCounters |
|
3:MachineryLifetimeCounterType |
O |
|
0:HasAddIn |
Object |
3:OperationCounters |
|
3:MachineryOperationCounterType |
O |
|
0:HasComponent |
Object |
Measurements |
|
0:FolderType |
M |
|
0:HasComponent |
Object |
3:MachineryBuildingBlocks |
|
0:FolderType |
M |
|
Conformance Units |
|||||
|
WMTP Basic |
|||||
|
WMTP DeviceConfiguration Calibration Capabilities |
|||||
|
WMTP DeviceConfiguration Time Capabilities |
|||||
|
WMTP Firmware Services |
|||||
|
WMTP License Services |
|||||
|
WMTP BatteryLevel |
|||||
|
WMTP Service and LifeCycle Information Basic |
|||||
|
WMTP Service and LifeCycle Information Advanced |
|||||
|
WMTP Temperature Measurement |
|||||
|
WMTP RotationSpeed Measurement |
|||||
|
WMTP Humidity Measurement |
|||||
|
WMTP Acceleration Measurement |
|||||
|
WMTP Force Measurement |
|||||
|
WMTP Torque Measurement |
|||||
|
WMTP Position Measurement |
|||||
|
WMTP Dimension Measurement |
|||||
|
WMTP WorkCycleData |
|||||
|
WMTP ServiceCycleData |
|||||
DeviceConfiguration is representing a collection of all nodes that enable configuration or provide information on the configuration of a WMTP.
DeviceInformation is representing a collection of all nodes that provide information about the WMTP.
WMTPWorkCycleData enables the handling of measured work cycles.
WMTPServiceCycleData enables the handling of service data of the WMTP.
MachineryLifetimeCounters is representing a collection of all counters with a start and an end value. It is used as the MachineryLifetimeCounterType defined in OPC 40001-1. In the information model for WMTP, all counters that are implemented according to the MachineryLifetimeCounterType of the OPC 40001-1 shall be integrated with the HasComponent reference under this Object. This Object shall also be referenced as HasAddIn in the MachineryBuildingBlocks Folder.
MachineryOperationCounters is representing a collection of all incrementing counters. It is used as the MachineryOperationCounterType defined in OPC 40001-1. In the information model for WMTP, all counters that are implemented according to the MachineryLifetimeCounterType of the OPC 40001-1 shall be integrated with the HasComponent reference under this Object. This Object shall also be referenced as HasAddIn in the MachineryBuildingBlocks Folder.
Measurements is representing a collection of all nodes that provide values measured by the WMTP, such as temperature, rotation speed, humidity, etc.
MachineryBuildingBlocks is representing a folder that directly references all those building blocks of the OPC UA for Machinery (OPC 40001-1, OPC 40001-3) which are implemented with an HasAddIn reference in this information model.
The components of the WirelessMachineToolPeripheralType have additional references which are defined in Table 16.
Table 16 – WirelessMachineToolPeripheralType Additional References
|
SourceBrowsePath |
Reference Type |
Is Forward |
TargetBrowsePath |
||
|
3:MachineryBuildingBlocks |
0:HasAddIn |
True |
|
||
|
3:MachineryBuildingBlocks |
0:HasAddIn |
True |
3:LifetimeCounters |
||
|
3:MachineryBuildingBlocks |
0:HasAddIn |
True |
3:OperationCounters |
The components of the WirelessMachineToolPeripheralType have additional subcomponents which are defined in Table 17.
Table 17 – WirelessMachineToolPeripheralType Additional Subcomponents
|
Source Path |
Reference |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
Others |
|
DeviceConfiguration |
0:HasProperty |
Variable |
CalibrationMode |
0:Boolean |
0:PropertyType |
O |
|
DeviceConfiguration |
0:HasComponent |
Method |
SetDeviceTime |
|
|
O |
|
DeviceConfiguration |
0:HasComponent |
Method |
UpdateFirmware |
|
|
O |
|
DeviceConfiguration |
0:HasComponent |
Method |
SendLicenseData |
|
|
O |
|
DeviceConfiguration |
0:HasComponent |
Method |
SwitchCalibrationMode |
|
|
O |
|
DeviceInformation |
0:HasAddIn |
Object |
2:Identification |
|
3:MachineryComponentIdentificationType |
M |
|
DeviceInformation |
0:HasComponent |
Object |
BatteryLevel |
|
6:ProcessValueType |
O |
|
DeviceInformation |
0:HasProperty |
Variable |
LicenseInformation |
0:String |
0:PropertyType |
O |
|
DeviceInformation |
0:HasProperty |
Variable |
NextServiceDate |
0:UtcTime |
0:PropertyType |
O |
|
DeviceInformation |
0:HasProperty |
Variable |
LastService |
0:UtcTime |
0:PropertyType |
O |
|
DeviceInformation |
0:HasComponent |
Variable |
LifeCycleStatus |
0:UInt32 |
0:MultiStateValueDiscreteType |
O |
|
3:LifetimeCounters |
0:HasComponent |
Variable |
LicenseValidity |
0:Number |
2:LifetimeVariableType |
O |
|
3:LifetimeCounters |
0:HasComponent |
Variable |
RemainingLifetimeCounter |
0:Number |
2:LifetimeVariableType |
O |
|
3:LifetimeCounters |
0:HasComponent |
Variable |
RemainingCycleCounter |
0:Number |
2:LifetimeVariableType |
O |
|
3:LifetimeCounters |
0:HasComponent |
Variable |
NextServiceCounter |
0:Number |
2:LifetimeVariableType |
O |
|
3:OperationCounters |
0:HasComponent |
Variable |
OperationSinceLastServiceCounter |
0:Duration |
0:BaseDataVariableType |
O |
|
Measurements |
0:HasComponent |
Object |
<Temperature> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<RotationSpeed> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<Humidity> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<Acceleration> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<Force> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<Torque> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<Position> |
|
WMTPMeasurementType |
OP |
|
Measurements |
0:HasComponent |
Object |
<Dimension> |
|
WMTPMeasurementType |
OP |
CalibrationMode indicates whether the device is currently in calibration mode or not. True means the WMTP is in calibration mode.
SetDeviceTime enables writing the current date and time on the WMTP.
UpdateFirmware enables transferring a new firmware to the WMTP. Possible implementation or monitoring of the installation takes place independently of OPC UA on the respective WMTP and is solved differently by different manufacturers.
SendLicenseData enables transferring license data to the WMTP. Possible implementation or monitoring of the installation takes place independently of OPC UA on the respective WMTP and is solved differently by different manufacturers.
SwitchCalibrationMode enables the WMTP to be switched to calibration mode and back.
Identification is used as defined in OPC 40001-1 and shall also be referenced as AddIn in the
MachineryBuildingBlocks Folder.
BatteryLevel contains all data on the current battery level of the WMTP.
LicenseInformation contains information about the license of the WMTP. How this information looks like is solved differently by different manufacturers.
NextServiceDate is the date when the next maintenance is scheduled.
LastService is the date when the last maintenance of the device was carried out.
LifeCycleStatus is a parameter which outputs the life cycle in the form of four stages (unknown, green, yellow, red). This parameter is generated internally in the WMTP and is solved differently by different manufacturers.
LicenseValidity is used as the MachineryLifetimeCounterType is defined in OPC 40001-1. It is representing a counter that counts down a time value specified by the manufacturer of the WMTP. At the end of this period, the license of the WMTP Software is not valid anymore.
RemainingLifetimeCounter is used as the MachineryLifetimeCounterType is defined in OPC 40001-1. It is representing a counter that counts down a time value specified by the manufacturer of the WMTP. At the end of this period, the WMTP has reached its maximum lifetime.
RemainingCycleCounter is used as the MachineryLifetimeCounterType is defined in OPC 40001-1. It is representing a counter that counts down a number of working cycles specified by the manufacturer of the WMTP. At the end of this period, the WMTP has reached its maximum service life.
NextServiceCounter is used as the MachineryLifetimeCounterType is defined in OPC 40001-1. It is representing a counter that counts down a time value specified by the manufacturer of the WMTP. A service is to be carried out when this time period expires.
OperationSinceLastServiceCounter is representing a counter that counts the duration of use since the last service of the WMTP.
Temperature contains all data on the measured temperature.
RotationSpeed contains all data on the measured rotational speed.
Humidity contains all data on the measured humidity.
Acceleration contains all data on the measured acceleration of the WMTP.
Force contains all data on the measured force.
Torque contains all data on the measured torque.
Position contains all data on the measured position of the WMTP.
Dimension contains all data on the measured dimension.
NOTE: The list of measurements is representing the most used types. The model can be extended as required by the end user.
A child Node of the WirelessMachineToolPeripheralType has an additional Attribute value defined in Table 18.
Table 18 – WirelessMachineToolPeripheralType Attribute values for child nodes
|
BrowsePath |
Value Attribute |
Description Attribute |
|||
|
[ {"Value": 0, "DisplayName": "green", "Description": ""}, {"Value": 1, "DisplayName": "yellow", "Description": ""}, {"Value": 2, "DisplayName": "red", "Description": ""}, ] |
|
The Method SetDeviceTime allows to set the device time. The signature of this Method is specified below.
Signature
SetDeviceTime (
[in]0:DateTime DateTime,
[in]0:TimeZoneDataTypeTimeZoneOffset
);
Table 19 – SetDeviceTime Method Arguments
|
Argument |
Description |
|
DateTime |
Date and time in UTC time |
|
TimeZoneOffset |
Time difference from UTC in minutes |
Table 20 – SetDeviceTime Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
SetDeviceTime |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |
NOTE: A call with DateTime = "2024-02-03 12:00" (UTC time) and TimeZoneOffset = {120; true}, sets the (local) machine time to "03-02-2024 14:00" and the time zone to "UTC+2".
The Method UpdateFirmware sends a new firmware to be transferred to the WMTP. The signature of this Method is specified below.
Signature
UpdateFirmware (
[in]0:Byte[]FirmwareData
);
Table 21 – UpdateFirmware Method Arguments
|
Argument |
Description |
|
FirmwareData |
This array of bytes contains the corresponding firmware to be loaded onto the WMTP. |
Table 22 – UpdateFirmware Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
UpdateFirmware |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |
The Method SendLicenseData sends license data to the WMTP. The signature of this Method is specified below.
Signature
SendLicenseData (
[in]0:Byte[]LicenseData
);
Table 23 – SendLicenseData Method Arguments
|
Argument |
Description |
|
LicenseData |
This array of bytes contains the corresponding license information to be transfered onto the WMTP. |
Table 24 – SendLicenseData Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
SendLicenseData |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |
The Method SwitchCalibrationMode enables to switch the WMTP between "Calibrate" mode and "Use" mode. The signature of this Method is specified below.
Signature
SwitchCalibrationMode (
[in]0:UInt16TargetMode
);
Table 25 – SwitchCalibrationMode Method Arguments
|
Argument |
Description |
|
TargetMode |
Describes the mode in which the WMTP is to be set. NOTE: The TargetMode is from DataType UInt16. Two different entries should be used: -0 exit calibration mode -1 enter calibration mode |
Table 26 – SwitchCalibrationMode Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
SwitchCalibrationMode |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |