/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:  

*        RConnectionMonitor provides an interface for an application

*        to get information about active data connection. It also provides

*        a way to close any connection or all the connections.

*

*/

#ifndef __CONNECTIONMONITOR_H

#define __CONNECTIONMONITOR_H

// INCLUDES

#include "musunittesting.h"

#include <e32base.h>

// CONSTANTS

// TInt Attributes 

// Used by GetIntAttribute

const TUint KBearer                            =1;  // TConnMonBearerType

const TUint KNetworkStatus                     =2;  // TConnMonNetworkStatus

const TUint KConnectionStatus                  =3;  // progress constants from nifvar.h

const TUint KProtocolType                      =4;  // TConnMonProtocolType

const TUint KNetworkRegistration               =5;  // TConnMonNetworkRegistration

const TUint KSignalStrength                    =6;  // dBm

const TUint KNetworkMode                       =7;  // TConnMonNetworkMode

const TUint KSecurityMode                      =8;  // TConnMonSecurityMode

const TUint KTrafficClass                      =30; // Qos - Not supported

const TUint KDeliveryOrder                     =31; // Qos - Not supported

const TUint KErroneousSDUDelivery              =32; // Qos - Not supported

const TUint KResidualBitErrorRatio             =33; // Qos - Not supported

const TUint KSDUErrorRatio                     =34; // Qos - Not supported

// TUInt Attributes

// Used by GetUintAttribute, SetUintAttribute

const TUint KDownlinkData                      =100; // in bytes

const TUint KUplinkData                        =101; // in bytes

const TUint KIAPId                             =102;

const TUint KNetworkIdentifier                 =103;

const TUint KTransmitPower                     =104; // mW

const TUint KMobilePhoneNetworkMode			   =105; // TConnMonMobilePhoneNetworkMode 	

const TUint KMaximumBitrateDownlink            =130; // Qos - Not supported

const TUint KMaximumBitrateUplink              =131; // Qos - Not supported

const TUint KMaximumSDUSize                    =132; // Qos - Not supported

const TUint KTransferDelay                     =133; // Qos - Not supported

const TUint KGuaranteedBitrateDownlink         =134; // Qos - Not supported

const TUint KGuaranteedBitrateUplink           =135; // Qos - Not supported

const TUint KTrafficHandlingPriority           =136; // Qos - Not supported

const TUint KActivityTimeThreshold             =150; // in seconds, minimum allowed is 5

const TUint KDownlinkDataThreshold             =151; // in bytes,   minimum allowed is 4096

const TUint KUplinkDataThreshold               =152; // in bytes,   minimum allowed is 4096

const TUint KBearerAvailabilityThreshold       =153; // 1 means that events are 'ON', 0 means 'OFF'

const TUint KSignalStrengthThreshold           =154; // 1 means that events are 'ON', 0 means 'OFF'

// TBool Attributes 

// Used by GetBoolAttribute, SetBoolAttribute 

const TUint KConnectionActive                  =200;

const TUint KBearerAvailability                =201;

const TUint KConnectionStop                    =250;

const TUint KConnectionStopAll                 =251;

// TDes Attributes 

// Used by GetStringAttribute 

const TUint KIAPName                           =300;

const TUint KAccessPointName                   =301;

const TUint KTelNumber                         =302;

const TUint KNetworkName                       =303;

// TPckgBuf Attributes

// Used by GetPckgAttribute

const TUint KStartTime                         =400; // TTime

const TUint KClientInfo                        =401; // TConnMonClientEnum (connections only)

const TUint KNetworkNames                      =402; // TConnMonNetworkNames

const TUint KIapAvailability                   =403; // TConnMonIapInfo 

const TUint KWLANNetworks                      =404; // TConnMonWLANNetworksPckg

const TUint KSNAPsAvailability				   =405; // returns SNAPs ids in old iap-like way (see KIapAvailability)

const TUint KAvailableSNAPsIds				   =406; // returns SNAPs ids in TConnMonIdsArrayPckg  		

// Base value for plug-in specific attribute ids

const TUint KConnMonPluginAttributeBase        =3000000;

// DATA TYPES

// Bearer type

enum TConnMonBearerType

{

    EBearerUnknown            = 0,

    EBearerCSD                = 1,  // CSD (GSM)

    EBearerWCDMA              = 2,  // PSD (WCDMA)

    EBearerLAN                = 3,

    EBearerCDMA2000           = 4,

    EBearerGPRS               = 5,    

    EBearerHSCSD              = 6,  // HSCSD (GSM)

    EBearerEdgeGPRS           = 7,

    EBearerWLAN               = 8,

    EBearerBluetooth          = 9,

    EBearerVirtual            = 10,

    EBearerVirtualVPN         = 11,

