The SoftwareVersionType identifies a concrete version of a software. It is used by the CachedLoadingType (8.4.5) and the DirectLoadingType (8.4.4) to store the version information.
The Description Attribute on the instances of the SoftwareVersionType should be used to provide additional information about the concrete version of the software to the user (e.g., change notes).
The SoftwareVersionType is illustrated in Figure 47 and formally defined in Table 90.
Figure 47 – SoftwareVersionType
Table 90 – SoftwareVersionType definition
|
Attribute |
Value |
||||
|
BrowseName |
1:SoftwareVersionType |
||||
|
IsAbstract |
False |
||||
|
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
Other |
|
Subtype of the 0:BaseObjectType defined in OPC 10000-5 |
|||||
|
0:HasProperty |
Variable |
1:Manufacturer |
0:LocalizedText |
0:PropertyType |
M |
|
0:HasProperty |
Variable |
1:ManufacturerUri |
0:String |
0:PropertyType |
M |
|
0:HasProperty |
Variable |
1:SoftwareRevision |
0:String |
0:PropertyType |
M |
|
0:HasProperty |
Variable |
1:PatchIdentifiers |
0:String[] |
0:PropertyType |
O |
|
0:HasProperty |
Variable |
1:ReleaseDate |
0:DateTime |
0:PropertyType |
O |
|
0:HasProperty |
Variable |
1:ChangeLogReference |
0:String |
0:PropertyType |
O |
|
0:HasProperty |
Variable |
1:Hash |
0:ByteString |
0:PropertyType |
O |
|
0:HasComponent |
Method |
1:Clear |
|
|
O |
|
Conformance Units |
|||||
|
DI SU Software Update |
|||||
The read only Manufacturer Property provides the name of the company that created the software.
In case of the Pending Version this shall be empty if there is no pending software to install.
The read only ManufacturerUri Property provides a unique identifier for the manufacturer of the software.
In case of the Pending Version this shall be empty if there is no pending software to install.
The read only SoftwareRevision Property defines the version of the software. The format and semantics of the string is vendor-specific. SemanticVersionString (a sub-type of String defined in OPC 10000-5) can be used when using the Semantic Versioning format.
In case of the Pending Version this shall be empty if there is no pending software to install.
The read only PatchIdentifiers Property identifies the list of patches that are applied to a software version. The format and semantics of the strings are vendor-specific. The order of the strings shall not be relevant.
The read only ReleaseDate Property defines the date when the software is released. If the version information is about patches, this should be the date of the latest patch. It is additional information for the user.
The read only ChangeLogReference Property can optionally provide a URL to a web site with detailed information about the particular version of the software (change notes). In case of a patched software, the web site should also inform about the patches.
The optional read only Hash Property can be read by a Client to get the hash of a previously transferred Software Package. The hash value is calculated by the Server with the SHA-256 algorithm. It can be used to verify if the transferred package matches the one at the Client.
This optional Method can be used to delete the previously transferred software from the device. For Pending and Fallback Versions this often makes sense to free memory. For configuration objects it can be possible to clear the Current Version. This Method supports the use case in 8.2.2.1.
Signature
Clear();
Method Result Codes (defined in Call Service)
|
Result Code |
Description |
|
Bad_InvalidState |
The version object is already cleared. |