// Copyright (c) 1999-2009 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

// which accompanies this distribution, and is available

// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// This file define the classes for the different PDU elements

// 

//

/**

 @file

*/

#ifndef __GSMUELEM_H__

#define __GSMUELEM_H__

// Includes

#include <e32std.h>

#include <e32base.h>

#include <charconv.h>

#include <gsmunmspacemobph.h>

class RFs;

class RReadStream;

class RWriteStream;

class CSmsEMSBufferSegmenter;

// class declarations

/**

 *  Decoding error.

 *  @publishedAll

 *  @released 

 */

const TInt KErrGsmuDecoding = KErrCorrupt;

/**

 *  @internalComponent

 */

_LIT8(KMOSES,"\x40\x4d\x64\xd3\x50\x00");

/**

 *  @internalComponent

 */

_LIT16(KNETWORK,"NETWORK");

// Constants

/**

 *  @internalComponent

 */

const TUint8 KSms7BitAlphabetEscapeChar=0x1b;

/**

 *  Thin wrapper over TLex8 to provide leaving functions when getting the next

 *  character(s).

 *  

 *  These functions leave with KErrGsmuDecoding if there are insufficient characters

 *  remaining.

 *  @publishedAll

 *  @released

 */

class TGsmuLex8 : public TLex8

	{

	public:

		TGsmuLex8(const TDesC8& aSource);

		TUint8 GetL();

		void IncL(TInt aNumber = 1);

		TPtrC8 NextWithNoIncL(TInt aLength) const;

		TPtrC8 NextWithNoIncL(TInt aLength, TBool aAcceptTruncation) const;		

		TPtrC8 NextAndIncL(TInt aLength);

	private:

		inline void LeaveL() const;

	};

/**

 *  Base class for performing all operations on octets.

 *  @publishedAll

 *  @released 

 */

class TSmsOctet

	{

public:

	inline TSmsOctet(TInt aValue);

	inline TSmsOctet(TUint8 aValue = 0);

	inline operator TInt() const;

	const TSmsOctet& operator = (TInt aValue);

	inline void FillSemiOctets(TInt aNum);

	inline TInt SemiOctetsToNum() const;

	TUint8* EncodeL(TUint8* aPtr) const;

	inline void DecodeL(TGsmuLex8& aPdu);

	inline void InternalizeL(RReadStream& aStream);

	inline void ExternalizeL(RWriteStream& aStream) const;

protected:

	/** Octet value. */

	TUint8 iValue;

	};

/**

 *  Bit masks for key first octet of an SMS PDU

 *  @publishedAll

 *  @released

 */

