FwUpdate Configuration Service Provider

Send Feedback

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 also informs the user of new updates and, if the user accepts the update, passes the download request to Download Agent.

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.

    Format Node
    Roles allowed to query and update setting Manager

    Operator_TPS

    Access Type Get
    Occurs One
  • FwUpdate/x
    X is the package identifier (a GUID) referenced by Image Update.

    The following table shows the default settings.

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

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

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

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

    Format 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 Starting Download
    20 Download failed.

    No data received.

    30 Download Progressing.

    Download has started and 0 or more bytes of data have been downloaded.

    40 Download Complete.

    Data received.

    50 Starting Update.

    Data received. Update is about to start.

    60 Update Progressing.
    70 Update Failed.

    Data received, but update has failed.

    80 Update Successful.

    Update complete. Data is still available.

    90 Update Successful.

    Data has been removed after successful update.

    The following table shows the default settings.

    Format Chr
    Access Type Get
    Occurs ZeroOrOne

See Also

Configuration Service Provider Reference for Windows Mobile-Based Devices | FwUpdate Configuration Service Provider Examples for OMA DM

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.