Share via


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.

Bb737669.265c892e-1080-4d90-b164-726ddc8bc83d(en-us,MSDN.10).gif

  • 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