class TSmsFirstOctet : public TSmsOctet

	{

public:

/** TP-MTI (Message Type Indicator) First octet of all SMS PDUs. */

	enum TSmsMTI

		{

	/** SMS-DELIVER or SMS-DELIVER-REPORT message. */

		ESmsMTIDeliverOrDeliverReport=0x00,

	/** SMS-SUBMIT or SMS-SUBMIT-REPORT message. */

		ESmsMTISubmitOrSubmitReport=0x01,

	/** SMS-STATUS or SMS-COMMAND message. */

		ESmsMTIStatusReportOrCommand=0x02,

	/** Mask for these bit flags. */

		ESmsMTIMask=0x03

		};

/**

 *  TP-UDHI (User Data Header Indicator) Found in first octet of

 *  Submit and Deliver and possibly, Deliver Report and Status Report. 

 */

	enum TSmsUDHI

		{

	/** User data header indicator not present. */

		ESmsUDHIHeaderNotPresent=0x00,

	/** User data header indicator present. */

		ESmsUDHIHeaderPresent=0x40,

	/** Mask for these bit flags. */

		ESmsUDHIMask=0x40

		};

/** TP-RP (Reply Path) Found in first octet of Submit and Deliver. */

	enum TSmsReplyPath

		{

	/** Reply path does not exist. */

		ESmsReplyPathNone=0x00,

	/** Reply path exists. */

		ESmsReplyPathExists=0x080,

	/** Mask for these bit flags. */

		ESmsReplyPathMask=0x80

		};

/** TP-MMS (More Messages To Send) Found in Deliver and Status Report. */

	enum TSmsMoreMessagesToSend

		{

	/** More messages to send. */

		ESmsMoreMessagesToSend=0x00,

	/** No more messages to send. */

		ESmsNoMoreMessagesToSend=0x04,

	/** Mask for these bit flags. */

		ESmsMoreMessagesToSendMask=0x04,

		};

/** T-SRI (Status Report Indicator) Found in Status Report. */

	enum TSmsStatusReportIndicator

		{

	/** Status report is not going to be returned. */

		ESmsStatusReportNotReturned=0x00,

	/** Status report is going to be returned. */

		ESmsStatusReportReturned=0x20,

	/** Mask for these bit flags. */

		ESmsStatusReportIndicatorMask=0x20

		};

/** TP-RD bit flags. */

	enum TSmsRejectDuplicates

		/**

		 *  T-RD (Reject Duplicates) Found in Submit

		 */

		{

	/** Accept duplicates. */

		ESmsAcceptDuplicates=0x00,

	/** Reject duplicates. */

		ESmsRejectDuplicates=0x04,

	/** Mask for these bit flags. */

		ESmsRejectDuplicatesMask=0x04

		};

/** T-SRQ (Status Report Qualifier). Found in Status Report. */

	enum TSmsStatusReportQualifier

		{

	/** Status report result of submit. */

		ESmsStatusReportResultOfSubmit=0x00,

	/** Status report result of command. */

		ESmsStatusReportResultOfCommand=0x20,

	/** Mask for these bit flags. */

		ESmsStatusReportQualifierMask=0x20

		};

/** TP-VPF (Validity Period Format). Found in Submit. */

	enum TSmsValidityPeriodFormat

		{

	/** TP-VP field not present. */

		ESmsVPFNone=0x00,

	/** TP-VP field present. Enhanced format (7 octets). */

		ESmsVPFEnhanced=0x08,	// was ESmsVPFReserved, the new GSM spec!

	/** TP-VP field present, relative validity format. */

		ESmsVPFInteger=0x10,    // relative validity period

	/** TP-VP field present, absolute validity format. */

		ESmsVPFSemiOctet=0x18,  // absolute validity period

	/** Mask for these bit flags. */

		ESmsVPFMask=0x18

		};

/** TP-SRR (Status Report Request) Found in Submit and Command. */

	enum TSmsStatusReportRequest

		{

	/** Status report is not requested. */

		ESmsStatusReportNotRequested=0x00,

	/** Status report is requested. */

		ESmsStatusReportRequested=0x20,

	/** Mask for these bit flags. */

		ESmsStatusReportRequestMask=0x20

		};

public:

	TSmsFirstOctet(TInt aValue=0);

	const TSmsFirstOctet& operator = (TInt aValue);  //  Review

	};

/**

 *  TP-FCS (Failure Cause) octet. For Deliver and Submit errors

 *  @publishedAll

 *  @released

 */

