MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

System Information

Namespace

The QtMobility APIs are placed into the QtMobility namespace. This is done to facilitate the future migration of QtMobility APIs into Qt. See the Quickstart guide for an example on how the namespace impacts on application development.

QSystemDeviceInfo::ProfileDetails

Access to details of the currently active phone profile

QSystemAlignedTimer

Service for applications to synchronize their activity

QSystemBatteryInfo

Access to battery and power information from the system

QSystemDeviceInfo

Access to device information from the system

QSystemDisplayInfo

Access to display information from the system

QSystemInfo

Access to various general information from the system

QSystemNetworkInfo

Access to various networking status and signals

QSystemScreenSaver

Access to screen saver and blanking

QSystemStorageInfo

Access to disk storage information from the system

System Information

The System Information API provides a set of APIs to discover system related information and capabilities.

Overview

The System Information API returns the system information related to a number of categories.

Information Categories

Version

Contains version information for a range of supporting software on the device. For example, from the Operating System and Firmware to the version of WebKit, Qt and the Service Framework.

Features (hardware)

This lists the supported hardware on the device. Features include items such as the camera, bluetooth, GPS, FM radio etc.

Network

The state of the network connection, and also the type of network e.g. gsm, cdma, ethernet etc.

Display Information

This provides height, width, contrast, and other information of the display.

Storage Information

The presence of various storage devices. Including: none, internal, removable, cdrom.

Device Information

  • Battery Status
  • Power State
  • Profile (silent, vibrating, normal etc)
  • Sim
  • Input Method (key/buttons, keypad, qwerty, single touch screen, multitouch etc)

Screensaver

This provides the access to the information of the screen saver.

Building and compiling

To build the library, run configure and make.

Linux supports a NetworkManager based backend and generic backend using QNetworkInterface only. By default the generic backend is selected. If the NetworkManager backend is required run qmake as follows:

 qmake BACKEND=NetworkManager

The backend selection is expected to disappear once the API is integrated into Qt.

Main Classes

QSystemDeviceInfo::ProfileDetails

Access to details of the currently active phone profile

QSystemAlignedTimer

Service for applications to synchronize their activity

QSystemBatteryInfo

Access to battery and power information from the system

QSystemDeviceInfo

Access to device information from the system

QSystemDisplayInfo

Access to display information from the system

QSystemInfo

Access to various general information from the system

QSystemNetworkInfo

Access to various networking status and signals

QSystemScreenSaver

Access to screen saver and blanking

QSystemStorageInfo

Access to disk storage information from the system

QML Elements

The Qt SystemInfo offers access to system information through declarative UI by providing systeminfo elements. Detailed information can be found at QML SystemInfo QML Plugin.

QML AlignedTimer Element

The AlignedTimer element allows applications to synchronize activity, such as network access, like checking for updates.

QML BatteryInfo Element

The BatteryInfo element allows you to receive battery change notifications from the device.

QML DeviceInfo Element

The DeviceInfo element allows you to access information anbout the device and receive notifications from the device.

QML DisplayInfo Element

The DisplayInfo element allows you to get information and receive notifications about the diplsay.

QML GeneralInfo Element

The GeneralInfo element allows you access to general system information and to receive notifications from the device.

QML NetworkInfo Element

The NetworkInfo element allows you to get information and receive notifications from the network.

QML ScreenSaver Element

The ScreenSaver element allows you to temporarily suppress and delay the screensaver from turning on or blanking the screen.

Examples

System Information Example

The System Information example demonstrates how an application can very easily access the system information of the device.

System Information QML Example

The System Info QML example demonstrates how an application can very easily access the system information of the device.