Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
6/2/2010
The FwUpdate Configuration Service Provider informs the user of updates offered by the OMA DM server and, if the user accepts an update, passes the download request to Download Agent. It also 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 installation.
Note
Windows Mobile and FwUpdate Configuration Provider support OMA Firmware Update Managed Object (FUMO) Alternative Download Mechanism over HTTP. OMA DM Download descriptor is not supported. For more information about FUMO Alternative Download Mechanism, see Server Requirements for OTA Firmware Update in this document, and Firmware Update Management Object Architecture (OMA-AD-FUMO-V1_0-20060615-C), available from this OMA Web site.
The FwUpdate object is mounted below the root of the DM tree (./FwUpdate). Each node immediately below it represents a content package being downloaded or installed.
The following image shows the FwUpdate management object used by OMA DM:
.gif)
The following table shows the parameters that are used in the FwUpdate Configuration Service Provider.
| Parameter | Description |
|---|---|
FwUpdate/x |
x is the package identifier referenced by Image Update. The package identifier can be any string, including a GUID. |
FwUpdate/x/DownloadAndUpdate |
DownloadAndUpdate is the node on which the Exec command is invoked to initiate the download and immediate installation of package content. |
FwUpdate/x/DownloadAndUpdate/PkgURL |
This is the URL of the package to be downloaded. |
FwUpdate/x/PkgName |
This is the user-friendly name of the package to be downloaded. |
FwUpdate/x/PkgVersion |
Contains version information for the package. |
FwUpdate/x/State |
Indicates the state of a download or update after invoking the Exec command. |
The example illustrates how to instruct the FwUpdate Configuration Service Provider to download and install ROM update packages.
To use this example, you must replace {package_identifier} inside the curly brackets with the correct value.
<Add>
<CmdID>1</CmdID>
<Item>
<Target>
<LocURI>./FwUpdate/{package_identifier}/DownloadAndUpdate/PkgURL</LocURI>
</Target>
<Data>http://{package download server http address}/{update_package.pks}</Data>
</Item>
<Item>
<Target>
</Target>
<Data>{package name}</Data>
</Item>
</Add>
<Exec>
<CmdID>2</CmdID>
<Item>
<Target>
<LocURI>./FwUpdate/{package_identifier}/DownloadAndUpdate</LocURI>
</Target>
</Item>
</Exec>
After executing a command, the FwUpdate Configuration Service Provider updates its management object State node with one of the following values:
| Value | Meaning |
|---|---|
10 |
Applies to Windows Mobile 6: Idle. Download not started. |
20 |
Download failed. No data received. |
30 |
Download in progress. Download has started and 0 or more bytes of data have been downloaded. |
40 |
Download complete. Data received. |
50 |
Not used. |
80 |
Applies to Windows Mobile 6: The update failed. Update data has been deleted or removed. If any update in the super package fails, then the entire package fails. |
100 |
Applies to Windows Mobile 6: All updates in the super package succeeded. Update data has been deleted or removed. |