class TSmsFailureCause : public TSmsOctet

	{

public:

/** TP-FCS flags. */

	enum TSmsFailureCauseError

		{

//  Reserved values

//		....

//		....

//  PID errors

	/** Telematic interworking not supported. */

		ESmsPIDErrorTelematicInterworkingNotSupported=0x80,

	/** Short message Type 0 not supported. */

		ESmsPIDErrorShortMessageType0NotSupported=0x81,

	/** Cannot replace short message. */

		ESmsPIDErrorCannotReplaceShortMessage=0x82,

	/** Reserved. */

		ESmsPIDErrorReserved1=0x83,

	/** Reserved. */

		ESmsPIDErrorReserved2=0x84,

	/** Reserved. */

		ESmsPIDErrorReserved3=0x85,

	/** Reserved. */

		ESmsPIDErrorReserved4=0x86,

	/** Reserved. */

		ESmsPIDErrorReserved5=0x87,

	/** Reserved. */

		ESmsPIDErrorReserved6=0x88,

	/** Reserved. */

		ESmsPIDErrorReserved7=0x89,

	/** Reserved. */

		ESmsPIDErrorReserved8=0x8A,

	/** Reserved. */

		ESmsPIDErrorReserved9=0x8B,

	/** Reserved. */

		ESmsPIDErrorReserved10=0x8C,

	/** Reserved. */

		ESmsPIDErrorReserved11=0x8D,

	/** Reserved. */

		ESmsPIDErrorReserved12=0x8E,

	/** Unspecified TP-PID error. */

		ESmsPIDErrorUnspecified=0x8F,

//  DCS errors

	/** Data coding scheme (alphabet) not supported. */

		ESmsDCSErrorAlphabetNotSupported=0x90,

	/** Message class not supported. */

		ESmsDCSErrorMessageClassNotSupported=0x91,

	/** Reserved. */

		ESmsDCSErrorReserved1=0x92,

	/** Reserved. */

		ESmsDCSErrorReserved2=0x93,

	/** Reserved. */

		ESmsDCSErrorReserved3=0x94,

	/** Reserved. */

		ESmsDCSErrorReserved4=0x95,

	/** Reserved. */

		ESmsDCSErrorReserved5=0x96,

	/** Reserved. */

		ESmsDCSErrorReserved6=0x97,

	/** Reserved. */

		ESmsDCSErrorReserved7=0x98,

	/** Reserved. */

		ESmsDCSErrorReserved8=0x99,

	/** Reserved. */

		ESmsDCSErrorReserved9=0x9A,

	/** Reserved. */

		ESmsDCSErrorReserved10=0x9B,

	/** Reserved. */

		ESmsDCSErrorReserved11=0x9C,

	/** Reserved. */

		ESmsDCSErrorReserved12=0x9D,

	/** Reserved. */

		ESmsDCSErrorReserved13=0x9E,

	/** Reserved. */

		ESmsDCSErrorUnspecified=0x9F,

//  CommandErrors

	/** Command cannot be actioned. */

		ESmsCommandErrorCannotBeActioned=0xA0,

	/** Command unsupported. */

		ESmsCommandErrorUnsupported=0xA1,

	/** Reserved. */

		ESmsCommandErrorReserved1=0xA2,

	/** Reserved. */

		ESmsCommandErrorReserved2=0xA3,

	/** Reserved. */

		ESmsCommandErrorReserved3=0xA4,

	/** Reserved. */

		ESmsCommandErrorReserved4=0xA5,

	/** Reserved. */

		ESmsCommandErrorReserved5=0xA6,

	/** Reserved. */

		ESmsCommandErrorReserved6=0xA7,

	/** Reserved. */

		ESmsCommandErrorReserved7=0xA8,

	/** Reserved. */

		ESmsCommandErrorReserved8=0xA9,

	/** Reserved. */

		ESmsCommandErrorReserved9=0xAA,

	/** Reserved. */

		ESmsCommandErrorReserved10=0xAB,

	/** Reserved. */

		ESmsCommandErrorReserved11=0xAC,

	/** Reserved. */

		ESmsCommandErrorReserved12=0xAD,

	/** Reserved. */

		ESmsCommandErrorReserved13=0xAE,

	/** Unspecified TP-Command error. */

		ESmsCommandErrorUnspecified=0xAF,

//

	/** PDU not supported. */

		ESmsErrorPDUNotSupported=0xB0,

//  Reserved values

//		....

//		....

	/** SC busy. */

		ESmsErrorSCBusy=0xC0,

	/** No SC subscription. */

		ESmsErrorNoSCSubscription=0xC1,

	/** SC system failure. */

		ESmsErrorNoSCSystemFailure=0xC2,

	/** Invalid SME address. */

		ESmsErrorInvalidSMEAddress=0xC3,

	/** Destination SME barred. */

		ESmsErrorDestinationSMEBarred=0xC4,

	/** SM Rejected-Duplicate SM. */

		ESmsErrorSMRejectedDuplicateSM=0xC5,

	/** TP-VPF not supported. */

		ESmsErrorVPFNotSupported=0xC6,

	/** TP-VP not supported. */

		ESmsErrorVPNotSupported=0xC7,

//  Reserved values

//		....

//		....

	/** SIM SMS storage full. */

		ESmsErrorSIMSMSStorageFull=0xD0,

	/** No SMS storage capability in (U)SIM. */

		ESmsErrorNoSMSStorageCapabilityOnSIM=0xD1,

	/** Error in MS. */

		ESmsErrorErrorInMS=0xD2,

	/** Memory Capacity Exceeded. */

		ESmsErrorMemoryCapacityExceded=0xD3,

	/** (U)SIM Application Toolkit Busy. */

		ESmsErrorSIMApplicationToolkitBusy=0xD4,

	/** (U)SIM data download error. */

		ESmsErrorSIMDataDownloadError=0xD5,

//  Reserved values

//		....

//		....

	/** Value specific to an application. */

		ESmsApplicationError1=0xE0,

	/** Value specific to an application. */

		ESmsApplicationError2=0xE1,

	/** Value specific to an application. */

		ESmsApplicationError3=0xE2,

	/** Value specific to an application. */

		ESmsApplicationError4=0xE3,

	/** Value specific to an application. */

		ESmsApplicationError5=0xE4,

	/** Value specific to an application. */

		ESmsApplicationError6=0xE5,

	/** Value specific to an application. */

		ESmsApplicationError7=0xE6,

	/** Value specific to an application. */

		ESmsApplicationError8=0xE7,

	/** Value specific to an application. */

		ESmsApplicationError9=0xE8,

	/** Value specific to an application. */

		ESmsApplicationError10=0xE9,

	/** Value specific to an application. */

		ESmsApplicationError11=0xEA,

	/** Value specific to an application. */

		ESmsApplicationError12=0xEB,

	/** Value specific to an application. */

		ESmsApplicationError13=0xEC,

	/** Value specific to an application. */

		ESmsApplicationError14=0xED,

	/** Value specific to an application. */

		ESmsApplicationError15=0xEE,

	/** Value specific to an application. */

		ESmsApplicationError16=0xEF,

	/** Value specific to an application. */

		ESmsApplicationError17=0xF0,

	/** Value specific to an application. */

		ESmsApplicationError18=0xF1,

	/** Value specific to an application. */

		ESmsApplicationError19=0xF2,

	/** Value specific to an application. */

		ESmsApplicationError20=0xF3,

	/** Value specific to an application. */

		ESmsApplicationError21=0xF4,

	/** Value specific to an application. */

		ESmsApplicationError22=0xF5,

	/** Value specific to an application. */

		ESmsApplicationError23=0xF6,

	/** Value specific to an application. */

		ESmsApplicationError24=0xF7,

	/** Value specific to an application. */

		ESmsApplicationError25=0xF8,

	/** Value specific to an application. */

		ESmsApplicationError26=0xF9,

	/** Value specific to an application. */

		ESmsApplicationError27=0xFA,

	/** Value specific to an application. */

		ESmsApplicationError28=0xFB,

	/** Value specific to an application. */

		ESmsApplicationError29=0xFC,

	/** Value specific to an application. */

		ESmsApplicationError30=0xFD,

	/** Value specific to an application. */

		ESmsApplicationError31=0xFE,

//

	/** Unspecified error cause. */

		ESmsErrorUnspecified=0xFF,

	/**	@internalComponent	*/

		ESmsErrorFree=0x100

		};

public:

	TSmsFailureCause();

	inline TInt Error() const;

	inline void SetError(TSmsFailureCauseError aError);

	};