    EBearerWcdmaCSD           = 12, // CSD (WCDMA)

    EBearerExternalCSD        = 30, // ext CSD (GSM)

    EBearerExternalWCDMA      = 31, // ext PSD (WCDMA)

    EBearerExternalLAN        = 32,

    EBearerExternalCDMA2000   = 33,

    EBearerExternalGPRS       = 34,    

    EBearerExternalHSCSD      = 35, // ext HSCSD (GSM)

    EBearerExternalEdgeGPRS   = 36,

    EBearerExternalWLAN       = 37,

    EBearerExternalBluetooth  = 38,

    EBearerExternalWcdmaCSD   = 39  // ext CSD (WCDMA)

};

// Bearer specific general connection id

enum TConnMonBearerId

{

    EBearerIdAll              = 0,

    EBearerIdGPRS             = 2000000,  // covers internal and external GPRS and EdgeGPRS

    EBearerIdWCDMA            = 2000001,  // covers internal and external PSD (WCDMA)

    EBearerIdCSD              = 2000002,  // covers internal and external CSD and HSCSD (GSM)

    EBearerIdGSM              = 2000003,  // union of EBearerIdGPRS and EBearerIdCSD

    EBearerIdWLAN             = 2000004,

    EBearerIdLAN              = 2000005,

    EBearerIdWcdmaCSD         = 2000006,  // covers internal and external CSD (WCDMA)

    EBearerIdCDMA2000         = 2000007,

    EBearerIdVirtualVPN       = 2000008

};

// Network status

enum TConnMonNetworkStatus

    {

    EConnMonStatusNotAvailable = 0,

    EConnMonStatusUnattached,

    EConnMonStatusAttached,

    EConnMonStatusActive,

    EConnMonStatusSuspended

    };

// Protocol Type (type of PDP)

// It may not be available for some bearers (returns EProtocolTypeUnknown).

enum TConnMonProtocolType

{

    EProtocolTypeUnknown = 0,

    EProtocolTypeIPv4,

    EProtocolTypeIPv6,

    EProtocolTypeX25,

    EProtocolTypePPP,

    EProtocolTypeCDPD,

    EProtocolTypeIP  // connection uses both IPv4 and IPv6

};

// Asyncronous request codes

enum TConnMonAsyncRequest

    {

    EConnMonGetConnectionCount = 1,

    EConnMonGetIntAttribute,

    EConnMonGetUintAttribute,

    EConnMonGetBoolAttribute,

    EConnMonGetStringAttribute,

    EConnMonGetPckgAttribute

    };

// Events sent by Connection Monitor

enum TConnMonEvent

    {

    EConnMonCreateConnection          = 1,

    EConnMonDeleteConnection          = 2,

    EConnMonCreateSubConnection       = 3,

    EConnMonDeleteSubConnection       = 4,

    EConnMonDownlinkDataThreshold     = 5,

    EConnMonUplinkDataThreshold       = 6,

    EConnMonNetworkStatusChange       = 7,

    EConnMonConnectionStatusChange    = 8,

    EConnMonConnectionActivityChange  = 9,

    EConnMonNetworkRegistrationChange = 10,

    EConnMonBearerChange              = 11,

    EConnMonSignalStrengthChange      = 12,

    EConnMonBearerAvailabilityChange  = 13,

    EConnMonIapAvailabilityChange     = 14,

    EConnMonTransmitPowerChange       = 15,  

	EConnMonSNAPsAvailabilityChange	  = 16,	

	EConnMonNewWLANNetworkDetected	  = 17,

	EConnMonOldWLANNetworkLost		  = 18,

    EConnMonPacketDataAvailable       = 19,

    EConnMonPacketDataUnavailable     = 20,

    EConnMonBearerInfoChange          = 21,		

    EConnMonPluginEventBase           = 4000000

    };

// Network registration status. Valid for CSD, GPRS and WCDMA.

enum TConnMonNetworkRegistration

    {

    ENetworkRegistrationNotAvailable = 0,

    ENetworkRegistrationUnknown,

    ENetworkRegistrationNoService,

    ENetworkRegistrationEmergencyOnly,

    ENetworkRegistrationSearching,

    ENetworkRegistrationBusy,

    ENetworkRegistrationHomeNetwork,

    ENetworkRegistrationDenied,

    ENetworkRegistrationRoaming

    };

// Traffic class

enum TQosTrafficClass

    {

    EQosTrafficClassConversational = 1,

    EQosTrafficClassStreaming,

    EQosTrafficClassInteractive,

    EQosTrafficClassBackground

    };

// Delivery order

enum TQosDeliveryOrder

    {

    EQosDeliveryOrderYes = 1,

    EQosDeliveryOrderNo

    };

