/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  describes system information utilities.

*

*/

#ifndef __SYSINFO_H__

#define __SYSINFO_H__

#include <BADESCA.H>

#include <f32file.h>

#include <AccPolGenericIDArray.h>

#include <etelmm.h>

class ISystemObserver;

/**

*   @ref CSysData is base class which can be extend to implement variety of 

*   system data representations.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CSysData) : public CBase

    {

    public:

    // Enumeration of supported i/o data types.

    enum TDataType

        {

        EStatus,

        EVersion,

        EConnectionList,

        EConnectionInfo,

        ENetworkInfo,

        EDriveInfo,

        ELanguageList,

        EDriveList,

        EAccessoryList,

        EAccessoryInfo,

        EResolution,

        EStringList,

        EStringData,

        };

    public:

    /**

    * virtual Destructor.

    */

    virtual ~CSysData ();

    /**

    * @return type of data stored.

    */

    IMPORT_C TDataType DataType() const;

    protected:

    /**

    * C++ default constructor.

    */

    CSysData(TDataType aType);		

    private:

    /**

    * Data type

    */

    TDataType   iDataType;

    };

/**

*  @ref CStatus is an integer data used in general for representing status 

*   information of some System Attributes. Typically ON,OFF state, battery 

*   level and so on.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CStatus) : public CSysData

    {

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    IMPORT_C static CStatus* NewL(TInt aStatus);

    /**

    * @return   status information

    */    

    IMPORT_C TInt Status() const;

    /**

    * Destructor.

    */

    ~CStatus();

    private:

    /**

    * C++ default constructor.

    */

    CStatus(TInt aStatus);

    private:

    /**

    * Status value.

    */

    TInt    iStatus;

    };

/**

*  @ref CResolution screen resolution of device specified in X,Y Pixels.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CResolution) : public CSysData

    {

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    static CResolution* NewL(TInt aXPixels, TInt aYPixels);

    /**

    * @return X-Pixels.

    */

    IMPORT_C TInt XPixels() const;

    /**

    * @return Y-Pixels.

    */

    IMPORT_C TInt YPixels() const;

    /**

    * Destructor.

    */

    ~CResolution();

    private:

    /**

    * C++ default constructor.

    */

    CResolution (TInt aXPixels, TInt aYPixels);

    private:

    /**

    * X-Pixels.

    */

    TInt    iXPixels;

    /**

    * Y-Pixels.

    */

    TInt    iYPixels;

    };

/**

*  @ref CAccessoryInfo provides accessory information i.e  ACCESSORY TYPE

*  @ref TAccessoryType and its connection status @ref TAccessoryState.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CAccessoryInfo):public CSysData

    {

    public:

    typedef	enum{

        /** Unknown. */

        EUnknown=-1,

        /** Headset */

        EHeadSet,

        /** Bluetooth headset */

        EBTHeadSet,

        /** Carkit */

        ECarKit,

        /** Bluetooth carkit */

        EBTCarKit

        }TAccessoryType;

    typedef enum{

        /** Accessory connected */

        EDisconnected,

        /** Accessory disconnected */

        EConnected

        }TAccessoryState;

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    static CAccessoryInfo* NewL(const TAccPolGenericID& aGenericID, 

                                        TAccessoryState aAccState);

    /**

    * Destructor.

    */

    ~CAccessoryInfo();

    public:

    /**

    * @return ACCESSORY TYPE

    */

    IMPORT_C TInt AccessoryType() const;

    /**

    * @return Connection state.

    */

    IMPORT_C TInt ConnectionState() const;

    private:

    /**

    * C++ default constructor.

    */

    CAccessoryInfo(TAccessoryState aAccState);

    /**

    * Deduce accessory type from aGenericID.

    */

    void GetAccessoryProperty( const TAccPolGenericID& aGenericID );

    private:

    /**

    * Accessory type

    */

    TInt    iAccessoryType;

    /**

    * Connection State.

    */

    TInt    iConnectionState;

    };

/**

*  @ref CAccList provides access to read list of accessories.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CAccList): public CSysData

    {

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    static CAccList* NewL();

    /**

    * @return @ref CAccessoryInfo client owns created instance.

    */

    IMPORT_C const CAccessoryInfo* operator[](TInt aIndex) const;

    /**

    * On return aAccInfo has new CAccessoryInfo instance ownership given to

    * client.

    */

    IMPORT_C TBool AtL(TInt aIndex,const CAccessoryInfo*& aAccInfo) const;

    /**

    * @return number of accessories in the list.

    */

    IMPORT_C TInt Count () const;

    /**

    * Destructor.

    */

    ~CAccList();

    private:

    /**

    * C++ default constructor.

    */

    CAccList();

    /**

    * Symbian 2nd phase constructor.

    */

    void ConstructL();

    private:

    /**

    * Accessory ID Array.

    */

    TAccPolGenericIDArray   iAccessories;

    /**

    * number of accessories.

    */

    TInt                    iCount;

    };

