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

// This file contains all the method definitions for RMobilePhone.  It also contains the

// entry point for the Etelmm Dll.

// 

//

/**

 @file

*/

// From core API

#include <etelext.h>

// Multimode header files

#include <etelmm.h>

#include <mmlist.h>

#include "mm_hold.h"

/************************************************************************/

//

//  TMobileAddress

//

/************************************************************************/

EXPORT_C RMobilePhone::TMobileAddress::TMobileAddress() 

	: iTypeOfNumber(EUnknownNumber),

	  iNumberPlan(EUnknownNumberingPlan)

	{

	}

void RMobilePhone::TMobileAddress::InternalizeL(RReadStream& aStream)

/**

 * This method internalizes the mobile address from a stream.

 *

 * @param aStream The read stream containing the mobile address.

 */

	{

	iTypeOfNumber=STATIC_CAST(TMobileTON, aStream.ReadUint32L());

	iNumberPlan=STATIC_CAST(TMobileNPI, aStream.ReadUint32L());

	aStream >> iTelNumber;

	}

void RMobilePhone::TMobileAddress::ExternalizeL(RWriteStream& aStream) const

/**

 * This method externalizes the mobile address into a stream. 

 *

 * @param aStream The write stream that will contain the mobile address.

 */

	{

	aStream.WriteUint32L(iTypeOfNumber);

	aStream.WriteUint32L(iNumberPlan);

	aStream << iTelNumber;

	}

/************************************************************************/

//

//  RMobilePhone

//

/************************************************************************/

EXPORT_C RMobilePhone::RMobilePhone()

	: iMmPtrHolder(NULL)

/** Constructor. */

	{

	}

EXPORT_C void RMobilePhone::ConstructL()

/** Allocates and Initializes the members of the RMobilePhone object.

@leave KErrNoMemory Out of memory. 

@capability None

*/

	{

	RPhone::ConstructL();

	__ASSERT_ALWAYS(iMmPtrHolder==NULL,PanicClient(EEtelPanicHandleNotClosed));

	iMmPtrHolder = CMobilePhonePtrHolder::NewL(CMobilePhonePtrHolder::EMaxNumberPhonePtrSlots,CMobilePhonePtrHolder::EMaxNumberPhonePtrCSlots);

	}

EXPORT_C void RMobilePhone::Destruct()

/** Destructor. 

@capability None

*/

	{

	RPhone::Destruct();

	delete iMmPtrHolder;

	iMmPtrHolder = NULL;

	}

EXPORT_C void RMobilePhone::InitialiseMM(TRequestStatus& aReqStatus, TDes8& aTableSettings) const

/**

 * This method explicitly initialises the phone.

 *

 * @param aReqStatus returns the result code after the asynchronous call completes.

 * @param aIAP contains the IAP location to use for this phone.

 * @capability NetworkControl

 * @capability WriteDeviceData

*/

	{

	Set(EMobilePhoneMMInitialise, aReqStatus, aTableSettings);

	}

/************************************************************************/

//

//  TMultimodeType

//

/************************************************************************/

RMobilePhone::TMultimodeType::TMultimodeType()

	{}

EXPORT_C TInt RMobilePhone::TMultimodeType::ExtensionId() const

/**

 * This method returns the multimode API extension number of the class

 *

 * @return TInt An integer that will indicate the version of the type

 * @capability None

*/

	{

	return iExtensionId;

	}

void RMobilePhone::TMultimodeType::InternalizeL(RReadStream& aStream)

/**

 * This method internalizes the multimode type from a stream 

 *

 * @param aStream The read stream containing the multimode type

 */

	{

	iExtensionId=aStream.ReadInt32L();	

	}

void RMobilePhone::TMultimodeType::ExternalizeL(RWriteStream& aStream) const

/**

 * This method externalizes the multimode type into a stream 

 *

 * @param aStream The write stream that will contain the multimode type

 */

	{

	aStream.WriteInt32L(iExtensionId);

	}

/************************************************************************/

//

//  Methods to retrieve basic multimode API information & capabilities

//

/************************************************************************/

