Jump to: navigation, search

Latest revision as of 04:23, 11 October 2012

Article Metadata

Code Example

Article

Created: kiran10182 (08 Mar 2010)

Last edited: hamishwillee (11 Oct 2012)

ID		Creation date	8-March-2010
Platform	S60 3rd Edition, FP1, FP2 S60 5th Edition	Tested on devices	Nokia 5800 xPressMusic
Category	Qt	Subcategory	Qt Mobility API

Keywords (APIs, classes, methods, functions): QSystemDeviceInfo, QString, QStringList, QButton, QLabel

Tip: 
 Please read this article before moving forward: Archived:Setting up environment for Qt Mobility API
 Setup Carbide.c++ IDE as explained in this article: Working with Carbide.c++ IDE for Qt Mobility APIs

1 Overview
2 What is covered in QSystemDeviceInfo API Part 1
3 Capabilities required
4 UI design (.ui file)
5 Project configuration file (.Pro file)
6 Implementing QSystemDeviceInfo API
- 6.1 Header file
- 6.2 Source file
7 Output
8 Useful functions
9 Keywords
- 9.1 Headers
- 9.2 Classes
10 Example Application
11 Related articles
12 Reference links

Overview

This is a part 1 of the QSystemDeviceInfo API which is a part of the System Information API from Qt Mobility project.

What is covered in QSystemDeviceInfo API Part 1

It is a part of the System Information API.
This article covers information about
- IMEI of the device
- IMSI information
- Manufacturer information
- Model information
- Product information
- Battery level
- Battery status
- Current profile
- SIM card status
- Device status

Capabilities required

ReadDeviceData

UI design (.ui file)

Project configuration file (.Pro file)

Add the Qt Mobility project configuration option in the .Pro file as shown below

CONFIG += mobility
MOBILITY += systeminfo

Add required capability in .pro file as shown below:

symbian:TARGET.CAPABILITY = ReadDeviceData

Implementing QSystemDeviceInfo API

QSystemDeviceInfo API is a part of the QtMobility namespace. So declare the QtMobility namespace as shown below:

using namespace QtMobility;

Header file

#ifndef SYSTEMDEVICEINFO_H
#define SYSTEMDEVICEINFO_H
 
#include <QtGui/QWidget>
#include "ui_SystemDeviceInfo.h"
#include <qsysteminfo.h>
 
using namespace QtMobility;
class SystemDeviceInfo : public QWidget
{
    Q_OBJECT
 
public:
    SystemDeviceInfo(QWidget *parent = 0);
    ~SystemDeviceInfo();
 
public slots:
    void listDeviceInformation();
    void resetAllFields();
private:
    Ui::SystemDeviceInfo ui;
    QSystemDeviceInfo* deviceInfo;
};
 
#endif // SYSTEMDEVICEINFO_H

Source file

#include "SystemDeviceInfo.h"
 
SystemDeviceInfo::SystemDeviceInfo(QWidget *parent)
    : QWidget(parent), deviceInfo(NULL)
{
	ui.setupUi(this);
	deviceInfo = new QSystemDeviceInfo;
	QObject::connect(ui.listDeviceInfoButton,
					SIGNAL(clicked()),
					this,
					SLOT(listDeviceInformation()));
	QObject::connect(ui.resetButton, 
					SIGNAL(clicked()),
					this, 
					SLOT(resetAllFields()));
}
 
SystemDeviceInfo::~SystemDeviceInfo()
{
	delete deviceInfo;
}
 
void SystemDeviceInfo::listDeviceInformation()
{
	if(deviceInfo)
	{
		ui.imeiLabel->setText(deviceInfo->imei());
		ui.imsiLabel->setText(deviceInfo->imsi());
		ui.manufacturerLabel->setText(deviceInfo->manufacturer());
		ui.modelLabel->setText(deviceInfo->model());
		ui.productLabel->setText(deviceInfo->productName());
		ui.batteryLabel->setText(QString::number(deviceInfo->batteryLevel()));
		ui.batteryStatusLabel->setText(QString::number(
				(QSystemDeviceInfo::BatteryStatus)deviceInfo->batteryStatus()));
		ui.profileLabel->setText(QString::number(
				(QSystemDeviceInfo::Profile)deviceInfo->currentProfile()));
		ui.simLabel->setText(QString::number(
				(QSystemDeviceInfo::SimStatus)deviceInfo->simStatus()));
		ui.deviceLabel->setText(QString::number((int)deviceInfo->isDeviceLocked()));
	}
}
 
void SystemDeviceInfo::resetAllFields()
{
	if(deviceInfo)
	{
		ui.imeiLabel->clear();
		ui.imsiLabel->clear();
		ui.manufacturerLabel->clear();
		ui.modelLabel->clear();
		ui.productLabel->clear();
		ui.batteryLabel->clear();
		ui.batteryStatusLabel->clear();
		ui.profileLabel->clear();
		ui.simLabel->clear();
		ui.deviceLabel->clear();
	}
}

