8.5 DataTypes

8.5.1 SoftwareVersionFileType enumeration

This enumeration is used to identify the version in the methods of the TemporaryFileTransferType that is used in the PackageLoadingType (8.4.3). The Enumeration is defined in Table 112. Its representation in the AddressSpace is defined in Table 113.

Table 112 – SoftwareVersionFileType Items
Name Value Description
Current0The currently used version of the software identified by the CurrentVersion Object.
Pending1The Pending Version of the software that could be installed identified by the PendingVersion Object.
Fallback2The Fallback Version of the software identified by the FallbackVersion Object.
Table 113 – SoftwareVersionFileType definition
Attribute Value
BrowseName1:SoftwareVersionFileType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumStrings0:LocalizedText []0:PropertyType
Conformance Units
DI SU Software Update

8.5.2 UpdateBehavior OptionSet

The UpdateBehavior OptionSet is based on UInt32. It describes how the device can perform the update. All possible options are described in Table 114. All other values are reserved for future versions of this specification. The OptionSet is used in the UpdateBehavior Property of the DirectLoadingType (8.4.4.3) and in the GetUpdateBehavior Methods on the CachedLoadingType (8.4.5.5) and in the FileSystemLoadingType (8.4.6.3).

Table 114 – UpdateBehavior OptionSet
Value Bit No. Description
KeepsParameters0If KeepsParameters is not set, the device will lose its configuration during update. The Client should do a backup of the parameters before the update and restore them afterwards.
WillDisconnect1If WillDisconnect is set, the OPC UA Server will restart during installation. This can be the case if the update is about the firmware of the device that hosts the OPC UA Server.
RequiresPowerCycle2If RequiresPowerCycle is set, the devices require a manual power off / power on for installation.
WillReboot3If WillReboot is set, the device will reboot during the update, inclusive of embedded infrastructure elements like an integrated switch.
An update Client should take this into account since the devices behind an integrated switch are not reachable for that time.
NeedsPreparation4If NeedsPreparation is not set, the Client can install the update without maintaining the PrepareForUpdateStateMachine. This can be used to support an installation without stopping the software.

The UpdateBehavior OptionSet representation in the AddressSpace is defined in Table 115.

Table 115 – UpdateBehavior OptionSet Definition
Attribute Value
BrowseName1:UpdateBehavior
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of 0:UInt32 defined in OPC 10000-5.
0:HasPropertyVariable0:OptionSetValues0:LocalizedText[]0:PropertyType
Conformance Units
DI SU Software Update

8.5.3 SoftwareClass enumeration

This Enumeration is used to classify components, where instances of SoftwareUpdateType can be attached (see 8.3.2). The Enumeration is defined in Table 116. Its representation in the AddressSpace is defined in Table 117.

Table 116 – SoftwareClass Items
Name Value Description
Firmware0The software update is used for the firmware of a physical device.
Application1The software update is used for an executable software.
Configuration2The software update is used for the configuration of a device or application.
Solution3The software update is used to install a solution with several software package to several components.
Table 117 – SoftwareClass definition
Attribute Value
BrowseName1:SoftwareClass
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumStrings0:LocalizedText []0:PropertyType
Conformance Units
DI SU Software Update