/**

*  @ref CStringData string data represented using this class.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CStringData): public CSysData

    {

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    IMPORT_C static CStringData* NewL(const TDesC& aString);

    /**

    * On return aString contains string data.

    */

    IMPORT_C void StringData(TPtrC& aString) const;

    /**

    * Destructor.

    */

    ~CStringData();

    private:

    /**

    * C++ default constructor.

    */

    CStringData();

    private:

    /**

    * String data.

    */

    HBufC*      iStringData;

    }; 

/**

*  @ref CVersion Major and Minor version information.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CVersion): public CSysData

    {

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    static CVersion* NewL(TInt aMajor,TInt aMinor);

    /**

    * @return Manjor Version number.

    */

    IMPORT_C TInt MajorVersion() const;

    /**

    * @return Minor Version number.

    */

    IMPORT_C TInt MinorVersion() const;

    /**

    * Destructor.

    */

    ~CVersion();

    private:

    /**

    * C++ default constructor.

    */

    CVersion(TInt aMajor,TInt aMinor);

    private:

    /**

    * Major Version.

    */

    TInt    iMajorVersion;

    /**

    * Minor Version.

    */

    TInt    iMinorVersion;

    }; 

/**

*  @ref CConnectionInfo provides access to read connection information i.e Connection type,

* 	Access point ID, Network name and Access point name.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CConnectionInfo) : public CSysData

    {

    public:

    typedef enum{

        /** disconnected */

        EDisconnected,

        /** connected */

        EConnected

    }TConnectionState;

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    IMPORT_C static CConnectionInfo* NewL(TUint aConnId, TUint aIAPId,

                                            TInt aBearerType,

                                            TConnectionState aConnectStatus,

                                            const TDesC& aIAPName,

                                            const TDesC& aNetworkName,

                                            const TDesC& aConnectionName);

    /**

    * Destructor.

    */

    ~CConnectionInfo();

    /**

    * @return A new instance of this class object.

    */    

    CConnectionInfo* CopyL();

    public:

    TUint ConnectionId() const;

    IMPORT_C TUint IAPId() const;

    IMPORT_C TInt BearerType()const;

    IMPORT_C TPtrC IAPName() const;

    IMPORT_C TPtrC NetworkName() const;

    IMPORT_C TPtrC ConnectionName() const;

    IMPORT_C TConnectionState ConnectionState() const;

    void SetConnectionState(CConnectionInfo::TConnectionState aState);

    private:

    /**

    * C++ default constructor.

    */

    CConnectionInfo ();

    /**

    * Symbian 2nd phase constructor.

    */

    void ConstructL(TUint aConnId, TUint aIAPId,

                        TInt aBearerType,

                        TConnectionState aConnectStatus,

                        const TDesC& aIAPName,

                        const TDesC& aNetworkName,

                        const TDesC& aConnectionName);

    private:

    TUint                   iConnectionId;

    TConnectionState        iConnectStatus;

    TUint                   iIAPId;

    TInt                    iBearerType;

    HBufC*                  iIAPName;

    HBufC*                  iNetworkName;

    HBufC*                  iConnectionName;

    };

/**

*  @ref CConnectionList this class lists connections. provides access to 

*   each connection information.

*

*  @lib sysinfoservice.lib

*  @since S60 3.2

*/

NONSHARABLE_CLASS(CConnectionList) : public CSysData

    {

    public:

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    static CConnectionList* NewL(

                    RPointerArray<CConnectionInfo>& aConnectionInfoArr);

    /**

    * Two-phased constructor.

    *

    * @return A new instance of this class.

    */    

    static CConnectionList* NewLC(

                    RPointerArray<CConnectionInfo>& aConnectionInfoArr);

    /**

    * On return aConnectionInfo contains connection information. aConnectionInfo  

    * ownership not given to user.

    */

    IMPORT_C TBool At(TInt aIndex,const CConnectionInfo*& aConnectionInfo) const;

    /**

    * @return ConnectionInfo at index.

    */

    IMPORT_C const CConnectionInfo* operator[](TInt aIndex) const;

    /**

    * @return number of connections.

    */

    IMPORT_C TInt Count() const;

    /**

    * Destructor.

    */

    ~CConnectionList();