Partager via


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.

Bb737430.107b50ae-63e5-4b98-83c8-e30248c01ff7(en-us,MSDN.10).gif

  • 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