Determining device features

S60 devices support different sets of device features, depending on their configuration and the underlying hardware. When you develop applications for multiple S60 devices, you can programmatically determine which platform, software version, languages, features, and accessories a particular device supports. This allows you to programmatically enable and disable application functions for a particular device.

You can use S60 system software extension APIs to:

  • Check the device platform version.

  • Retrieve software and language package versions and amount of free space on a disk drive.

  • Query paths to default folders on a device.

  • Scan for supported sensor channels on a device.

  • Discover device features.

  • Access information and receive notifications on accessories connected to devices.

The following table summarizes the APIs that are available from a particular S60 platform release onwards for determining supported device features.

Use case

API

Published

Examples of use

Check device platform version

Version Info API

3.2

Enable touch functions on 5th Edition devices and disable them on earlier devices.

Retrieve software and language pack versions and amount of free space on a disk drive

SysUtil API

2.0

  • Enable and disable application functions depending on the device firmware version.

  • Enable and disable application functions depending on the device language pack.

  • Check whether there is enough disk space available to store data on the device.

Query paths to default folders on a device

Platform Environment API

2.0

Store images in the Images folder on devices.

Scan for supported sensor channels on a device

Sensor channel API

5.0

  • Detect movement gestures, such as moving the device up or down.

  • Detect the rotation of a device on each axis (x, y, and z) of the three-dimensional Cartesian coordinate system.

  • Detect the proximity of the device to the user's hand or ear, for example.

  • Detect the number of degrees between the device and the magnetic north.

Discover device features

Feature Discovery API

2.8

  • Check whether the device supports data synchronization or device management.

  • Find out which cellular stack, such as GSM, CDMA, or WCDMA the device supports.

  • Find out which physical connection methods, such as Bluetooth and universal serial bus (USB), the device supports for downloading data.

  • Check whether a multimedia card (MMC) is available for storing data.

Access information and receive notifications on accessories connected to devices

Accessory Monitoring API

5.0

  • Check whether a headset that can handle stereo audio is connected to a device.

  • Receive notification when the headset is disconnected from the device.

  • Find out which physical connection methods the device supports for downloading data.