The FwUpdate Configuration Service Provider

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.

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:

FwUpdate Parameters

The following table shows the parameters that are used in the FwUpdate Configuration Service Provider.

Code Example

Description

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.

Code

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

FwUpdate Result (State) Codes

After executing a command, the FwUpdate Configuration Service Provider updates its management object State node with one of the following values: