// Copyright (c) 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:
// @file atphbkstoreread.h
// This contains CAtPhbkStoreRead which is use to read a phonebook Entry
//
#ifndef ATPHBKSTOREREAD_H
#define ATPHBKSTOREREAD_H
//system include
#include <e32std.h>
#include <e32base.h>
//user include
#include "atcommandbase.h"
/**
* CAtPhbkStoreRead
*
*/
class CAtPhbkStoreRead : public CAtCommandBase
{
public:
/**
* Destructor
*
*/
~CAtPhbkStoreRead();
/**
* static NewL
*
* @param aGloblePhone
* @param aCtsyDispatcherCallback
*/
static CAtPhbkStoreRead* NewL(CGlobalPhonemanager& aGloblePhone,
CCtsyDispatcherCallback& aCtsyDispatcherCallback);
/**
* static NewLC
*
* @param aGloblePhone
* @param aCtsyDispatcherCallback
*/
static CAtPhbkStoreRead* NewLC(CGlobalPhonemanager& aGloblePhone,
CCtsyDispatcherCallback& aCtsyDispatcherCallback);
/**
* Virtual function. Inherited from CAtCommandBase
* Start Execute AT Command
*/
virtual void ExecuteCommand();
/**
* Will be called by AT Manager whenever a event was triggered
*
* @param aEventSource
* @param aStatus
*/
virtual void EventSignal(TAtEventSource aEventSource, TInt aStatus);
/**
* Virtual function. Inherited from CAtCommandBase
*
* @param aResponseBuf Line buf reading from baseband
*/
virtual void ParseResponseL(const TDesC8& aResponseBuf);
/**
* Start this request
*
*/
void StartRequest();
/**
* Set read phonebook parameters
*
* @param aIndex
* @param aSlotNum
*/
void SetReadParam(TInt aIndex,TInt aSlotNum);
/**
* Set Phonebook Type
*
* @param aPhonebookType
*/
void SetPhonebookType(DispatcherPhonebook::TPhonebook aPhonebookType);
protected:
/**
* Constructor
*
* @param aGloblePhone
* @param aCtsyDispatcherCallback
*/
CAtPhbkStoreRead(CGlobalPhonemanager& aGloblePhone,
CCtsyDispatcherCallback& aCtsyDispatcherCallback);
/**
* 2nd Constructor
*/
void ConstructL();
private:
/**
* Executer AT command for reading a phonebook entry
*/
void ReadEntry();
/**
* Generate TLV Data should be used by callback
*/
TInt GeneratePhbkDataL();
private:
/**
* save PhoneBookType by SetPhonebookType
*/
DispatcherPhonebook::TPhonebook iPhoneBookType;
/**
* state machine for EventSignal
*/
enum
{
ESetStoreName,
ESetStoreNameComplete,
EReadEntry,
EReadEntryComplete,
EATNotInProgress
}iState;
/**
* The return error value of AT command executed
*/
TInt iError;
/*
* the first index should be read
*/
TInt iIndex;
/*
* the phonebook item number want to read
*/
TInt iSlotNum;
/**
* This is used to generate TLV data by GeneratePhbkData
*/
TPhonebookReadEntry iReadEntry;
/*
* Client reserved space for phonebook data
*/
TBuf8<800> iPhbkData;
/*
* indicate whether it is OK or ERROR string
*/
TBool iEndFlag;
}; // class CAtPhbkStoreRead
#endif // ATPHBKSTOREREAD_H