/*

* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU Lesser General Public License as published by

* the Free Software Foundation, version 2.1 of the License.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU Lesser General Public License for more details.

*

* You should have received a copy of the GNU Lesser General Public License

* along with this program.  If not, 

* see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/".

*

* Description:

*

*/

#include "xqsysinfo.h"

#include "xqsysinfo_p.h"

/*!

    \class XQSysInfo

    \brief The XQSysInfo class is used to retrieve information about the phone (e.g. software version, free memory, IMEI, etc.)

*/

/*!

    Constructs a XQSysInfo object with the given parent.

*/

XQSysInfo::XQSysInfo(QObject* parent):

    QObject(parent), d(new XQSysInfoPrivate(this))

{

}

/*!

    Destroys the XQSysInfo object.

*/

XQSysInfo::~XQSysInfo()

{

    delete d;

}

/*!

    \enum XQSysInfo::Error

    This enum defines the possible errors for a XQSysInfo object.

*/

/*! \var XQSysInfo::Error XQSysInfo::NoError

    No error occured.

*/

/*! \var XQSysInfo::Error XQSysInfo::OutOfMemoryError

    Not enough memory.

*/

/*! \var XQSysInfo::Error XQSysInfo::IncorrectDriveError

    Wrong drive letter.

*/

/*! \var XQSysInfo::Error XQSysInfo::DriveNotFoundError

    Drive cannot be found.

*/

/*! \var XQSysInfo::Error XQSysInfo::UnknownError

    Unknown error.

*/

/*!

    \enum XQSysInfo::Drive

    This enum defines the possible drive letters to be used.

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveA 

    Drive A

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveB

    Drive B

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveC

    Drive C

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveD

    Drive D

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveE

    Drive E

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveF

    Drive F

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveG

    Drive G

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveH

    Drive H

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveI

    Drive I

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveJ

    Drive J

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveK

    Drive K

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveL

    Drive L

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveM

    Drive M

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveN 

    Drive N

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveO

    Drive O

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveP

    Drive P

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveQ

    Drive Q

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveR

    Drive R

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveS

    Drive S

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveT

    Drive T

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveU

    Drive U

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveV

    Drive V

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveW    

    Drive W

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveX

    Drive X

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveY

    Drive Y

*/

/*! \var XQSysInfo::Drive XQSysInfo::DriveZ

    Drive Z

*/

/*! 

    \enum XQSysInfo:Language

    This enum defines the languages that are available

*/        

/*!

    \return Current language of the phone UI

*/

XQSysInfo::Language XQSysInfo::currentLanguage() const

{

    return d->currentLanguage();

}

/*!

    \return International Mobile Equipment Identity (IMEI) unique identifier for the device. 

*/

QString XQSysInfo::imei() const

{

    return d->imei();

}

/*!

    \return International Mobile Subscriber Identity (IMSI) from the device's SIM card, 

*/

QString XQSysInfo::imsi() const

{

    return d->imsi();

}

/*!

    \return Firmware version of the device

*/

QString XQSysInfo::softwareVersion() const

{

    return d->softwareVersion();

}

/*!

    \return Phone model

*/

QString XQSysInfo::model() const

{

    return d->model();

}

/*!

    \return Manufacturer of the phone

*/

QString XQSysInfo::manufacturer() const

{

    return d->manufacturer();

}

/*!

    \return Current battery level as a percentage, i.e. 0 to 100%

*/

uint XQSysInfo::batteryLevel() const

{

    return d->batteryLevel();

}

/*!

    \return Network signal strength as a percentage, i.e. 0 to 100%

*/

int XQSysInfo::signalStrength() const

{

    return d->signalStrength();

}

/*!

    NOTE: No implementation in the alpha release

    \return Version string for the device's browser

*/

QString XQSysInfo::browserVersion() const

{

    return d->browserVersion();

}

/*!

    \param drive Drive letter as enumeration

    \return Available disk space in bytes on the given drive

*/

qlonglong XQSysInfo::diskSpace(XQSysInfo::Drive drive) const

{

    return d->diskSpace(drive);

}

/*!

    Helper function to check if the disk space on the given drive is in critical condition, i.e. very low

    \param drive Drive letter as enumeration

    \return True, if memory is low on the given device, otherwise false

*/

bool XQSysInfo::isDiskSpaceCritical(XQSysInfo::Drive drive) const

{

    return d->isDiskSpaceCritical(drive);

}

/*!

    Free RAM memory in bytes

    \return Free RAM memory in bytes

*/

int XQSysInfo::memory() const

{

    return d->memory();

}

/*!

    Checks if the specific feature is supported in the environment. See

    <a href="http://library.forum.nokia.com/topic/S60_5th_Edition_Cpp_Developers_Library/GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6/html/featureinfo_8h.html">

    featureinfo.h File Reference</a>

    in the Symbian S60 SDK for a list of the feature ids. //insp: major, description of the error checking missing

    \param featureId Feature id

     \return True, if the feature is supported, otherwise false

*/

bool XQSysInfo::isSupported(int featureId)

{

    return XQSysInfoPrivate::isSupported(featureId);

}

/*!

    \return Error code indicating the current error level

*/

XQSysInfo::Error XQSysInfo::error() const

{

    return d->error();

}

/*!

    Checks if the network is available

    \return True, if the network is available, otherwise false

*/

bool XQSysInfo::isNetwork() const

{

    return d->isNetwork();

}

/*!

    \fn void XQSysInfo::networkSignalChanged(ulong signalStrength)

    This signal is emitted when the signal strength changes.

    \param signalStrength New signal strength value

    \sa signalStrength()

*/

/*!

    \fn void XQSysInfo::batteryLevelChanged(uint batteryLevel)

    This signal is emitted when the battery level changes.

    \param batteryLevel New battery level

    \sa batteryLevel()

*/