EXPORT_C TInt RMobilePhone::GetMultimodeAPIVersion(TInt& aVersion) const

/** Gets the current version of the multimode ETel API.

@param aVersion On return, the current version of the multimode ETel API

@return KErrNone 

@capability None

*/

	{

	aVersion = KEtelExtMultimodeV6;

	return KErrNone;

	}

EXPORT_C TInt RMobilePhone::GetMultimodeCaps(TUint32& aCaps) const

/** Gets the multimode capabilities of the phone.

@param aCaps On return, contain the bit-wise sum of the multimode capabilities 

from TMobilePhoneModeCaps

@return KErrNone 

@capability None

@see RMobilePhone::TMobilePhoneModeCaps

*/

	{

	TPckg<TUint32> ptr1(aCaps);

	return Get(EMobilePhoneGetMultimodeCaps, ptr1);

	}

EXPORT_C void RMobilePhone::GetPhoneStoreInfo(TRequestStatus& aReqStatus, TDes8& aInfo, const TDesC& aStoreName) const

/** Gets information about a phone store.

The method returns information about the phone store specified by aStoreName. 

Valid values of aStoreName are the various store name literals whose values are defined

as S1, S2, S3... S28.

The phone store information includes the store's name, the type of thing 

it stores, the total number of storage slots and the number of used slots 

if known. It does not give information about which slots are filled and which 

are empty. The information is returned in the aInfo structure. The RMobilePhoneStore::TMobilePhoneStoreInfoV1 

type is defined in more detail in section Common Storage functionality. Valid 

storage specific aInfo types are listed in sections SMS Message Storage (RMobileSmsStore) 

to Own Number Storage (RMobileONStore).

@param aReqStatus On return, KErrNone if successful, an error code if not.

@param aInfo On completion, a descriptor of type 

RMobilePhoneStore::TMobilePhoneStoreInfoV1Pckg, or one of the 

TMobilePhoneStoreInfoV1 derived classes' package types, that contains the phone 

store information.

@param aStoreName The name of the store, for which information is required

@see RMobilePhoneStore::TMobilePhoneStoreInfoV1 

@capability ReadDeviceData

*/

// Note for TSY developers: The RMobilePhone::TPhoneStoreNameAndIccType structure 

// is used internally (API/TSY) to package the iStoreName and iIccType and pass 

// them to the TSY.

	{

	SetAndGet(EMobilePhoneGetPhoneStoreInfo,aReqStatus, aInfo, aStoreName);

	}

EXPORT_C void RMobilePhone::GetPhoneStoreInfo(TRequestStatus& aReqStatus, TDes8& aInfo, const TDesC& aStoreName, const TDesC& aMode) const

/** This method returns the information related to a particular phone store on 

	a specific Icc.

The method returns information about the phone store specified by aStoreName 

and aMode. Valid values of aStoreName are the various store name literals whose values 

are defined as "S1", "S2", "S3"... "S28". Valid values of aMode are specified 

in the EtelMM API Design Document under the section "Phone Book Storage 

(RMobilePhoneBookStore)"

The phone store information includes the store’s name, the type of thing 

it stores, the total number of storage slots and the number of used slots 

if known. It does not give information about which slots are filled and which 

are empty. The information is returned in the aInfo structure. The RMobilePhoneStore::TMobilePhoneStoreInfoV1 

type is defined in more detail in section Common Storage functionality. Valid 

storage specific aInfo types are listed in sections SMS Message Storage (RMobileSmsStore) 

to Own Number Storage (RMobileONStore).

Note for TSY developers: The RMobilePhone::TPhoneStoreNameAndIccType structure 

is used internally (API/TSY) to package the iStoreName and iIccType and pass 

them to the TSY.

@param aStatus On return, KErrNone if successful, an error code if not.

@param aInfo On completion, a descriptor of type 

RMobilePhoneStore::TMobilePhoneStoreInfoV1Pckg, or one of the 

TMobilePhoneStoreInfoV1 derived classes' package types, that contains the phone 

store information.

@param aStoreName Specifies the name of the store, for which information is 

required.

@param aMode Specifies the type of the ICC that the phonebook belongs to.

@see RMobilePhoneStore::TMobilePhoneStoreInfoV1

@capability ReadDeviceData

*/

	{

	iMmPtrHolder->iPhoneStoreNameAndIccType.iStoreName = aStoreName;

	iMmPtrHolder->iPhoneStoreNameAndIccType.iMode = aMode;

	TPtrC8& ptr1=iMmPtrHolder->SetC(CMobilePhonePtrHolder::ESlot1GetPhoneStoreInfo, iMmPtrHolder->iPhoneStoreNameAndIccType);

	SetAndGet(EMobilePhoneGetPhoneStoreInfo,aReqStatus, ptr1, aInfo);

	}