/**

 *  TP-ST (Status Report) octet. Found in Status Report

 *  @publishedAll

 *  @released

 */

class TSmsStatus : public TSmsOctet

	{

public:

/** TP-ST flag values. */

	enum TSmsStatusValue

		{

//  Short message transaction completed

	/** Short message received by the SME. */

		ESmsShortMessageReceivedBySME=0x00,

	/**

	 *  Short message forwarded by the SC to the SME but the SC is unable to confirm

	 *  	delivery. 

	 */

		ESmsShortMessageForwardedBySCToSMEButUnconfirmedBySC=0x01,

	/** Short message replaced by the SC. */

		ESmsShortMessageReplacedBySC=0x02,

//  Reserved values

//		....

//		....

//  Temporary error, SC still trying to transfer SM

	/** Temporary error, SC still trying to transfer SM: congestion. */

		ESmsTempError1StatusCongestion=0x20,

	/** Temporary error, SC still trying to transfer SM: SME busy. */

		ESmsTempError1StatusSMEBusy=0x21,

	/** Temporary error, SC still trying to transfer SM: No response from SME. */

		ESmsTempError1StatusNoResponseFromSME=0x22,

	/** Temporary error, SC still trying to transfer SM: Service rejected. */

		ESmsTempError1StatusServiceRejected=0x23,

	/** Temporary error, SC still trying to transfer SM: Quality of service not available. */

		ESmsTempError1StatusQualityOfServiceNotAvailable=0x24,

	/** Temporary error, SC still trying to transfer SM: Error in SME. */

		ESmsTempError1StatusErrorInSME=0x25,

//  Reserved values

//		....

//		....

//  Permanent error, SC is not making any more transfer attempts

	/**

	 *  Permanent error, SC is not making any more transfer attempts: Remote procedure

	 *  	error. 

	 */

		ESmsPermErrorRemoteProcedureError=0x40,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: Incompatible

	 *  	destination. 

	 */

		ESmsPermErrorIncompatibleDestination=0x41,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: Connection rejected

	 *  	by SME. 

	 */

		ESmsPermErrorConnectionRejectedBySME=0x42,

	/** Permanent error, SC is not making any more transfer attempts: Not obtainable. */

		ESmsPermErrorNotObtainable=0x43,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: Quality of service

	 *  	not available. 

	 */

		ESmsPermErrorQualityOfServiceNotAvailable2=0x44,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: No interworking

	 *  	available. 

	 */

		ESmsPermErrorNoInterworkingAvailable=0x45,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: SM Validity Period

	 *  	Expired. 

	 */

		ESmsPermErrorSMValidityPeriodExpired=0x46,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: SM Deleted by

	 *  	originating SME. 

	 */

		ESmsPermErrorSMDeletedByOriginatingSME=0x47,

	/**

	 *  Permanent error, SC is not making any more transfer attempts: SM Deleted by

	 *  	SC Administration. 

	 */

		ESmsPermErrorSMDeletedBySCAdministration=0x48,

	/** Permanent error, SC is not making any more transfer attempts: SM does not exist. */

		ESmsPermErrorDoesNotExist=0x49,

//  Reserved values

//		....

//		....

//  Temporary error, SC is not making any more transfer attempts

	/** Temporary error, SC is not making any more transfer attempts: Congestion. */

		ESmsTempError2Congestion=0x60,

	/** Temporary error, SC is not making any more transfer attempts: SME Busy. */

		ESmsTempError2SMEBusy=0x61,

	/**

	 *  Temporary error, SC is not making any more transfer attempts: No response from

	 *  	SME. 

	 */

		ESmsTempError2NoResponseFromSME=0x62,

	/** Temporary error, SC is not making any more transfer attempts: Service rejected. */

		ESmsTempError2ServiceRejected=0x63,

	/**

	 *  Temporary error, SC is not making any more transfer attempts: Quality of service

	 *  	not available. 

	 */

		ESmsTempError2QualityOfServiceNotAvailable=0x64,

	/** Temporary error, SC is not making any more transfer attempts: Error in SME. */

		ESmsTempError2ErrorInSME=0x65,

//  Reserved values

//		....

//		....

		};

public:

	TSmsStatus();

	inline TSmsStatus::TSmsStatusValue Status() const;

	inline void SetStatus(TSmsStatusValue aValue);

	};

