FwUpdate Configuration Service Provider

4/8/2010

This configuration service provider handles the Firmware Update management object FwUpdate. The FwUpdate object contains information about content packages that are being downloaded and updated or installed on the device. This information includes: package ID, package version, the user friendly name for the package, a URL indicating the location of the package, and the current state of the package download or install. The FwUpdate Configuration Service Provider can specify if updates are enabled when roaming. The FwUpdate Configuration Service Provider also informs the user of new updates and, if the user accepts the update, passes the download request to Download Agent. It is possible to force an update without user permission.

Note

Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information about roles, see Security Roles and Default Roles for Configuration Service Providers.

The FwUpdate object is mounted below the root of the DM tree (./FwUpdate). Each node immediately below it represents a content package that is in the process of being downloaded or installed.

The following image shows the management object used by OMA DM.

• FwUpdate
  The root node of the FwUpdate object. The default security role maps to each subnode unless specific permission is granted to the subnode.

  Data type	node
  Roles allowed to query and update setting	Manager Operator_TPS
  Access type	Get
  Occurs	One

• FwUpdate/x
  X is the package identifier referenced by Image Update. The package identifier can be any string, including a GUID.

  The following table shows the default settings.

  Data type	node
  Access type	Get, Add, Delete
  Occurs	ZeroOrMore

• FwUpdate/x/DownloadAndUpdate
  DownloadAndUpdate is the node on which the Exec command is invoked in order to initiate download and immediate installation of package content.

  The following table shows the default settings.

  Data type	node
  Access type	Get, Exec, Add, Delete
  Occurs	One

• FwUpdate/x/DownloadAndUpdate/PkgURL
  The indicates the URL of the package to be downloaded.

  The following table shows the default settings.

  Data type	chr
  Access type	Get, Replace, Add, Delete
  Occurs	One

• FwUpdate/x/PkgName
  Indicates the user friendly name of the package to be downloaded.

  The following table shows the default settings.

  Data type	chr
  Access type	Get, Replace, Add, Delete
  Occurs	One

• FwUpdate/x/PkgVersion
  Contains version information for the package.

  The following table shows the default settings.

  Data type	chr
  Access type	Get, Replace, Add, Delete
  Occurs	One

• FwUpdate/x/State
  Indicates the state of a download or update after invoking the Exec command.

  The following table lists the possible states that may be reported.

  State Code	Description
  10	Idle. Download not started.
  20	Download failed. No data received.
  30	Download Progressing. Download has started and zero or more bytes of data have been downloaded.
  40	Download Complete. Data received.
  50	Starting Update. Data received. Update is about to start.
  80	Update Failed. The update failed and the data was deleted or removed.
  100	Update Successful. Data has been removed after successful update.

  The following table shows the default settings.

  Data type	chr
  Access type	Get
  Occurs	One

See Also

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
FwUpdate DDF File

Other Resources

FwUpdate Configuration Service Provider Examples for OMA DM