The UpdateSoftwareStatus Method allows a Client to provide the firmware status for a Device on the network.

The Client may be the SoftwareUpdateManager (see 4.2.5) or other administrative application that allows a human to provide information about a manual process.

This Method shall be called from an authenticated SecureChannel and from a Session that has access to the SoftwareUpdateAdmin Role (see 4.2.6).

Signature

UpdateSoftwareStatus(

[in]0:String productInstanceUri,

[in]0:Boolean status,

[in]0:String softwareRevision

);

Argument

Description

productInstanceUri

The unique identifier for the Device.

status

The status of the software.

If TRUE the firmware is up to date, otherwise, an update is required before the Device can be used on the network.

softwareRevision

The version of the software which is running on the Device (status=TRUE) or needs to be installed on the Device (status=FALSE).

Method Result Codes (defined in Call Service)

Result Code

Description

Bad_UserAccessDenied

The Session does not have the permissions needed to call the Method.

Bad_NotFound

The productInstanceUri does not refer to a known Device.

Table 19 specifies the AddressSpace representation for the UpdateSoftwareStatus Method.

Table 19 – UpdateSoftwareStatus Method AddressSpace Definition

Attribute

Value

BrowseName

2:UpdateSoftwareStatus

References

NodeClass

BrowseName

DataType

TypeDefinition

ModellingRule

0:HasProperty

Variable

0:InputArguments

0:Argument []

0:PropertyType

Mandatory