/**

 *  TP-PI octet. Found in Reports and Commands

 *  @publishedAll

 *  @released

 */

class TSmsParameterIndicator : public TSmsOctet

	{

public:

/** TP-PI bit flags. */

	enum TSmsPIBits

		{

	/** Protocol identifier present. */

		ESmsPIDProtocolIdentifierPresent=0x01,

	/** Data coding scheme present. */

		ESmsPIDDataCodingSchemePresent=0x02,

	/** User data present. */

		ESmsPIDUserDataPresent=0x04,

	/** Reserved. */

		ESmsPIDReserved1=0x08,

	/** Reserved. */

		ESmsPIDReserved2=0x10,

	/** Reserved. */

		ESmsPIDReserved3=0x20,

	/** Reserved. */

		ESmsPIDReserved4=0x40,

	/** Extension. */

		ESmsPIDExtension=0x80

		};

public:

	TSmsParameterIndicator();

	inline TBool Extension() const;

	inline void SetExtension(TBool aExtension);

	inline TBool UserDataPresent() const;

	inline void SetUserDataPresent(TBool aPresent);

	inline TBool DataCodingSchemePresent() const;

	inline void SetDataCodingSchemePresent(TBool aPresent);

	inline TBool ProtocolIdentifierPresent() const;

	inline void SetProtocolIdentifierPresent(TBool aPresent);

	};

// TSmsPID - conversion (None, Fax, Mail, etc.)

/**

 *  TP-PID PDU octet. Found in ALL 6 message types.

 *  @publishedAll

 *  @released

 */

