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

image012.png

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