// Copyright (c) 1997-2009 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:

// ETel Basic Gsm API

// 

//

#if !defined(__ETELBGSM_H__)

#define __ETELBGSM_H__

#if !defined(__ETEL_H__)

#include "DummyETEL.h"

#endif

#if !defined(__E32BASE_H__)

#include <e32base.h>

#endif

#if !defined(__S32MEM_H__)

#include <s32mem.h>

#endif

/**

@internalComponent

*/

const TInt KETelExtBasicGsm					=1000;

const TInt KETelMixinBasicPhoneId			=KETelExtBasicGsm+1;

const TInt KETelMixinBasicPhoneBookSupport	=KETelExtBasicGsm+2;

const TInt KETelMixinBasicPhoneSignalAndBer	=KETelExtBasicGsm+3;

const TInt KETelMixinBasicPhoneNetwork		=KETelExtBasicGsm+4;

const TInt KETelMixinBasicPhoneBatteryPower	=KETelExtBasicGsm+5;

const TInt KETelMixinBasicPhoneIndicator	=KETelExtBasicGsm+6;

const TInt KETelMixinBasicPhoneClockAndAlarm=KETelExtBasicGsm+7;

const TUint KGsmMaxTelNumberSize=100;

/**

@internalComponent

*/

struct TGsmTelNumber

	{

	TUint iTypeOfNumber;

	TBuf<KGsmMaxTelNumberSize> iTelNumber;

	};

/**

@internalComponent

*/

const TUint KGsmPasswordSize=30;			// Maximum length of longest password

typedef TBuf<KGsmPasswordSize> TGsmPassword;

class CBasicPtrHolder;

class RBasicGsmCall : public RCall