class TSmsProtocolIdentifier : public TSmsOctet

	{

public:

/** PID bits 7-6, which determine the meaning of the lower order bits. */

	enum TSmsPIDType

		{

	/** Telematic interworking. */

		ESmsPIDTelematicInterworking=0x00,

	/** Short message. */

		ESmsPIDShortMessageType=0x40,

	/** Reserved. */

		ESmsPIDReserved=0x80,

	/** SC specific use. */

		ESmsPIDSCSpecificUse=0xC0,

	/** Mask of bits 7-6. */

		ESmsPIDTypeMask=0xC0

		};

/** Telematic device indicator flags. Bit 5 - When Bit 7 = 0, Bit 6 = 0 */

	enum TSmsTelematicDeviceIndicator

		{

	/** No telematic device. */

		ESmsNoTelematicDevice=0x00,

	/** Telematic device. */

		ESmsTelematicDevice=0x20,

	/** Telematic device indicator mask. */

		EPIDTelematicDeviceIndicatorMask=0x20

		};

/** Telematic Interworking device type flags. Bits 4-0 - When Bit 5 = 1*/

	enum TSmsTelematicDeviceType

		{

	/** Device type is specific to this SC. */

		ESmsSCSpecificDevice=0x00,

	/** Telex. */

		ESmsTelex=0x01,

	/** Group 3 telefax. */

		ESmsGroup3TeleFax=0x02,

	/** Group 4 telefax. */

		ESmsGroup4TeleFax=0x03,

	/** Voice telephone. */

		ESmsVoiceTelephone=0x04,

	/** ERMES. */

		ESmsERMES=0x05,

	/** National Paging System. */

		ESmsNationalPagingSystem=0x06,

	/** Videotex. */

		ESmsVideotex=0x07,

	/** Teletex, carrier unspecified. */

		ESmsTeletexCarrierUnspecified=0x08,

	/** Teletex, PSPDN. */

		ESmsTeletexPSPDN=0x09,

	/** Teletex, CSPDN. */

		ESmsTeletexCSPDN=0x0A,

	/** Teletex, in analog PSTN. */

		ESmsTeletexAnaloguePSTN=0x0B,

	/** Teletex, in digital ISDN */

		ESmsTeletexDigitalISDN=0x0C,

	/** UCI (Universal Computer Interface, ETSI DE/PS 3 01-3). */

		ESmsUCI=0x0D,

	/** Reserved. */

		ESmsReserved1=0x0E,

	/** Reserved. */

		ESmsReserved2=0x0F,

	/** A message handling facility. */

		ESmsMessageHandlingFacility=0x10,

	/** X.400 message handling system. */

		ESmsX400MessageHandlingSystem=0x11,

	/** Internet Electronic Mail. */

		ESmsInternetElectronicMail=0x12,

	/** Reserved. */

		ESmsReserved3=0x13,

	/** Reserved. */

		ESmsReserved4=0x14,

	/** Reserved. */

		ESmsReserved5=0x15,

	/** Reserved. */

		ESmsReserved6=0x16,

	/** Reserved. */

		ESmsReserved7=0x17,

	/** Value specific to each SC. */

		ESmsSCSpecific1=0x18,

	/** Value specific to each SC. */

		ESmsSCSpecific2=0x19,

	/** Value specific to each SC. */

		ESmsSCSpecific3=0x1A,

	/** Value specific to each SC. */

		ESmsSCSpecific4=0x1B,

	/** Value specific to each SC. */

		ESmsSCSpecific5=0x1C,

	/** Value specific to each SC. */

		ESmsSCSpecific6=0x1D,

	/** Value specific to each SC. */

		ESmsSCSpecific7=0x1E,

	/** Value specific to each SC. */

		ESmsGsmMobileStation=0x1F,

	/** Mask for telematic device type bits. */

		ESmsTelematicDeviceTypeMask=0x1F

		};

/** SM-AL protocol flag. No Telematic Interworking. Bits 4-0 - When Bit 5 = 0*/

	enum TSmsShortMessageALProtocol

		{

	/** Mask for SM-AL protocol flag bit. */

		ESmsShortMessageALProtocolMask=0x0F

		};

/** Short Message Type flags. Bits 5-0 - When Bit 7 = 1, Bit 6 = 0*/

	enum TSmsShortMessageType

		{

	/** Short Message Type 0. */

		ESmsShortMessageType0=0x00,

	/** Replace Short Message Type 1. */

		ESmsReplaceShortMessageType1=0x01,

	/** Replace Short Message Type 2. */

		ESmsReplaceShortMessageType2=0x02,

	/** Replace Short Message Type 3. */

		ESmsReplaceShortMessageType3=0x03,

	/** Replace Short Message Type 4. */

		ESmsReplaceShortMessageType4=0x04,

	/** Replace Short Message Type 5. */

		ESmsReplaceShortMessageType5=0x05,

	/** Replace Short Message Type 6. */

		ESmsReplaceShortMessageType6=0x06,

	/** Replace Short Message Type 7. */

		ESmsReplaceShortMessageType7=0x07,

//  Reserved values

//		....

//		....

	/** Return Call Message. */

		ESmsReturnCallMesage=0x1F,

//  Reserved values

//		....

//		....

		ESmsAnsi136RData=0x3C,

 		ESmsMEDataDownload=0x3D,

	/** ME De-personalization Short Message. */

		ESmsMEDepersonalizationShortMessage=0x3E,

	/** ME Data download. */

		ESmsSIMDataDownLoad=0x3F,

//		ESmsShortMessageTypeMask=0x1F

	/** Mask for Short Message type bits. */

		ESmsShortMessageTypeMask=0x3F

		};

public:

	TSmsProtocolIdentifier();

	inline TSmsPIDType PIDType() const;

	inline void SetPIDType(TSmsPIDType aSmsPIDType);

	TSmsTelematicDeviceIndicator TelematicDeviceIndicator() const;

	void SetTelematicDeviceIndicator(TSmsTelematicDeviceIndicator aIndicator);

	TSmsTelematicDeviceType TelematicDeviceType() const;

	void SetTelematicDeviceType(TSmsTelematicDeviceType aDeviceType);

	TInt ShortMessageALProtocol() const;

	void SetShortMessageALProtocol(TSmsShortMessageALProtocol aProtocol);

	TInt ShortMessageType() const;

	void SetShortMessageType(TSmsShortMessageType aShortMessageType);

	};

