DeviceInformation Configuration Service Provider

4/8/2010

The DeviceInformation Configuration Service Provider enables the server to query general device information, such as the OS version and memory usage.

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 image shows the management object as used by OMA DM.

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

Parameters

• DeviceInformation
  The root node of the DeviceInformation object. The default security role maps to each subnode unless specific permission is granted to the subnode.

  Data type	node
  Roles allowed to query setting	Manager
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/AvailableStorage
  Amount of storage memory currently available on the system.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/AvailableStorageMB
  Amount of storage memory currently available on the system. Only returns the MB of available on-device storage, formatted as NN.NN.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/AvailableRemovableStorageMB
  Remaining Removable Storage Card Memory formatted as NN.NN (for the first Storage Card only).

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/TotalRemovableStorageMB
  Total Removable Storage Card Memory formatted as NN.NN (for the first Storage Card only).

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/TotalStorage
  Total amount of storage memory.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/TotalStorageMB
  Total amount of storage memory. Only returns the MB for on-device storage, formatted as NN.NN.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/BacklightACTimeout
  The backlight timeout.

  Data type	int
  Roles allowed to query setting	Manager AuthenticatedUser
  Title	Backlight timeout
  Access Type	Get Replace
  Occurs	One
  Scope	Permanent

• DeviceInformation/Product
  Product name (for example, Windows Mobile Classic or Windows Mobile Standard).

  Data type	chr
  Roles allowed to query and update setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/BacklightBatteryTimeout
  Backlight timeout in milliseconds. A value of 1 indicates Never.

  Data type	int
  Roles allowed to query setting	Manager AuthenticatedUser
  Title	Backlight time out:
  Access Type	Get Replace
  Occurs	One
  Scope	Permanent

• DeviceInformation/BatteryStrength
  Current battery strength of the device, displayed in a progress bar as a percentage of the total strength. The MinValue is 0 and the MaxValue is 100.

  Data type	int
  Roles allowed to query setting	Manager AuthenticatedUser
  Title	Main battery:
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/ProcessorType
  Type of processor on which the device is running.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/AvailableRam
  Amount of RAM currently available on the system.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/AvailableRamMB
  Amount of RAM currently available on the system. Only returns the MB of RAM, formatted as NN.NN.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/TotalRam
  Total amount of RAM in the system.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/TotalRamMB
  Total amount of RAM in the system. Only returns the MB of RAM, formatted as NN.NN.

  Data type	chr
  Roles allowed to query setting	Manager AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/ProductVersion
  The product version information, in the format OSMajorVersion.OSMinorVersion.OSBuildNumber(ProductBuildNumber.AdaptationKitLevel)

  Data type	chr
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/OperatingSystemVersion
  The OS version information, in the format OSMajorVersion.OSMinorVersion.OSBuildNumber.

  Data type	chr
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

• DeviceInformation/OperatingSystem
  The name of the operating system.

  Data type	chr
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser
  Access Type	Get
  Occurs	One
  Scope	Permanent

See Also

Reference

DeviceInformation Configuration Service Provider Examples for OMA Client Provisioning
DeviceInformation Configuration Service Provider Examples for OMA DM

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
DeviceInformation DDF File