10 MachineConfigurationType
10.1 MachineConfigurationType Definition
This OPC UA ObjectType represents the current configuration of a machine. It is formally defined in Table 27.

| 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 | ||
10.2 UserMachineName
The UserMachineName Property represents the description of the machine given by the machine operator or OPC client (e.g. "machine 42").
10.3 LocationName
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").
10.4 TimeZoneOffset
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.
10.5 SetMachineTime
The SetMachineTime Method allows setting the server time together with TimeZoneOffset.
Signature
SetMachineTime (
[in] 0:DateTime DateTime
[in] 0:TimeZoneDataType TimeZoneOffset);| Argument | Description |
| DateTime | Date and time in UTC time |
| TimeZoneOffset | Time difference from UTC in minutes incl. daylight saving time |
| 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.
10.6 PageDirectory
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.
| 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 |
10.7 GetPage
Method for retrieving the image of a page of the control system.
Signature
GetPage (
[in] 0:String Id
[out] 0:Image Page);| Argument | Description |
| Id | Id of the Page |
| Page | Image of a page of the control system (ImageBMP, ImageGIF, ImageJPG or ImagePNG) |
| 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 |
10.8 GetCurrentPage
Method for retrieving a screenshot of the control system with the currently shown contents.
Signature
GetCurrentPage (
[in] 0:UInt32 VisualisationUnit
[out] 0:Image Page);| 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) |
| 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 |