/**

 *  TP-DCS Data Coding Scheme defined in 3GPP TS 23.038.

 *  

 *  The data coding scheme is not always present in an GSM SMS PDU (CSmsPDU).

 *  It is always present for a SUBMIT (CSmsSubmit) and a DELIVER (CSmsDeliver),

 *  and is sometimes present for a DELIVER REPORT (CSmsDeliverReport), a SUBMIT

 *  REPORT (CSmsSubmitReport) or a STATUS REPORT (CSmsStatusReport), depending

 *  on the parameter indicator (TSmsParameterIndicator).

 *  @publishedAll

 *  @released 

 */

class TSmsDataCodingScheme : public TSmsOctet

	{

public:

/** Flags for bits 7-4, which determine the meaning of the lower order bits. */

	enum TSmsDCSBits7To4

		{

	/** Text is uncompressed, no class information. */

		ESmsDCSTextUncompressedWithNoClassInfo=0x00,

	/** Text is uncompressed, class information present. */

		ESmsDCSTextUncompressedWithClassInfo=0x10,

	/** Text is compressed, no class information. */

		ESmsDCSTextCompressedWithNoClassInfo=0x20,

	/** Text is compressed, class information present. */

		ESmsDCSTextCompressedWithClassInfo=0x30,

	/** Auto Deletion, Text is uncompressed, no class information. */

		ESmsDCSAutoDelNoClassInfoUncompressedText=0x40,

	/** Auto Deletion, Text is uncompressed, class information present. */

		ESmsDCSAutoDelClassInfoUncompressedText=0x50,

	/** Auto Deletion, Text is compressed, no class information. */

		ESmsDCSAutoDelNoClassInfoCompressedText=0x60,

	/** Auto Deletion, Text is compressed, class information present. */

		ESmsDCSAutoDelClassInfoTextCompressedText=0x70,

	/** Reserved. */

		ESmsDCSReserved1=0x40,

	/** Reserved. */

		ESmsDCSReserved2=0x50,

	/** Reserved. */

		ESmsDCSReserved3=0x60,

	/** Reserved. */

		ESmsDCSReserved4=0x70,

	/** Reserved. */

		ESmsDCSReserved5=0x80,

	/** Reserved. */

		ESmsDCSReserved6=0x90,

	/** Reserved. */

		ESmsDCSReserved7=0xA0,

	/** Reserved. */

		ESmsDCSReserved8=0xB0,

	/** Message Waiting Indication Group: Discard Message. */

		ESmsDCSMessageWaitingIndicationDiscardMessage=0xC0,

	/** Message Waiting Indication Group (7 bit). */

		ESmsDCSMessageWaitingIndication7Bit=0xD0,  //  7 bit User data

	/** Message Waiting Indication Group (UCS2). */

		ESmsDCSMessageWaitingIndicationUCS2=0xE0,  //  unicode User data

	/** Text uncompressed, 7 bit or 8 bit. */

		ESmsDCSTextUncompressed7BitOr8Bit=0xF0,

	/** Masks bits 7 to 4. */

		ESmsDCSBits7To4Mask=0xF0

		};

/** Message Marked for Automatic Deletion */

    enum TAutomaticDeletionGroup

        {

        ESmsDCSAutomaticDeletion     = 0x40,

        ESmsDCSAutomaticDeletionMask = 0xC0

        };

/** Alphabet bit flags. */

	enum TSmsAlphabet

		{

	/** GSM 7 bit default alphabet. */

		ESmsAlphabet7Bit=0x00,

	/** 8-bit data. */

		ESmsAlphabet8Bit=0x04,

	/** UCS2. */

		ESmsAlphabetUCS2=0x08,

	/** Reserved. */

		ESmsAlphabetReserved=0x0C,

	/** Mask for these bit flags. */

		ESmsAlphabetMask=0x0C,

		};

/** Message Class bit flags. */

	enum TSmsClass

		{

	/** Class 0. */

		ESmsClass0=0x00,

	/** Class 1. */

		ESmsClass1=0x01,

	/** Class 2. */

		ESmsClass2=0x02,

	/** Class 3. */

		ESmsClass3=0x03,

	/** Mask for these bit flags. */

		ESmsClassMask=0x03,

		};

/** Indication Sense bit flags. */

	enum TSmsIndicationState

		{

	/** Indication inactive. */

		ESmsIndicationInactive=0x00,

	/** Indication active. */

		ESmsIndicationActive=0x08,

	/** Mask for these bit flags. */

		ESmsIndicationStateMask=0x08

		};

/** Indication Type bit flags. */

	enum TSmsIndicationType

		{

	/** Voicemail Message Waiting. */

		ESmsVoicemailMessageWaiting=0x00,

	/** Fax Message Waiting. */

		ESmsFaxMessageWaiting=0x01,

	/** Electronic Mail Message Waiting. */

		ESmsElectronicMailMessageWaiting=0x02,

	/** Other Message Waiting. */

		ESmsFaxOtherMessageWaiting=0x03,

	/** Mask for these bit flags. */

		ESmsIndicationTypeMask=0x03

		};

public:

	TSmsDataCodingScheme();

	inline TSmsDCSBits7To4 Bits7To4() const;

	inline void SetBits7To4(TSmsDCSBits7To4 aBits7To4);

//  Normal SMS settings

	TBool TextCompressed() const;

	void SetTextCompressed(TBool aCompressed);

	TSmsAlphabet Alphabet() const;

	void SetAlphabet(TSmsAlphabet aAlphabet);

	TBool Class(TSmsClass& aClass) const;

	void SetClass(TBool aClassDefined,TSmsClass aClass);

//  Message waiting settings

	TSmsIndicationState IndicationState() const;

	void SetIndicationState(TSmsIndicationState aState);

	TSmsIndicationType IndicationType() const;

	void SetIndicationType(TSmsIndicationType aType);

	};

/**

 *  Specifies alternative 7bit encoding combinations to use if the default

 *  GSM encoding cannot encode the message as 7bit without data loss.

 * 

 *  @publishedAll

 *  @released 

 */

enum TSmsEncoding

	{

	/** Default value meaning that no alternative encoding would be used. */

	ESmsEncodingNone = 0,

	/**

	 *  Allows the use of the Turkish Single Shift table in place of the

	 *  default GSM shift table.

	 * 

	 *  @note If used during encoding there will be a 3 octet cost in the User Data

	 *        Header.

	 */

	ESmsEncodingTurkishSingleShift = 0x11,

	/**

	 *  Allows the use of the Turkish Locking Shift table in place of the

	 *  default GSM alphabet table.

	 * 

	 *  @note If used during encoding there will be a 3 octet cost in the User Data

	 *        Header.

	 *  @note This encoding should only be used if the relevant national

	 *        regulatory body has requested its use.

	 */

	ESmsEncodingTurkishLockingShift	= 0x12,

    /**

     *  Allows the use of the Turkish Locking Shift and/or the Turkish Single

     *  Shift tables in place of the default GSM alphabet and shift tables.

	 * 

	 *  @note If used during encoding there will be a 3 or 6 octet cost in the User Data