/***********************************************************************************/

//

// MobileIccAccess functional unit

//

/***********************************************************************************/

EXPORT_C TInt RMobilePhone::GetIccAccessCaps(TUint32& aCaps) const

/** This function member gets the current ICC access capabilities of the phone.

ICC access, as meant by this API, consists of any read/write or command transaction 

that the phone may execute with the ICC. ICC access is always initiated by 

the phone (even for SIM toolkit), however in a multimode phone it may not 

be possible to access the ICC at all times - perhaps only when the phone 

is in a cellular mode that includes a ICC as part of its standard.

@param aCaps On completion, the sum of RMobilePhone::TMobilePhoneIccCaps

constants that is currently supported by the TSY.

@return KErrNone if successful, KErrNotSupported if the TSY/ME does not

support any ICC access.

@capability None

*/

	{

	TPckg<TUint32> ptr1(aCaps);

	return Get(EMobilePhoneGetIccAccessCaps, ptr1);

	}

EXPORT_C void RMobilePhone::NotifyIccAccessCapsChange(TRequestStatus& aReqStatus, TUint32& aCaps) const

/** This function member notifies the client if the current ICC access capabilities 

change, probably due to a change of network mode.

Use RTelSubSessionBase::CancelAsyncRequest(EMobilePhoneNotifyIccAccessCapsChange) 

to cancel a previously placed asynchronous NotifyIccAccessCapsChange() request.

@param aReqStatus On return, KErrNone if successful.

@param aCaps On completion, the sum of RMobilePhone::TMobilePhoneIccCaps

constants that is currently supported by the TSY.

@capability None

*/

	{

	__ASSERT_ALWAYS(iMmPtrHolder!=NULL,PanicClient(EEtelPanicNullHandle));

	TPtr8& ptr1=iMmPtrHolder->Set(CMobilePhonePtrHolder::ESlot1NotifyIccAccessCapsChange,aCaps);

	Get(EMobilePhoneNotifyIccAccessCapsChange,aReqStatus,ptr1);

	}

EXPORT_C void RMobilePhone::GetIccIdentity(TRequestStatus& aReqStatus, TIccIdentity& aIdentity) const

/** 

Gets the ICC identity. 

This is the unique identifier for the ICC as defined in EF_ICCID.

@param aReqStatus On return, KErrNone if successful.

param aIdentity TIccIdentity buffer which will contain the ICC ID on completion.

@capability ReadDeviceData

*/

	{

	__ASSERT_ALWAYS(iMmPtrHolder!=NULL,PanicClient(EEtelPanicNullHandle));

	TPtr8& ptr1 = iMmPtrHolder->Set(CMobilePhonePtrHolder::ESlot1GetIccIdentity, aIdentity);

	Get(EMobilePhoneGetIccIdentity,aReqStatus, ptr1);

	}

EXPORT_C RMobilePhone::TMobilePhoneCspFileV1::TMobilePhoneCspFileV1()

	: iCallOfferingServices(0),iCallRestrictionServices(0),iOtherSuppServices(0),

	iCallCompletionServices(0),iTeleservices(0),iCphsTeleservices(0),iCphsFeatures(0),

	iNumberIdentServices(0),iPhase2PlusServices(0),iValueAddedServices(0)

	{

	iExtensionId=KETelExtMultimodeV1;

	}

EXPORT_C void RMobilePhone::GetCustomerServiceProfile(TRequestStatus& aReqStatus, TDes8& aCsp) const

