Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 Rolesand 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