8 Software update model ToC Previous Next

8.4 ObjectTypes ToC Previous Next

8.4.5 CachedLoadingType ToC Previous Next

8.4.5.1 Overview ToC Model

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

readme_files/image046.png Figure 44 – CachedLoadingType

Table 71 – CachedLoadingType definition

Attribute Value
BrowseName CachedLoadingType
IsAbstract False

Subtype of the PackageLoadingType

References NodeClass BrowseName DataType TypeDefinition ModellingRule
HasComponent Object PendingVersion   SoftwareVersionType Mandatory
HasComponent Object FallbackVersion   SoftwareVersionType Optional
HasComponent Method GetUpdateBehavior     Mandatory
Conformance Units          
DI SU CachedLoading          

8.4.5.2 FileTransfer ToC

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 ToC

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 ToC

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.

8.4.5.5 GetUpdateBehavior Method ToC

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]	String		ManufacturerUri,
[in]	String		SoftwareRevision,
[in]	String[]		PatchIdentifiers,
[out]	UpdateBehavior	UpdateBehavior);
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.

Previous Next