/** Gets the whole Customer Service Profile file that is stored on the SIM to the 

client.

Use: RTelSubSessionBase::CancelAsyncRequest(EMobilePhoneGetCustomerServiceProfile) 

to cancel a previously placed asynchronous GetCustomerServiceProfile()() request.

@param aReqStatus On return, KErrNone if successful, KErrMMETelWrongMode if 

the phone does not support ICC access during the current mode, KErrNotFound 

if there is no SIM inserted or the CSP file does not exist on the current 

SIM, KErrAccessDenied if the CSP read access condition has not been fulfilled 

(i.e. PIN1 has not been verified).

@param aCsp On completion, a TMobilePhoneCspFileV1Pckg with the current Service 

Profile.

@see TMobilePhoneCspFileV1 

@capability None

*/

	{

	Get(EMobilePhoneGetCustomerServiceProfile, aReqStatus, aCsp);

	}

EXPORT_C RMobilePhone::TMobilePhoneServiceTableV1::TMobilePhoneServiceTableV1()

	: iServices1To8(0),iServices9To16(0),iServices17To24(0),iServices25To32(0),

	iServices33To40(0), iServices41To48(0), iServices49To56(0)

	{

	iExtensionId=KETelExtMultimodeV1;

	}

/**

Default constructor.

Initialises iExtensionId to KETelExtMultimodeV2.

*/

EXPORT_C RMobilePhone::TMobilePhoneServiceTableV2::TMobilePhoneServiceTableV2()

	: TMobilePhoneServiceTableV1()

	{

	iExtensionId=KETelExtMultimodeV2;

	}

/**

Default constructor.

Initialises iExtensionId to KETelExtMultimodeV8.

*/

EXPORT_C RMobilePhone::TMobilePhoneServiceTableV8::TMobilePhoneServiceTableV8()

	: TMobilePhoneServiceTableV2(),iServices57To64(0),iServices65To72(0)

	{

	iExtensionId=KEtelExtMultimodeV8;

	}

EXPORT_C void RMobilePhone::GetServiceTable(TRequestStatus& aReqStatus, TMobilePhoneServiceTable aTable, TDes8& aSst) const

 /** Gets the whole contents of a service table file (SIM or CDMA) that is stored on the ICC to 

	the client.

	Use RTelSubSessionBase::CancelAsyncRequest(EMobilePhoneGetServiceTable) to 

	cancel a previously placed asynchronous GetServiceTable()() request.

	@param aReqStatus On return, KErrNone if successful, KErrMMETelWrongMode if 

	the phone does not support ICC access during the current mode, KErrNotFound 

	if there is no ICC inserted or the specified service table file does not exist 

	on the current ICC, KErrAccessDenied if the service table's read access condition 

	has not been fulfilled (i.e. PIN1 has not been verified).

	@param aTable Specifies whether the SIM or CDMA service table is to be retrieved

	@param aSst On completion, a TMobilePhoneServiceTableV1Pckg containing 

	the service table.

	@see TMobilePhoneServiceTableV1 

@capability None

*/

	{

	__ASSERT_ALWAYS(iMmPtrHolder!=NULL,PanicClient(EEtelPanicNullHandle));

	iMmPtrHolder->iServiceTable = aTable;

	TPtrC8& ptr1=iMmPtrHolder->SetC(CMobilePhonePtrHolder::ESlot1GetServiceTable, iMmPtrHolder->iServiceTable);

	SetAndGet(EMobilePhoneGetServiceTable, aReqStatus, ptr1, aSst);

	}

/***********************************************************************************/

//

// MobilePower functional unit

//

/***********************************************************************************/

EXPORT_C TInt RMobilePhone::GetBatteryCaps(TUint32& aCaps) const

/** Gets the battery information capabilities of the phone.

@param aCaps On return, the bit-wise sum of RMobilePhone::TMobilePhoneBatteryCaps

constants.

@return KErrNone if successful, KErrNotSupported if the TSY/ME does not support 

any battery functionality.

@capability None

*/

	{

	TPckg<TUint32> ptr1(aCaps);

	return Get(EMobilePhoneGetBatteryCaps, ptr1);

	}