/**

RBasicGsmCall

@internalComponent

*/

	{

public:

	IMPORT_C RBasicGsmCall();

//

// Basic Gsm Call Caps

//

	enum TBearerCaps

		{

		KCapsBearerSpeedAutobauding=0x00000001,

		KCapsBearerSpeedV21_300=0x00000002,

		KCapsBearerSpeedV22_1200=0x00000004,

		KCapsBearerSpeedV23_1200_75=0x00000008,

		KCapsBearerSpeedV22bis_2400=0x00000010,

		KCapsBearerSpeedV26ter_2400=0x00000020,

		KCapsBearerSpeedV32_4800=0x00000040,

		KCapsBearerSpeedV32_9600=0x00000080,

		KCapsBearerSpeedUnknown_NetworkSpecific=0x00000100,

		KCapsBearerSpeedV32bis_7200=0x00000200,

		KCapsBearerSpeedV32bis_12000=0x00000400,

		KCapsBearerSpeedV32bis_14400=0x00000800,

		KCapsBearerSpeedV34_9600=0x00001000,

		KCapsBearerSpeedV34_12000=0x00002000,

		KCapsBearerSpeedV34_14400=0x00004000,

		KCapsBearerSpeedV110_300=0x00008000,

		KCapsBearerSpeedV110_1200=0x00010000,

		KCapsBearerSpeedV110_2400=0x00020000,

		KCapsBearerSpeedV110_4800=0x00040000,

		KCapsBearerSpeedV110_9600=0x00080000,

		KCapsBearerSpeedV110_12000=0x00100000,

		KCapsBearerSpeedV110_14400=0x00200000,

		KCapsBearerSpeedV120_1200=0x00400000,

		KCapsBearerSpeedV120_2400=0x00800000,

		KCapsBearerSpeedV120_4800=0x01000000,

		KCapsBearerSpeedV120_9600=0x02000000,

		KCapsBearerSpeedV120_14400=0x04000000,

		KCapsBearerSpeedUnknown=0x40000000,

		KCapsBearerSpeedExtensions=0x80000000

		};

	enum

		{

		KCapsBearerNameAsynchronousModem=0x00000001,

		KCapsBearerNameSynchronousModem=0x00000002,

		KCapsBearerNamePADAccessAsynchronous=0x00000004,

		KCapsBearerNamePacketAccessSynchronous=0x00000008,

		KCapsBearerNameDataCircuitAsynchronousRdi=0x00000010,

		KCapsBearerNameDataCircuitSynchronousRdi=0x00000020,

		KCapsBearerNamePADAccessAsynchronousRdi=0x00000040,

		KCapsBearerNamePacketAccessSynchronousRdi=0x00000080,

		KCapsBearerNameUnknown=0x40000000,

		KCapsBearerNameExtensions=0x80000000

		};

	enum

		{

		KCapsBearerCETransparent=0x00000001,

		KCapsBearerCENonTransparent=0x00000002,

		KCapsBearerCETransparentPreferred=0x00000004,

		KCapsBearerCENonTransparentPreferred=0x00000008,

		KCapsBearerCEUnknown=0x40000000,

		KCapsBearerCEExtensions=0x80000000

		};

	struct TRlpParamRanges

		{

		TUint iWsMin;

		TUint iWsMax;

		TUint iMwsMin;

		TUint iMwsMax;

		TUint iT1Min;

		TUint iT1Max;

		TUint iN2Min;

		TUint iN2Max;

		TUint iT4Min;

		TUint iT4Max;

		};

	struct TCaps

		{

		TUint iBearerSpeed;

		TUint iBearerName;

		TUint iBearerCe;

		TRlpParamRanges iRlpParams;

		};

	IMPORT_C virtual TInt GetBasicGsmCaps(TCaps& aCaps) const;

	IMPORT_C virtual void NotifyBasicGsmCaps(TRequestStatus& aStatus, TCaps& aCaps);

	IMPORT_C virtual void NotifyBasicGsmCapsCancel() const;

//

// Basic Gsm Call Parameters

//

	enum TBearerSpeed

		{

		EBearerSpeedAutobauding,

		EBearerSpeedV21_300,

		EBearerSpeedV22_1200,

		EBearerSpeedV23_1200_75,

		EBearerSpeedV22bis_2400,

		EBearerSpeedV26ter_2400,

		EBearerSpeedV32_4800,

		EBearerSpeedV32_9600,

		EBearerSpeedUnknown_NetworkSpecific,

		EBearerSpeedV32bis_7200,

		EBearerSpeedV32bis_12000,

		EBearerSpeedV32bis_14400,

		EBearerSpeedV34_9600,

		EBearerSpeedV34_12000,

		EBearerSpeedV34_14400,

		EBearerSpeedV34_19200,

		EBearerSpeedV34_28800,

		EBearerSpeedV110_300,

		EBearerSpeedV110_1200,

		EBearerSpeedV110_2400,

		EBearerSpeedV110_4800,

		EBearerSpeedV110_9600,

		EBearerSpeedV110_12000,

		EBearerSpeedV110_14400,

		EBearerSpeedV110_19200,

		EBearerSpeedV110_28800,

		EBearerSpeedV110_38400,

		EBearerSpeedV110_48000,

		EBearerSpeedV110_56000,

		EBearerSpeedV120_1200,

		EBearerSpeedV120_2400,

		EBearerSpeedV120_4800,

		EBearerSpeedV120_9600,

		EBearerSpeedV120_14400,

		EBearerSpeedV120_19200,

		EBearerSpeedV120_28800,

		EBearerSpeedV120_38400,

		EBearerSpeedV120_48000,

		EBearerSpeedV120_56000,

		EBearerSpeedBitTransparent_56000,

		EBearerSpeedBitTransparent_64000

		};

	enum TBearerName

		{

		EBearerNameAsynchronousModem,

		EBearerNameSynchronousModem,

		EBearerNamePADAccessAsynchronous,

		EBearerNamePacketAccessSynchronous,

		EBearerNameDataCircuitAsynchronousRdi,

		EBearerNameDataCircuitSynchronousRdi,

		EBearerNamePADAccessAsynchronousRdi,

		EBearerNamePacketAccessSynchronousRdi

		};

	enum TBearerCE

		{

		EBearerCETransparent,

		EBearerCENonTransparent,

		EBearerCETransparentPreferred,

		EBearerCENonTransparentPreferred

		};

	struct TBearer

		{

		TBearerSpeed iSpeed;

		TBearerName iName;

		TBearerCE iCe;

		};

	struct TRlpParams

		{

		TUint iIws;

		TUint iMws;

		TUint iT1;

		TUint iN2;

		TUint iT4;

		};

	class TCallParams : public RCall::TCallParams

/**

@internalComponent

*/

		{

	public:

		IMPORT_C TCallParams();

		IMPORT_C TCallParams(const TBearer& aBearer,const TRlpParams& aRlpParams);

		TBearer iBearer;

		TRlpParams iRlpParams;

		};

	typedef TPckg<TCallParams> TCallParamsPckg;

	class TCallInfo : public RCall::TCallInfo

/**

General notification information

@internalComponent

*/

		{

	public:

		TBearer iBearer;

	public:

		IMPORT_C TCallInfo();

		};

	IMPORT_C virtual TInt GetInfoBasicGsm(TCallInfo& aCallInfo) const;

//

//	HSCSD Functionality

//

//	HSCSD Capability Information

	enum THscsdBearerCaps

		{

		KCapsBearerSpeedV34_19200=0x00000001,

		KCapsBearerSpeedV34_28800=0x00000002,

		KCapsBearerSpeedV110_19200=0x00000004,

		KCapsBearerSpeedV110_28800=0x00000008,

		KCapsBearerSpeedV110_38400=0x00000010,

		KCapsBearerSpeedV110_48000=0x00000020,

		KCapsBearerSpeedV110_56000=0x00000040,

		KCapsBearerSpeedV120_19200=0x00000080,

		KCapsBearerSpeedV120_28800=0x00000100,

		KCapsBearerSpeedV120_38400=0x00000200,

		KCapsBearerSpeedV120_48000=0x00000400,

		KCapsBearerSpeedV120_56000=0x00000800,

		KCapsBearerSpeedBitTransparent_56000=0x00001000,

		KCapsBearerSpeedBitTransparent_64000=0x00002000

		};

	enum TAiurCodingsCaps

		{

		EAiurCodings48=0x00000001,

		EAiurCodings96=0x00000004,

		EAiurCodings144=0x00000008

		};

	struct THscsdCaps

		{

		TUint iHscsdBearerSpeed;		// Logical OR of THscsdBearerCaps values

		TInt iMClass;				// Detailed in GSM 05.02 V6.4.1 Appendix B

		TInt iMaxRxTimeSlots;

		TInt iMaxTxTimeSlots;

		TInt iTotalRxTxTimeSlots;

		TUint iCodingCaps;			// Logical OR of TAiurCodings values

		};

	IMPORT_C virtual TInt GetHscsdCaps(THscsdCaps& aHscsdCaps) const;

	IMPORT_C virtual void NotifyHscsdGsmCaps(TRequestStatus& aStatus, THscsdCaps& aHscsdCaps) const;

	IMPORT_C virtual void NotifyHscsdGsmCapsCancel() const;

//

// Statically Configure HSCSD call parameters

//		(will not work during a call)

//

	enum TAiur

		{

		EAiurBps9600,

		EAiurBps14400,

		EAiurBps19200,

		EAiurBps28800,

		EAiurBps38400,

		EAiurBps43200,

		EAiurBps57600

		};

	struct THscsdParams

		{

		TAiur iAiur;

		TInt iRequestedTimeSlots;

		TInt iMaxTimeSlots;

		TUint iCodings;			// Logical OR of TAiurCodings values

								// Note that iCodings=0x0 indicates that all

								// supported codings are acceptable.

		};

	IMPORT_C virtual TInt SetHscsdParams(const THscsdParams& aHSCSDParams) const;

	IMPORT_C virtual TInt GetHscsdParams(THscsdParams& aHSCSDParams) const;

//

// Retrieve current call information

//

	struct THscsdDynamicParams

		{

		TAiur iAiur;

		TInt iRxTimeSlots;

		TInt iTxTimeSlots;

		TUint iCodings; 		// Logical OR of TAiurCodings values

		};

	IMPORT_C virtual TInt GetDynamicHscsdParams(THscsdDynamicParams& aHSCSDParams) const;

	IMPORT_C virtual void NotifyDynamicHscsdParams(TRequestStatus& aStatus, THscsdDynamicParams& aHSCSDParams) const;

	IMPORT_C virtual void NotifyDynamicHscsdParamsCancel() const;

//

// Request a dynamic change of HSCSD parameters

//

	IMPORT_C virtual TInt SetDynamicHscsdParams(const THscsdDynamicParams& aHSCSDParams) const;

	IMPORT_C virtual void SetDynamicHscsdParams(TRequestStatus& aStatus, const THscsdDynamicParams& aHSCSDParams) const;

	IMPORT_C virtual void SetDynamicHscsdParamsCancel() const;

private:

	CBasicPtrHolder* iBasicPtrHolder;

protected:

	IMPORT_C virtual void ConstructL();

	IMPORT_C virtual void Destruct();

	};

