10 MachineConfigurationType

10.1 MachineConfigurationType Definition

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
BrowseNameMachineConfigurationType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of 0:BaseObjectType defined in OPC UA Part 5
0:HasPropertyVariableUserMachineName0:String0:PropertyTypeM, RW
0:HasPropertyVariableLocationName0:String0:PropertyTypeM, RW
0:HasPropertyVariableTimeZoneOffset0:TimeZoneDataType0:PropertyTypeM, RW
0:HasComponent MethodSetMachineTimeM
0:HasPropertyVariablePageDirectoryPageEntryDataType[]0:PropertyTypeO, RO
0:HasComponent MethodGetPageO
0:HasComponent MethodGetCurrentPageO

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);
Table 28 – SetMachineTime Method Arguments
Argument Description
DateTimeDate and time in UTC time
TimeZoneOffsetTime difference from UTC in minutes incl. daylight saving time
Table 29 – SetMachineTime Method AddressSpace Definition
Attribute Value
BrowseNameSetMachineTime
References Node Class BrowseName DataType TypeDefinition Modelling Rule
0:HasPropertyVariableInputArgumentsArgument[]0:PropertyTypeM

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.

Table 30 – PageEntryDataType Definition
Name Type Description
PageEntryDataTypestructureSubtype of 0:Structure as defined in OPC UA 10000-3

Id

0:StringUnique identifier defined by manufacturer

Title

0:LocalizedTextPage 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);
Table 31 – GetPage Method Arguments
Argument Description
IdId 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
BrowseNameGetPage
References Node Class BrowseName DataType TypeDefinition Modelling Rule
0:HasPropertyVariableInputArgumentsArgument[]0:PropertyTypeM
0:HasPropertyVariableOutputArgumentsArgument[]0:PropertyTypeM

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);
Table 33 – GetCurrentPage Method Arguments
Argument Description
VisualisationUnitNumber 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
BrowseNameGetCurrentPage
References Node Class BrowseName DataType TypeDefinition Modelling Rule
0:HasPropertyVariableInputArgumentsArgument[]0:PropertyTypeM
0:HasPropertyVariableOutputArgumentsArgument[]0:PropertyTypeM