This OPC UA ObjectType represents the current configuration of a machine. It is formally defined in Table 27.
Figure 6 – MachineConfigurationType Overview
Table 27 – MachineConfigurationType Definition
|
Attribute |
Value |
||||
|
BrowseName |
MachineConfigurationType |
||||
|
IsAbstract |
False |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
Subtype of 0:BaseObjectType defined in OPC UA Part 5 |
|||||
|
0:HasProperty |
Variable |
UserMachineName |
0:String |
0:PropertyType |
M, RW |
|
0:HasProperty |
Variable |
LocationName |
0:String |
0:PropertyType |
M, RW |
|
0:HasProperty |
Variable |
TimeZoneOffset |
0:TimeZoneDataType |
0:PropertyType |
M, RW |
|
0:HasComponent |
Method |
SetMachineTime |
|
|
M |
|
0:HasProperty |
Variable |
PageDirectory |
PageEntryDataType[] |
0:PropertyType |
O, RO |
|
0:HasComponent |
Method |
GetPage |
|
|
O |
|
0:HasComponent |
Method |
GetCurrentPage |
|
|
O |
The UserMachineName Property represents the description of the machine given by the machine operator or OPC client (e.g. "machine 42").
The LocationName Property represents the description of the location of the machine given by the machine operator or OPC client (e.g. "plant 2, hall C").
The TimeZoneOffset Property represents the difference of the local time to Coordinated Universal Time (UTC) given by the machine operator or OPC client.
Information: TimeZoneDataType (as defined in OPC UA Part 3) is a structure with two components:
- offset (0:UInt16): Time difference from UTC in minutes (e.g. 120 for daylight saving time in Berlin)
- daylightSavingInOffset (0:Boolean): If TRUE, then daylight saving time (DST) is in effect and offset includes the DST correction. If FALSE, then the offset does not include DST correction and DST may or may not have been in effect.
NOTE: The UTC time itself is part of OPC UA Part 5: ServerStatus CurrentTime.
The SetMachineTime Method allows setting the server time together with TimeZoneOffset.
Signature
SetMachineTime (
[in]0:DateTimeDateTime
[in]0:TimeZoneDataTypeTimeZoneOffset);
Table 28 – SetMachineTime Method Arguments
|
Argument |
Description |
|
DateTime |
Date and time in UTC time |
|
TimeZoneOffset |
Time difference from UTC in minutes incl. daylight saving time |
Table 29 – SetMachineTime Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
SetMachineTime |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Modelling Rule |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |
Example: A call with DateTime = "2021-04-30 12:00" (UTC time) and TimeZoneOffset = {120; true}, sets the (local) machine time to "30-04-2021 14:00" and the time zone to "UTC+2" with active daylight saving time.
The PageDirectory Property is an array and represents a list of the pages that are implemented in the machine control system and are shown on the screen of the machine. The used PageEntryDataType is defined in Table 30.
Table 30 – PageEntryDataType Definition
|
Name |
Type |
Description |
|
PageEntryDataType |
structure |
Subtype of 0:Structure as defined in OPC UA 10000-3 |
|
Id |
0:String |
Unique identifier defined by manufacturer |
|
Title |
0:LocalizedText |
Page Name |
Method for retrieving the image of a page of the control system.
Signature
GetPage (
[in]0:StringId
[out]0:ImagePage);
Table 31 – GetPage Method Arguments
|
Argument |
Description |
|
Id |
Id of the Page |
|
Page |
Image of a page of the control system (ImageBMP, ImageGIF, ImageJPG or ImagePNG) |
Table 32 – GetPage Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
GetPage |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Modelling Rule |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |
|
0:HasProperty |
Variable |
OutputArguments |
Argument[] |
0:PropertyType |
M |
Method for retrieving a screenshot of the control system with the currently shown contents.
Signature
GetCurrentPage (
[in]0:UInt32VisualisationUnit
[out]0:ImagePage);
Table 33 – GetCurrentPage Method Arguments
|
Argument |
Description |
|
VisualisationUnit |
Number of the visualisation unit from which the image should be created, 0 = default unit |
|
Page |
Image of a page of the control system (ImageBMP, ImageGIF, ImageJPG or ImagePNG) |
Table 34 – GetCurrentPage Method AddressSpace Definition
|
Attribute |
Value |
||||
|
BrowseName |
GetCurrentPage |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Modelling Rule |
|
0:HasProperty |
Variable |
InputArguments |
Argument[] |
0:PropertyType |
M |
|
0:HasProperty |
Variable |
OutputArguments |
Argument[] |
0:PropertyType |
M |