class TGsmDateTime : public TDateTime

/**

TGsmDateTime

@internalComponent

*/

	{

public:

	IMPORT_C TGsmDateTime();

	IMPORT_C TGsmDateTime(TInt aTimeZone,TInt aYear,TMonth aMonth,TInt aDay,TInt aHour,TInt aMinute, TInt aSecond,TInt aMicroSecond);

	IMPORT_C void SetTimeZone(const TInt aTimeZone);

	IMPORT_C TInt TimeZone() const;

private:

	TInt iTimeZone;

	};

class MBasicGsmPhoneId

/**

Phone ID Information

@internalComponent

*/

	{

public:

	enum {	KPhoneManufacturerIdSize=50	};

	enum {	KPhoneModelIdSize=50	};

	enum {	KPhoneRevisionIdSize=50	};

	enum {	KPhoneSerialNumberSize=50	};

	struct TId

		{

		TBuf<KPhoneManufacturerIdSize> iManufacturerId;

		TBuf<KPhoneModelIdSize> iModelId;

		TBuf<KPhoneRevisionIdSize> iRevisionId;

		TBuf<KPhoneSerialNumberSize> iSerialNumber;

		};

	virtual TInt GetGsmPhoneId(TId& aId) const=0;

	virtual void IdFreeSlot1() const=0;

	virtual void IdFreeSlot2() const=0;

	virtual void IdFreeSlot3() const=0;

	virtual void IdFreeSlot4() const=0;

protected:

	MBasicGsmPhoneId();

	};