// Delivery of erroneous SDUs

enum TQosErroneousSDUDelivery

    {

    EQosErroneousSDUDeliveryYes = 1,

    EQosErroneousSDUDeliveryNo,

    EQosErroneousSDUDeliveryUnspecified

    };

// Residual bit error ratio

enum TQosBitErrorRatio

    {

    EQosBERFivePerHundred = 1,

    EQosBEROnePerHundred,

    EQosBERFivePerThousand,

    EQosBEROnePerThousand,

    EQosBEROnePerTenThousand,

    EQosBEROnePerMillion

    };

// SDU error ratio

enum TQosSDUErrorRatio

    {

    EQosSDUErrorRatioOnePerHundred = 1,

    EQosSDUErrorRatioSevenPerThousand,

    EQosSDUErrorRatioOnePerThousand,

    EQosSDUErrorRatioOnePerTenThousand,

    EQosSDUErrorRatioOnePerHundredThousand

    };

// Client-server requests

enum TConnMonRequests

    {

    EReqGetConnectionCount             = 0,

    EReqGetConnectionInfo              = 1,

    EReqGetSubConnectionInfo           = 2,

    EReqGetIntAttribute                = 3,

    EReqGetUintAttribute               = 4,

    EReqGetBoolAttribute               = 5,

    EReqGetStringAttribute             = 6,

    EReqGetPckgAttribute               = 7,

    EReqSetIntAttribute                = 8,

    EReqSetUintAttribute               = 9,

    EReqSetBoolAttribute               = 10,

    EReqSetStringAttribute             = 11,

    EReqSetPckgAttribute               = 12,

    EReqCancelAsyncRequest             = 13,

    EReqReceiveEvent                   = 14,

    EReqCancelReceiveEvent             = 15,

    EReqPluginCreateSubSession         = 500,

    EReqPluginCloseSubSession          = 501,             

    EReqPluginRegisterAttribute        = 502,

    EReqPluginCancelRegisterAttribute  = 503,

    EReqPluginEvent                    = 504, 

    EReqPluginGetQuery                 = 505,

    EReqPluginCancelGetQuery           = 506,

    EReqPluginAttribute                = 507,

    EReqInternalSetThreshold           = 600,

    EReqInternalResetThreshold         = 601

    };

// WLAN connection modes

enum TConnMonNetworkMode 

    {

    EConnMonInfraStructure = 0,

    EConnMonAdHoc          = 1,

    EConnMonSecureInfra    = 2

    };

// WLAN connection security modes

enum TConnMonSecurityMode

    {

    EConnMonSecurityOpen   = 0,

    EConnMonSecurityWep    = 1,

    EConnMonSecurity802d1x = 2,

    EConnMonSecurityWpa    = 3,

    EConnMonSecurityWpaPsk = 4

    };

/** Defines Current Network Modes.

Modes: Common */

	enum TConnMonMobilePhoneNetworkMode

		{

	/** Network mode is unknown.

	Modes: Common */

		EConnMonNetworkModeUnknown = 0,

	/** ME is not registered.

	Modes: Common */

		EConnMonNetworkModeUnregistered,

	/** GSM/GPRS or DCS1800 network. */

		EConnMonNetworkModeGsm,

	/** AMPS network.

	Modes: CDMA */

		EConnMonNetworkModeAmps,

	/** CDMA (IS-95) network.

	Modes: CDMA */

		EConnMonNetworkModeCdma95,

	/** CDMA (cdma2000) network.

	Modes: CDMA */

		EConnMonNetworkModeCdma2000,

	/** WCDMA  (UTRA Frequency Division Duplex (FDD)) network.

	Modes: WCDMA */

		EConnMonNetworkModeWcdma,

	/** TD-CDMA (UTRA Time Division Duplex (TDD)) network.

	Modes: WCDMA */	

		EConnMonNetworkModeTdcdma

		};

// Maximum size of a plug-in's attribute or event data

const TUint KConnMonMaxPluginDataSize        = 512;

const TUint KConnMonMaxStringAttributeLength = 64;

// Package class definition for getting the TTime

typedef TPckgBuf< TTime > TConnMonTimeBuf;

// Package class definition for getting the client information

const TUint KConnMonMaxClientUids = 10;

class TConnMonClientEnum

    {

    public:

	    inline TConnMonClientEnum():iCount(0){}

    public:

        TUint iCount;

        TUid  iUid[ KConnMonMaxClientUids ];

    };

typedef TPckgBuf< TConnMonClientEnum > TConnMonClientEnumBuf;

// Package class definition for getting network names

const TUint KConnMonMaxNetworkCount = 10;

