8.4.5 CachedLoadingType

8.4.5.1 Overview

The CachedLoadingType provides information about the Current Version, the Pending Version and the Fallback Version (if supported). Additionally, it allows upload and download of different versions of the software. The Cached-Loading option is described in 8.3.4.4.

The CachedLoadingType is illustrated in Figure 45 and formally defined in Table 82.

Figure 45 – CachedLoadingType
Table 82 – CachedLoadingType definition
Attribute Value
BrowseName1:CachedLoadingType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 1:PackageLoadingType
0:HasComponentObject1:PendingVersion1:SoftwareVersionTypeM
0:HasComponentObject1:FallbackVersion1:SoftwareVersionTypeO
0:HasComponentMethod1:GetUpdateBehaviorM
Conformance Units
DI SU CachedLoading
8.4.5.2 FileTransfer

The FileTransfer Object is inherited from the PackageLoadingType. In this sub-type the Current version shall not be writable and the Pending version shall be writable (see SoftwareVersionFileType in 8.5.1).

8.4.5.3 PendingVersion

The PendingVersion Object describes an already transferred new Software Package that is ready to be installed.

If there is no Software Package available, the values should be empty.

8.4.5.4 FallbackVersion

The optional FallbackVersion Object describes an alternate version on the device. This could be a factory default version or the version before the last update. Installing the Fallback Version can be used to revert to a reliable version of the software.

If a Fallback Version is supported by the device the object shall be available. If there is currently no Fallback Version on the device, the values should be empty.

8.4.5.5 GetUpdateBehavior Method

With this Method the Client can check the specific update behavior for a specified software version. To identify the version the GetUpdateBehavior Method requires the ManufacturerUri, SoftwareRevision and PatchIdentifiers Properties of the SoftwareVersionType.

Signature

	GetUpdateBehavior(
	  [in]	0:String		ManufacturerUri,
	  [in]	0:String		SoftwareRevision,
	  [in]	0:String[]		PatchIdentifiers,
	  [out]	UpdateBehavior	UpdateBehavior);
	
Table 83 – GetUpdateBehavior Method Arguments
Argument Description
ManufacturerUri ManufacturerUri Property of either the Pending or Fallback SoftwareVersionType that should be installed.
SoftwareRevision SoftwareRevision Property of either the Pending or Fallback SoftwareVersionType that should be installed.
PatchIdentifiers PatchIdentifiers Property of either the Pending or Fallback SoftwareVersionType that should be installed. (or empty array if not supported by the SoftwareVersionType instance)
UpdateBehaviorUpdate behavior option set for the specified SoftwareVersionType instance

Method Result Codes (defined in Call Service)

Result Code Description
Bad_NotFoundIf the Software Package, identified by the parameters, does not exist.
Table 84 – GetUpdateBehavior Method AddressSpace definition
Attribute Value
BrowseName1:GetUpdateBehavior
References NodeClass BrowseName DataType TypeDefinition Other
0:HasPropertyVariable0:InputArguments0:Argument[] 0:PropertyTypeM
0:HasPropertyVariable0:OutputArguments0:Argument[] 0:PropertyTypeM
Conformance Units
DI SU CachedLoading