EXPORT_C RMobilePhone::TMobilePhoneBatteryInfoV1::TMobilePhoneBatteryInfoV1() :

		iStatus(EPowerStatusUnknown), iChargeLevel(0)

	{

	iExtensionId=KETelExtMultimodeV1;

	}

EXPORT_C void RMobilePhone::GetBatteryInfo(TRequestStatus& aReqStatus, TMobilePhoneBatteryInfoV1& aInfo) const

/** This function member returns a snapshot of the current battery information 

of the phone.

Use RTelSubSessionBase::CancelAsyncRequest(EMobilePhoneGetBatteryInfo) to 

cancel a previously placed asynchronous GetBatteryInfo() request.

@param aReqStatus On return, KErrNone if successful.

@param aInfo On completion, the mobile phone battery status. 

@capability None

*/

	{

	__ASSERT_ALWAYS(iMmPtrHolder!=NULL,PanicClient(EEtelPanicNullHandle));

	TPtr8& ptr1=iMmPtrHolder->Set(CMobilePhonePtrHolder::ESlot1GetBatteryInfo,aInfo);

	Get(EMobilePhoneGetBatteryInfo,aReqStatus,ptr1);

	}

EXPORT_C void RMobilePhone::NotifyBatteryInfoChange(TRequestStatus& aReqStatus, TMobilePhoneBatteryInfoV1& aInfo) const

/** This function member posts an asynchronous notification request.

The notification will trigger when the phone's battery information changes 

in any way.

Use RTelSubSessionBase::CancelAsyncRequest(EMobilePhoneNotifyBatteryInfoChange) 

to cancel a previously placed asynchronous NotifyBatteryInfoChange() request.

@param aReqStatus On return, KErrNone if successful.

@param aInfo On completion, the mobile phone battery status. 

@capability None

*/

	{

	__ASSERT_ALWAYS(iMmPtrHolder!=NULL,PanicClient(EEtelPanicNullHandle));

	TPtr8& ptr1=iMmPtrHolder->Set(CMobilePhonePtrHolder::ESlot1NotifyBatteryInfoChange,aInfo);

	Get(EMobilePhoneNotifyBatteryInfoChange,aReqStatus,ptr1);

	}

/***********************************************************************************/

//

// MobileSignal functional unit

//

/***********************************************************************************/

EXPORT_C TInt RMobilePhone::GetSignalCaps(TUint32& aCaps) const

/** This function member gets the signal strength capabilities of the phone.

@param aCaps On return, the sum of RMobilePhone::TMobilePhoneSignalCaps

constants that this phone supports.

@return KErrNone if successful, KErrNotSupported if the TSY/ME does not

support any signal strength functionality.

@capability None

*/

	{

	TPckg<TUint32> ptr1(aCaps);

	return Get(EMobilePhoneGetSignalCaps, ptr1);

	}

EXPORT_C void RMobilePhone::GetSignalStrength(TRequestStatus& aReqStatus, TInt32& aSignalStrength, TInt8& aBar) const

/** This function member gets the phone's current signal strength.

Use RTelSubSessionBase::CancelAsyncRequest(EMobilePhoneGetSignalStrength) 

to cancel a previously placed asynchronous GetSignalStrength() request.

@param aReqStatus On return, KErrNone if successful, KErrNotSupported if signal 

strength information is not supported by the phone, and KErrNotFound if no 

signal strength information is currently available.

@param aSignalStrength On completion, the signal strength in dBm, or 0 if the 

TSY does not wish to provide this information.

@param aBar On completion, the number of bars the phone should display, or 

-1 if the TSY does not wish to provide this information.

@capability None

*/

	{

	__ASSERT_ALWAYS(iMmPtrHolder!=NULL,PanicClient(EEtelPanicNullHandle));

	TPtr8& ptr1=iMmPtrHolder->Set(CMobilePhonePtrHolder::ESlot1GetSignalStrength,aSignalStrength);

	TPtr8& ptr2=iMmPtrHolder->Set(CMobilePhonePtrHolder::ESlot2GetSignalStrength,aBar);