class MBasicGsmPhoneBookSupport

/**

Phone Book Support

@internalComponent

*/

	{

public:

	struct TPhoneBookInfo

		{

		TInt iUsed;

		TInt iTotal;

		TBool iWriteAccess;

		TBool iRestrictedWriteAccess;

		TName iName;

		TInt iMaxNumberLength;

		TInt iMaxTextLength;

		};

	virtual TInt EnumeratePhoneBooks(TInt& aPhoneBookCount) const=0;

	virtual TInt GetPhoneBookInfo(const TInt aIndex, TPhoneBookInfo& aInfo) const=0;

	virtual void GetPhoneBookInfo(TRequestStatus& aStatus, const TInt aIndex, TPhoneBookInfo& aInfo) const=0;

	virtual void GetPhoneBookInfoCancel() const=0;

	virtual void PhBookSupportFreeSlot3() const=0;

	virtual void PhBookSupportFreeSlot4() const=0;

protected:

	MBasicGsmPhoneBookSupport();

	};

class MBasicGsmPhoneSignalandBer

/**

Signal Strength and Bit Error Rate Information

@internalComponent

*/

	{

public:

	virtual TInt GetSignalStrength(TInt32& aSignalStrength) const=0;

	virtual void GetSignalStrength(TRequestStatus& aStatus, TInt32& aSignalStrength)=0;

	virtual void GetSignalStrengthCancel() const=0;

	virtual void SignalStrengthNotification(TRequestStatus& aStatus,TInt32& aSignalStrength)=0;

	virtual void SignalStrengthNotificationCancel() const=0;

	virtual TInt GetBer(TUint& aBer) const=0;

	virtual void GetBer(TRequestStatus& aStatus, TUint& aBer)=0;

	virtual void GetBerCancel() const=0;

	virtual void BerNotification(TRequestStatus& aStatus,TUint& aBer)=0;

	virtual void BerNotificationCancel() const=0;

	enum TSignalStrengthAndBerCaps

		{

		KCapsSignalStrength=0x00000001,

		KCapsSignalBer=0x00000002,

		KCapsSignalStrengthUpdate=0x00000004,

		KCapsSignalBerUpdate=0x00000008

		};

	struct TSignalAndBerCapsFlags

		{

		TUint iSignalCaps;

		};

	virtual TInt GetSignalCaps(TSignalAndBerCapsFlags& aCaps) const=0;

	virtual void NotifySignalCaps(TRequestStatus& aStatus, TSignalAndBerCapsFlags& aCaps)=0;

	virtual void NotifySignalCapsCancel() const=0;

	virtual void SignalFreeSlot1() const=0;

	virtual void SignalFreeSlot2() const=0;

	virtual void SignalFreeSlot3() const=0;

	virtual void SignalFreeSlot4() const=0;

protected:

	MBasicGsmPhoneSignalandBer();

	};

class CGsmNetworkList;

class MBasicGsmPhoneNetwork

/**

Network support

@internalComponent

*/

	{

public:

	enum

		{

		KShortNetworkNameSize=20,

		KLongNetworkNameSize=30

		};

	enum TNetworkStatus

		{

		ENetStatUnknown,

		ENetStatAvailable,

		ENetStatCurrent,

		ENetStatForbidden,

		ENetStatNotApplicable

		};

	class TBscNetworkId	

/**

@internalComponent

*/

		{

	public:

		IMPORT_C void InternalizeL(RReadStream& aStream);

		IMPORT_C void ExternalizeL(RWriteStream& aStream) const;

	public:

		TUint iMCC;

		TUint iMNC;

		};

	enum TNetworkSetMode

		{

		ENetworkSetModeAutomatic,

		ENetworkSetModeManual