ROMPackage Configuration Service Provider

4/8/2010

The ROMPackage Configuration Service Provider provides information about updatable ROM packages. A Windows Mobile device does not have a single firmware, but instead has ROM regions segmented into different ROM packages that can be independently updated. The OMA DM server can query the current version of each ROM package by using this Configuration Service Provider.

A DM Server will query the device for information about a ROM package (identifier, version, and state) before updating it. The ROMPackage Configuration Service Provider returns a ROMPackage object containing this information. ROMPackage objects are mounted below the MSFT vendor node (./vendor/MSFT/ROMPackage)

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 following figure shows the structure of the ROMPackage management object used by OMA DM.

• ROMPackage
  The root node of the ROMPackage object. This contains a list of all packages that are currently installed on the device. The server uses this information to determine the updates that are applicable to the device.

  The following table shows the default settings for all parameters in this Configuration Service Provider. 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 Operator - TPS
  Access Type	Get
  Occurs	One

• ROMPackage/x
  Required. X is the ROM package identifier (a GUID).

  The following table shows the default settings.

  Format	Node
  Access Type	Get
  Occurs	OneOrMore

• ROMPackage/x/PkgName
  Optional. Name of the package that is currently installed on the device.

  The following table shows the default settings.

  Format	Chr
  Access Type	Get
  Occurs	One

• ROMPackage/x/PkgVersion
  Required. Contains version information for the ROM package.

  The following table shows the default settings.

  Format	Chr
  Access Type	Get
  Occurs	One

• ROMPackage/x/State
  Required. Indicates the state of the package.

  A value of 80 indicates Update Successful.

  The following table shows the default settings.

  Format	Chr
  Access Type	Get
  Occurs	One

See Also

Reference

ROMPackage Configuration Service Provider Examples for OMA DM

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
ROMPackage DDF File