class TConnMonNetwork

     {

     public:

     	inline TConnMonNetwork():iType(0), iSignalStrength(0){}

     public:

         TBuf8< 32 >  			iName;

         TInt8      			iType; 				// see TConnMonNetworkMode

         TUint8					iSignalStrength;

     };

class TConnMonNetworkNames

     {

     public:

     	inline TConnMonNetworkNames():iCount(0){}

		inline TUint Count() {return iCount;}

     public:

         TUint            iCount;

         TConnMonNetwork  iNetwork[ KConnMonMaxNetworkCount ];

      };

typedef TPckgBuf< TConnMonNetworkNames > TConnMonNetworkNamesBuf;

// Package class definiton for getting available IAPs

const TUint KConnMonMaxIAPCount = 25;

class TConnMonIap

    {

    public:

    	inline TConnMonIap():iIapId(0){}

    public:

        TUint iIapId;

    };

class TConnMonIapInfo

    {

    public:

    	inline TConnMonIapInfo():iCount(0){}

		inline TUint Count() {return iCount;}

    public:

        TUint        iCount;

        TConnMonIap  iIap[ KConnMonMaxIAPCount ];

    };

typedef TPckgBuf< TConnMonIapInfo > TConnMonIapInfoBuf;

// Package class definiton for receiving event of SNAPs' availability change

const TUint KConnMonMaxSNAPsCount = 25;

class TConnMonSNAPId

    {

    public:

    	inline TConnMonSNAPId():iSNAPId(0){}

    public:

        TUint iSNAPId;

    };

class TConnMonSNAPInfo

    {

    public:

    	inline TConnMonSNAPInfo():iCount(0){}

		inline TUint Count() {return iCount;}

    public:

        TUint        iCount; // amount of items in iSNAP

        TConnMonSNAPId iSNAP[ KConnMonMaxSNAPsCount ]; // array of ids of available SNAPs

    };

typedef TPckgBuf< TConnMonSNAPInfo > TConnMonSNAPInfoBuf;

/**

 *  Interface template for the class T serialization to/from HBuf/TPtr

 *  Class T could be any type of class (T, C, etc)

 *

 *  @since S60 v3.1

 */

template <class T>

class MDesSerializer

	{

	public:

	/**

     * Have to pack the object of class T to HBufC

     * Ownership of newly cleated pointer is transferred to caller	

     * @since S60 v3.1

     * @return pointer to heap descriptor

     */	

	virtual const HBufC* ToBuf() const = 0;

	/**

     * Have to unpack object of class T from aPtrC

     * @since S60 v3.1

     * @return const pointer to heap descriptor

     */	

	static T FromPtrC(const TPtrC& aPtrC);

    };

/**

 *  TConnMonWLANNetwork is a class, incapsulated WLAN network abstraction 

 *	Implements MDesSerializer interface to be able to be transferred through processes (client/server)

 *  in object's size-independent manner, to meet backward/forward compatibility 

 *

 *  @since S60 v3.1

 */

class TConnMonWLANNetwork: public MDesSerializer<TConnMonWLANNetwork>

	{

	public:

		// Length of the WLAN network name

		static const TUint KMaxNameLength 	= 32;

		// amount of additional fields in the buffer

		static const TUint KNumberOfExtraFields = 0; 

		// defines max size of the object in TChar's

		static const TUint KMaxSize = (

								 sizeof(TUint) 			// length of name

								+sizeof(TBuf<KMaxNameLength>) // iName

								+sizeof(TUint)			// iConnectionMode 

								+sizeof(TUint)  		// iSignalStrength

								+sizeof(TUint)  		// iSecurityMode

								+sizeof(TUint) 			// length of buffer

								+sizeof(TInt)*KNumberOfExtraFields

								+sizeof(RArray<TInt>) 	// Array of extra fields

							 )/  sizeof(TChar) + 1;   	// +1 is for rounding to bigger integer

		// defines shifts of fields	inside the object, packed to a descriptor

		enum FieldsShifts

		{

		ENameLength	= 		0,

		EName 		= 		1,

		// relatively to iName's end

		EConnectionMode = 	1,

		ESignalStrength = 	2,

		ESecurityMode = 	3,

		EBufCounter = 		4,

		EBufBase = 			4/*, 

		EBufParam0 = 		5 */

		};

		/**

	     * Default constructor

	     * @param aName name of the network

		 * @param aConectionMode ConnectionMode of the network

		 * @param aSignalStrength Signal strength of the network

		 * @param aSecurityMode Security mode of the network

		 * @param aBuf Buffer of the additional fields

	     * @since S60 v3.1

	     */

		IMPORT_C TConnMonWLANNetwork(const TBuf<KMaxNameLength>& aName, TUint aConnectionMode,

							TUint aSignalStrength, TUint aSecurityMode,	const RArray<TInt>& aBuf);

		/**