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 44 and formally defined in Table 76.

image047.png

Figure 44 – CachedLoadingType

Table 76 – CachedLoadingType definition

Attribute

Value

BrowseName

CachedLoadingType

IsAbstract

False

References

NodeClass

BrowseName

DataType

TypeDefinition

Other

Subtype of the PackageLoadingType

0:HasComponent

Object

PendingVersion

SoftwareVersionType

M

0:HasComponent

Object

FallbackVersion

SoftwareVersionType

O

0:HasComponent

Method

GetUpdateBehavior

M

Conformance Units

DI SU CachedLoading

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).

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.

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 may 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.

With this Method the Client may 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]UpdateBehaviorUpdateBehavior);

Table 77 – 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)

UpdateBehavior

Update behavior option set for the specified SoftwareVersionType instance

Method Result Codes (defined in Call Service)

Result Code

Description

Bad_NotFound

If the Software Package, identified by the parameters, does not exist.

Table 78 – GetUpdateBehavior Method AddressSpace definition

Attribute

Value

BrowseName

GetUpdateBehavior

References

NodeClass

BrowseName

DataType

TypeDefinition

Other

0:HasProperty

Variable

InputArguments

0:Argument[]

0:PropertyType

M

0:HasProperty

Variable

OutputArguments

0:Argument[]

0:PropertyType

M

Conformance Units

DI SU CachedLoading