Output

Useful functions

QString imei ();
QString imsi ();
QString manufacturer ();
QString model ();
QString productName ();
int batteryLevel () const;
QSystemDeviceInfo::BatteryStatus batteryStatus ();
QSystemDeviceInfo::Profile currentProfile ();
bool isDeviceLocked ();
QSystemDeviceInfo::SimStatus simStatus ();

Keywords

Headers

#include <qsysteminfo.h>

Classes

QSystemDeviceInfo
QString
QStringList
QButton
QLabel

Example Application

A working example application is available to download from here: QSystemDeviceInfo part1.zip

Reference links

@@ Line 1: / Line 1: @@
-[[Category:Qt]][[Category:Qt for Symbian]][[Category:Code Examples]]
+{{ArticleMetaData <!-- v1.2 -->
+|sourcecode= [[Media:SystemDeviceInfo.zip]]
+|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
+|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
+|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
+|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
+|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
+|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
+|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
+|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
+|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
+|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
+|translated-by= <!-- [[User:XXXX]] -->
+|translated-from-title= <!-- Title only -->
+|translated-from-id= <!-- Id of translated revision -->
+|review-by= <!-- After re-review: [[User:username]] -->
+|review-timestamp= <!-- After re-review: YYYYMMDD -->
+|update-by= <!-- After significant update: [[User:username]]-->
+|update-timestamp= <!-- After significant update: YYYYMMDD -->
+|creationdate= 20100308
+|author= [[User:Kiran10182]]
+}}
+[[Category:Qt Mobility]]
 {|style="background:#eceff2" width="660px" border="1" cellpadding="5" cellspacing="0"
 |-
@@ Line 9: / Line 31: @@
 |'''Tested on devices''' || Nokia 5800 xPressMusic
 |-
-|'''Category''' || Qt for Symbian
+|'''Category''' || Qt
 |'''Subcategory''' || Qt Mobility API
 |-
@@ Line 23: / Line 45: @@
 {{Tip|<b></b>
-* Please read this article before moving forward: [[Setting up environment for Qt Mobility API]]
+* Please read this article before moving forward: [[Archived:Setting up environment for Qt Mobility API]]
 * Setup Carbide.c++ IDE as explained in this article: [[Working with Carbide.c++ IDE for Qt Mobility APIs]]
 }}
@@ Line 48: / Line 70: @@
 = Capabilities required =
-* ReadDeviceData
+* [[Capabilities (Symbian Signed)/ReadDeviceData Capability|ReadDeviceData]]
@@ Line 58: / Line 80: @@
 = Project configuration file (.Pro file) =
 * Add the Qt Mobility project configuration option in the .Pro file as shown below
-<code cpp>
+<code cpp-qt>
 CONFIG += mobility
 MOBILITY += systeminfo
@@ Line 65: / Line 87: @@
 * Add required capability in .pro file as shown below:
-<code cpp>
+<code cpp-qt>
 symbian:TARGET.CAPABILITY = ReadDeviceData
 </code>
@@ Line 71: / Line 93: @@
 = Implementing QSystemDeviceInfo API =
 * QSystemDeviceInfo API is a part of the QtMobility namespace. So declare the QtMobility namespace as shown below:
-<code cpp>
+<code cpp-qt>
 using namespace QtMobility;
 </code>
 == Header file==
-<code cpp>
+<code cpp-qt>
 #ifndef SYSTEMDEVICEINFO_H
 #define SYSTEMDEVICEINFO_H
@@ Line 106: / Line 128: @@
 == Source file ==
-<code cpp>
+<code cpp-qt>
 #include "SystemDeviceInfo.h"
@@ Line 200: / Line 222: @@
-= Related articles ==
+= Related articles =
 * [[Getting started with Qt Mobility APIs]]
-* [[Setting up environment for Qt Mobility API]]
+* [[Archived:Setting up environment for Qt Mobility API]]
 * [[Working with Carbide.c++ IDE for Qt Mobility APIs]]
 * [[Working with QSystemInfo - System Information API - Part 1]]
@@ Line 214: / Line 236: @@
 * [http://qt.nokia.com/ Qt - cross-platform application and UI framework]
 * [http://labs.trolltech.com/page/Projects/QtMobility Qt Mobility API]
-* [http://qt.nokia.com/developer/new-qt-apis New Qt APIs Beta - Mobility Project]
+* [http://qt.nokia.com/developer/qt-roadmap New Qt APIs Beta - Mobility Project]
-* SDK help
+* SDK help[[Category:Code Examples]][[Category:MeeGo Harmattan]] [[Category:Symbian]]

Wiki

Wiki Resources

Main Platforms

Other

Natural Languages

Toolbox

Namespaces

Variants

Views

Actions

Contents

Working with QSystemDeviceInfo - System Information API - Part 1