RSat Class Reference

class RSat : public RTelSubSessionBase

Provides an interface to Symbian's ETelSat API. RSat inherits from RTelSubSessionBase defined in ETEL.H.

On GSM/WCDMA networks, this API offers access to the (U)SIM Application Toolkit, or (U)SAT. On CDMA networks, it offers access to Cdma Card Application Toolkit, or CCAT. Both toolkits are very similar.

Phones on both networks contain an electronic card that stores the information such as subscriber's identification, the phone's number, an address book, etc. The (U)SAT and CCAT toolkits allow the card to be more than just a storage device; they define a protocols that allow the card to ask the phone to perform tasks. For instance, a card can ask the phone to display a message on the screen, add new menu items to the phone's menus, ask the phone to dial a number, or browse to a URL.

(U)SAT and CCAT are based around 'Proactive Commands': each is a task for the phone to perform. For the four tasks mentioned in the previous paragraph, the card sends the phone proactive commands called DISPLAY TEXT, SET UP MENU, SET UP CALL, and LAUNCH BROWSER. Understanding the range of proactive commands and their capabilities is the first step to understanding (U)SAT and CCAT.

To use Symbian's ETelSat API you request notification when proactive commands arrive at the phone. For each proactive command (DISPLAY TEXT, SET UP MENU etc.) there is an RSat member function. This function tells Symbian OS when you are interested in a proactive command. It also gives Symbian OS a TRequestStatus that is completed when the next proactive command arrives.

Some of the proactive commands are not accessible to Symbian's ETelSat API. Your phone's TSY deals with them for you, hiding them from RSat . The remaining proactive commands are handled by RSat . Request notification for each one using the functions listed below.

(U)SAT and CCAT are defined in 3GPP TS 31.111 and 3GPP2 C.S0035-0 respectively. Both of these specifications are based on ETSI TS 102 223. We suggest you read ETSI TS 102 223 before reading anything else: it is much more informative and easier to read than the other two specifications. We also suggest you have a basic understanding of ETSI TS 102 223 before using Symbian's ETelSat API.

Before starting a (U)SAT or CCAT session, start a session with a phone. A phone session is represented by either RPhone or RMobilePhone. Now you can create an RSat interface and start the RSat session with RSat::Open() . Pass this method the RPhone or RMobilePhone instance. This tells the (U)SAT or CCAT session which phone to work with.

This documentation uses the word "UICC" to mean the card. Here are the phrases used to describe the card on various networks:

On GSM networks, the physical card is called the ICC and the software it contains is called the SIM (Subscriber Identity Module). SAT is an interface to the software.

On WCDMA networks, the physical card is called the UICC and the software it contains is called the USIM (Universal Subscriber Identity Module). USAT is an interface to the software.

On 3G CDMA networks, the card and the software are called a R-UIM. CCAT is an interface to the software.

To use the ETelSat API, follow these steps. Firstly, create an interface to the phone, if you haven't already done so:

Secondly, create and open an interface to the ETelSat client:

Now tell the UICC what SAT features the phone supports. The UICC expects this information in a "profile" object. The structure of this object is described in ETSI TS 102 223.

  • Firsly, call RSat::GetMeSideSatProfile() . The TSY returns a profile describing the SAT features that are supported by the phone's hardware and the TSY. These will be features that are not under the ETelSat client's control; you cannot use the RSat API to access them.

  • Now modify the profile to include the SAT features that you support. This will mainly involve settings flags in the profile object.

Here is a list of the proactive commands supported by RSat . Once you have completed all the steps above, queue some notification requests by calling some RSat::Notify..... command listed below:

Note: the phone continuously polls the card, waiting for proactive commands. However, the polling process is hidden from the ETelSat API - simply request notification and wait for the commands.

Nested Classes and Structures

Public Member Functions
RSat ()
IMPORT_C TInt ClientSatProfileIndication (const TDesC8 &)
IMPORT_C void Close ()
IMPORT_C void EventDownload ( TRequestStatus &, TEventList , const TDesC8 &)
IMPORT_C void GetClut ( TRequestStatus &, TUint , TUint , TDes8 &)
IMPORT_C void GetIcon ( TRequestStatus &, TUint8 , TIcon &)
IMPORT_C void GetImageInstance ( TRequestStatus &, const TDesC8 &, TDes8 &)
IMPORT_C void GetMeSideSatProfile ( TRequestStatus &, TDes8 &)
IMPORT_C void GetOpenChannelPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void GetProvisioningRefFile ( TRequestStatus &, const TProvisioningFileRef &, TDes8 &)
IMPORT_C void MenuSelection ( TRequestStatus &, const TDesC8 &)
IMPORT_C void MmsNotificationDownload ( TRequestStatus &, const TDesC8 &)
IMPORT_C void MmsTransferStatus ( TRequestStatus &, const TDesC8 &)
IMPORT_C void NotifyCallControlRequest ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyCbDownload ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyCloseChannelPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyDeclareServicePCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyDisplayMultimediaMsgPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyDisplayTextPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyGetChannelStatusPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyGetFramesStatusPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyGetInkeyPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyGetInputPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyGetReaderStatusPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyGetServiceInfoPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyLanguageNotificationPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyLaunchBrowserPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyLocalInfoPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyMoSmControlRequest ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyOpenChannelPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyPerformCardApduPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyPlayTonePCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyPollingIntervalPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyPollingOffPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyPowerOffCardPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyPowerOnCardPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyProactiveSimSessionEnd ( TRequestStatus &)
IMPORT_C void NotifyProactiveSimSessionStart ( TRequestStatus &)
IMPORT_C void NotifyReceiveDataPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyRefreshPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyRefreshRequired ( TRequestStatus &)
IMPORT_C void NotifyRefreshRequired ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyRetrieveMultimediaMsgPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyRunAtCommandPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySelectItemPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySendDataPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySendDtmfPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySendSmPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySendSsPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySendUssdPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyServiceSearchPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySetFramesPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySetUpCallPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySetUpCallPCmdCancel ()
IMPORT_C void NotifySetUpEventListPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySetUpIdleModeTextPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySetUpMenuPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySetUpMenuPCmdCancel ()
IMPORT_C void NotifySmsPpDownload ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifySubmitMultimediaMsgPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyTimerExpiration ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyTimerMgmtPCmd ( TRequestStatus &, TDes8 &)
IMPORT_C void NotifyTsyStateUpdated ( TRequestStatus &, TPCmd &)
IMPORT_C TInt Open ( RPhone &)
IMPORT_C void RefreshAllowed ( TRequestStatus &, const TDesC8 &)
IMPORT_C void SendMessageNoLogging ( TRequestStatus &, const TDesC8 &, TUint16 &)
IMPORT_C void TerminalRsp ( TRequestStatus &, TPCmd , const TDesC8 &)
IMPORT_C TInt UsatClientReadyIndication ()
IMPORT_C void UssdDataDownload ( TRequestStatus &, const TDesC8 &)
Protected Member Functions
IMPORT_C void ConstructL ()
IMPORT_C void Destruct ()
Private Member Functions
RSat (const RSat &)
Inherited Functions
RSubSessionBase::CloseSubSession(TInt)
RSubSessionBase::CreateAutoCloseSubSession(RSessionBase &,TInt,const TIpcArgs &)
RSubSessionBase::CreateSubSession(const RSessionBase &,TInt)
RSubSessionBase::CreateSubSession(const RSessionBase &,TInt,const TIpcArgs &)
RSubSessionBase::RSubSessionBase()
RSubSessionBase::Send(TInt)const
RSubSessionBase::Send(TInt,const TIpcArgs &)const
RSubSessionBase::SendReceive(TInt)const
RSubSessionBase::SendReceive(TInt,TRequestStatus &)const
RSubSessionBase::SendReceive(TInt,const TIpcArgs &)const
RSubSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
RSubSessionBase::Session()const
RSubSessionBase::SubSessionHandle()const
RTelSubSessionBase::Blank(const TInt,TReqPriorityType)const
RTelSubSessionBase::Blank(const TInt,TRequestStatus &,TReqPriorityType)const
RTelSubSessionBase::CancelAsyncRequest(TInt)const
RTelSubSessionBase::CancelReq(const TInt,const TInt)const
RTelSubSessionBase::CancelSubSession()const
RTelSubSessionBase::Get(const TInt,TDes16 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes8 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes8 &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes16 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes8 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes8 &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::RTelSubSessionBase()
RTelSubSessionBase::ResetSessionHandle()
RTelSubSessionBase::SessionHandle()const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC16 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC8 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC8 &,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const RFile &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC16 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC8 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC8 &,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,TDes8 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,const TDesC16 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,const TDesC8 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,const TDesC8 &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::SetSessionHandle(RSessionBase &)
RTelSubSessionBase::SubSessionHandle()
Public Member Enumerations
enum TActionOriginator { EActionOriginatorNotSet , EClientOriginator , EMeSideOriginator }
enum TAdditionalInfoType {
KNoAdditionalInfo  = 0x0001, KMeProblem  = 0x0002, KSatNetworkErrorInfo  = 0x0004, KControlInteraction  = 0x0008, KSendSsInfo  = 0x0010, KTextString  = 0x0020, KItemIdentifier  = 0x0040, KCallControlRequestedAction  = 0x0080, KRApdu  = 0x0100, KCardATR  = 0x0200, KATResponse  = 0x0400, KChannelData  = 0x0800, KChannelStatusInfo  = 0x1000, KServiceAvailability  = 0x2000, KCardReaderInfo  = 0x4000, KLocalInformation  = 0x8000, KTimerMgmt  = 0x10000, KPollingIntv  = 0x20000, KServiceRecord  = 0x40000, KFramesInfo  = 0x80000
}
enum TAlphaIdStatus { EAlphaIdNotSet , EAlphaIdProvided , EAlphaIdNull , EAlphaIdNotPresent }
enum TAlphaIdValidity { EAlphaIdValidityNotSet , EValidAlpaId , ENullAlphaId , ENoAlphaId }
enum TBCRepeatIndicator { EBCAlternateMode , EBCSequentialMode , EBCFallbackMode , EBCServiceChangeAndFallbackMode }
enum TBearerIndProtoError {
KNoSpecificBIPError  = 0x00, KNoChannelAvailable  = 0x01, KChannelClosed  = 0x02, KChannelIdNotValid  = 0x03, KBufferSizeNotAvailable  = 0x04, KSecurityError  = 0x05, KTranportLevelNotAvailable  = 0x06, KRemoteDeviceNotReachable  = 0x07, KServiceError  = 0x08, KServiceIdUnknown  = 0x09, KPortNotAvailable  = 0x10
}
enum TBearerType {
EBearerTypeNotSet , ECSDBearer , EGPRSBearer , EDefaultBearer , EBTBearer , EIrDaBearer , ERS232Bearer , EUSBBearer , EUtranBearer
}
enum TBrowserBearer { KSmsBearer  = 0x00, KCsdBearer  = 0x01, KUssdBearer  = 0x02, KGprsBearer  = 0x03 }
enum TBrowserError { KNoSpecificBrowserError  = 0x00, KBearerUnvailable  = 0x01, KBrowserUnavailable  = 0x02, KMeUnableToReadProvisioningData  = 0x04 }
enum TBrowserIdentity {
EBrowserIdNotSet , EBrowserIdNotPresent , EDefaultBrowser , EBrowserIdNotSpecified , EWMLBrowser , EHTMLBrowser , EXHTMLBrowser , ECHTMLBrowser
}
enum TBrowserSelection { EBrowserSelectionNotSet , ELaunchBrowserIfNotAlreadyLaunched , EUseExistingBrowser , ECloseExistingLaunchNewBrowserSession }
enum TBrowserTerminationCause { EUnknownCause , EUserTermination , EErrorTermination }
enum TCallControlType { ECcTypeNotSet , ECcAddress , ECcSsString , ECcUssdString , ECcPDPParameters }
enum TCallParamOrigin { EOriginatorUnknown , EOriginatorSIM , EOriginatorEtelClient , EOriginatorExternal }
enum TCcInteractionError { KNoSpecificInteractionError  = 0x00, KActionNotAllowed  = 0x01, KRequestTypeChanged  = 0x02 }
enum TClearScreenTrigger { EClearScreenTriggerNotSet , EClearAfterDelay , EUserClear }
enum TControlResult { EControlResultNotSet , EAllowedNoModification , ENotAllowed , EAllowedWithModifications }
enum TDeviceId {
KDeviceIdNotSet  = -1, KKeypad  = 0x01, KDisplay  = 0x02, KEarPiece  = 0x03, KAdditionalCardReader0  = 0x10, KAdditionalCardReader1  = 0x11, KAdditionalCardReader2  = 0x12, KAdditionalCardReader3  = 0x13, KAdditionalCardReader4  = 0x14, KAdditionalCardReader5  = 0x15, KAdditionalCardReader6  = 0x16, KAdditionalCardReader7  = 0x17, KChannel1  = 0x21, KChannel2  = 0x22, KChannel3  = 0x23, KChannel4  = 0x24, KChannel5  = 0x25, KChannel6  = 0x26, KChannel7  = 0x27, KUICC  = 0x81, KME  = 0x82, KNetwork  = 0x83
}
enum TDisplayPriority { EDisplayPriorityNotSet , ENormalPriority , EHighPriority }
enum TElementaryFiles {
KUnknownEf  = 0x2000, KDirEf  = 0x2F00, KElpEf  = 0x2F05, KArrEf  = 0x2F06, KImgEf  = 0x4F20, KPscEf  = 0x4F22, KCcEf  = 0x4F23, KPuidEf  = 0x4F24, KPbr  = 0x4F30, KSllEf  = 0x4F31, KMmlEf  = 0x4F47, KMmdfEf  = 0x4F48, KInvScan  = 0x4F64, KImpiEf  = 0x6F02, KImpuEf  = 0x6F03, KDomainEf  = 0x6F04, KLpEf  = 0x6F05, KArradEf  = 0x6F06, KImsiEf  = 0x6F07, KCsp1Ef  = 0x6F15, KDckEf  = 0x6F2C, KPlmnSelEf  = 0x6F30, KHplmnEf  = 0x6F31, KCnlEf  = 0x6F32, KAcmMaxEf  = 0x6F37, KSstEf  = 0x6F38, KAcmEf  = 0x6F39, KAdnEf  = 0x6F3A, KFdnEf  = 0x6F3B, KSmsEf  = 0x6F3C, KCcpEf  = 0x6F3D, KGid1Ef  = 0x6F3E, KGid2Ef  = 0x6F3F, KMsisdnEf  = 0x6F40, KPuctEf  = 0x6F41, KSmspEf  = 0x6F42, KSmssEf  = 0x6F43, KLndEf  = 0x6F44, KCbmiEf  = 0x6F45, KSpnEf  = 0x6F46, KSmsrEf  = 0x6F47, KCbmidEf  = 0x6F48, KSdnEf  = 0x6F49, KExt1Ef  = 0x6F4A, KExt2Ef  = 0x6F4B, KExt3Ef  = 0x6F4C, KBdnEf  = 0x6F4D, KExt5Ef  = 0x6F4E, KCcp2Ef  = 0x6F4F, KCbmirEf  = 0x6F50, KNiaEf  = 0x6F51, KLociGprsEf  = 0x6F53, KSumeEf  = 0x6F54, KExt4Ef  = 0x6F55, KEstEf  = 0x6F56, KAclEf  = 0x6F57, KCmiEf  = 0x6F58, KStartHfnEf  = 0x6F5B, KThresholdEf  = 0x6F5C, KOPlmnwAcTEf  = 0x6F61, KHPlmnwAcTEf  = 0x6F62, KRplmnActEf  = 0x6F65, KPsLociEf  = 0x6F73, KAccEf  = 0x6F78, KFPlmnEf  = 0x6F7B, KIciEf  = 0x6F80, KOciEf  = 0x6F81, KIctEf  = 0x6F82, KOctEf  = 0x6F83, KCsp2Ef  = 0x6F98, KAdEf  = 0x6FAD, KPhaseEf  = 0x6FAE, KVcgsEf  = 0x6FB1, KVgcssEf  = 0x6FB2, KVbsEf  = 0x6FB3, KVbssEf  = 0x6FB4, KeMlppEf  = 0x6FB5, KAaemef  = 0x6FB6, KEccEf  = 0x6FB7, KGmsi  = 0x6FC2, KHiddenKeyEf  = 0x6FC3, KPnnEf  = 0x6FC5, KOplEf  = 0x6FC6, KMbdnEf  = 0x6FC7, KExt6Ef  = 0x6FC8, KMbiEf  = 0x6FC9, KMwisEf  = 0x6FCA, KCfisEf  = 0x6FCB, KExt7Ef  = 0x6FCC, KSpdiEf  = 0x6FCD, KMmsnEF  = 0x6FCE, KExt8Ef  = 0x6FCF, KMmsicpEf  = 0x6FD0, KMmsupEf  = 0x6FD1, KMmsucpEf  = 0x6FD2, KNiaRel5Ef  = 0x6FD3, KVgcscaEf  = 0x6FD4, KVbscaEf  = 0x6FD5, KGbabpEf  = 0x6FD6, KMsklEf  = 0x6FD7, KMukEf  = 0x6FD8, KGbanlEf  = 0x6FDA
}
enum TEventList {
KMTCall  = 0x00001, KCallConnected  = 0x00002, KCallDisconnected  = 0x00004, KLocationStatus  = 0x00008, KUserActivity  = 0x00010, KIdleScreenAvailable  = 0x00020, KCardReaderStatus  = 0x00040, KLanguageSelection  = 0x00080, KBrowserTermination  = 0x00100, KDataAvailable  = 0x00200, KChannelStatus  = 0x00400, KAccessTechnologyChange  = 0x00800, KDisplayParamsChanges  = 0x01000, KLocalConnection  = 0x02000, KNetworkSearchModeChange  = 0x04000, KBrowsingStatusChange  = 0x08000, KFramesInformationChange  = 0x10000
}
enum TFramesError {
KNoSpecificCauseCanBeGiven  = 0x00, KFrameIdentifierIsNotValid  = 0x01, KNumberOfFramesExceeded  = 0x02, KNoFrameIdentified  = 0x03, KRequestSizeNotSupported  = 0x04, KDefaultActiveFrameIsNotValid  = 0x05
}
enum TFramesLayout { EFrameHorizontal  = 0x01, EFrameVertical  = 0x02 }
enum TFramesSeparator { EFrameSeparatorNotSet , EFrameSeparatorDrawn , EFrameSeparatorNotDrawn }
enum TGetInkeyRspFormat { EGetInkeyRspFormatNotSet , EDigitOnly , ECharSmsDefaultAlphabet , ECharUcs2Alphabet , EYesNo }
enum TGetInkeyRspMode { EGetInkeyRspModeNotSet , EUserRspDisplayed , EImmediateDigitRsp }
enum TGetInputRspFormat {
EGetInputRspFormatNotSet , EDigitOnlyUnpacked , EDigitOnlyPacked , ESmsDefaultAlphabetUnpacked , ESmsDefaultAlphabetPacked , EUcs2Alphabet
}
enum TGetReaderStatusMode { ECardReaderModeNotSet , ECardReaderStatus , ECardReaderIdentifier }
enum THelp { EHelpNotSet , EHelpAvailable , ENoHelpAvailable }
enum THelpRequest { EHelpRequestNotSet , EHelpRequested , EHelpNotRequested }
enum TIconQualifier { EIconQualifierNotSet , ENoIconId , ESelfExplanatory , ENotSelfExplanatory }
enum TImageCoding { KBasic  = 0x11, KColour  = 0x21 }
enum TImmediateRsp { EImmediateRspNotSet , EImmediateRsp , ENoImmediateRsp }
enum TInputDisplayOption { EInputDisplayOptionNotSet , EDisplayUserInput , EHideUserInput }
enum TLanguageNotificationType { ENotificationTypeNotSet , ENonSpecificLangNotification , ESpecificLangNotification }
enum TLinkEstablishment { ELinkEstablishmentNotSet , EOnDemand , EImmediate }
enum TLocaInfomationType {
KProvideLocalInfo  = 0x00, KProvideLocalInfoImei  = 0x01, KProvideLocalInformationNmr  = 0x02, KProvideLocalInfoDateTimeTimeZone  = 0x03, KProvideLocalInfoLanguage  = 0x04, KProvideLocalInfoTimingAdv  = 0x05, KProvideLocalInfoAccTech  = 0x06, KProvideLocalInfoESN  = 0x07, KProvideLocalInfoIMEISV  = 0x08, KProvideLocalInfoSearchMode  = 0x09, KProvideLocalInfoChargeStateOfBattery  = 0x0A, KProvideLocalInfoMEID  = 0x0B
}
enum TLocalBearerId {
ELocalBearerIdNotSet , ELocalBearerIdNotPresent , ETechnologyIndependent , ELocalBearerBT , ELocalBearerIrda , ELocalBearerRs232 , ELocalBearerUsb
}
enum TMeProblem {
KNoSpecificMeProblem  = 0x00, KScreenBusy  = 0x01, KMeBusyOnCall  = 0x02, KMeBusyOnSs  = 0x03, KNoService  = 0x04, KAccBar  = 0x05, KRadioRessourceNotGranted  = 0x06, KNotInSpeechCall  = 0x07, KMeBusyOnUssd  = 0x08, KMeBusyOnSendDtmf  = 0x09, KNoUSIMActive  = 0x0A
}
enum TMenuContent { KItems  = 0x01, KItemNextActions  = 0x02, KItemIconIds  = 0x04, KItemTextAttributes  = 0x08 }
enum TMultipleCardError {
KNoSpecificMultiCardError  = 0x00, KNoCardReader  = 0x01, KNoCard  = 0x02, KCardReadyBusy  = 0x03, KCardPoweredOff  = 0x04, KCApduFormatError  = 0x05, KMuteCard  = 0x06, KTransmissionError  = 0x07, KProtocolNotSupported  = 0x08, KSpecifiedReaderNotValid  = 0x09
}
enum TNetworkSearchMode { EUnknown , EManual , EAutomatic }
enum TNumberingPlan {
ENumberingPlanNotSet , EUnknownNumberingPlan , EIsdnNumberPlan , EDataNumberPlan , ETelexNumberPlan , EServiceCentreSpecificPlan1 , EServiceCentreSpecificPlan2 , ENationalNumberPlan , EPrivateNumberPlan , EERMESNumberPlan
}
enum TOpenChannelType {
EPCmdTypeNotSet , ECsBearer , EGprsBearer , ELocalLinksBearer , EAnyBearer , EUiccServerMode
}
enum TOtherAddressType { EAddressNotSet , EAddressNotPresent , EIPv4Address , EIPv6Address }
enum TPCmd {
EDisplayText , EGetInkey , EGetInput , EPlayTone , ERefresh , ESelectItem , ESendDtmf , ESendSm , ESendSs , ESendUssd , ESetUpCall , ESetUpEventList , ESetUpIdleModeText , ESetUpMenu , EPerformCardApdu , EPowerOffCard , EPowerOnCard , EGetReaderStatus , ERunAtCommand , ELanguageNotification , ELaunchBrowser , EOpenChannelCs , EOpenChannelGprs , EOpenChannelLocal , ECloseChannel , EReceiveData , ESendData , EGetChannelStatus , EDeclareService , EServiceSearch , EGetServiceInformation , ETimerMngt , ELocalInfo , EPollingInterval , EPollingOff , ERetrieveMultimediaMsg , ESubmitMultimediaMsg , EDisplayMultimediaMsg , ESetFrames , EGetFramesStatus , EOpenChannelUiccServerMode
}
enum TPCmdResult {
KPCmdResultNotSet  = -1, KSuccess  = 0x00, KPartialComprehension  = 0x01, KMissingInformation  = 0x02, KRefreshAdditionEFRead  = 0x03, KSuccessRequestedIconNotDisplayed  = 0x04, KModifiedByCallControl  = 0x05, KSuccessLimitedService  = 0x06, KPerformedWithModifications  = 0x07, KRefreshUSIMNotActive  = 0x08, KPlayTonePerformedSuccessfully  = 0x09, KPSessionTerminatedByUser  = 0x10, KBackwardModeRequestedByUser  = 0x11, KNoResponseFromUser  = 0x12, KHelpRequestedByUser  = 0x13, KUssdTransactionTerminatedByUser  = 0x14, KMeUnableToProcessCmd  = 0x20, KNetworkUnableToProcessCmd  = 0x21, KPCmdNotAcceptedByUser  = 0x22, KCallClearedBeforeConnectionOrReleased  = 0x23, KContradictionWithTimerState  = 0x24, KInteractionWithCCTemporaryError  = 0x25, KLaunchBrowserError  = 0x26, KMMSTemporaryProblem  = 0x27, KCmdBeyondMeCapabilities  = 0x30, KCmdTypeNotUnderstood  = 0x31, KCmdDataNotUnderstood  = 0x32, KCmdNumberNotKnown  = 0x33, KSsReturnError  = 0x34, KSmsRpError  = 0x35, KErrorRequiredValuesMissing  = 0x36, KUssdReturnError  = 0x37, KMultipleCardCmdsError  = 0x38, KInteractionWithCCPermanentError  = 0x39, KBearerIndepProtocolError  = 0x3A, KAccessTechUnableProcessCmd  = 0x3B, KFramesError  = 0x3C, KMMSError  = 0x3D
}
enum TPresentationType { EPresentationTypeNotSet , ENotSpecified , EDataValues , ENavigationOptions }
enum TReconnectionMode { EReconnectionModeNotSet , ENoAutomaticReconnection , EAutomaticReconnection }
enum TRefreshType {
ERefreshTypeNotSet , ESimInitFullFileChangeNotification , EFileChangeNotification , ESimInitFileChangeNotification , ESimInit , ESimReset , EUsimApplicationReset , E3GSessionReset
}
enum TRemoteAddressCoding { ECodingNotSet , E48BitAddress }
enum TSatProfileByte1 {
KCapsProfileDownload  = 0x01, KCapsSmsPpDataDownload  = 0x02, KCapsCbDataDownload  = 0x04, KCapsMenuSelection  = 0x08, KCaps9EXX  = 0x10, KCapsSmsPpDataDownload2  = 0x10, KCapsTimerExpiration  = 0x20, KCapsUssdStringInCC  = 0x40, KCapsCCByUSim2  = 0x40, KCapsCCByUSim3  = 0x80
}
enum TSatProfileByte10 { KCapsSoftKeySelectItem  = 0x10, KCapsSoftKeySetUpMenu  = 0x20 }
enum TSatProfileByte12 {
KCapsOpenChannel  = 0x01, KCapsCloseChannel  = 0x02, KCapsReceiveData  = 0x04, KCapsSendData  = 0x08, KCapsGetChannelStatus  = 0x10, KCapsServiceSearch  = 0x20, KCapsGetServiceInfo  = 0x40, KCapsDeclareService  = 0x80
}
enum TSatProfileByte13 { KCapsCsdSupportByMe  = 0x01, KCapsGprsSupportByMe  = 0x02, KCapsBtSupportByMe  = 0x04, KCapsIrdaSupportByMe  = 0x08, KCapsRs232SupportByMe  = 0x10 }
enum TSatProfileByte14 { KCapsScreenSizingParams  = 0x80 }
enum TSatProfileByte15 { KCapsVariableSizeFonts  = 0x80 }
enum TSatProfileByte16 { KCapsDisplayResize  = 0x01, KCapsTextWrapping  = 0x02, KCapsTextScrolling  = 0x04, KCapsWidthReductionInMenu  = 0x80 }
enum TSatProfileByte17 { KCapsTcp  = 0x01, KCapsUdp  = 0x02, KCapsTcpServerMode  = 0x04 }
enum TSatProfileByte18 {
KCapsDisplayTextVariableTimeout  = 0x01, KCapsGetInkeyHelp  = 0x02, KCapsUsbSupportByMe  = 0x04, KCapsGetInkeyVariableTimeout  = 0x08, KCapsCallControlOnGprs  = 0x20, KCapsProvideLocalInfoIMEISV  = 0x40, KCapsProvideLocalInfoSearchModeChange  = 0x80
}
enum TSatProfileByte2 {
KCapsCommandResult  = 0x01, KCapsCCBySim  = 0x02, KCapsCellIdInCCBySim  = 0x04, KCapsCCByUSim4  = 0x04, KCapsMOSMControl  = 0x08, KCapsAlphaIdHandling  = 0x10, KCapsCCByUSim5  = 0x10, KCapsUcs2Entry  = 0x20, KCapsUcs2Display  = 0x40, KCapsExtensionTextDisplay  = 0x80, KCapsDisplayText2  = 0x80
}
enum TSatProfileByte21 { KCapsWML  = 0x01, KCapsXHTML  = 0x02, KCapsHTML  = 0x04, KCapsCHTML  = 0x08 }
enum TSatProfileByte22 {
KCapsProvideLocalInfoUTRAN  = 0x01, KCapsProvideLocalInfoBatteryState  = 0x02, KCapsPlayThemedAndMelodyTone  = 0x04, KCapsSetUpCallMultimediaCall  = 0x08, KCapsRefreshGBA  = 0x10, KCapsRetrieveMultimediaMessage  = 0x20, KCapsSubmitMultimediaMessage  = 0x40, KCapsDisplayMultimediaMesage  = 0x80
}
enum TSatProfileByte23 {
KCapsSetFrames  = 0x01, KCapsGetFramesStatus  = 0x02, KCapsMmsNotificationDownload  = 0x04, KCapsProvideLocalInfoMEID  = 0x20, KCapsProvideLocalInfoNmrUTRAN  = 0x40, KCapsUssdDataDownload  = 0x80
}
enum TSatProfileByte24 { KCapsMaxNumFramesBit1  = 0x01, KCapsMaxNumFramesBit2  = 0x02, KCapsMaxNumFramesBit3  = 0x04, KCapsMaxNumFramesBit4  = 0x08 }
enum TSatProfileByte25 { KCapsBrowsingStatusEvent  = 0x01, KCapsMmsTransferStatusEvent  = 0x02, KCapsFrameParametersChangeEvent  = 0x04 }
enum TSatProfileByte28 {
KCapsTextAttributeAlignmentLeft  = 0x01, KCapsTextAttributeAlignmentCentre  = 0x02, KCapsTextAttributeAlignmentRight  = 0x04, KCapsTextAttributeFontSizeNormal  = 0x08, KCapsTextAttributeFontSizeLarge  = 0x10, KCapsTextAttributeFontSizeSmall  = 0x20
}
enum TSatProfileByte29 {
KCapsTextAttributeStyleNormal  = 0x01, KCapsTextAttributeStyleBold  = 0x02, KCapsTextAttributeStyleItalic  = 0x04, KCapsTextAttributeStyleUnderline  = 0x08, KCapsTextAttributeStyleStrikethrough  = 0x10, KCapsTextAttributeStyleForeground  = 0x20, KCapsTextAttributeStyleBackground  = 0x40
}
enum TSatProfileByte3 {
KCapsDisplayText  = 0x01, KCapsGetInkey  = 0x02, KCapsGetInput  = 0x04, KCapsMoreTime  = 0x08, KCapsPlayTone  = 0x10, KCapsPollInterval  = 0x20, KCapsPollingOff  = 0x40, KCapsRefresh  = 0x80
}
enum TSatProfileByte4 {
KCapsSelectItem  = 0x01, KCapsSendSM  = 0x02, KCapsSendSS  = 0x04, KCapsSendUSSD  = 0x08, KCapsSetUpCall  = 0x10, KCapsSetUpMenu  = 0x20, KCapsProvideLocalInformation  = 0x40, KCapsProvideLocalInformationNMR  = 0x80
}
enum TSatProfileByte5 {
KCapsSetUpEventList  = 0x01, KCapsMtCallEvent  = 0x02, KCapsCallConnectedEvent  = 0x04, KCapsCallDisconnectedEvent  = 0x08, KCapsLocationStatusEvent  = 0x10, KCapsUserActivityEvent  = 0x20, KCapsIdleScreenAvailableEvent  = 0x40, KCapsCardReaderStatusEvent  = 0x80
}
enum TSatProfileByte6 {
KCapsLanguageSelectionEvent  = 0x01, KCapsBrowserTerminationEvent  = 0x02, KCapsDataAvailableEvent  = 0x04, KCapsChannelStatusEvent  = 0x08, KCapsAccTechnoChangedEvent  = 0x10, KCapsDisplayParamsChangedEvent  = 0x20, KCapsLocalConnectionEvent  = 0x40, KCapsNetworkSearchModeChangeEvent  = 0x80
}
enum TSatProfileByte7 { KCapsPowerOnCard  = 0x01, KCapsPowerOffCard  = 0x02, KCapsPerformCardApdu  = 0x04, KCapsGetReaderStatus  = 0x08, KCapsGetReaderStatusId  = 0x10 }
enum TSatProfileByte8 {
KCapsTimerManagementStartStop  = 0x01, KCapsTimerManagementGetCurrentValue  = 0x02, KCapsProvideLocalInfoDateTimeTimeZone  = 0x04, KCapsBinaryChoiceGetInkey  = 0x08, KCapsGetInkey2  = 0x08, KCapsSetUpIdleModeText  = 0x10, KCapsRunAtCmd  = 0x20, KCaps2ndAlphaIdSetUpCall  = 0x40, KCapsSetUpCall2  = 0x40, KCaps2ndCapabilityConfigParam  = 0x80, KCapsCCByUSim6  = 0x80
}
enum TSatProfileByte9 {
KCapsSustainedDisplayText  = 0x01, KCapsDisplayText3  = 0x01, KCapsSendDTMFCmd  = 0x02, KCapsProvideLocalInfoBcchCoding  = 0x04, KCapsProvideLocalnfoNmr2  = 0x04, KCapsProvideLocalInfoLanguage  = 0x08, KCapsProvideLocalInfoTimingAdv  = 0x10, KCapsLanguageNotification  = 0x20, KCapsLaunchBrowser  = 0x40, KCapsProvideLocalInfoAccTech  = 0x80
}
enum TSatTextCoding { E7bitPacked , E7bitUnpacked , E16bitUCS2 }
enum TSatVersion {
KSatVersionNotSet  = -1, KSatV1  = 1, KSatV2  = 2, KSatV3  = 3, KSatV4  = 4, KSatV5  = 5, KSatV6  = 6, KSatV7  = 7
}
enum TSelectionPreference { ESelectionPreferenceNotSet , ENoSelectionPreference , ESoftKeyPreferred }
enum TSendDataMode { ESendDataModeNotSet , EStoreDataInTxBuffer , ESendDataImmediately }
enum TServiceDeclarationType { EDeclarationTypeNotSet , EAddService , EDeleteService }
enum TSetUpCallType {
ESetUpCallTypeNotSet , EOnlyIfNotBusy , EOnlyIfNotBusyWithRedial , EHoldOtherCalls , EHoldOtherCallsWithRedial , EDisconnectOtherCalls , EDisconnectOtherCallsWithRedial
}
enum TSetUpEventListType { ESetUpEventListTypeNotSet , EUpdateEventList , ERemoveExistingEventList }
enum TSetUpIdleModeTextType { ESetUpIdleModeTextTypeNotSet , EUpdateIdleModeText , ERemoveExistingIdleModeText }
enum TTextAttributeStatus { ETextAttributeNotSet , ETextAttributeProvided , ETextAttributeNotPresent }
enum TTimeUnit { ETimeUnitNotSet , ENoDurationAvailable , EMinutes , ESeconds , ETenthsOfSeconds }
enum TTimerId {
KTimer1  = 0x01, KTimer2  = 0x02, KTimer3  = 0x03, KTimer4  = 0x04, KTimer5  = 0x05, KTimer6  = 0x06, KTimer7  = 0x07, KTimer8  = 0x08, KTimerNotFound  = 0xFF
}
enum TTimerMgmtType { EStartTimer , EDeactivateTimer , EGetTimerValue }
enum TTone {
KToneNotSet  = -1, KDialTone  = 0x01, KCalledSubscriberBusy  = 0x02, KCongestion  = 0x03, KRadioPathAcknowledge  = 0x04, KRadioPathNotAvailableCallDropped  = 0x05, KErrorSpecialInfo  = 0x06, KCallWaitingTone  = 0x07, KRingingTone  = 0x08, KGeneralBeep  = 0x10, KPositiveTone  = 0x11, KNegativeTone  = 0x12, KUserSelectedToneIncomingSpeech  = 0x13, KUserSelectedToneIncomingSms  = 0x14, KCriticalAlert  = 0x15, KVibrateOnly  = 0x20, KHappyTone  = 0x30, KSadTone  = 0x31, KUrgentActionTone  = 0x32, KQuestionTone  = 0x33, KMessageReceivedTone  = 0x34, KMelody1  = 0x40, KMelody2  = 0x41, KMelody3  = 0x42, KMelody4  = 0x43, KMelody5  = 0x44, KMelody6  = 0x45, KMelody7  = 0x46, KMelody8  = 0x47
}
enum TTransportProtocol { EProtocolNotSet , EProtocolNotPresent , EUdp , ETcp , ETcpUiccInServerMode }
enum TTypeOfNumber {
ETypeOfNumberNotSet , EUnknownNumber , EInternationalNumber , ENationalNumber , ENetworkSpecificNumber , EDedicatedNumber , EAlphanumericNumber , EAbbreviatedNumber
}
enum TUtranMeasurementQualifier { EUtranMeasurementQualifierNotSet , EUtranMeasurementQualifierIntraFrequency , EUtranMeasurementQualifierInterFrequency , EUtranMeasurementQualifierInterRATGsm }
Inherited Enumerations
RTelSubSessionBase:TReqPriorityType
Public Member Type Definitions
typedef TBuf8 < KAccessNameMaxSize > TAccessName
typedef TBuf < KAdditionalInfoMaxSize > TAdditionalInfo
typedef TBuf8 < KAidMaxSize > TAid
typedef TBuf < KAlphaIdMaxSize > TAlphaIdBuf
typedef TBuf8 < KApduDataMaxSize > TApduData
typedef TBuf8 < KAtCommandMaxSize > TAtCommand
typedef TBuf8 < KAttributeInfoMaxSize > TAttributeInfo
typedef TBuf8 < KBearerListMaxSize > TBearerList
typedef TBuf8 < KBearerParamsMaxSize > TBearerParams
typedef TPckg < TBrowserTerminationEventV2 > TBrowserTerminationEventV2Pckg
typedef TPckg < TBrowsingStatusEventV6 > TBrowsingStatusEventV6Pckg
typedef TPckg < TCallControlV1 > TCallControlV1Pckg
typedef TPckg < TCallControlV2 > TCallControlV2Pckg
typedef TPckg < TCallControlV5 > TCallControlV5Pckg
typedef TPckg < TCallControlV6 > TCallControlV6Pckg
typedef TPckg < TCardReaderStatusEventV2 > TCardReaderStatusEventV2Pckg
typedef TPckg < TCbDownloadV3 > TCbDownloadV3Pckg
typedef TBuf8 < KCbPageSize > TCbPage
typedef TBuf8 < KCcpMaxSize > TCcp
typedef TBuf8 < KChannelDataMaxSize > TChannelData
typedef TBuf8 < KChannelStatusMaxSize > TChannelStatus
typedef TPckg < TChannelStatusEventV2 > TChannelStatusEventV2Pckg
typedef TPckg < TChannelStatus > TChannelStatusPckg
typedef TPckg < TCloseChannelRspV2 > TCloseChannelRspV2Pckg
typedef TPckg < TCloseChannelV2 > TCloseChannelV2Pckg
typedef TPckg < TCloseChannelV5 > TCloseChannelV5Pckg
typedef TPckg < TCloseChannelV6 > TCloseChannelV6Pckg
typedef TPckg < TDataAvailableEventV2 > TDataAvailableEventV2Pckg
typedef TPckg < TDeclareServiceRspV2 > TDeclareServiceRspV2Pckg
typedef TPckg < TDeclareServiceV2 > TDeclareServiceV2Pckg
typedef TBuf8 < KDeviceFilterMaxSize > TDeviceFilter
typedef TPckg < TDisplayMultimediaMessageRspV6 > TDisplayMultimediaMessageRspV6Pckg
typedef TPckg < TDisplayMultimediaMessageV6 > TDisplayMultimediaMessageV6Pckg
typedef TPckg < TDisplayParamsEventV2 > TDisplayParamsEventV2Pckg
typedef TPckg < TDisplayTextRspV1 > TDisplayTextRspV1Pckg
typedef TPckg < TDisplayTextV1 > TDisplayTextV1Pckg
typedef TPckg < TDisplayTextV2 > TDisplayTextV2Pckg
typedef TPckg < TDisplayTextV5 > TDisplayTextV5Pckg
typedef TPckg < TDisplayTextV6 > TDisplayTextV6Pckg
typedef TBuf8 < KDtmfStringMaxSize > TDtmfString
typedef TPckg < TEventDownloadBaseV2 > TEventDownloadBaseV2Pckg
typedef TBuf < KMaxFileListSize > TFileList
typedef TBuf < KMaxFrameLayoutSize > TFrameLayoutBuf
typedef TBuf8 < KMaxFrameNumber > TFrameList
typedef TPckg < TFramesInformationChangedEventV6 > TFramesInformationChangedEventV6Pckg
typedef TPckg < TGetChannelStatusRspV2 > TGetChannelStatusRspV2Pckg
typedef TPckg < TGetChannelStatusV2 > TGetChannelStatusV2Pckg
typedef TPckg < TGetFramesStatusRspV6 > TGetFramesStatusRspV6Pckg
typedef TPckg < TGetFramesStatusV6 > TGetFramesStatusV6Pckg
typedef TPckg < TGetInkeyRspV1 > TGetInkeyRspV1Pckg
typedef TPckg < TGetInkeyRspV2 > TGetInkeyRspV2Pckg
typedef TBuf < KGetInkeyTextMaxSize > TGetInkeyText
typedef TPckg < TGetInkeyV1 > TGetInkeyV1Pckg
typedef TPckg < TGetInkeyV2 > TGetInkeyV2Pckg
typedef TPckg < TGetInkeyV5 > TGetInkeyV5Pckg
typedef TPckg < TGetInkeyV6 > TGetInkeyV6Pckg
typedef TBuf < KGetInputDefaultTextMaxSize > TGetInputDefaultText
typedef TPckg < TGetInputRspV1 > TGetInputRspV1Pckg
typedef TBuf < KGetInputTextMaxSize > TGetInputText
typedef TPckg < TGetInputV1 > TGetInputV1Pckg
typedef TPckg < TGetInputV5 > TGetInputV5Pckg
typedef TPckg < TGetInputV6 > TGetInputV6Pckg
typedef TPckg < TGetReaderStatusRspV2 > TGetReaderStatusRspV2Pckg
typedef TPckg < TGetReaderStatusV2 > TGetReaderStatusV2Pckg
typedef TPckg < TGetServiceInfoRspV2 > TGetServiceInfoRspV2Pckg
typedef TPckg < TGetServiceInfoV2 > TGetServiceInfoV2Pckg
typedef TPckg < TGetServiceInfoV5 > TGetServiceInfoV5Pckg
typedef TPckg < TGetServiceInfoV6 > TGetServiceInfoV6Pckg
typedef TBuf8 < KImageInstanceDescriptorsMaxSize > TIcon
typedef TBuf16 < KIdleModeTextMaxSize > TIdleModeText
typedef TPckg < TInstanceInfoV2 > TInstanceInfoV2Pckg
typedef TPckg < TInstanceInfoV3 > TInstanceInfoV3Pckg
typedef TBuf16 < KItemListMaxSize > TItemList
typedef TPckg < TLanguageNotificationRspV2 > TLanguageNotificationRspV2Pckg
typedef TPckg < TLanguageNotificationV2 > TLanguageNotificationV2Pckg
typedef TPckg < TLanguageSelectionEventV2 > TLanguageSelectionEventV2Pckg
typedef TPckg < TLaunchBrowserRspV2 > TLaunchBrowserRspV2Pckg
typedef TPckg < TLaunchBrowserV2 > TLaunchBrowserV2Pckg
typedef TPckg < TLaunchBrowserV5 > TLaunchBrowserV5Pckg
typedef TPckg < TLaunchBrowserV6 > TLaunchBrowserV6Pckg
typedef TPckg < TLocalConnectionEventV2 > TLocalConnectionEventV2Pckg
typedef TPckg < TLocalInfoRspV3 > TLocalInfoRspV3Pckg
typedef TPckg < TLocalInfoV3 > TLocalInfoV3Pckg
typedef TPckg < TLocalInfoV6 > TLocalInfoV6Pckg
typedef TBuf < KMaxFrameLayoutSize > TMMSNotification
typedef TPckg < TMenuSelectionV1 > TMenuSelectionV1Pckg
typedef TPckg < TMmsNotificationDownloadV6 > TMmsNotificationDownloadV6Pckg
typedef TPckg < TMmsTransferStatusV6 > TMmsTransferStatusV6Pckg
typedef TPckg < TMoSmControlV1 > TMoSmControlV1Pckg
typedef TBuf < KMaxMultimediaContentIdSize > TMultimediaContentId
typedef TBuf < KMaxMultimediaMessageIdSize > TMultimediaMessageId
typedef TBuf < KMaxMultimediaMessageRefSize > TMultimediaMessageRef
typedef TBuf < KMaxMultimediaMessageStatusSize > TMultimediaMessageStatus
typedef TPckg < TNetworkSearchModeChangeEventV6 > TNetworkSearchModeChangeEventV6Pckg
typedef TPckg < TOpenChannelBaseV2 > TOpenChannelBaseV2Pckg
typedef TPckg < TOpenChannelRspV2 > TOpenChannelRspV2Pckg
typedef TPckg < TOpenCsChannelV2 > TOpenCsChannelV2Pckg
typedef TPckg < TOpenCsChannelV5 > TOpenCsChannelV5Pckg
typedef TPckg < TOpenCsChannelV6 > TOpenCsChannelV6Pckg
typedef TPckg < TOpenGprsChannelV2 > TOpenGprsChannelV2Pckg
typedef TPckg < TOpenGprsChannelV4 > TOpenGprsChannelV4Pckg
typedef TPckg < TOpenGprsChannelV5 > TOpenGprsChannelV5Pckg
typedef TPckg < TOpenGprsChannelV6 > TOpenGprsChannelV6Pckg
typedef TPckg < TOpenLocalLinksChannelV2 > TOpenLocalLinksChannelV2Pckg
typedef TPckg < TOpenLocalLinksChannelV5 > TOpenLocalLinksChannelV5Pckg
typedef TPckg < TOpenLocalLinksChannelV6 > TOpenLocalLinksChannelV6Pckg
typedef TPckg < TOpenUiccServerModeChannelV7 > TOpenUiccServerModeChannelV7Pckg
typedef TPckg < TPerformCardApduRspV2 > TPerformCardApduRspV2Pckg
typedef TPckg < TPerformCardApduV2 > TPerformCardApduV2Pckg
typedef TPckg < TPlayToneRspV1 > TPlayToneRspV1Pckg
typedef TPckg < TPlayToneV1 > TPlayToneV1Pckg
typedef TPckg < TPlayToneV2 > TPlayToneV2Pckg
typedef TPckg < TPlayToneV5 > TPlayToneV5Pckg
typedef TPckg < TPlayToneV6 > TPlayToneV6Pckg
typedef TPckg < TPollingIntervalRspV3 > TPollingIntervalRspV3Pckg
typedef TPckg < TPollingIntervalV3 > TPollingIntervalV3Pckg
typedef TPckg < TPollingOffRspV3 > TPollingOffRspV3Pckg
typedef TPckg < TPollingOffV3 > TPollingOffV3Pckg
typedef TPckg < TPowerOffCardRspV2 > TPowerOffCardRspV2Pckg
typedef TPckg < TPowerOffCardV2 > TPowerOffCardV2Pckg
typedef TPckg < TPowerOnCardRspV2 > TPowerOnCardRspV2Pckg
typedef TPckg < TPowerOnCardV2 > TPowerOnCardV2Pckg
typedef TBuf8 < KFileRefMaxSize > TProvisioningFileRef
typedef TPckg < TProvisioningFileRef > TProvisioningFileRefPckg
typedef TPckg < TReceiveDataRspV2 > TReceiveDataRspV2Pckg
typedef TPckg < TReceiveDataV2 > TReceiveDataV2Pckg
typedef TPckg < TReceiveDataV5 > TReceiveDataV5Pckg
typedef TPckg < TReceiveDataV6 > TReceiveDataV6Pckg
typedef TBuf16 < KRefreshedFileListMaxSize > TRefreshFileList
typedef TPckg < TRefreshRspV1 > TRefreshRspV1Pckg
typedef TPckg < TRefreshV1 > TRefreshV1Pckg
typedef TPckg < TRefreshV2 > TRefreshV2Pckg
typedef TBuf8 < KRemoteAddressMaxSize > TRemoteAddress
typedef TPckg < TRetrieveMultimediaMessageRspV6 > TRetrieveMultimediaMessageRspV6Pckg
typedef TPckg < TRetrieveMultimediaMessageV6 > TRetrieveMultimediaMessageV6Pckg
typedef TPckg < TRunAtCommandRspV2 > TRunAtCommandRspV2Pckg
typedef TPckg < TRunAtCommandV2 > TRunAtCommandV2Pckg
typedef TPckg < TRunAtCommandV5 > TRunAtCommandV5Pckg
typedef TPckg < TRunAtCommandV6 > TRunAtCommandV6Pckg
typedef TPckg < TSatProfileV1 > TSatProfileV1Pckg
typedef TPckg < TSatProfileV2 > TSatProfileV2Pckg
typedef TPckg < TSatProfileV5 > TSatProfileV5Pckg
typedef TPckg < TSatProfileV6 > TSatProfileV6Pckg
typedef TPckg < TSatSmsV1 > TSatSmsV1Pckg
typedef TBuf < KMaxMobileTelNumberSize > TSatTelNumber
typedef TPckg < TSelectItemRspV1 > TSelectItemRspV1Pckg
typedef TPckg < TSelectItemV1 > TSelectItemV1Pckg
typedef TPckg < TSelectItemV2 > TSelectItemV2Pckg
typedef TPckg < TSelectItemV5 > TSelectItemV5Pckg
typedef TPckg < TSelectItemV6 > TSelectItemV6Pckg
typedef TPckg < TSendDataRspV2 > TSendDataRspV2Pckg
typedef TPckg < TSendDataV2 > TSendDataV2Pckg
typedef TPckg < TSendDataV5 > TSendDataV5Pckg
typedef TPckg < TSendDataV6 > TSendDataV6Pckg
typedef TPckg < TSendDtmfRspV1 > TSendDtmfRspV1Pckg
typedef TPckg < TSendDtmfV1 > TSendDtmfV1Pckg
typedef TPckg < TSendDtmfV5 > TSendDtmfV5Pckg
typedef TPckg < TSendDtmfV6 > TSendDtmfV6Pckg
typedef TPckg < TSendSmRspV1 > TSendSmRspV1Pckg
typedef TPckg < TSendSmV1 > TSendSmV1Pckg
typedef TPckg < TSendSmV5 > TSendSmV5Pckg
typedef TPckg < TSendSmV6 > TSendSmV6Pckg
typedef TPckg < TSendSsRspV1 > TSendSsRspV1Pckg
typedef TPckg < TSendSsRspV2 > TSendSsRspV2Pckg
typedef TPckg < TSendSsV1 > TSendSsV1Pckg
typedef TPckg < TSendSsV6 > TSendSsV6Pckg
typedef TPckg < TSendUssdRspV1 > TSendUssdRspV1Pckg
typedef TPckg < TSendUssdV1 > TSendUssdV1Pckg
typedef TPckg < TSendUssdV6 > TSendUssdV6Pckg
typedef TBuf8 < KServiceRecordMaxSize > TServiceRecord
typedef TBuf8 < KServiceSearchMaxSize > TServiceSearchParam
typedef TPckg < TServiceSearchRspV2 > TServiceSearchRspV2Pckg
typedef TPckg < TServiceSearchV2 > TServiceSearchV2Pckg
typedef TPckg < TServiceSearchV5 > TServiceSearchV5Pckg
typedef TPckg < TServiceSearchV6 > TServiceSearchV6Pckg
typedef TPckg < TSetFramesRspV6 > TSetFramesRspV6Pckg
typedef TPckg < TSetFramesV6 > TSetFramesV6Pckg
typedef TPckg < TSetUpCallRspV1 > TSetUpCallRspV1Pckg
typedef TPckg < TSetUpCallRspV2 > TSetUpCallRspV2Pckg
typedef TPckg < TSetUpCallV1 > TSetUpCallV1Pckg
typedef TPckg < TSetUpCallV5 > TSetUpCallV5Pckg
typedef TPckg < TSetUpCallV6 > TSetUpCallV6Pckg
typedef TPckg < TSetUpEventListRspV1 > TSetUpEventListRspV1Pckg
typedef TPckg < TSetUpEventListV1 > TSetUpEventListV1Pckg
typedef TPckg < TSetUpIdleModeTextRspV1 > TSetUpIdleModeTextRspV1Pckg
typedef TPckg < TSetUpIdleModeTextV1 > TSetUpIdleModeTextV1Pckg
typedef TPckg < TSetUpIdleModeTextV5 > TSetUpIdleModeTextV5Pckg
typedef TPckg < TSetUpIdleModeTextV6 > TSetUpIdleModeTextV6Pckg
typedef TPckg < TSetUpMenuRspV1 > TSetUpMenuRspV1Pckg
typedef TPckg < TSetUpMenuV1 > TSetUpMenuV1Pckg
typedef TPckg < TSetUpMenuV2 > TSetUpMenuV2Pckg
typedef TPckg < TSetUpMenuV5 > TSetUpMenuV5Pckg
typedef TPckg < TSmsPpDownloadV3 > TSmsPpDownloadV3Pckg
typedef TBuf < KSubAddressMaxSize > TSubAddress
typedef TPckg < TSubmitMultimediaMessageRspV6 > TSubmitMultimediaMessageRspV6Pckg
typedef TPckg < TSubmitMultimediaMessageV6 > TSubmitMultimediaMessageV6Pckg
typedef TBuf8 < KTextAttributeBufSize > TTextAttributeBuf
typedef TBuf < KTextStringMaxSize > TTextString
typedef TBuf < KTextToDisplayMaxSize > TTextToDisplay
typedef TPckg < TTimerExpirationV3 > TTimerExpirationV3Pckg
typedef TPckg < TTimerMgmtRspV3 > TTimerMgmtRspV3Pckg
typedef TPckg < TTimerMgmtV3 > TTimerMgmtV3Pckg
typedef TBuf8 < KUrlMaxSize > TUrl
typedef TPckg < TUssdDataDownloadV6 > TUssdDataDownloadV6Pckg
Private Attributes
CSatPtrHolder * iEtelSatPtrHolder
Inherited Attributes
RTelSubSessionBase::iPtrHolder

Constructor & Destructor Documentation

RSat()

IMPORT_C RSat ( )

Default constructor

RSat(const RSat &)

RSat ( const RSat & aSat ) [private]

Parameters

const RSat & aSat

Member Functions Documentation

ClientSatProfileIndication(const TDesC8 &)

IMPORT_C TInt ClientSatProfileIndication ( const TDesC8 & aClientSatProfile ) const

At the beginning of a ETelSat API session, you must tell the UICC what SAT features the phone supports. Do this after creating and opening an RSat session. This is a three-part process:

  • Firstly, call RSat::GetMeSideSatProfile() . This returns a profile describing the SAT features that are supported by the phone's hardware and the TSY. These features are not under the ETelSat API control; they happen without your involvement.

Once you have told the UICC of the profile:

  • Firstly, request notification of proactive commands with the RSat::Notify... functions.

Parameters

const TDesC8 & aClientSatProfile Client SAT profile. A packaged RSat::TSatProfileVx class. See above for which version to use.

Close()

IMPORT_C void Close ( )
This method closes RSat . RSat::Open()
capability
None

ConstructL()

IMPORT_C void ConstructL ( ) [protected, virtual]

Initialises RSat . called as part of the two-phase construction (typical to Symbian OS).

Destruct()

IMPORT_C void Destruct ( ) [protected, virtual]

Default destructor

EventDownload(TRequestStatus &, TEventList, const TDesC8 &)

IMPORT_C void EventDownload ( TRequestStatus & aReqStatus,
TEventList aSingleEvent,
const TDesC8 & aEventInfo
) const

The SET UP EVENT LIST proactive command gives the phone a list of events that may occur to the phone. The event list may include a change of access technology, user action, browser termination and more. You must inform the UICC when an event on the list occurs by calling RSat::EventDownload() . If the event is not on the list then you do not need to notify the UICC.

See RSat::NotifySetUpEventListPCmd() for more information.

capability
NetworkControl
capability
WriteDeviceData
RSat::NotifySetUpEventListPCmd() RSat::TEventList

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TEventList aSingleEvent Name of the event that has occurred.
const TDesC8 & aEventInfo Additional information available about aSingleEvent.

GetClut(TRequestStatus &, TUint, TUint, TDes8 &)

IMPORT_C void GetClut ( TRequestStatus & aReqStatus,
TUint aInstanceNumber,
TUint aOffset,
TDes8 & aClut
) const

This method retrieves the CLUT (Colour Lookup Table) for an image instance designated by aInstanceNumber. This is used when displaying icons; see RSat::GetImageInstance() .

The format of the CLUT is described in ETSI TS 131 102; see Annex B.

To cancel an outstanding request, call RTelSubSessionBase::CancelAsyncRequest( ESatGetClut )

capability
None

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TUint aInstanceNumber Specifies which instance of an icon is to be retrieved.
TUint aOffset Specifies the offset at which is located the clut within the image instance.
TDes8 & aClut The TSY fills this with the colour look up table specified by aInstance Number, retrieved from the UICC.

GetIcon(TRequestStatus &, TUint8, TIcon &)

IMPORT_C void GetIcon ( TRequestStatus & aReqStatus,
TUint8 aRecordNumber,
TIcon & aIconEf
) const

A proactive command may be accompanied by an icon to be displayed to the user; see RSat::TIconId . The command does not contain the icon. Instead, it contains an icon identifier, RSat::TIconId::iIdentifier . When you want to display an icon, the first step is to pass RSat::TIconId::iIdentifier to RSat::GetIcon() to retrieve the icon's EF record from the UICC.

The EF record describes the icon. The UICC may store several images that represent the same icon. Images can differ in size and coding scheme. Each is listed and described in the EF record. Analyse the EF record and choose a suitable image, then call RSat::GetImageInstance() to retrieves the actual image data to display.

If none of the images are suitable then see the error conditions described in RSat::TIconId .

The EF record is described in ETSI TS 131 102; search for EFimg or "Contents of files at the DFGRAPHICS level"

To cancel an outstanding request, call RTelSubSessionBase::CancelAsyncRequest( ESatGetIcon )

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TUint8 aRecordNumber EF record number of the icon to get. This must be a value from RSat::TIconId::iIdentifier.
TIcon & aIconEf The TSY fills this with the icon EF record retrieved from the UICC, specified by aRecordNumber.

GetImageInstance(TRequestStatus &, const TDesC8 &, TDes8 &)

IMPORT_C void GetImageInstance ( TRequestStatus & aReqStatus,
const TDesC8 & aInstanceInfo,
TDes8 & aInstance
) const

This method retrieves an icon's image data from the UICC. The data is returned in aInstance.

For colour images, you will also need to retrieve a Colour LookUp Table (CLUT). Use RSat::GetClut() for this.

Before calling this method, you must have called RSat::GetIcon() to retrieve the icon's EF record.

aInstanceInfo is a RSat::TInstanceInfoV3Pckg (a packaged RSat::TInstanceInfoV3 ) containing details of the image you would like to get. This includes the image's size. aInstance should be the size of the image.

The EF record is described in ETSI TS 131 102; search for EFimg or "Contents of files at the DFGRAPHICS level". The format of both image data and CLUT is also described in ETSI TS 131 102; see Annex B.

To cancel an outstanding request, call RTelSubSessionBase::CancelAsyncRequest( ESatGetImageInstance )

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
const TDesC8 & aInstanceInfo Specifies the instance number, offset and length of the image to retrieve from EF.
TDes8 & aInstance The TSY fills this with the image instance EF specified by aInstanceInfo, retrieved from the UICC.

GetMeSideSatProfile(TRequestStatus &, TDes8 &)

IMPORT_C void GetMeSideSatProfile ( TRequestStatus & aReqStatus,
TDes8 & aMeSimSatProfile
) const

At the beginning of a ETelSat API session, you must tell the UICC what SAT features the phone supports. Do this after creating and opening an RSat session. This is a three-part process:

  • Firstly, call RSat::GetMeSideSatProfile() . This returns a profile describing the SAT features that are supported by the phone's hardware and the TSY. These features are not under the ETelSat API control; they happen without your involvement.

Once you have told the UICC of the profile:

  • Firstly, request notification of proactive commands with the RSat::Notify... functions.

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TDes8 & aMeSimSatProfile The TSY fills this with the phone hardware and TSY's SAT profile, packaged in a RSat::TSatProfileV1Pckg or RSat::TSatProfileV2Pckg

GetOpenChannelPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void GetOpenChannelPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

Parameters

TRequestStatus & aReqStatus
TDes8 & aPCmd Pass in a RSat::TOpenCsChannelV2Pckg, RSat::TOpenGprsChannelV2Pckg, RSat::TOpenLocalLinksChannelV2Pckg, RSat::TOpenUiccServerModeChannelV7 or derived class as appropriate.

GetProvisioningRefFile(TRequestStatus &, const TProvisioningFileRef &, TDes8 &)

IMPORT_C void GetProvisioningRefFile ( TRequestStatus & aReqStatus,
const TProvisioningFileRef & aFileRef,
TDes8 & aFile
) const

This method retrieves the Provisioning Reference File designated by aFileRef. Call this when handling a LAUNCH BROWSER proactive command.

capability
ReadDeviceData
RSat::NotifyLaunchBrowserPCmd()

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
const TProvisioningFileRef & aFileRef Specifies which provisioning file is to be retrieved.
TDes8 & aFile File, specified by aInstance Number, retrieved from the UICC.

MenuSelection(TRequestStatus &, const TDesC8 &)

IMPORT_C void MenuSelection ( TRequestStatus & aReqStatus,
const TDesC8 & aSelection
) const

Sends a MENU SELECTION envelope command to the UICC. This is related to a SET UP MENU proactive command. SET UP MENU asks for a menu to be added to the phone's menu system. If a user chooses an item from this menu, then inform the UICC of the user's selection with RSat::MenuSelection() .

capability
NetworkControl
capability
ReadDeviceData
RSat::TMenuSelectionV1 RSat::NotifySetUpMenuPCmd()

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
const TDesC8 & aSelection Describes the menu item that the user selected. Pass a packaged version of the latest "TMenuSelection" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TMenuSelectionV1Pckg, a packaged RSat::TMenuSelectionV1. For later versions of Symbian OS, check for an updated API (RSat::TMenuSelectionV2 etc).

MmsNotificationDownload(TRequestStatus &, const TDesC8 &)

IMPORT_C void MmsNotificationDownload ( TRequestStatus & aReqStatus,
const TDesC8 & aMmsNotificationDownload
) const

This method allows the client to pass the MM1_notification.REQ message to the UICC upon receiving the MMS notification intended for the UICC. The MMS Notification download envelope command details are passed in the packaged version of TMmsNotificationDownloadV6 in the aMmsNotificationDownload parameter.

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

To cancel a previously placed RSat::MmsNotificationDownload request, call RTelSubSessionBase::CancelAsyncRequest(ESatMmsNotificationDownload)

capability
NetworkControl
capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
const TDesC8 & aMmsNotificationDownload

MmsTransferStatus(TRequestStatus &, const TDesC8 &)

IMPORT_C void MmsTransferStatus ( TRequestStatus & aReqStatus,
const TDesC8 & aMmsTransferStatus
) const
This method allows the client to notify the UICC of the following:
  • the status of an MMS message submitted to the network.

  • the UICC storage completion of a retrieved MMS message.

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

To cancel a previously placed RSat::MmsTransferStatus request, call RTelSubSessionBase::CancelAsyncRequest(ESatMmsTransferStatus)

capability
NetworkControl
capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
const TDesC8 & aMmsTransferStatus

NotifyCallControlRequest(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyCallControlRequest ( TRequestStatus & aReqStatus,
TDes8 & aCallControlDetails
) const

In SAT-enabled phones, the UICC can request control of outgoing calls or activation of PDP Contexts. The phone's TSY passes the call's parameters to the UICC, such as the telephone number, or in the case of PDP activation PDP parameters. The UICC will allow the call (activation of the context), disallow the call (activation of the context), or it will modify the call's (pdp context activation) parameters. This happens without the RSat client's involvement. However, RSat clients can be informed when call control has taken place the by calling RSat::NotifyCallControlRequest() .

This notification completes when a client requests a call set up or PDP contedxt activation which is modified by the UICC.

You may receive this notification following your attempt to send an SMS in response to a SET UP CALL proactive command (call) or OPEN CHANNEL proactive command (PDP context). You may also receive it when another application attempts to set up a call or activate PDP context.

Upon completion, for a call, aCallControlDetails contains the details of the new action to be performed, instead of the original call set up; for a PDP context activation, aPdpParameters contain the parameters that shall be utilized instead or original PDP activation request.

capability
NetworkControl
capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TDes8 & aCallControlDetails TCallControlV1 packaged into a descriptor, TCallControlV1Pckg. starting with version 9.2, in the case of PDP context activation TCallControlV3 packaged into a descriptor, TCallControlV3Pckg.

NotifyCbDownload(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyCbDownload ( TRequestStatus & aReqStatus,
TDes8 & aCbDownload
) const

This notification completes when a client (not necessarily the SAT client) requests a Cell Broadcast data download. Upon completion the envelope command details will be returned in a RSat::TCbDownloadV3Pckg , a packaged version of the RSat::TCbDownloadV3 class in the aCbDownload.

capability
NetworkControl
capability
ReadUserData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
TDes8 & aCbDownload An RSat:: TCbDownloadV3 packaged in a RSat::TCbDownloadV3Pckg

NotifyCloseChannelPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyCloseChannelPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a CLOSE CHANNEL proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The CLOSE CHANNEL command requests that the phone closes a channel previously opened with the OPEN CHANNEL proactive command. The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111.

Symbian OS support for this command is available from v7.0s onwards.

The command includes:

When you open a channel following an OPEN CHANNEL command, you chose a channel identifier - a number from 1 to 7. When you inform the UICC that you opened a channel successfully, you tell the UICC which number you have chosen to represent the channel. The UICC includes this number in subsequent CLOSE CHANNEL commands so that you know which channel to close.

See the description of the CLOSE CHANNEL command in ETSI TS 102 223 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

Once you have attempted to close the channel, give your response to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TCloseChannelRspV2Pckg (a packaged TCloseChannelRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TCloseChannelRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TCloseChannel" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TCloseChannelV2Pckg, a packaged RSat::TCloseChannelV2. For Symbian OS version 9.2, use RSat::TCloseChannelV5Pckg. For Symbian OS version 9.4, use RSat::TCloseChannelV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TCloseChannelV7 etc).

NotifyDeclareServicePCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyDeclareServicePCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a DECLARE SERVICE proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111.

Symbian OS support for this command is available from v7.0s onwards.

You need to give a response to command back to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TDeclareServiceRspV2Pckg (a packaged TDeclareServiceRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TDeclareServiceRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TDeclareService" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TDeclareServiceV2Pckg, a packaged RSat::TDeclareServiceV2. For later versions of Symbian OS, check for an updated API (RSat::TDeclareServiceV3 etc).

NotifyDisplayMultimediaMsgPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyDisplayMultimediaMsgPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

The DISPLAY MULTIMEDIA MESSAGE command tells the phone to Display the Multimedia file to the User .

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

This asynchronous request is a notifier that completes when the UICC issues a DISPLAY MULTIMEDIA MESSAGE PCmd. Upon completion the proactive command details will be returned in a packaged version of TDisplayMultimediaMessageV6 in the aPCmd parameter.

To cancel a previously placed RSat::NotifyDisplayMultimediaMsgPCmd request, call RTelSubSessionBase::CancelAsyncRequest(ESatNotifyDisplayMultimediaMsgPCmd)

Once you have dealt with the command, you must give your response to the UICC. In Symbian OS versions up to and including 9.4, pass RSat::TerminalRsp() a RSat::TDisplayMultimediaMessageRspV6Pckg (a packaged RSat::TDisplayMultimediaMessageRspV6 ). For later versions of Symbian OS, check for an updated API (RSat::TDisplayMultimediaMessageRspV7 etc).

capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus
TDes8 & aPCmd RSat::TDisplayMultimediaMessageV6, packaged into RSat::TDisplayMultimediaMessageV6Pckg

NotifyDisplayTextPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyDisplayTextPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a DISPLAY TEXT proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The DISPLAY TEXT command instructs the terminal to display a text message, and/or an icon. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

Once you have dealt with the command, you must give your response to the DISPLAY TEXT command. In Symbian OS versions up to and including 8.1a & 8.1b, pass RSat::TerminalRsp() a RSat::TDisplayTextRspV1Pckg (a packaged RSat::TDisplayTextRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TDisplayTextRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TDisplayText" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TDisplayTextV2Pckg, a packaged RSat::TDisplayTextV2. Use RSat::TDisplayTextV1 with older versions of Symbian OS. For Symbian OS version 9.2, use RSat::TDisplayTextV5Pckg. For Symbian OS version 9.4, use RSat::TDisplayTextV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TDisplayTextV7 etc).

NotifyGetChannelStatusPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyGetChannelStatusPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a GET CHANNEL STATUS proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The GET CHANNEL STATUS command asks the phone to return the status of a channel opened with the OPEN CHANNEL proactive command. Both of these commands are described fully in ETSI TS 102 223 and 3GPP TS 31.111.

When you open a channel following an OPEN CHANNEL command, you chose a channel identifier - a number from 1 to 7. When you inform the UICC that you opened a channel successfully, you tell the UICC which number you have chosen to represent the channel. The UICC includes this number in subsequent GET CHANNEL STATUS commands so that you know which channel's status to return.

Symbian OS support for this command is available from v7.0s onwards.

You need to return the channel status or an error to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TGetChannelStatusRspV2Pckg (a packaged TGetChannelStatusRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TGetChannelStatusRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received.
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TGetChannelStatus" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TGetChannelStatusV2Pckg, a packaged RSat::TGetChannelStatusV2. For later versions of Symbian OS, check for an updated API (RSat::TGetChannelStatusV3 etc).

NotifyGetFramesStatusPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyGetFramesStatusPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

GET FRAMES STATUS command requests the terminal to return a Frames parameters data object.

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

This asynchronous request is a notifier that completes when the UICC issues a GET FRAMES STATUS PCmd. Upon completion the proactive command details will be returned in a packaged version of TGetFramesStatusV6 in the aPCmd parameter.

To cancel a previously placed RSat::NotifyGetFramesStatusPCmd request, call RTelSubSessionBase::CancelAsyncRequest(ESatNotifyGetFramesStatusPCmd)

Once you have dealt with the command, you must give your response to the UICC. In Symbian OS versions up to and including 9.4, pass RSat::TerminalRsp() a RSat::TGetFramesStatusRspV6Pckg (a packaged RSat::TGetFramesStatusRspV6 ). For later versions of Symbian OS, check for an updated API (RSat::TGetFramesStatusRspV7 etc).

capability
None

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
TDes8 & aPCmd RSat::TGetFramesStatusV6, packaged into RSat::TGetFramesStatusV6Pckg

NotifyGetInkeyPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyGetInkeyPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a GET INKEY proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The GET INKEY command instructs you to display text and/or an icon and to expect the user to enter a single character. The command states the required response:

  • Get a digit (0-9, *, #, and +) from the user.

  • Get a character from the user from the SMS alphabet.

  • Get a character from the user from the UCS2 alphabet.

  • Get a Yes or No decision from the user.

The response entered by the user shall be passed back to the UICC. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

Once you have dealt with the command, you must give your response to the GET INKEY command. For Symbian OS v6.1 or v7.0 pass RSat::TerminalRsp() a RSat::TGetInkeyRspV1Pckg (a packaged TGetInkeyRspV1 ). For versions up to and included v8.1a and v8.1b use RSat::TGetInkeyRspV2Pckg (a packaged RSat::TGetInkeyRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TGetInkeyRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TGetInkey" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TGetInkeyV2Pckg, a packaged RSat::TGetInkeyV2. For Symbian OS version 9.2, use RSat::TDisplayTextV5Pckg. Use RSat::TGetInkeyV1 with older versions of Symbian OS. For Symbian OS version 9.4, use RSat::TDisplayTextV6Pckg.a packaged RSat::TGetInkeyV6. For later versions of Symbian OS, check for an updated API(RSat::TGetInkeyV7 etc).

NotifyGetInputPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyGetInputPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a GET INPUT proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The GET INPUT command instructs you to display text and/or an icon and to expect the user to enter a string. Pass the string back to the UICC. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

Once you have dealt with the command, you must give your response to the GET INPUT command. For Symbian OS versions up to and including v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TGetInputRspV1Pckg (a packaged RSat::TGetInputRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TGetInputRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TGetInput" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TGetInkeyV1Pckg, a packaged RSat::TGetInkeyV1. For Symbian OS version 9.2, use RSat::TGetInkeyV5Pckg. For Symbian OS version 9.4, use RSat::TGetInkeyV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TGetInkeyV7 etc).

NotifyGetReaderStatusPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyGetReaderStatusPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a GET READER STATUS proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The GET READER STATUS command requests the status of the card reader specified in the command. The command is described fully in ETSI TS 102 223. Symbian OS support for this command is available from v7.0s onwards.

The command can request two types of information:

Once you have tried to get the status, you must give your response to the GET READER STATUS command. This should include the APDU command results, if there are any. For Symbian OS versions from v7.0s to v8.1a and v8.1b, pass RSat::TerminalRsp() a RSat::TGetReaderStatusRspV2Pckg (a packaged RSat::TGetReaderStatusRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TGetReaderStatusRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TGetReaderStatus" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TGetReaderStatusV2Pckg, a packaged RSat::TGetReaderStatusV2. For later versions of Symbian OS, check for an updated API (RSat::TGetReaderStatusV3 etc).

NotifyGetServiceInfoPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyGetServiceInfoPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a GET SERVICE INFO proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111.

Symbian OS support for this command is available from v7.0s onwards.

You need to give a response to command back to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TGetServiceInfoRspV2Pckg (a packaged TGetServiceInfoRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TGetServiceInfoRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TGetServiceInfo" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TGetServiceInfoV2Pckg, a packaged RSat::TGetServiceInfoV2. For Symbian OS version 9.2, use RSat::TGetServiceInfoV5Pckg. For Symbian OS version 9.4, use RSat::TGetServiceInfoV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TGetServiceInfoV7 etc).

NotifyLanguageNotificationPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyLanguageNotificationPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a LANGUAGE NOTIFICATION proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The LANGUAGE NOTIFICATION command tells the phone the language in which any text strings from the UICC are written. This includes text within proactive commands or envelope command responses. The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111. Symbian OS support for this command is available from v7.0s onwards.

The command contains a flag, RSat::TLanguageNotificationV2::iNotificationType , that describes the command's purpose:

  • If iNotificationType is set to RSat::ENonSpecificLangNotification then the UICC is not using any specific language. This has the effect of cancelling previous specific LANGUAGE NOTIFICATION commands.

Once you have dealt with the command, you must give your response to the LANGUAGE NOTIFICATION command. For Symbian OS versions from v7.0s to v8.1a and v8.1b, pass RSat::TerminalRsp() a RSat::TLanguageNotificationRspV2Pckg (a packaged TLanguageNotificationRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TLanguageNotificationRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TRunAtCommand" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TRunAtCommandV2Pckg, a packaged RSat::TRunAtCommandV2. For later versions of Symbian OS, check for an updated API (RSat::TRunAtCommandV3 etc).

NotifyLaunchBrowserPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyLaunchBrowserPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a LAUNCH BROWSER proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The LAUNCH BROWSER command requests that the phone browses to the supplied URL. The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111. Symbian OS support for this command is available from v7.0s onwards.

Handling the command is a four-stage process:

Step one is to ask the user for their permission to launch the browser. The LAUNCH BROWSER command provides two parameters for this: an alpha identifier ( RSat::TLaunchBrowserV2::iAlphaId ) and an icon ( RSat::TLaunchBrowserV2::iIconId ). You can display these to help the user make a choice.

Step two: examine the rest of the command and decide whether you can proceed. The command includes:

Step three is to tell the UICC your intentions. You must do this before launching the browser. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TLaunchBrowserRspV2Pckg (a packaged RSat::TLaunchBrowserRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TLaunchBrowserRspV3 etc).

Finally, you can launch the browser.

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TLaunchBrowser" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TLaunchBrowserV2Pckg, a packaged RSat::TLaunchBrowserV2. For Symbian OS version 9.2, use RSat::TLaunchBrowserV5Pckg. For Symbian OS version 9.4, use RSat::TLaunchBrowserV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TLaunchBrowserV7 etc).

NotifyLocalInfoPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyLocalInfoPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a PROVIDE LOCAL INFORMATION proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

Support for this command is only available from v7.0s of Symbian OS onwards.

The PROVIDE LOCAL INFORMATION command instructs the phone to send local information to the UICC. The command is described fully in ETSI TS 102 223, 3GPP2 C.S0035-0 and 3GPP TS 31.111. Briefly, though, the command includes:

The type of information depends upon the network on which the phone is running. For GSM/WCDMA networks, read 3GPP TS 31.111; for CDMA networks read 3GPP2 C.S0035-0. ETSI TS 102 223 only provides generic information about the PROVIDE LOCAL INFORMATION command.

Provide the information (or an error code) in the format described in the specifications. In Symbian OS versions up to and including 8.1a & 8.1b, pass RSat::TerminalRsp() a RSat::TLocalInfoRspV3Pckg (a packaged RSat::TLocalInfoRspV3 ). For later versions of Symbian OS, check for an updated API (RSat::TLocalInfoRspV4 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TLocalInfo" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TLocalInfoV3Pckg, a packaged RSat::TLocalInfoV3. For Symbian OS version 9.4, use RSat::TLocalInfoV6. For later versions of Symbian OS, check for an updated API (RSat::TLocalInfoV7 etc).

NotifyMoSmControlRequest(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyMoSmControlRequest ( TRequestStatus & aReqStatus,
TDes8 & aMoSmDetails
) const

In SAT-enabled phones on GSM/WCDMA networks, the UICC can control who SMS messages are sent to. The phone's TSY passes the UICC the SMS's parameters, such as the telephone number of the recipient. The UICC will allow the message, disallow the message, or it modify the delivery parameters. This happens without the RSat client's involvement. However, RSat clients can be informed when SMS control has taken place the by calling RSat::NotifyMoSmControlRequest() .

This notification completes when a client tries to send an SMS which is then modified by SMS control.

You may receive this notification following your attempt to send an SMS in response to a SEND SHORT MESSAGE proactive command. You may also receive it when another application attempts to send an SMS.

Upon completion, aMoSmDetails contains the details of the new SMS operation to be performed instead of the original request.

capability
NetworkControl
capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TDes8 & aMoSmDetails TMoSmControlV1 packaged into a descriptor, TMoSmControlV1Pckg.

NotifyOpenChannelPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyOpenChannelPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when an OPEN CHANNEL proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The OPEN CHANNEL command asks the phone to open a channel. You must inform the UICC whether you were successful. If so, subsequent proactive commands ask the phone to read or write data to the channel, to get the channel's status and to close the channel.

The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111. The documents also describe these related commands:

  • CLOSE CHANNEL

  • SEND DATA

  • RECEIVE DATA

  • GET CHANNEL STATUS

The OPEN COMMAND defines the channel that should be opened. Typical examples are a channel to an IP address, an Internet domain name, a local serial connection etc.

The command is returned in a class that inherits from RSat::TOpenChannelBaseV2 . When you receive an OPEN CHANNEL command, look at its RSat::TOpenChannelBaseV2::iPCmdType field. This determines the type of bearer to use for the channel. There are three types:

The description of the "TOpen..." classes describes their contents and how to set up the channel.

If you successfully open a channel then you must assign it a channel number from 1 to 7. You can have up to seven channels open at once, each opened with a separate OPEN CHANNEL command. You must inform the UICC of your chosen channel number. Subsequent CLOSE CHANNEL, SEND DATA, RECEIVE DATA and GET CHANNEL STATUS commands from the UICC will include a channel number from those you have returned to the UICC.

If you do not successfully open a channel then return an error code as recommended in ETSI TS 102 223 and 3GPP TS 31.111.

Whether you are successful or unsuccessful, respond to the OPEN CHANNEL command as follows: for Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TOpenChannelRspV2Pckg (a packaged RSat::TOpenChannelRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TOpenChannelRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received.
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Pass in a RSat::TOpenChannelBaseV2Pckg. When the request completes, class will be changed to a RSat::TOpenCsChannelV2Pckg for Symbian OS 7.0s, 8.0 and 8.1. For Symbian OS 9.2, class will be changed to a RSat::TOpenCsChannelV5Pckg. For Symbian OS 9.4, class will be changed to a RSat::TOpenCsChannelV6Pckg. or for Symbian OS 7.0s, 8.0 and 8.1, class will be changed to a RSat::TOpenGprsChannelV2Pckg. For Symbian OS 9.2, class will be changed to a RSat::TOpenGprsChannelV5Pckg. For Symbian OS 9.4, class will be changed to a RSat::TOpenGprsChannelV6Pckg. or for Symbian OS 7.0s, 8.0 and 8.1, class will be changed to a RSat::TOpenLocalLinksChannelV2Pckg. For Symbian OS 9.2, class will be changed to a RSat::TOpenLocalLinksChannelV5Pckg. For Symbian OS 9.4, class will be changed to a RSat::TOpenLocalLinksChannelV6Pckg. and RSat::TOpenUiccServerModeChannelV7Pckg has been introduced to support UICC Server Mode. Look at RSat::TOpenChannelBaseV2::iPCmdType to find out which determines the type of bearer to use for the channel. For later versions of Symbian OS, check for an updated version of APIs (RSat::TOpenCsChannelV7 or RSat::TOpenGprsChannelV6 or RSat::TOpenLocalLinksChannelV7 or TOpenUiccServerModeChannelV8 etc).

NotifyPerformCardApduPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyPerformCardApduPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a PERFORM CARD APDU proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The PERFORM CARD APDU command asks the phone to send an APDU command to the card specified in the command. The command is described fully in ETSI TS 102 223. Symbian OS support for this command is available from v7.0s onwards.

The command includes:

Once you have dealt with the APDU command, you must give your response to the PERFORM CARD APDU command. This should include the APDU command results, if there are any. For Symbian OS versions from v7.0s to v8.1a and v8.1b, pass RSat::TerminalRsp() a RSat::TPerformCardApduRspV2Pckg (a packaged RSat::TPerformCardApduRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TPerformCardApduRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TPerformCardApdu" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TPerformCardApduV2Pckg, a packaged RSat::TPerformCardApduV2. For later versions of Symbian OS, check for an updated API (RSat::TPerformCardApduV3 etc).

NotifyPlayTonePCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyPlayTonePCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a PLAY TONE proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The PLAY TONE command instructs you to play a tone. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

See the description of the PLAY TONE command in ETSI TS 102 223 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

Once you have dealt with the command, you must give your response to the PLAY TONE command. For Symbian OS v6.1 or v7.0 pass RSat::TerminalRsp() a RSat::TPlayToneRspV1Pckg (a packaged TPlayToneRspV1 ). For versions up to and including v8.1a and v8.1b use RSat::TPlayToneRspV2Pckg (a packaged RSat::TPlayToneRspV2). For later versions of Symbian OS, check for an updated API (RSat::TPlayToneRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TPlayTone" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TPlayToneV2Pckg, a packaged RSat::TPlayToneV2. For Symbian OS version 9.2, use RSat::TPlayToneV5Pckg. For Symbian OS version 9.4, use RSat::TPlayToneV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TPlayToneV7 etc).

NotifyPollingIntervalPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyPollingIntervalPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a POLL INTERVAL proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

Support for this command is only available from v7.0s of Symbian OS onwards.

The POLL INTERVAL command tells the phone how often the UICC would like to be polled by the phone. Each time it is polled, it can pass proactive commands to the phone. The command is described fully in ETSI TS 102 223. The command includes:

It is up to the phone to choose the polling interval; the value in the proactive command is only a request. It should choose the closest acceptable value. The phone should tell the UICC what interval it has chosen to use as follows:

In Symbian OS versions up to and including 8.1a & 8.1b, pass RSat::TerminalRsp() a RSat::TPollingIntervalRspV3Pckg (a packaged RSat::TPollingIntervalRspV3 ). For later versions of Symbian OS, check for an updated API (RSat::TPollingIntervalRspV4 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TPollingInterval" class. For Symbian OS versions from v7.0s to v8.1a and 8.1b use RSat::TPollingIntervalV3Pckg, a packaged RSat::TPollingIntervalV3. For later versions of Symbian OS, check for an updated API (RSat::TPollingIntervalV4 etc).

NotifyPollingOffPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyPollingOffPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a POLLING OFF proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

Support for this command is only available from v7.0s of Symbian OS onwards.

The POLLING OFF command tells the phone not to poll the UICC for proactive commands any more. The command is described fully in ETSI TS 102 223. The command includes the device for which polling should be turned off - RSat::TPollingOffV3::iDestination .

Once you have dealt with the command, you must give your response to the UICC. In Symbian OS versions up to and including 8.1a & 8.1b, pass RSat::TerminalRsp() a RSat::TPollingOffRspV3Pckg (a packaged RSat::TPollingOffRspV3 ). For later versions of Symbian OS, check for an updated API (RSat::TPollingOffRspV4 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TPollingOff" class. For Symbian OS versions from v7.0s to v8.1a and 8.1b use RSat::TPollingOffV3Pckg, a packaged RSat::TPollingOffV3. For later versions of Symbian OS, check for an updated API (RSat::TPollingOffV4 etc).

NotifyPowerOffCardPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyPowerOffCardPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a POWER OFF CARD proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The POWER OFF CARD command closes the session with the card specified in the command. The command is described fully in ETSI TS 102 223. Symbian OS support for this command is available from v7.0s onwards.

Once you have tried to close the session, you must give your response to the POWER OFF CARD command. This should include the APDU command results, if there are any. For Symbian OS versions from v7.0s to v8.1a and v8.1b, pass RSat::TerminalRsp() a RSat::TPowerOffCardRspV2Pckg (a packaged RSat::TPowerOffCardRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TPowerOffCardRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TPowerOffCard" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TPowerOffCardV2Pckg, a packaged RSat::TPowerOffCardV2. For later versions of Symbian OS, check for an updated API (RSat::TPowerOffCardV3 etc).

NotifyPowerOnCardPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyPowerOnCardPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a POWER ON CARD proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The POWER ON CARD command requests that you start a session with the card specified in the command. The command is described fully in ETSI TS 102 223. Symbian OS support for this command is available from v7.0s onwards.

Once you have tried to start the session, you must give your response to the POWER ON CARD command. This should include the APDU command results, if there are any. For Symbian OS versions from v7.0s to v8.1a and v8.1b, pass RSat::TerminalRsp() a RSat::TPowerOnCardRspV2Pckg (a packaged RSat::TPowerOnCardRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TPowerOnCardRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TPowerOnCard" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TPowerOnCardV2Pckg, a packaged RSat::TPowerOnCardV2. For later versions of Symbian OS, check for an updated API (RSat::TPowerOnCardV3 etc).

NotifyProactiveSimSessionEnd(TRequestStatus &)

IMPORT_C void NotifyProactiveSimSessionEnd ( TRequestStatus & aReqStatus ) const
This function is no longer needed when using the ETelSat API.
capability
None

Parameters

TRequestStatus & aReqStatus

NotifyProactiveSimSessionStart(TRequestStatus &)

IMPORT_C void NotifyProactiveSimSessionStart ( TRequestStatus & aReqStatus ) const
This function is no longer needed when using the ETelSat API.
capability
None

Parameters

TRequestStatus & aReqStatus

NotifyReceiveDataPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyReceiveDataPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a RECEIVE DATA proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The RECEIVE DATA command asks the phone for data from a channel opened with the OPEN CHANNEL proactive command. Both of these commands are described fully in ETSI TS 102 223 and 3GPP TS 31.111.

Symbian OS support for this command is available from v7.0s onwards.

The command includes:

When you open a channel following an OPEN CHANNEL command, you chose a channel identifier - a number from 1 to 7. When you inform the UICC that you opened a channel successfully, you tell the UICC which number you have chosen to represent the channel. The UICC includes this number in subsequent RECEIVE DATA commands so that you know which channel to use.

See the description of the RECEIVE DATA command in ETSI TS 102 223 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

You need to give the data or an error to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TReceiveDataRspV2Pckg (a packaged TReceiveDataRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TReceiveDataRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TReceiveData" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TReceiveDataV2Pckg, a packaged RSat::TReceiveDataV2. For Symbian OS version 9.2, use RSat::TReceiveDataV5Pckg. For Symbian OS version 9.4, use RSat::TReceiveDataV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TReceiveDataV7 etc).

NotifyRefreshPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyRefreshPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a REFRESH proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The REFRESH command is described fully in ETSI TS 102 223. It tells you three main things:

  • It can indicate that one or more of the files on the UICC have changed.

  • It can request that the UICC has been reset.

  • It can request that one of the applications running on the UICC be refreshed.

RSat::TRefreshV1::iType indicates any or all of these things. If one or more of the data files on the UICC have changed, a list of the changed files will be given in RSat::TRefreshV1::iFileList . This will be a series of identifiers from RSat::TElementaryFiles . If an application needs to be refreshed, its ID is in RSat::TRefreshV2::iAid .

Any application that deals with UICC data may want to receive notification when files change. For instance, the address book application may want to know if the address book data changes. Hence the procedure for handling REFRESH commands is more complicated than other proactive commands. The following scheme is necessary to allow for multiple clients to process a REFRESH notification:

Your phone's main SAT application decides when other applications receive REFRESH commands. If the main SAT application is in the middle of editing UICC data, it can delay the REFRESH notification to other applications until it has finished editing:

  • When the UICC sends a REFRESH command, the RSat::NotifyRefreshRequired() notification completes. This tells the main SAT application that a REFRESH command is pending. This gives the main SAT application a chance to tidy up.

Once you have dealt with a REFRESH command, you must give your response to the UICC. For Symbian OS versions up to and included v8.1a and v8.1b pass a RSat::TRefreshRspV2Pckg (a packaged RSat::TRefreshRspV2) to RSat::TerminalRsp() . For later versions of Symbian OS, check for an updated API (RSat::TRefreshRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TRefreshV2Pckg, a packaged RSat::TRefreshV2. Use RSat::TRefreshV1 with older versions of Symbian OS. For later versions of Symbian OS, check for an updated API (RSat::TRefreshV3 etc).

NotifyRefreshRequired(TRequestStatus &)

IMPORT_C void NotifyRefreshRequired ( TRequestStatus & aReqStatus ) const

This notification completes when SAT engine indicates that it can complete the required refresh. This is phase 1 of a two phase refresh cycle with RSat::NotifyRefreshPCmd() being phase 2. The TSY should inform the UICC via terminal response should refresh not be possible at this time. This is intended to be used only by the SAT engine.

See RSat::NotifyRefreshPCmd() for more information.

capability
None

Parameters

TRequestStatus & aReqStatus

NotifyRefreshRequired(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyRefreshRequired ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This notification completes when SAT Engine indicates that it can complete the required refresh. This is phase 1 on a two phase refresh cycle with NotifyRefreshPCmd being phase 2. The TSY should inform the UICC via terminal response should refresh not be possible at this time. This is intended to be used only by the SAT Engine.

capability
None

Parameters

TRequestStatus & aReqStatus
TDes8 & aPCmd TRefreshV1 packaged into a descriptor, TRefreshV1Pckg.

NotifyRetrieveMultimediaMsgPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyRetrieveMultimediaMsgPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

The RETRIEVE MULTIMEDIA MESSAGE command tells the phone to retrieve a Multimedia file from Network.

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

This asynchronous request is a notifier that completes when the UICC issues a RETRIEVE MULTIMEDIA MESSAGE PCmd. Upon completion the proactive command details will be returned in a packaged version of TRetrieveMultimediaMessageV6 in the aPCmd parameter.

To cancel a previously placed RSat::NotifyRetrieveMultimediaMsgPCmd request, call RTelSubSessionBase::CancelAsyncRequest(ESatNotifyRetrieveMultimediaMsgPCmd)

Once you have dealt with the command, you must give your response to the UICC. In Symbian OS versions beginning from 9.4, pass RSat::TerminalRsp() a RSat::TRetrieveMultimediaMessageRspV6Pckg (a packaged RSat::TRetrieveMultimediaMessageRspV6 ). For later versions of Symbian OS, check for an updated API (RSat::TRetrieveMultimediaMessageRspV7 etc).

capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes. Set to KErrNone on successful completion; another error code otherwise.
TDes8 & aPCmd a RSat::TRetrieveMultimediaMessageV6, packaged into a RSat::TRetrieveMultimediaMessageV6Pckg. Get filled with the details of the proactive command on completion of this notification.

NotifyRunAtCommandPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyRunAtCommandPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a RUN AT COMMAND proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The RUN AT COMMAND command asks the phone to perform the AT command provided. The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111. Symbian OS support for this command is available from v7.0s onwards.

The command includes:

See the description of the RUN AT COMMAND command in ETSI TS 102 223 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

Once you have dealt with the command, you must give your response to the RUN AT COMMAND command. This should include the AT response string, if there is one. For Symbian OS versions from v7.0s to v8.1a and v8.1b, pass RSat::TerminalRsp() a RSat::TRunAtCommandV2RspPckg (a packaged TRunAtCommandRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TRunAtCommandRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TRunAtCommand" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TRunAtCommandV2Pckg, a packaged RSat::TRunAtCommandV2. For Symbian OS version 9.2, use RSat::TRunAtCommandV5Pckg. For Symbian OS version 9.4, use RSat::TRunAtCommandV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TRunAtCommandV7 etc).

NotifySelectItemPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySelectItemPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SELECT ITEM proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SELECT ITEM command provides a set of menu items to be shown to the user. The user can choose one of these menu items. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

Once you have integrated the menu (but before the user has made a selection), you must give your response to the SELECT ITEM command. For Symbian OS versions up to and including v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TSelectItemRspV1Pckg (a packaged TGetInputRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TSelectItemRspV2 etc).

If the user chooses a menu item then inform the UICC with RSat::MenuSelection() . This includes the identifier of the chosen menu item.

You may receive a SELECT ITEM command with no menu! This means that the menu from the previous SELECT ITEM command should be removed; see RSat::TMenuItemBaseV1::IsRemoveMenu() .

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TSelectItem" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TSelectItemV2Pckg, a packaged RSat::TSelectItemV2. For Symbian OS version 9.2, use RSat::TDisplayTextV5Pckg. For Symbian OS version 9.4, use RSat::TDisplayTextV6Pckg. Use RSat::TSelectItemV1 with some older versions of Symbian OS. For later versions of Symbian OS, check for an updated API (RSat::TSelectItemV7 etc).

NotifySendDataPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySendDataPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SEND DATA proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The SEND DATA command asks the phone to send data on a channel opened with the OPEN CHANNEL proactive command. Both of these commands are described fully in ETSI TS 102 223 and 3GPP TS 31.111.

Symbian OS support for this command is available from v7.0s onwards.

The command includes:

When you open a channel following an OPEN CHANNEL command, you chose a channel identifier - a number from 1 to 7. When you inform the UICC that you opened a channel successfully, you tell the UICC which number you have chosen to represent the channel. The UICC includes this number in subsequent SEND DATA commands so that you know which channel to use.

See the description of the SEND DATA command in ETSI TS 102 223 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

You need to give a response to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TSendDataRspV2Pckg (a packaged TSendDataRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TSendDataRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TSendData" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TSendDataV2Pckg, a packaged RSat::TSendDataV2. For Symbian OS version 9.2, use RSat::TSendDataV5Pckg. For Symbian OS version 9.4, use RSat::TSendDataV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TSendDataV7 etc).

NotifySendDtmfPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySendDtmfPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SEND DTMF proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SEND DTMF command asks the phone to send a DTMF string. A call must be in progress to send DTMF tones. This command is independent of sending DTMF within the call set up (as defined in the SET UP CALL command) and therefore can be used at any time during a call.

The command is described fully in ETSI TS 102 223. It contains:

See the description of the SEND DTMF command in ETSI TS 102 223 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

Once you have dealt with the command, you must give your response to the SEND DTMF command. For Symbian OS v6.1 or v7.0 pass RSat::TerminalRsp() a RSat::TSendDtmfRspV1Pckg (a packaged TSendDtmfRspV1 ). For versions 7.0s, v8.1a and v8.1b use RSat::TSendDtmfRspV2Pckg (a packaged TSendDtmfRspV2). For later versions of Symbian OS, check for an updated API (RSat::TSendDtmfRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSendDtmf" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TSendDtmfV1Pckg, a packaged RSat::TSendDtmfV1. For Symbian OS version 9.2, use RSat::TSendDtmfV5. For Symbian OS version 9.4, use RSat::TSendDtmfV6. For later versions of Symbian OS, check for an updated API (RSat::TSendDtmfV7 etc).

NotifySendSmPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySendSmPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SEND SHORT MESSAGE proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SEND SHORT MESSAGE command asks the phone to send an SMS message. Return the response to this request to the UICC.

The command is described in ETSI TS 102 223, with additional information for GSM/WCDMA networks in 3GPP TS 31.111, and for CDMA networks in 3GPP2 C.S0035-0. The command contains:

Display the icon as described in RSat::TIconId . Display the text in the alpha identifier, if there is any. If the alpha identifier is not present in the proactive command then you can display whatever you like while sending the message.

However, if the alpha identifier is present in the proactive command but it is an empty string then do not display anything: just send the message without letting the user know. To help with this, send the message by calling RSat::SendMessageNoLogging() instead of the usual RMobileSmsMessaging::SendMessage(). This avoids the message being logged.

Return the result of the SMS or an error code to the UICC. For Symbian OS versions up to and including v8.1a and 8.1b pass RSat::TerminalRsp() a RSat::TSendSsRspV1Pckg (a packaged TSendSsRspV1 ). For later versions of Symbian OS, check for an updated API ( RSat::TSendSsRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSendSm" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TSendSmV1Pckg, a packaged RSat::TSendSmV1. For Symbian OS version 9.2, use RSat::TSendSmV5Pckg. For Symbian OS version 9.4, use RSat::TSendSmV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TSendSmV7 etc).

NotifySendSsPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySendSsPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SEND SS proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

This command is only supported on GSM/WCDMA networks. It can be ignored on CDMA networks.

The SEND SS command asks the phone to send a supplementary service request to the network. Return the response to this request to the UICC.

The command is described fully in 3GPP TS 31.111 but does not appear in ETSI TS 102 223. It contains:

See the description of the SEND SS command in 3GPP TS 31.111 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

Return the result of the SS request or an error code to the UICC. For Symbian OS versions up to and including v8.1a and 8.1b pass RSat::TerminalRsp() a RSat::TSendSsRspV1Pckg (a packaged TSendSsRspV1 ). For later versions of Symbian OS, check for an updated API ( RSat::TSendSsRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSendSs" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TSendSsV1Pckg, a packaged RSat::TSendSsV1. For Symbian OS version 9.4, use RSat::TSendSmV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TSendSsV7 etc).

NotifySendUssdPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySendUssdPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SEND USSD proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

This command is only supported on GSM/WCDMA networks. It can be ignored on CDMA networks.

The SEND USSD command asks the phone to send an Unstructured Supplementary Service Data request to the network. Return the response to this request to the UICC.

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

See the description of the SEND USSD command in 3GPP TS 31.111 for the circumstances under which the alpha identifier's text should be displayed. Display the icon as described in RSat::TIconId .

Return the result of the USSD request or an error code to the UICC. For Symbian OS versions up to and including v8.1a and 8.1b pass RSat::TerminalRsp() a RSat::TSendUssdRspV1Pckg (a packaged TSendUssdRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TSendUssdRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSendUssd" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TSendUssdV1Pckg, a packaged RSat::TSendUssdV1. For Symbian OS versions 9.4 and above use RSat::TSendUssdV6Pckg, a packaged RSat::TSendUssdV6. For later versions of Symbian OS, check for an updated API (RSat::TSendUssdV7 etc).

NotifyServiceSearchPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyServiceSearchPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SERVICE SEARCH proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

The command is described fully in ETSI TS 102 223 and 3GPP TS 31.111.

Symbian OS support for this command is available from v7.0s onwards.

You need to give a response to command back to the UICC. For Symbian OS versions from 7.0s to v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TServiceSearchRspV2Pckg (a packaged TServiceSearchRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TServiceSearchRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TServiceSearch" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TServiceSearchV2Pckg, a packaged RSat::TServiceSearchV2. For Symbian OS version 9.2, use RSat::TServiceSearchV5Pckg. For Symbian OS version 9.4, use RSat::TServiceSearchV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TServiceSearchV7 etc).

NotifySetFramesPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySetFramesPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

SET FRAMES command instructs the terminal to divide the terminal screen into multiple, scrollable rectangular regions called frames inorder to present multiple information at once. It can be applied to entire screen or to an already existing frame, dividing this frame into sub-frames

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:
  • The indicator tells the terminal whether or not to draw a separator between every adjoining frame - RSat::TSetFramesV6::iFrameSeparator

  • This value is used to indentify the frame, a value of '00' refers to the entire terminal's screen.Any other value refers to an existing frame - RSat::TSetFramesV6::iFrameId

  • It contains the layout information of the frame - RSat::TSetFramesV6::iFrameLayout

  • This is optional. It contains an indication of the frame to be used to display information in case a Frame Identifier is not included - RSat::TSetFramesV6::iDefaultFrameId

This asynchronous request is a notifier that completes when the UICC issues a SET FRAMES PCmd. Upon completion the proactive command details will be returned in a packaged version of TSetFramesV6 in the aPCmd parameter.

To cancel a previously placed RSat::NotifySetFramesPCmd request, call RTelSubSessionBase::CancelAsyncRequest(ESatNotifySetFramesPCmd)

Once you have dealt with the command, you must give your response to the UICC. In Symbian OS versions up to and including 9.4, pass RSat::TerminalRsp() a RSat::TSetFramesRspV6Pckg (a packaged RSat::TSetFramesRspV6 ). For later versions of Symbian OS, check for an updated API (RSat::TSetFramesRspV7 etc).

capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
TDes8 & aPCmd RSat::TSetFramesV6, packaged into RSat::TSetFramesV6Pckg

NotifySetUpCallPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySetUpCallPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SET UP CALL proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SET UP CALL command asks you to connect a phone call. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

After receiving the command, first look at RSat::TSetUpCallV1::iType to decide whether to make the call. Then you need to ask the user's permission to call. This is the confirmation phase. Display the confirmation alpha ID and icon as described in ETSI TS 102 223.

If the user gives permission, you can dial the number and attempt to connect the call. This is the 'call set up' phase. Display the call setup alpha ID and icon as described in ETSI TS 102 223.

If the call could not be connected, look at RSat::TSetUpCallV1::iType to see whether you should try to dial again. Do not re-dial for longer than RSat::TSetUpCallV1::iDuration .

Once the call has connected, or if the call could not be made and you have finished re-dialling, you must give your response to the SET UP CALL command. For Symbian OS v6.1 or v7.0 pass RSat::TerminalRsp() a RSat::TSetUpCallRspV1Pckg (a packaged TSetUpCallRspV1 ). For versions up to and including v8.1a and v8.1b use RSat::TSetUpCallRspV2Pckg (a packaged RSat::TSetUpCallRspV2 ). For later versions of Symbian OS, check for an updated API (RSat::TSetUpCallRspV3 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSetUpCall" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TSetUpCallV1Pckg, a packaged RSat::TSetUpCallV1. For Symbian OS version 9.2, use RSat::TSetUpCallV5Pckg. For Symbian OS version 9.4, use RSat::TSetUpCallV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TSetUpCallV7 etc).

NotifySetUpCallPCmdCancel()

IMPORT_C void NotifySetUpCallPCmdCancel ( ) const

NotifySetUpEventListPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySetUpEventListPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SET UP EVENT LIST proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SET UP EVENT LIST command gives the phone a list of events about which the UICC is interested in receiving notification. The event list may include such things as a change of access technology, user action, browser termination and more. You must inform the UICC when an event on the list occurs by calling RSat::EventDownload() . If the event is not on the list then you do not need to notify the UICC.

RSat::TSetUpEventListV1::iEvents field contains the list of events in the form of flags from RSat::TEventList . When a flagged event occurs, notify the UICC by passing RSat::EventDownload() the appropriate flag. Many events require you to supply information about the event.

The events, their flags and any additional information required by the UICC are shown below. Most events are described in the "Envelope Commands (Event Download)" section of ETSI TS 102 223. 3GPP TS 31.111 contains additional detail for certain events on GSM/WCDMA networks.

  • MT(Mobile Terminated) Call Event - RSat::KMTCall flag. Notify the UICC when the phone receives a call setup message. Return the transaction number, address and subaddress as defined in ETSI TS 102 223 (and 3GPP TS 31.111 on GSM/WCDMA networks.) This event is often handled by the TSY, in which case RSat clients can ignore it.

  • Call Connected Event - RSat::KCallConnected flag. Notify the UICC when the phone receives or sends a call connect message for mobile-terminated calls. Return the transaction number as defined in as defined in ETSI TS 102 223 (and 3GPP TS 31.111 on GSM/WCDMA networks.) This event is often handled by the TSY, in which case RSat clients can ignore it.

  • Call Disconnected Event - RSat::KCallDisconnected flag. Notify the UICC when a call is disconnected. Return the transaction number and cause code as defined in ETSI TS 102 223 (and 3GPP TS 31.111 on GSM/WCDMA networks.) This event is often handled by the TSY, in which case RSat clients can ignore it.

  • Location Status Event - RSat::KLocationStatus flag. Notify the UICC when the phone has changed location. This only happens when the phone enters the idle state. Return the location information and location status as defined in as defined in ETSI TS 102 223 (and 3GPP TS 31.111 on GSM/WCDMA networks.) This event is often handled by the TSY, in which case RSat clients can ignore it.

  • User Activity Event - RSat::KUserActivity flag. Notify the UICC when you detect some user activity (e.g. a key-press, removal of key-lock). There is no additional information to be returned to the UICC. Unlike the majority of other events, you should only respond to the first instance of user activity. Ignore subsequent user activity unless the UICC sends another SET UP EVENT LIST command listing the user activity event.

  • Idle Screen Available Event - RSat::KIdleScreenAvailable flag. Notify the UICC when the phone next enters a state where it is willing to display text that is not urgent. More specifically, the phone will accept rather than reject a DISPLAY TEXT command of normal priority. Unlike the majority of other events, you should only respond to the first "Idle screen available event". Ignore subsequent events unless the UICC sends another SET UP EVENT LIST command listing the "Idle screen available event".

  • Card Reader Status Event - RSat::KCardReaderStatus flag. Notify the UICC when a card reader becomes available or unavailable, and when a card is inserted or removed. Return the new status. This is a RSat::TCardReaderStatusEventV2 containing the "Card Reader Status" object defined in ETSI TS 102 223's object definitions.

As an alternative to the above, the SET UP EVENT LIST command may cancel the previous command. It does this by setting the command's RSat::TSetUpEventListV1::iType to RSat::ERemoveExistingEventList instead of RSat::EUpdateEventList .

You must give your response to the command after you receive it. In Symbian OS versions up to and including 8.1a & 8.1b, pass RSat::TerminalRsp() a RSat::TSetUpEventListRspV1Pckg (a packaged TSetUpEventListRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TSetUpEventListRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSetUpEventList" class. For Symbian OS versions up to and including 8.1a and 8,1b, use RSat::TSetUpEventListV1Pckg, a packaged RSat::TSetUpEventListV1. For later versions of Symbian OS, check for an updated API (RSat::TSetUpEventListV2 etc).

NotifySetUpIdleModeTextPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySetUpIdleModeTextPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SET UP IDLE MODE TEXT proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SET UP IDLE MODE TEXT command provides text (and optionally an icon) to be displayed when the phone is idle. The presentation style is not defined by this command; that is left to the phone designer. The command is described fully in ETSI TS 102 223.

Two types of command can be sent by the UICC:

Once you have dealt with the command, you must give your response to the SET UP IDLE MODE TEXT command. For Symbian OS versions up to and including v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TSetUpIdleModeTextRspV1Pckg (a packaged RSat::TSetUpIdleModeTextRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TSetUpIdleModeTextRspV2 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TSetUpIdleModeText" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TSetUpIdleModeTextV1Pckg, a packaged RSat::TSetUpIdleModeTextV1. For Symbian OS version 9.2, use RSat::TSetUpIdleModeTextV5Pckg. For Symbian OS version 9.4, use RSat::TSetUpIdleModeTextV6Pckg. For later versions of Symbian OS, check for an updated API (RSat::TSetUpIdleModeTextV7 etc).

NotifySetUpMenuPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySetUpMenuPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a SET UP MENU proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is competed. Unpack the command to examine its contents.

The SET UP MENU command provides a set of menu items to be integrated with the phone's menu system. The user can choose one of these menu items at their own discretion. The command is described fully in ETSI TS 102 223. Briefly, though, the command includes:

Once you have integrated the menu (but before the user has made a selection), you must give your response to the SET UP MENU command. For Symbian OS versions up to and including v8.1a and v8.1b pass RSat::TerminalRsp() a RSat::TSetUpMenuRspV1Pckg (a packaged TGetInputRspV1 ). For later versions of Symbian OS, check for an updated API (RSat::TSetUpMenuRspV2 etc).

If the user chooses a menu item then inform the UICC with RSat::MenuSelection() . This includes the identifier of the chosen menu item.

You may receive a SET UP MENU command with no menu! This means that the menu from the previous SET UP MENU command should be removed; see RSat::TMenuItemBaseV1::IsRemoveMenu() .

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. Use a packaged version of the latest "TSetUpMenu" class. For Symbian OS 7.0s, 8.0 and 8.1 use RSat::TSetUpMenuV2Pckg, a packaged RSat::TSetUpMenuV2. For Symbian OS version 9.2, use RSat::TSetUpMenuV5. Use RSat::TSetUpMenuV1 with some older versions of Symbian OS. For later versions of Symbian OS, check for an updated API (RSat::TSetUpMenuV6 etc).

NotifySetUpMenuPCmdCancel()

IMPORT_C void NotifySetUpMenuPCmdCancel ( ) const

Cancels notification for a SET UP MENU proactive command.

NotifySmsPpDownload(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySmsPpDownload ( TRequestStatus & aReqStatus,
TDes8 & aSmsPpDownload
) const

This notification completes when a client (not necessarily the SAT client) requests a SMS-PP data download. Upon completion the envelope command details will be returned in a RSar::TSmsPpDownloadV3Pckg, a packaged version of the RSat::TSmsPpDownloadV3 class in the aSmsPpDownload.

capability
NetworkControl
capability
ReadUserData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
TDes8 & aSmsPpDownload RSat::TSmsPpDownloadV3 packaged in a RSat::TSmsPpDownloadV3Pckg

NotifySubmitMultimediaMsgPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifySubmitMultimediaMsgPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

The SUBMIT MULTIMEDIA MESSAGE command tells the phone to Submit a Multimedia file to the Network.

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

This asynchronous request is a notifier that completes when the UICC issues a SUBMIT MULTIMEDIA MESSAGE PCmd. Upon completion the proactive command details will be returned in a packaged version of TSubmitMultimediaMessageV6 in the aPCmd parameter.

To cancel a previously placed RSat::NotifySubmitMultimediaMsgPCmd request, call RTelSubSessionBase::CancelAsyncRequest(ESatNotifySubmitMultimediaMsgPCmd)

Once you have dealt with the command, you must give your response to the UICC. In Symbian OS versions beginning from 9.4, pass RSat::TerminalRsp() a RSat::TSubmitMultimediaMessageRspV6Pckg (a packaged RSat::TSubmitMultimediaMessageRspV6 ). For later versions of Symbian OS, check for an updated API (RSat::TSubmitMultimediaMessageRspV7 etc).

capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
TDes8 & aPCmd RSat::TSubmitMultimediaMessageV6, packaged into RSat::TSubmitMultimediaMessageV6Pckg

NotifyTimerExpiration(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyTimerExpiration ( TRequestStatus & aReqStatus,
TDes8 & aTimerExpiration
) const

The phone provides timers for the UICC. Using the TIMER MANAGEMENT proactive command, the UICC can start, stop and read the current value of a timer. Receive these commands with RSat::NotifyTimerMgmtPCmd() , then start, stop or read a timer as requested. Timers are started with a particular value. When this counts down to zero, send a TIMER EXPIRATION envelope command to the UICC with RSat::NotifyTimerExpiration() .

Each TIMER MANAGEMENT proactive command includes an ID that identifiers the timer. You must manage up to 8 timer for the UICC. When a timer expires, pass the ID of the timer to the UICC in aTimerExpiration.

Support for this command is only available from v7.0s of Symbian OS onwards.

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TDes8 & aTimerExpiration Information about the timer that has expired. A RSat::TTimerExpirationV3Pckg, a packaged RSat::TTimerExpirationV3.

NotifyTimerMgmtPCmd(TRequestStatus &, TDes8 &)

IMPORT_C void NotifyTimerMgmtPCmd ( TRequestStatus & aReqStatus,
TDes8 & aPCmd
) const

This method requests notification when a TIMER MANAGEMENT proactive command is sent by the UICC. When the request completes, the command is placed into aPCmd and the aReqStatus is completed. Unpack the command to examine its contents.

Support for this command is only available from v7.0s of Symbian OS onwards.

The phone provides timers for the UICC. Using proactive commands, the UICC can start, stop and read the current value of timers. Timers are started with a particular value. When this counts down to zero, send a Timer Expiration envelope command to the UICC; see RSat::NotifyTimerExpiration() . You must manage up to 8 timers for the UICC.

The command is described fully in ETSI TS 102 223, 3GPP2 C.S0035-0 and 3GPP TS 31.111. Briefly, though, TIMER MANAGEMENT commands are of three types:

Each command includes a timer identifier, RSat::TTimerMgmtV3::iTimerId , so that you know which timer to use.

After you have tried to stop, start or read a timer, respond to the UICC as follows: In Symbian OS versions 7.0s, 8.1a & 8.1b, pass RSat::TerminalRsp() a RSat::TTimerMgmtRspV3Pckg (a packaged TTimerMgmtRspV3 ). For later versions of Symbian OS, check for an updated API (RSat::TTimerMgmtRspV4 etc).

Parameters

TRequestStatus & aReqStatus The aReqStatus is completed when the proactive command is received
TDes8 & aPCmd When the request completes, this buffer will contain the proactive command. aPCmd must be a packaged version of the latest "TTimerMgmt" class. For Symbian OS versions up to and including v8.1a and 8.1b use RSat::TTimerMgmtV3Pckg, a packaged RSat::TTimerMgmtV3. For later versions of Symbian OS, check for an updated API (RSat::TTimerMgmtV4 etc).

NotifyTsyStateUpdated(TRequestStatus &, TPCmd &)

IMPORT_C void NotifyTsyStateUpdated ( TRequestStatus & aReqStatus,
TPCmd & aPCmd
) const

This notification completes when the TSY has finished its handling of a proactive command. This should be used for proactive commands that are handled by the TSY and not by the ETelSat client. It informs the ETelSat client when the TSY has completed the required actions of the command.

capability
None

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TPCmd & aPCmd Upon completion, aPcmd contains an RSat::TPCmd indicating the proactive command that has completed.

Open(RPhone &)

IMPORT_C TInt Open ( RPhone & aPhone )

This method opens the RSat interface.

You must have previously opened an interface to the phone (either an RPhone or EMobilePhone). Pass the phone session to RSat::Open() .

After opening the RSat session:

RSat::Close()
capability
None

Parameters

RPhone & aPhone A phone session (either an RPhone or EMobilePhone).

RefreshAllowed(TRequestStatus &, const TDesC8 &)

IMPORT_C void RefreshAllowed ( TRequestStatus & aReqStatus,
const TDesC8 & aRefreshAllowedRsp
) const

This method allows client to report whether refresh can be carried out. This is intended to be used only by the SAT engine.

See RSat::NotifyRefreshPCmd() for more information.

capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
const TDesC8 & aRefreshAllowedRsp Indication that successful refresh can be carried out or nature of error if not

SendMessageNoLogging(TRequestStatus &, const TDesC8 &, TUint16 &)

IMPORT_C void SendMessageNoLogging ( TRequestStatus & aReqStatus,
const TDesC8 & aMsg,
TUint16 & aMsgRef
) const

This method sends a SAT SMS without it being logged.

See RSat::NotifySendSmPCmd() for more information.

capability
NetworkServices
capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
const TDesC8 & aMsg TSatSmsV1 packaged into a descriptor, TSatSmsV1Pckg.
TUint16 & aMsgRef

TerminalRsp(TRequestStatus &, TPCmd, const TDesC8 &)

IMPORT_C void TerminalRsp ( TRequestStatus & aReqStatus,
TPCmd aPCmd,
const TDesC8 & aRsp
) const

This method replies to a proactive command. The reply is sent to the UICC. This is a generic method which replies to every proactive command.

Each type of proactive command requires a different response. There are classes to implement the responses for the different commands. To respond to a command, create an instance of the appropriate class, fill in the fields, and then package the object. Then pass the package and the associated proactive command type to RSat::TerminalRsp() .

capability
NetworkControl

Parameters

TRequestStatus & aReqStatus This method is asynchronous. aReqStatus indicates when the operation has completed.
TPCmd aPCmd The type of proactive command that you are responding to.
const TDesC8 & aRsp Packaged response object associated with the proactive command type.

UsatClientReadyIndication()

IMPORT_C TInt UsatClientReadyIndication ( ) const

Indicates that you are ready to receive proactive commands from the UICC. Do not call this until:

  • You have requested notification to receive proactive commands (see the RSat::Notify.... functions).

capability
NetworkControl

UssdDataDownload(TRequestStatus &, const TDesC8 &)

IMPORT_C void UssdDataDownload ( TRequestStatus & aReqStatus,
const TDesC8 & aDes
) const

This method allows the client to pass a USSD packet to the UICC upon receiving the USSD packet intended for the UICC. The USSD Data Download ENVELOPE command details are passed in the packaged version of TUssdDataDownloadV6 class in the aDes parameter

The command is described fully in 3GPP TS 31.111. Note that it does not appear in ETSI TS 102 223. It contains:

To cancel a previously placed RSat::UssdDataDownload request, call RTelSubSessionBase::CancelAsyncRequest(ESatUssdDataDownload)

capability
NetworkControl
capability
WriteUserData

Parameters

TRequestStatus & aReqStatus TRequestStatus result code after the asynchronous call completes
const TDesC8 & aDes

Member Enumerations Documentation

Enum TActionOriginator

Specifies to the client who should perform the modified action: the client side or the ME Side.

Enumerators

EActionOriginatorNotSet

Initialization value used within constructor(s) or if the call control does not require a new action to be performed.

EClientOriginator

The client is responsible for performing the action described in the call control class.

EMeSideOriginator

The ME Side is responsible for performing the action described in the call control class. The client side should still display any provided alpha identifier.

Enum TAdditionalInfoType

All proactive commands require a response from you to the UICC via the RSat::TerminalRsp() method. Some require a descriptor containing 'additional information', RSat::TAdditionalInfo . The information in this descriptor will depend upon the type of proactive command to which you are responding; see the description of each proactive command.

Besides returning the descriptor, you must indicate the type of additional information by returning a value from RSat::TAdditionalInfoType .

RSat::TAdditionalInfo RSat::TerminalRsp()

Enumerators

KNoAdditionalInfo = 0x0001
KMeProblem = 0x0002
KSatNetworkErrorInfo = 0x0004

The additional information, in this case, consists of the error code returned by the network. The error code returned by the network is available to the client, as it is passed up to the client in the extended GSM error code as a response to a SET UP CALL, a SEND SS, a SEND SHORT MESSAGE, SEND USSD or SEND DTMF.

KControlInteraction = 0x0008
KSendSsInfo = 0x0010
KTextString = 0x0020
KItemIdentifier = 0x0040
KCallControlRequestedAction = 0x0080
KRApdu = 0x0100
KCardATR = 0x0200
KATResponse = 0x0400
KChannelData = 0x0800
KChannelStatusInfo = 0x1000
KServiceAvailability = 0x2000
KCardReaderInfo = 0x4000
KLocalInformation = 0x8000
KTimerMgmt = 0x10000
KPollingIntv = 0x20000
KServiceRecord = 0x40000
KFramesInfo = 0x80000

Enum TAlphaIdStatus

Indicates the status of the alpha ID to the client. It can be present or not present. If it is present, then it can contain data (typically text) or it can be a null object. RSat::TAlphaId

Enumerators

EAlphaIdNotSet
EAlphaIdProvided
EAlphaIdNull
EAlphaIdNotPresent

Enum TAlphaIdValidity

Indicates the validity of the alpha ID from RSat::TCallControlV1::GetAlphaId() .

Enumerators

EAlphaIdValidityNotSet
EValidAlpaId
ENullAlphaId
ENoAlphaId

Enum TBCRepeatIndicator

Bearer Capability Repeat Indicator.

RMobileCall::TBCRepeatIndicator

Enumerators

EBCAlternateMode
EBCSequentialMode
EBCFallbackMode
EBCServiceChangeAndFallbackMode

Enum TBearerIndProtoError

Addition information provide to the UICC in response to proactive commands. A value from this enumeration should be provided when the general response to a command is RSat::KBearerIndepProtocolError Set the additional information type to RSat::KMeProblem .

Enum values are dictated by ETSI TS 102 223; see the description of the 'Result' data objects.

Enumerators

KNoSpecificBIPError = 0x00
KNoChannelAvailable = 0x01
KChannelClosed = 0x02
KChannelIdNotValid = 0x03
KBufferSizeNotAvailable = 0x04
KSecurityError = 0x05
KTranportLevelNotAvailable = 0x06
KRemoteDeviceNotReachable = 0x07
KServiceError = 0x08
KServiceIdUnknown = 0x09
KPortNotAvailable = 0x10

Enum TBearerType

Part of an OPEN CHANNEL proactive command. Used by RSat::TBearer . Defines the bearer type that you should use to open the channel. RSat::TOpenChannelBaseV2

Enumerators

EBearerTypeNotSet
ECSDBearer
EGPRSBearer
EDefaultBearer
EBTBearer
EIrDaBearer
ERS232Bearer
EUSBBearer
EUtranBearer

Enum TBrowserBearer

Enumerators

KSmsBearer = 0x00
KCsdBearer = 0x01
KUssdBearer = 0x02
KGprsBearer = 0x03

Enum TBrowserError

Addition information provide to the UICC in response to proactive commands. A value from this enumeration should be provided when the general response to a command is RSat::KLaunchBrowserError . Set the additional information type to RSat::KMeProblem .

Enumerators

KNoSpecificBrowserError = 0x00
KBearerUnvailable = 0x01
KBrowserUnavailable = 0x02
KMeUnableToReadProvisioningData = 0x04

Enum TBrowserIdentity

Part of the LAUNCH BROWSER proactive command. RSat::TLaunchBrowserV2

Enumerators

EBrowserIdNotSet
EBrowserIdNotPresent
EDefaultBrowser
EBrowserIdNotSpecified
EWMLBrowser
EHTMLBrowser
EXHTMLBrowser
ECHTMLBrowser

Enum TBrowserSelection

Part of the LAUNCH BROWSER proactive command. It describes the browser to use. RSat::TLaunchBrowserV2

Enumerators

EBrowserSelectionNotSet
ELaunchBrowserIfNotAlreadyLaunched
EUseExistingBrowser
ECloseExistingLaunchNewBrowserSession

Enum TBrowserTerminationCause

Describes the reason that the browser terminated. This for use with RSat::TBrowserTerminationEventV2 .

Enumerators

EUnknownCause
EUserTermination
EErrorTermination

Enum TCallControlType

Describes the type of call control request. Used by RSat::TCallControlV1::GetCallControlType() .

Enumerators

ECcTypeNotSet
ECcAddress
ECcSsString
ECcUssdString
ECcPDPParameters

Enum TCallParamOrigin

The originator of a call.

This list of enumerations matches RMobileCall::TCallParamOrigin in Etelmm.

RMobileCall::TCallParamOrigin

Enumerators

EOriginatorUnknown
EOriginatorSIM
EOriginatorEtelClient
EOriginatorExternal

Enum TCcInteractionError

Addition information provide to the UICC in response to proactive commands. A value from this enumeration should be provided when the general response to a command is RSat::KInteractionWithCCPermanentError . Set the additional information type to RSat::KMeProblem .

Enum values are dictated by ETSI TS 102 223; see the description of the 'Result' data objects.

Enumerators

KNoSpecificInteractionError = 0x00
KActionNotAllowed = 0x01
KRequestTypeChanged = 0x02

Enum TClearScreenTrigger

Part of a DISPLAY TEXT proactive command. After the text has been displayed, this determines the events that clear the text or icon. RSat::TDisplayTextV1 RSat::NotifyDisplayTextPCmd() RSat::TDisplayMultimediaMessageV6 RSat::NotifyDisplayMultimediaMsgPCmd()

Enumerators

EClearScreenTriggerNotSet
EClearAfterDelay

Clear screen after a specified delay. The UICC may specify the delay in RSat::TDisplayTextV2::iDuration . Otherwise the delay is at your discretion.

EUserClear

Enum TControlResult

Describes the result of call control request, and hence the action required. Used by RSat::TCallControlV1::GetCcGeneralResult() and RSat::TCallControlV1::SetCcGeneralResult() .

Enumerators

EControlResultNotSet

Initialization value used within constructor(s).

EAllowedNoModification

The action has been allowed by the ICC with no modification. However, the call control params might contain an alpha identifier to be displayed to the user; call RSat::TCallControlV1::GetAlphaId() to get the alpha ID (a RSat::TAlphaId ) and the alpha ID's validity (an RSat::TAlphaIdValidity ).

ENotAllowed

The action has not been allowed by the ICC. However, the call control params might contain an alpha identifier to be displayed to the user; call RSat::TCallControlV1::GetAlphaId() to get the alpha ID (a RSat::TAlphaId ) and the alpha ID's validity (an RSat::TAlphaIdValidity )

EAllowedWithModifications

The action has been allowed by the ICC with modifications. The call control params contain new modified params.

It may also contain an alpha identifier to be displayed to the user; call RSat::TCallControlV1::GetAlphaId() to get the alpha ID (a RSat::TAlphaId ) and the alpha ID's validity (an RSat::TAlphaIdValidity )

Enum TDeviceId

Some proactive commands are aimed at particular devices. The device will be on of those defined here.

Enumerators

KDeviceIdNotSet = -1
KKeypad = 0x01
KDisplay = 0x02
KEarPiece = 0x03
KAdditionalCardReader0 = 0x10
KAdditionalCardReader1 = 0x11
KAdditionalCardReader2 = 0x12
KAdditionalCardReader3 = 0x13
KAdditionalCardReader4 = 0x14
KAdditionalCardReader5 = 0x15
KAdditionalCardReader6 = 0x16
KAdditionalCardReader7 = 0x17
KChannel1 = 0x21
KChannel2 = 0x22
KChannel3 = 0x23
KChannel4 = 0x24
KChannel5 = 0x25
KChannel6 = 0x26
KChannel7 = 0x27
KUICC = 0x81
KME = 0x82
KNetwork = 0x83

Enum TDisplayPriority

Enumerators

EDisplayPriorityNotSet
ENormalPriority
EHighPriority

Enum TElementaryFiles

TElementaryFile specifies the EFs that can be modified over the air by the network or by the (U)SIM application toolkit on the (U)ICC. This is provided in this API for ease of use.

Files that can not be modified are not mentioned in the following constants. Other files that do not have a specified file number are not mentioned either (mostly the file starting with 0x4F).

It is assumed that unless stated otherwise the following file ids are valid for both GSM /WCDMA ICCs and CDMA RUIM. It has not been possible to define which of the CDMA EFs can be refreshed.

The enum values of TElementaryFiles are derived directly from ETSI 11.14, 3GPP TS 31.102 (Annex A) & 3GPP TS 31.103 (Annex A).

Enumerators

KUnknownEf = 0x2000
KDirEf = 0x2F00
KElpEf = 0x2F05
KArrEf = 0x2F06
KImgEf = 0x4F20
KPscEf = 0x4F22
KCcEf = 0x4F23
KPuidEf = 0x4F24
KPbr = 0x4F30
KSllEf = 0x4F31
KMmlEf = 0x4F47
KMmdfEf = 0x4F48
KInvScan = 0x4F64
KImpiEf = 0x6F02
KImpuEf = 0x6F03
KDomainEf = 0x6F04
KLpEf = 0x6F05
KArradEf = 0x6F06
KImsiEf = 0x6F07
KCsp1Ef = 0x6F15
KDckEf = 0x6F2C
KPlmnSelEf = 0x6F30
KHplmnEf = 0x6F31
KCnlEf = 0x6F32
KAcmMaxEf = 0x6F37
KSstEf = 0x6F38
KAcmEf = 0x6F39
KAdnEf = 0x6F3A
KFdnEf = 0x6F3B
KSmsEf = 0x6F3C
KCcpEf = 0x6F3D
KGid1Ef = 0x6F3E
KGid2Ef = 0x6F3F
KMsisdnEf = 0x6F40
KPuctEf = 0x6F41
KSmspEf = 0x6F42
KSmssEf = 0x6F43
KLndEf = 0x6F44
KCbmiEf = 0x6F45
KSpnEf = 0x6F46
KSmsrEf = 0x6F47
KCbmidEf = 0x6F48
KSdnEf = 0x6F49
KExt1Ef = 0x6F4A
KExt2Ef = 0x6F4B
KExt3Ef = 0x6F4C
KBdnEf = 0x6F4D
KExt5Ef = 0x6F4E
KCcp2Ef = 0x6F4F
KCbmirEf = 0x6F50
KNiaEf = 0x6F51
KLociGprsEf = 0x6F53
KSumeEf = 0x6F54
KExt4Ef = 0x6F55
KEstEf = 0x6F56
KAclEf = 0x6F57
KCmiEf = 0x6F58
KStartHfnEf = 0x6F5B
KThresholdEf = 0x6F5C
KOPlmnwAcTEf = 0x6F61
KHPlmnwAcTEf = 0x6F62
KRplmnActEf = 0x6F65
KPsLociEf = 0x6F73
KAccEf = 0x6F78
KFPlmnEf = 0x6F7B
KIciEf = 0x6F80
KOciEf = 0x6F81
KIctEf = 0x6F82
KOctEf = 0x6F83
KCsp2Ef = 0x6F98
KAdEf = 0x6FAD
KPhaseEf = 0x6FAE
KVcgsEf = 0x6FB1
KVgcssEf = 0x6FB2
KVbsEf = 0x6FB3
KVbssEf = 0x6FB4
KeMlppEf = 0x6FB5
KAaemef = 0x6FB6
KEccEf = 0x6FB7
KGmsi = 0x6FC2
KHiddenKeyEf = 0x6FC3
KPnnEf = 0x6FC5
KOplEf = 0x6FC6
KMbdnEf = 0x6FC7
KExt6Ef = 0x6FC8
KMbiEf = 0x6FC9
KMwisEf = 0x6FCA
KCfisEf = 0x6FCB
KExt7Ef = 0x6FCC
KSpdiEf = 0x6FCD
KMmsnEF = 0x6FCE
KExt8Ef = 0x6FCF
KMmsicpEf = 0x6FD0
KMmsupEf = 0x6FD1
KMmsucpEf = 0x6FD2
KNiaRel5Ef = 0x6FD3
KVgcscaEf = 0x6FD4
KVbscaEf = 0x6FD5
KGbabpEf = 0x6FD6
KMsklEf = 0x6FD7
KMukEf = 0x6FD8
KGbanlEf = 0x6FDA

Enum TEventList

These flags form the list of events in a SET UP EVENT LIST proactive command. They are also used in Event Download envelope commands to identify the event that you are reporting to the UICC.

RSat::NotifySetUpEventListPCmd() RSat::EventDownload()

Enumerators

KMTCall = 0x00001
KCallConnected = 0x00002
KCallDisconnected = 0x00004
KLocationStatus = 0x00008
KUserActivity = 0x00010
KIdleScreenAvailable = 0x00020
KCardReaderStatus = 0x00040
KLanguageSelection = 0x00080
KBrowserTermination = 0x00100
KDataAvailable = 0x00200
KChannelStatus = 0x00400
KAccessTechnologyChange = 0x00800
KDisplayParamsChanges = 0x01000
KLocalConnection = 0x02000
KNetworkSearchModeChange = 0x04000
KBrowsingStatusChange = 0x08000
KFramesInformationChange = 0x10000

Enum TFramesError

Addition information provide to the UICC in response to proactive commands. A value from this enumeration should be provided when the general response to a command is RSat::KFramesError Set the additional information type to RSat::KMeProblem .

Enum values are dictated by ETSI TS 102 223; see the description of the 'Result' data objects.

Enumerators

KNoSpecificCauseCanBeGiven = 0x00
KFrameIdentifierIsNotValid = 0x01
KNumberOfFramesExceeded = 0x02
KNoFrameIdentified = 0x03
KRequestSizeNotSupported = 0x04
KDefaultActiveFrameIsNotValid = 0x05

Enum TFramesLayout

This enum structure gives us the format of the Frame layout. RSat::TFrameLayout RSat::TSetFramesV6

Enumerators

EFrameHorizontal = 0x01
EFrameVertical = 0x02

Enum TFramesSeparator

Enumerators

EFrameSeparatorNotSet
EFrameSeparatorDrawn
EFrameSeparatorNotDrawn

Enum TGetInkeyRspFormat

Part of the GET INKEY proactive command. This tells you what response to get from the user. RSat::TGetInkeyV1 RSat::NotifyGetInkeyPCmd()

Enumerators

EGetInkeyRspFormatNotSet
EDigitOnly
ECharSmsDefaultAlphabet
ECharUcs2Alphabet
EYesNo

Enum TGetInkeyRspMode

Part of the GET INKEY proactive command. Determines how you get the response from the user. RSat::TGetInkeyV1 RSat::NotifyGetInkeyPCmd()

Enumerators

EGetInkeyRspModeNotSet
EUserRspDisplayed

Display character that the user chooses. You may allow the user to alter and/or confirm their choice before passing the character back to the UICC.

EImmediateDigitRsp

An immediate response is requested. The response must be a digit (0- 9, *, #, and +). Do not display the digit, and do not allow the user to alter or confirm their choice before returning the digit to the UICC.

Enum TGetInputRspFormat

Part of the GET INPUT proactive command. Determines the format of the string returned to the UICC. RSat::TGetInputV1 RSat::TGetInputV5 RSat::NotifyGetInputPCmd()

Enumerators

EGetInputRspFormatNotSet
EDigitOnlyUnpacked
EDigitOnlyPacked
ESmsDefaultAlphabetUnpacked
ESmsDefaultAlphabetPacked
EUcs2Alphabet

Enum TGetReaderStatusMode

Part of a GET READER STATUS proactive command. Describes the information that the UICC is requesting. RSat::TGetReaderStatusV2

Enumerators

ECardReaderModeNotSet
ECardReaderStatus
ECardReaderIdentifier

Enum THelp

The UICC may offer help to accompany a GET INKEY, GET INPUT, SET UP MENU or SELECT ITEM proactive command. This help is normally text for the phone's user.

Below are links to four member functions. They request notification for the GET INKEY, GET INPUT, SET UP MENU or SELECT ITEM proactive commands. When they complete, an object is returned containing the proactive command's details. This includes an RSat::THelp that states whether help is available for the command.

It is up to you whether you tell the user that help is available, and whether to display the help should the user ask for it. The proactive command does not contain the help; it only indicates whether help is available with RSat::THelp . The process of getting help depends upon the proactive command; see the links to the member functions below for details.

RSat::NotifyGetInkeyPCmd() RSat::NotifyGetInputPCmd() RSat::NotifySetUpMenuPCmd() RSat::NotifySelectItemPCmd()

Enumerators

EHelpNotSet
EHelpAvailable
ENoHelpAvailable

Enum THelpRequest

Part of a MENU SELECTION envelope command in response to a SET UP MENU proactive command. Indicates whether help is required with the user's menu selection. RSat::TMenuSelectionV1

Enumerators

EHelpRequestNotSet
EHelpRequested
EHelpNotRequested

Enum TIconQualifier

Included in each type of proactive command that can support icons. It describes the icon, if there is one.

RSat::TIconId RMobileCall::TIconQualifier

Enumerators

EIconQualifierNotSet
ENoIconId
ESelfExplanatory
ENotSelfExplanatory

Enum TImageCoding

Coding used for icons. RSat::TInstanceInfoV3 .

Enumerators

KBasic = 0x11
KColour = 0x21

Enum TImmediateRsp

Enumerators

EImmediateRspNotSet
EImmediateRsp
ENoImmediateRsp

Enum TInputDisplayOption

Part of the GET INPUT proactive command. Deetermine whether you display the user's string while they are entering it. RSat::TGetInputV1 RSat::TGetInputV5 RSat::NotifyGetInputPCmd()

Enumerators

EInputDisplayOptionNotSet
EDisplayUserInput
EHideUserInput

Enum TLanguageNotificationType

Part of the LANGUAGE NOTIFICATION proactive command. Determines whether the UICC is specifying its current language in iLanguage, or is saying that it is not using a specific language. RSat::TLanguageNotificationV2

Enumerators

ENotificationTypeNotSet
ENonSpecificLangNotification

No specific language is in use by the UICC. This has the effect of cancelling previous specific LANGUAGE NOTIFICATION commands.

ESpecificLangNotification

The language currently in use by the UICC is given in RSat::TLanguageNotificationV2::iLanguage .

Enum TLinkEstablishment

Part of an OPEN CHANNEL proactive command. Should the channel be opened now, or should you wait until you are given some data to send? RSat::TOpenChannelBaseV2

Enumerators

ELinkEstablishmentNotSet
EOnDemand
EImmediate

Enum TLocaInfomationType

Part of a PROVIDE LOCAL INFORMATION proactive command This describes the information that you should provide to the UICC.

The format of the information depends upon the network on which the phone is running. For GSM/WCDMA networks, read 3GPP TS 31.111; for CDMA networks read 3GPP2 C.S0035-0. ETSI TS 102 223 provides generic information about the PROVIDE LOCAL INFORMATION command. RSat::TLocalInfoV3 .

Enumerators

KProvideLocalInfo = 0x00

Location information & phone identity UICC: MCC, MNC, LAC, Cell ID

KProvideLocalInfoImei = 0x01
KProvideLocalInformationNmr = 0x02
KProvideLocalInfoDateTimeTimeZone = 0x03
KProvideLocalInfoLanguage = 0x04
KProvideLocalInfoTimingAdv = 0x05
KProvideLocalInfoAccTech = 0x06
KProvideLocalInfoESN = 0x07
KProvideLocalInfoIMEISV = 0x08
KProvideLocalInfoSearchMode = 0x09
KProvideLocalInfoChargeStateOfBattery = 0x0A
KProvideLocalInfoMEID = 0x0B

Enum TLocalBearerId

Identifies the physical method of transferring data.

Enumerators

ELocalBearerIdNotSet
ELocalBearerIdNotPresent
ETechnologyIndependent
ELocalBearerBT
ELocalBearerIrda
ELocalBearerRs232
ELocalBearerUsb

Enum TMeProblem

Addition information provide to the UICC in response to proactive commands. A value from this enumeration should be provided when the general response to a command is RSat::KMeUnableToProcessCmd Set the additional information type to RSat::KMeProblem .

Enum values are dictated by 3GPP 31.111 and ETSI TS 102 223; see the description of the 'Result' data objects.

Enumerators

KNoSpecificMeProblem = 0x00
KScreenBusy = 0x01
KMeBusyOnCall = 0x02
KMeBusyOnSs = 0x03
KNoService = 0x04
KAccBar = 0x05
KRadioRessourceNotGranted = 0x06
KNotInSpeechCall = 0x07
KMeBusyOnUssd = 0x08
KMeBusyOnSendDtmf = 0x09
KNoUSIMActive = 0x0A

Enum TMenuContent

Part of the SELECT ITEM and SET UP MENU proactive commands. Flags describing a menu's content. RSat::TMenuItemBaseV1::MenuContent() returns a combination of these flags.

Enumerators

KItems = 0x01
KItemNextActions = 0x02
KItemIconIds = 0x04
KItemTextAttributes = 0x08

Enum TMultipleCardError

Addition information provide to the UICC in response to proactive commands. A value from this enumeration should be provided when the general response to a command is RSat::KMultipleCardCmdsError . Set the additional information type to RSat::KMeProblem .

Enum values are dictated by ETSI TS 102 223; see the description of the 'Result' data objects.

Enumerators

KNoSpecificMultiCardError = 0x00
KNoCardReader = 0x01
KNoCard = 0x02
KCardReadyBusy = 0x03
KCardPoweredOff = 0x04
KCApduFormatError = 0x05
KMuteCard = 0x06
KTransmissionError = 0x07
KProtocolNotSupported = 0x08
KSpecifiedReaderNotValid = 0x09

Enum TNetworkSearchMode

Enumerators

EUnknown
EManual
EAutomatic

Enum TNumberingPlan

Numbering plan, part of a complete telephone number address along with the type of number and the number's digits.

RSat::TAddress RSat::TSsString

Enumerators

ENumberingPlanNotSet
EUnknownNumberingPlan
EIsdnNumberPlan
EDataNumberPlan
ETelexNumberPlan
EServiceCentreSpecificPlan1

The service centre specific plan is used to indicate a numbering plan specific to External Short Message Entities attached to the SMS centre.

EServiceCentreSpecificPlan2

The service centre specific plan is used to indicate a numbering plan specific to External Short Message Entities attached to the SMS centre.

ENationalNumberPlan
EPrivateNumberPlan
EERMESNumberPlan

Enum TOpenChannelType

Part of an OPEN CHANNEL proactive command. There are three types of OPEN CHANNEL command described in ETSI TS 102 223, 3GPP TS 31.111 and 3GPP2 C.S0035-0. RSat::TOpenChannelType is set to the type of command. RSat::TOpenChannelBaseV2 RSat::NotifyOpenChannelPCmd()

Enumerators

EPCmdTypeNotSet
ECsBearer
EGprsBearer
ELocalLinksBearer
EAnyBearer
EUiccServerMode

Enum TOtherAddressType

Part of an OPEN CHANNEL proactive command. Used by RSat::TOtherAddress . Defines the type of the IP addresses used when opening a channel. RSat::TOpenChannelBaseV2

Enumerators

EAddressNotSet
EAddressNotPresent
EIPv4Address
EIPv6Address

Enum TPCmd

Enumeration containing proactive commands for use with the RSat::TerminalRsp() , RSat::NotifyTsyStateUpdated() and RTelSubSessionBase::CancelAsyncRequest() methods only. Members of this enumeration do not have the same value as the proactive command codes in 3GPP TS 31.111 and ETSI TS 102 223.

Enumerators

EDisplayText
EGetInkey
EGetInput
EPlayTone
ERefresh
ESelectItem
ESendDtmf
ESendSm
ESendSs
ESendUssd
ESetUpCall
ESetUpEventList
ESetUpIdleModeText
ESetUpMenu
EPerformCardApdu
EPowerOffCard
EPowerOnCard
EGetReaderStatus
ERunAtCommand
ELanguageNotification
ELaunchBrowser
EOpenChannelCs
EOpenChannelGprs
EOpenChannelLocal
ECloseChannel
EReceiveData
ESendData
EGetChannelStatus
EDeclareService
EServiceSearch
EGetServiceInformation
ETimerMngt
ELocalInfo
EPollingInterval
EPollingOff
ERetrieveMultimediaMsg
ESubmitMultimediaMsg
EDisplayMultimediaMsg
ESetFrames
EGetFramesStatus
EOpenChannelUiccServerMode

Enum TPCmdResult

General Result of a proactive command.

All proactive commands require a response from you to the UICC via the RSat::TerminalRsp() method. When you send a response, include a value from this enumeration to indicate the level of success or failure. Some of these values require additional information to be returned to the UICC, too. For instance, you cannot return just RSat::KMeUnableToProcessCmd , you must return a value from RSat::TMeProblem , too. The description of each proactive command in 3GPP 31.111 and ETSI TS 102 223 will tell you what you need to return.

The values KSuccess to KUssdTransactionTerminatedByUser indicate that the proactive command was successful. It can be either completely or partially successful.

The values from KMeUnableToProcessCmd to KLaunchBrowserError indicate temporary errors. The UICC may make another attempt by resending the proactive command.

The values from KCmdBeyondMeCapabilities onwards are permanent errors. Use them to tell the UICC that the command cannot be executed at all.

TPCmdResult enum values are dictated by 3GPP 31.111 and ETSI TS 102 223; see the description of the 'Result' data object.

Enumerators

KPCmdResultNotSet = -1
KSuccess = 0x00

Command performed successfully. There were no problems.

KPartialComprehension = 0x01

Command performed with partial comprehension; see 'Command results' in ETSI TS 102 223.

KMissingInformation = 0x02

Command performed, with missing information. Use when you received a minimum set of components but you believe some components to be missing.

KRefreshAdditionEFRead = 0x03

REFRESH performed with additional EFs read.

KSuccessRequestedIconNotDisplayed = 0x04

Command performed successfully but requested icon could not be displayed.

KModifiedByCallControl = 0x05

Command performed, but modified by call control. Use this to indicate that call control modified the type of request indicated in the proactive command, and that the action requested by call control was performed successfully.

KSuccessLimitedService = 0x06

Command performed successfully, limited service.

KPerformedWithModifications = 0x07

Command performed with modification. Use this to indicate that you were unable to process the command using the exact parameters provided, but the command was processed with the best possible parameters.

KRefreshUSIMNotActive = 0x08

REFRESH performed but either the (U)SIM or R-UIM was not active.

KPlayTonePerformedSuccessfully = 0x09

PLAY TONE command performed successfully.

KPSessionTerminatedByUser = 0x10

(U)SAT / CCAT session terminated by the user.

KBackwardModeRequestedByUser = 0x11

Backward move in the (U)SAT / CCAT session requested by the user.

KNoResponseFromUser = 0x12

No response from user.

KHelpRequestedByUser = 0x13

Help information required by the user.

The UICC may offer help to accompany a GET INKEY, GET INPUT, SET UP MENU or SELECT ITEM proactive command. This help is normally text for the phone's user. If you tell the user that help is available, and if they would like the help, then respond with this value.

RSat::THelp

KUssdTransactionTerminatedByUser = 0x14

USSD (Unstructured Supplementary Services Data) session terminated by the user.

KMeUnableToProcessCmd = 0x20

The phone is currently unable to process command.

Besides returning this value, you must return additional information. Return a value from RSat::TMeProblem and set the additional information type to RSat::KMeProblem .

KNetworkUnableToProcessCmd = 0x21

The network is currently unable to process the command.

The network will return a cause value to indicate the problem. These values are defined in the appendices of 3GPP TS 24.008. Set bit 8 of the 8-bit code to 1, then include this code in the 'additional information' field in your response to the UICC. Set the additional information type to RSat::KSatNetworkErrorInfo .

If no cause code is available, set the 'additional information' field to zero.

KPCmdNotAcceptedByUser = 0x22

In some proactive commands, you are required to solicit and receive the user's approval before executing the proactive command. If the user does not give approval then you should not execute it, and you should give this response to the UICC.

KCallClearedBeforeConnectionOrReleased = 0x23

The user cleared down the call before the call connected or before the network released the call.

KContradictionWithTimerState = 0x24

Use this code when the UICC requests an action for a timer to be taken by the terminal and the state of the timer does not allow that action.

KInteractionWithCCTemporaryError = 0x25

Use this to indicate that call control modified the type of request indicated in the proactive command, and that the action requested by call control encounters a temporary problem.

KLaunchBrowserError = 0x26

Error launching the browser.

Besides returning this value, you must return an additional value from RSat::TBrowserError . Set the additional information type to RSat::KMeProblem .

KMMSTemporaryProblem = 0x27

The ME has rejected a RETRIEVE/SUBMIT/DISPLAY MUTIMEDIA MESSAGE proactive command, because it is busy processing some other MMS transaction.

RSat::KMeProblem

KCmdBeyondMeCapabilities = 0x30

Command is beyond your capabilities. You understand what the command is asking you to do, but you do not have the capability to do it. E.g. your code is running on a device that only supports SMS and the command asks you to set up a call.

KCmdTypeNotUnderstood = 0x31

Proactive command type not understood. It is unlikely this will be needed - it is to allow future expansion of commands.

KCmdDataNotUnderstood = 0x32

Command data not understood. You understand the command type is understood but not the accompanying data object(s).

KCmdNumberNotKnown = 0x33

Command number not known.

KSsReturnError = 0x34

The network returns a Supplementary Service (SS) error in response to a previous SS command. Specific cause values are the same as given by the network in the Return Error message.

The network will return an error value given in the Facility information element to indicate the problem. Set bit 8 of the 8-bit code to 1, then include this code in the 'additional information' field in your response to the UICC. Set the additional information type to RSat::KSatNetworkErrorInfo .

If no cause code is available, set the 'additional information' field to zero.

KSmsRpError = 0x35

The network returns an error in response to the phone trying to send a short message.

To indicate the problem, the network will return a cause value in the RP cause element from the RP-ERROR message. Set bit 8 of the 8-bit code to 1, then include this code in the 'additional information' field in your response to the UICC. Set the additional information type to RSat::KSatNetworkErrorInfo .

If no cause code is available, set the 'additional information' field to zero.

KErrorRequiredValuesMissing = 0x36

Required values are missing. You understand the command but one or more required data objects are missing. The specifications defining the (U)SAT and CCAT toolkits define the minimum required objects for each command.

KUssdReturnError = 0x37

The network returns a USSD error in response to a previous USSD command. Specific cause values are the same as given by the network in a Return Error message. This has additional information: the error value given in the Facility information element returned by the network. Set bit 8 of the 8-bit code to 1, then include this code in the 'additional information' field in your response to the UICC. Set the additional information type to RSat::KSatNetworkErrorInfo .

If no cause code is available, set the 'additional information' field to zero.

KMultipleCardCmdsError = 0x38

Multiple card commands error.

Besides returning this value, you must return an additional value from RSat::TMultipleCardError . Set the additional information type to RSat::KMeProblem .

KInteractionWithCCPermanentError = 0x39

Interaction with call control, permanent problem.

Besides returning this value, you must return an additional value from RSat::TCcInteractionError . Set the additional information type to RSat::KMeProblem .

KBearerIndepProtocolError = 0x3A

Bearer Independent Protocol error.

Besides returning this value, you must return an additional value from RSat::TBearerIndProtoError . Set the additional information type to RSat::KMeProblem .

KAccessTechUnableProcessCmd = 0x3B

Access Technology unable to process command.

KFramesError = 0x3C

An error occured while trying to process the SET FRAMES or GET FRAMES STATUS command.

KMMSError = 0x3D

A permanent error occured while trying to process one of the RETRIEVE/SUBMIT/DISPLAY MUTIMEDIA MESSAGE proactive commands.

RSat::KMeProblem

Enum TPresentationType

Part of the SELECT ITEM proactive command. This describes the content of the menu items. This is information is provided to help you display the menu.

Enumerators

EPresentationTypeNotSet
ENotSpecified
EDataValues
ENavigationOptions

Enum TReconnectionMode

Part of an OPEN CHANNEL proactive command. If an attempt to make a connection fails, should you try again automatically? RSat::TOpenChannelBaseV2

Enumerators

EReconnectionModeNotSet
ENoAutomaticReconnection

Reconnection should not be automatic. Do not attempt to reconnect.

EAutomaticReconnection

Reconnection should be automatic. Attempt to reconnect if the first attempt fails. The OPEN CONNECTION command may include a time limit for reconnection attempts.

Enum TRefreshType

Part of a REFRESH proactive command. Indicates the type of REFRESH command sent by the UICC RSat::TRefreshV1

Enumerators

ERefreshTypeNotSet
ESimInitFullFileChangeNotification
EFileChangeNotification
ESimInitFileChangeNotification
ESimInit
ESimReset
EUsimApplicationReset
E3GSessionReset

Enum TRemoteAddressCoding

The coding of the remote entity's address. RSat::TRemoteEntityAddress

Enumerators

ECodingNotSet
E48BitAddress

Enum TSatProfileByte1

Flags for byte 1 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsProfileDownload = 0x01
KCapsSmsPpDataDownload = 0x02
KCapsCbDataDownload = 0x04
KCapsMenuSelection = 0x08
KCaps9EXX = 0x10
KCapsSmsPpDataDownload2 = 0x10
KCapsTimerExpiration = 0x20
KCapsUssdStringInCC = 0x40
KCapsCCByUSim2 = 0x40
KCapsCCByUSim3 = 0x80

Enum TSatProfileByte10

Flags for byte 10 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsSoftKeySelectItem = 0x10
KCapsSoftKeySetUpMenu = 0x20

Enum TSatProfileByte12

Flags for byte 12 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsOpenChannel = 0x01
KCapsCloseChannel = 0x02
KCapsReceiveData = 0x04
KCapsSendData = 0x08
KCapsGetChannelStatus = 0x10
KCapsServiceSearch = 0x20
KCapsGetServiceInfo = 0x40
KCapsDeclareService = 0x80

Enum TSatProfileByte13

Flags for byte 13 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsCsdSupportByMe = 0x01
KCapsGprsSupportByMe = 0x02
KCapsBtSupportByMe = 0x04
KCapsIrdaSupportByMe = 0x08
KCapsRs232SupportByMe = 0x10

Enum TSatProfileByte14

Flags for byte 14 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsScreenSizingParams = 0x80

Enum TSatProfileByte15

Flags for byte 15 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsVariableSizeFonts = 0x80

Enum TSatProfileByte16

Flags for byte 16 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsDisplayResize = 0x01
KCapsTextWrapping = 0x02
KCapsTextScrolling = 0x04
KCapsWidthReductionInMenu = 0x80

Enum TSatProfileByte17

Flags for byte 17 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsTcp = 0x01
KCapsUdp = 0x02
KCapsTcpServerMode = 0x04

Enum TSatProfileByte18

Flags for byte 18 of the terminal profile. RSat::TSatProfileV2

Enumerators

KCapsDisplayTextVariableTimeout = 0x01
KCapsGetInkeyHelp = 0x02
KCapsUsbSupportByMe = 0x04
KCapsGetInkeyVariableTimeout = 0x08
KCapsCallControlOnGprs = 0x20
KCapsProvideLocalInfoIMEISV = 0x40
KCapsProvideLocalInfoSearchModeChange = 0x80

Enum TSatProfileByte2

Flags for byte 2 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsCommandResult = 0x01
KCapsCCBySim = 0x02
KCapsCellIdInCCBySim = 0x04
KCapsCCByUSim4 = 0x04
KCapsMOSMControl = 0x08
KCapsAlphaIdHandling = 0x10
KCapsCCByUSim5 = 0x10
KCapsUcs2Entry = 0x20
KCapsUcs2Display = 0x40
KCapsExtensionTextDisplay = 0x80
KCapsDisplayText2 = 0x80

Enum TSatProfileByte21

Flags for byte 21 of the terminal profile (extended browser capability). RSat::TSatProfileV6

Enumerators

KCapsWML = 0x01
KCapsXHTML = 0x02
KCapsHTML = 0x04
KCapsCHTML = 0x08

Enum TSatProfileByte22

Flags for byte 22 of the terminal profile. RSat::TSatProfileV6

Enumerators

KCapsProvideLocalInfoUTRAN = 0x01
KCapsProvideLocalInfoBatteryState = 0x02
KCapsPlayThemedAndMelodyTone = 0x04
KCapsSetUpCallMultimediaCall = 0x08
KCapsRefreshGBA = 0x10
KCapsRetrieveMultimediaMessage = 0x20
KCapsSubmitMultimediaMessage = 0x40
KCapsDisplayMultimediaMesage = 0x80

Enum TSatProfileByte23

Flags for byte 23 of the terminal profile. RSat::TSatProfileV6

Enumerators

KCapsSetFrames = 0x01
KCapsGetFramesStatus = 0x02
KCapsMmsNotificationDownload = 0x04
KCapsProvideLocalInfoMEID = 0x20
KCapsProvideLocalInfoNmrUTRAN = 0x40
KCapsUssdDataDownload = 0x80

Enum TSatProfileByte24

Bits for byte 24 of the terminal profile.

The first four bits contain the maximum number of frames supported, including frames created within existing frames.

The remaining four bits are RFU

RSat::TSatProfileV6

Enumerators

KCapsMaxNumFramesBit1 = 0x01
KCapsMaxNumFramesBit2 = 0x02
KCapsMaxNumFramesBit3 = 0x04
KCapsMaxNumFramesBit4 = 0x08

Enum TSatProfileByte25

Flags for byte 25 of the terminal profile. RSat::TSatProfileV6

Enumerators

KCapsBrowsingStatusEvent = 0x01
KCapsMmsTransferStatusEvent = 0x02
KCapsFrameParametersChangeEvent = 0x04

Enum TSatProfileByte28

Flags for byte 28 of the terminal profile. RSat::TSatProfileV5

Enumerators

KCapsTextAttributeAlignmentLeft = 0x01
KCapsTextAttributeAlignmentCentre = 0x02
KCapsTextAttributeAlignmentRight = 0x04
KCapsTextAttributeFontSizeNormal = 0x08
KCapsTextAttributeFontSizeLarge = 0x10
KCapsTextAttributeFontSizeSmall = 0x20

Enum TSatProfileByte29

Flags for byte 29 of the terminal profile. RSat::TSatProfileV5

Enumerators

KCapsTextAttributeStyleNormal = 0x01
KCapsTextAttributeStyleBold = 0x02
KCapsTextAttributeStyleItalic = 0x04
KCapsTextAttributeStyleUnderline = 0x08
KCapsTextAttributeStyleStrikethrough = 0x10
KCapsTextAttributeStyleForeground = 0x20
KCapsTextAttributeStyleBackground = 0x40

Enum TSatProfileByte3

Flags for byte 3 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsDisplayText = 0x01
KCapsGetInkey = 0x02
KCapsGetInput = 0x04
KCapsMoreTime = 0x08
KCapsPlayTone = 0x10
KCapsPollInterval = 0x20
KCapsPollingOff = 0x40
KCapsRefresh = 0x80

Enum TSatProfileByte4

Flags for byte 4 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsSelectItem = 0x01
KCapsSendSM = 0x02
KCapsSendSS = 0x04
KCapsSendUSSD = 0x08
KCapsSetUpCall = 0x10
KCapsSetUpMenu = 0x20
KCapsProvideLocalInformation = 0x40
KCapsProvideLocalInformationNMR = 0x80

Enum TSatProfileByte5

Flags for byte 5 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsSetUpEventList = 0x01
KCapsMtCallEvent = 0x02
KCapsCallConnectedEvent = 0x04
KCapsCallDisconnectedEvent = 0x08
KCapsLocationStatusEvent = 0x10
KCapsUserActivityEvent = 0x20
KCapsIdleScreenAvailableEvent = 0x40
KCapsCardReaderStatusEvent = 0x80

Enum TSatProfileByte6

Flags for byte 6 of the terminal profile.

Enumerators

KCapsLanguageSelectionEvent = 0x01
KCapsBrowserTerminationEvent = 0x02
KCapsDataAvailableEvent = 0x04
KCapsChannelStatusEvent = 0x08
KCapsAccTechnoChangedEvent = 0x10
KCapsDisplayParamsChangedEvent = 0x20
KCapsLocalConnectionEvent = 0x40
KCapsNetworkSearchModeChangeEvent = 0x80

Enum TSatProfileByte7

Flags for byte 7 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsPowerOnCard = 0x01
KCapsPowerOffCard = 0x02
KCapsPerformCardApdu = 0x04
KCapsGetReaderStatus = 0x08
KCapsGetReaderStatusId = 0x10

Enum TSatProfileByte8

Flags for byte 8 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsTimerManagementStartStop = 0x01
KCapsTimerManagementGetCurrentValue = 0x02
KCapsProvideLocalInfoDateTimeTimeZone = 0x04
KCapsBinaryChoiceGetInkey = 0x08
KCapsGetInkey2 = 0x08
KCapsSetUpIdleModeText = 0x10
KCapsRunAtCmd = 0x20
KCaps2ndAlphaIdSetUpCall = 0x40
KCapsSetUpCall2 = 0x40
KCaps2ndCapabilityConfigParam = 0x80
KCapsCCByUSim6 = 0x80

Enum TSatProfileByte9

Flags for byte 9 of the terminal profile. RSat::TSatProfileV1

Enumerators

KCapsSustainedDisplayText = 0x01
KCapsDisplayText3 = 0x01
KCapsSendDTMFCmd = 0x02
KCapsProvideLocalInfoBcchCoding = 0x04
KCapsProvideLocalnfoNmr2 = 0x04
KCapsProvideLocalInfoLanguage = 0x08
KCapsProvideLocalInfoTimingAdv = 0x10
KCapsLanguageNotification = 0x20
KCapsLaunchBrowser = 0x40
KCapsProvideLocalInfoAccTech = 0x80

Enum TSatTextCoding

Specifies the text coding scheme for RSat buffers. It may be used in conjunction with any RSat buffer to indicate the coding scheme used. (See ETSI TS 102 223 V5.9.0 section 8.15.)

Enumerators

E7bitPacked

7-bit packed coding

E7bitUnpacked

7-bit unpacked (i.e. 8-bit) coding

E16bitUCS2

16-bit Unicode (UCS-2) coding

Enum TSatVersion

The version number of a (U)SAT ETel API parameter, returned by RSat::TSatBase::ExtensionId() . RSat::TSatBase

Enumerators

KSatVersionNotSet = -1
KSatV1 = 1
KSatV2 = 2
KSatV3 = 3
KSatV4 = 4
KSatV5 = 5
KSatV6 = 6
KSatV7 = 7

Enum TSelectionPreference

A menu from SET UP MENU or SELECT ITEM can be marked as RSat::ESoftKeyPreferred . Then, if this feature is supported and the number of icon items does not exceed the number of soft keys available then display those icons as soft keys.

Enumerators

ESelectionPreferenceNotSet
ENoSelectionPreference
ESoftKeyPreferred

Enum TSendDataMode

Part of a SEND DATA proactive command. Describes the way in which data is send: should the SEND DATA command's data be sent immediately, or should the data from a series of SEND DATA command be buffered by the phone and sent at whatever rate the phone considers to be the best.

RSat::TSendDataV2 RSat::NotifySendDataPCmd()

Enumerators

ESendDataModeNotSet
EStoreDataInTxBuffer
ESendDataImmediately

Enum TServiceDeclarationType

Part of a DECLARE SERVICE proactive command.

RSat::TDeclareServiceV2

Enumerators

EDeclarationTypeNotSet
EAddService
EDeleteService

Enum TSetUpCallType

Part of a SET UP CALL proactive command. Determines the conditions under which a call should be set up. RSat::TSetUpCallV1

Enumerators

ESetUpCallTypeNotSet
EOnlyIfNotBusy
EOnlyIfNotBusyWithRedial
EHoldOtherCalls
EHoldOtherCallsWithRedial
EDisconnectOtherCalls
EDisconnectOtherCallsWithRedial

Enum TSetUpEventListType

Part of the SET UP EVENT LIST proactive command. It determines the command type: does the command contain a new event list or does it cancel the previous event list.

Enumerators

ESetUpEventListTypeNotSet
EUpdateEventList
ERemoveExistingEventList

Enum TSetUpIdleModeTextType

Part of the SET UP IDLE MODE TEXT proactive command. This determines the type of the command. RSat::TSetUpIdleModeTextV1

Enumerators

ESetUpIdleModeTextTypeNotSet
EUpdateIdleModeText

The SET UP IDLE MODE TEXT command contains idle mode text and perhaps an icon to accompany it.

ERemoveExistingIdleModeText

The existing idle mode text and icon should no longer be used. The SET UP IDLE MODE TEXT contains no new text.

Enum TTextAttributeStatus

Indicates the status of the text attribute to the client. It can be present or not present. If it is present, then it will provide text attribute data. This data is valid only if the text to which the text attribute data applies to is also valid. The text to which the text attribute applies to depends on the specific proactive UICC command and is specified in ETSI TS 102 223. RSat::TTextAttribute

Enumerators

ETextAttributeNotSet
ETextAttributeProvided
ETextAttributeNotPresent

Enum TTimeUnit

Describes the units in RSat::TDuration . RSat::TDuration

Enumerators

ETimeUnitNotSet
ENoDurationAvailable
EMinutes
ESeconds
ETenthsOfSeconds

Enum TTimerId

Identifies a timer. It is part of both the TIMER MANAGEMENT proactive command and the Timer Expiration envelope command. RSat::TTimerExpirationV3 RSat::TTimerMgmtV3

Enumerators

KTimer1 = 0x01
KTimer2 = 0x02
KTimer3 = 0x03
KTimer4 = 0x04
KTimer5 = 0x05
KTimer6 = 0x06
KTimer7 = 0x07
KTimer8 = 0x08
KTimerNotFound = 0xFF

Enum TTimerMgmtType

Part of the TIMER MANAGEMENT proactive command. It describes the type of command: start a timer, stop a timer, or read a timer's value. RSat::TTimerMgmtV3

Enumerators

EStartTimer
EDeactivateTimer
EGetTimerValue

Enum TTone

Part of the PLAY TONE proactive command. This determines the type of tone to play. RSat::TPlayToneV1 RSat::NotifyPlayTonePCmd()

Enumerators

KToneNotSet = -1
KDialTone = 0x01
KCalledSubscriberBusy = 0x02
KCongestion = 0x03
KRadioPathAcknowledge = 0x04
KRadioPathNotAvailableCallDropped = 0x05
KErrorSpecialInfo = 0x06
KCallWaitingTone = 0x07
KRingingTone = 0x08
KGeneralBeep = 0x10
KPositiveTone = 0x11
KNegativeTone = 0x12
KUserSelectedToneIncomingSpeech = 0x13
KUserSelectedToneIncomingSms = 0x14
KCriticalAlert = 0x15
KVibrateOnly = 0x20
KHappyTone = 0x30
KSadTone = 0x31
KUrgentActionTone = 0x32
KQuestionTone = 0x33
KMessageReceivedTone = 0x34
KMelody1 = 0x40
KMelody2 = 0x41
KMelody3 = 0x42
KMelody4 = 0x43
KMelody5 = 0x44
KMelody6 = 0x45
KMelody7 = 0x46
KMelody8 = 0x47

Enum TTransportProtocol

Part of an OPEN CHANNEL proactive command. Used by RSat::TSimMeInterface . Describes the transport protocol to use for the channel. RSat::TOpenChannelBaseV2

Enumerators

EProtocolNotSet
EProtocolNotPresent
EUdp
ETcp
ETcpUiccInServerMode

Enum TTypeOfNumber

Type of number, part of a complete telephone number address along with the numbering plan and the number's digits.

RSat::TAddress RSat::TSsString

Enumerators

ETypeOfNumberNotSet
EUnknownNumber
EInternationalNumber
ENationalNumber
ENetworkSpecificNumber

Administration/service number specific to the serving network, e.g. used to access an operator.

EDedicatedNumber

Called dedicated access / short code in GSM/WCDMA. Corresponds to TMobileTON::ESubscriberNumber in ETel MM API.

EAlphanumericNumber
EAbbreviatedNumber

Enum TUtranMeasurementQualifier

UTRAN Measurement Qualifier:It shall be included to indicate to the ME that "Network Measurement Results for a UTRAN" is required,read 3GPP TS 31.111. RSat::TLocalInfoV6 .

Enumerators

EUtranMeasurementQualifierNotSet
EUtranMeasurementQualifierIntraFrequency
EUtranMeasurementQualifierInterFrequency
EUtranMeasurementQualifierInterRATGsm

Member Type Definitions Documentation

Typedef TAccessName

typedef TBuf8 < KAccessNameMaxSize > TAccessName

Typedef TAdditionalInfo

typedef TBuf < KAdditionalInfoMaxSize > TAdditionalInfo

All proactive commands require a response from you to the UICC via the RSat::TerminalRsp() method. Some require a buffer containing 'additional information'. The information in this buffer will depend upon the type of proactive command to which you are responding; see the description of each proactive command.

Besides returning a RSat::TAdditionalInfo , you must indicate the type of additional information by returning a value from RSat::TAdditionalInfoType . RSat::TAdditionalInfoType RSat::TerminalRsp()

Typedef TAid

typedef TBuf8 < KAidMaxSize > TAid

Part of a REFRESH proactive command. Indicates the application on the UICC to be refreshed as defined in ETSI TS 101 220. RSat::TRefreshV1

Typedef TAlphaIdBuf

typedef TBuf < KAlphaIdMaxSize > TAlphaIdBuf

Buffer containing the alpha identifier in the proactive command sent from the ICC.

RSat::TAlphaId RMobileCall::TAlphaIdBuf

Typedef TApduData

typedef TBuf8 < KApduDataMaxSize > TApduData

Typedef TAtCommand

typedef TBuf8 < KAtCommandMaxSize > TAtCommand

Part of the RUN AT COMMAND proactive command. This contains the AT command string. Maximum size is 245 bytes. RSat::TRunAtCommandV2

Typedef TAttributeInfo

typedef TBuf8 < KAttributeInfoMaxSize > TAttributeInfo

Part of a GET SERVICE INFO proactive command. RSat::TGetServiceInfoV2

Typedef TBearerList

typedef TBuf8 < KBearerListMaxSize > TBearerList

A list containing bearers in order of priority. Each byte in this descriptor will be a value from RSat::TBrowserBearer that describes the bearer for the LAUNCH BROWSER command. Use the bearer in byte 1 if possible, followed by byte 2 etc. The maximum number is 4. RSat::TLaunchBrowserV2

Typedef TBearerParams

typedef TBuf8 < KBearerParamsMaxSize > TBearerParams

Part of an OPEN CHANNEL proactive command. Used by RSat::TBearer . Contains any parameters necessary to open the channel. RSat::TOpenChannelBaseV2

Typedef TBrowserTerminationEventV2Pckg

typedef TPckg < TBrowserTerminationEventV2 > TBrowserTerminationEventV2Pckg

Typedef TBrowsingStatusEventV6Pckg

typedef TPckg < TBrowsingStatusEventV6 > TBrowsingStatusEventV6Pckg

Typedef TCallControlV1Pckg

typedef TPckg < TCallControlV1 > TCallControlV1Pckg

Typedef TCallControlV2Pckg

typedef TPckg < TCallControlV2 > TCallControlV2Pckg

Typedef TCallControlV5Pckg

typedef TPckg < TCallControlV5 > TCallControlV5Pckg

Typedef TCallControlV6Pckg

typedef TPckg < TCallControlV6 > TCallControlV6Pckg

Typedef TCardReaderStatusEventV2Pckg

typedef TPckg < TCardReaderStatusEventV2 > TCardReaderStatusEventV2Pckg

Typedef TCbDownloadV3Pckg

typedef TPckg < TCbDownloadV3 > TCbDownloadV3Pckg

Typedef TCbPage

typedef TBuf8 < KCbPageSize > TCbPage

Cell broadcast (CB) page.

Typedef TCcp

typedef TBuf8 < KCcpMaxSize > TCcp

TCcp ( Capability configuration parameters ) is a 8-bit data buffer that contains the bearer capabilities as coded in ETSI 11.11 and ETSI 04.08. It is 14 bytes as it does not include the IEI (Information Element Identity).

It is used by the SET UP CALL proactive command. It is also used in call control.

RSat::NotifySetUpCallPCmd() RSat::NotifyCallControlRequest() RMobileCall::TCcp

Typedef TChannelData

typedef TBuf8 < KChannelDataMaxSize > TChannelData

Part of a SEND DATA proactive command. Contains the data to be sent. RSat::TSendDataV2 RSat::NotifySendDataPCmd()

Typedef TChannelStatus

typedef TBuf8 < KChannelStatusMaxSize > TChannelStatus

The channel status returned in the channel status event envelope when channel status event is part of the current event list (as set up in the SET UP EVENT LIST proactive command).

For UICC Server Mode, this event can indicate a state change in a TCP connection, for example, TCP in LISTEN state, TCP in CLOSED state, TCP in ESTABLISHED state (for details of specific encoding see ETSI TS 102 223 release 7 onwards).

Typedef TChannelStatusEventV2Pckg

typedef TPckg < TChannelStatusEventV2 > TChannelStatusEventV2Pckg

Typedef TChannelStatusPckg

typedef TPckg < TChannelStatus > TChannelStatusPckg

Typedef TCloseChannelRspV2Pckg

typedef TPckg < TCloseChannelRspV2 > TCloseChannelRspV2Pckg

Typedef TCloseChannelV2Pckg

typedef TPckg < TCloseChannelV2 > TCloseChannelV2Pckg

Typedef TCloseChannelV5Pckg

typedef TPckg < TCloseChannelV5 > TCloseChannelV5Pckg

Typedef TCloseChannelV6Pckg

typedef TPckg < TCloseChannelV6 > TCloseChannelV6Pckg

Typedef TDataAvailableEventV2Pckg

typedef TPckg < TDataAvailableEventV2 > TDataAvailableEventV2Pckg

Typedef TDeclareServiceRspV2Pckg

typedef TPckg < TDeclareServiceRspV2 > TDeclareServiceRspV2Pckg

Typedef TDeclareServiceV2Pckg

typedef TPckg < TDeclareServiceV2 > TDeclareServiceV2Pckg

Typedef TDeviceFilter

typedef TBuf8 < KDeviceFilterMaxSize > TDeviceFilter

Part of a SERVICE SEARCH proactive command. RSat::TServiceSearchV2

Typedef TDisplayMultimediaMessageRspV6Pckg

typedef TPckg < TDisplayMultimediaMessageRspV6 > TDisplayMultimediaMessageRspV6Pckg

Typedef TDisplayMultimediaMessageV6Pckg

typedef TPckg < TDisplayMultimediaMessageV6 > TDisplayMultimediaMessageV6Pckg

Typedef TDisplayParamsEventV2Pckg

typedef TPckg < TDisplayParamsEventV2 > TDisplayParamsEventV2Pckg

Typedef TDisplayTextRspV1Pckg

typedef TPckg < TDisplayTextRspV1 > TDisplayTextRspV1Pckg

Typedef TDisplayTextV1Pckg

typedef TPckg < TDisplayTextV1 > TDisplayTextV1Pckg

Typedef TDisplayTextV2Pckg

typedef TPckg < TDisplayTextV2 > TDisplayTextV2Pckg

Typedef TDisplayTextV5Pckg

typedef TPckg < TDisplayTextV5 > TDisplayTextV5Pckg

Typedef TDisplayTextV6Pckg

typedef TPckg < TDisplayTextV6 > TDisplayTextV6Pckg

Typedef TDtmfString

typedef TBuf8 < KDtmfStringMaxSize > TDtmfString

Part of the SEND DTMF proactive command. This contains the DTMF string. Maximum size is 243. RSat::TSendDtmfV1

Typedef TEventDownloadBaseV2Pckg

typedef TPckg < TEventDownloadBaseV2 > TEventDownloadBaseV2Pckg

Typedef TFileList

typedef TBuf < KMaxFileListSize > TFileList

This buffer contains the information of the received file. RSat::KMMSFileNameSize

Typedef TFrameLayoutBuf

typedef TBuf < KMaxFrameLayoutSize > TFrameLayoutBuf

Typedef TFrameList

typedef TBuf8 < KMaxFrameNumber > TFrameList

Typedef TFramesInformationChangedEventV6Pckg

typedef TPckg < TFramesInformationChangedEventV6 > TFramesInformationChangedEventV6Pckg

Typedef TGetChannelStatusRspV2Pckg

typedef TPckg < TGetChannelStatusRspV2 > TGetChannelStatusRspV2Pckg

Typedef TGetChannelStatusV2Pckg

typedef TPckg < TGetChannelStatusV2 > TGetChannelStatusV2Pckg

Typedef TGetFramesStatusRspV6Pckg

typedef TPckg < TGetFramesStatusRspV6 > TGetFramesStatusRspV6Pckg

Typedef TGetFramesStatusV6Pckg

typedef TPckg < TGetFramesStatusV6 > TGetFramesStatusV6Pckg

Typedef TGetInkeyRspV1Pckg

typedef TPckg < TGetInkeyRspV1 > TGetInkeyRspV1Pckg

Typedef TGetInkeyRspV2Pckg

typedef TPckg < TGetInkeyRspV2 > TGetInkeyRspV2Pckg

Typedef TGetInkeyText

typedef TBuf < KGetInkeyTextMaxSize > TGetInkeyText

Part of the GET INKEY proactive command. Contains the text to display to the user before getting a response. Maximum length is 242 characters. RSat::TGetInkeyV1 RSat::NotifyGetInkeyPCmd()

Typedef TGetInkeyV1Pckg

typedef TPckg < TGetInkeyV1 > TGetInkeyV1Pckg

A packaged RSat::TGetInkeyV1 .

Typedef TGetInkeyV2Pckg

typedef TPckg < TGetInkeyV2 > TGetInkeyV2Pckg

A packaged RSat::TGetInkeyV2 .

Typedef TGetInkeyV5Pckg

typedef TPckg < TGetInkeyV5 > TGetInkeyV5Pckg

A packaged RSat::TGetInkeyV5 .

Typedef TGetInkeyV6Pckg

typedef TPckg < TGetInkeyV6 > TGetInkeyV6Pckg

A packaged RSat::TGetInkeyV5 .

Typedef TGetInputDefaultText

typedef TBuf < KGetInputDefaultTextMaxSize > TGetInputDefaultText

Part of the GET INPUT proactive command. A default string: allow the user to edit this, or to delete it and replace it with their own text. RSat::TGetInputV1 RSat::NotifyGetInputPCmd()

Typedef TGetInputRspV1Pckg

typedef TPckg < TGetInputRspV1 > TGetInputRspV1Pckg

Typedef TGetInputText

typedef TBuf < KGetInputTextMaxSize > TGetInputText

Part of the GET INPUT proactive command. Contains the text to display to the user before getting a response. Maximum length is 238 characters. RSat::TGetInputV1 RSat::TGetInputV5 RSat::NotifyGetInputPCmd()

Typedef TGetInputV1Pckg

typedef TPckg < TGetInputV1 > TGetInputV1Pckg

A packaged RSat::TGetInputV1 .

Typedef TGetInputV5Pckg

typedef TPckg < TGetInputV5 > TGetInputV5Pckg

A packaged RSat::TGetInputV5 .

Typedef TGetInputV6Pckg

typedef TPckg < TGetInputV6 > TGetInputV6Pckg

A packaged RSat::TGetInputV6 .

Typedef TGetReaderStatusRspV2Pckg

typedef TPckg < TGetReaderStatusRspV2 > TGetReaderStatusRspV2Pckg

Typedef TGetReaderStatusV2Pckg

typedef TPckg < TGetReaderStatusV2 > TGetReaderStatusV2Pckg

Typedef TGetServiceInfoRspV2Pckg

typedef TPckg < TGetServiceInfoRspV2 > TGetServiceInfoRspV2Pckg

Typedef TGetServiceInfoV2Pckg

typedef TPckg < TGetServiceInfoV2 > TGetServiceInfoV2Pckg

Typedef TGetServiceInfoV5Pckg

typedef TPckg < TGetServiceInfoV5 > TGetServiceInfoV5Pckg

Typedef TGetServiceInfoV6Pckg

typedef TPckg < TGetServiceInfoV6 > TGetServiceInfoV6Pckg

Typedef TIcon

typedef TBuf8 < KImageInstanceDescriptorsMaxSize > TIcon

RSat::GetIcon() stores the an icon's EF record in this buffer. The record's structure is defined in ETSI TS 131 102; search for EFimg or "Contents of files at the DFGRAPHICS level" RSat::GetIcon() RSat::TIconId

Typedef TIdleModeText

typedef TBuf16 < KIdleModeTextMaxSize > TIdleModeText

Part of the SET UP IDLE MODE TEXT proactive command. This contains the idle mode text.

This buffer assumes that 16-bit descriptors are being used by default.

RSat::TSetUpIdleModeTextV1 RSat::KIdleModeTextMaxSize

Typedef TInstanceInfoV2Pckg

typedef TPckg < TInstanceInfoV2 > TInstanceInfoV2Pckg

Typedef TInstanceInfoV3Pckg

typedef TPckg < TInstanceInfoV3 > TInstanceInfoV3Pckg

Typedef TItemList

typedef TBuf16 < KItemListMaxSize > TItemList

Contains the menu in a SET UP MENU and SELECT ITEM proactive commands. Do not access the menu directly; use RSat::TMenuItemBaseV1::GetItem() and RSat::TMenuItemBaseV1::AddItem() instead.

Typedef TLanguageNotificationRspV2Pckg

typedef TPckg < TLanguageNotificationRspV2 > TLanguageNotificationRspV2Pckg

Typedef TLanguageNotificationV2Pckg

typedef TPckg < TLanguageNotificationV2 > TLanguageNotificationV2Pckg

Typedef TLanguageSelectionEventV2Pckg

typedef TPckg < TLanguageSelectionEventV2 > TLanguageSelectionEventV2Pckg

Typedef TLaunchBrowserRspV2Pckg

typedef TPckg < TLaunchBrowserRspV2 > TLaunchBrowserRspV2Pckg

Typedef TLaunchBrowserV2Pckg

typedef TPckg < TLaunchBrowserV2 > TLaunchBrowserV2Pckg

Typedef TLaunchBrowserV5Pckg

typedef TPckg < TLaunchBrowserV5 > TLaunchBrowserV5Pckg

Typedef TLaunchBrowserV6Pckg

typedef TPckg < TLaunchBrowserV6 > TLaunchBrowserV6Pckg

Typedef TLocalConnectionEventV2Pckg

typedef TPckg < TLocalConnectionEventV2 > TLocalConnectionEventV2Pckg

Typedef TLocalInfoRspV3Pckg

typedef TPckg < TLocalInfoRspV3 > TLocalInfoRspV3Pckg

Typedef TLocalInfoV3Pckg

typedef TPckg < TLocalInfoV3 > TLocalInfoV3Pckg

Typedef TLocalInfoV6Pckg

typedef TPckg < TLocalInfoV6 > TLocalInfoV6Pckg

Typedef TMMSNotification

typedef TBuf < KMaxFrameLayoutSize > TMMSNotification

Typedef TMenuSelectionV1Pckg

typedef TPckg < TMenuSelectionV1 > TMenuSelectionV1Pckg

Typedef TMmsNotificationDownloadV6Pckg

typedef TPckg < TMmsNotificationDownloadV6 > TMmsNotificationDownloadV6Pckg

A packaged RSat::TMMSNotificationDownloadV6.

Typedef TMmsTransferStatusV6Pckg

typedef TPckg < TMmsTransferStatusV6 > TMmsTransferStatusV6Pckg

Typedef TMoSmControlV1Pckg

typedef TPckg < TMoSmControlV1 > TMoSmControlV1Pckg

Typedef TMultimediaContentId

typedef TBuf < KMaxMultimediaContentIdSize > TMultimediaContentId

This buffer ontains the Data Object tag to be used when the MM Content is stored in the referenced BER-TLV file. RSat::KMaxMultimediaContentIdSize

Typedef TMultimediaMessageId

typedef TBuf < KMaxMultimediaMessageIdSize > TMultimediaMessageId

This may be present only if the iReceptionFile is present. It is mandatory in case the MMS Reception or Submission file can store several MMs. RSat::KMaxMultimediaMessageIdSize

Typedef TMultimediaMessageRef

typedef TBuf < KMaxMultimediaMessageRefSize > TMultimediaMessageRef

This buffer contains the URI identifying the multimedia message in the network. RSat::KMaxMultimediaMessageRefSize

Typedef TMultimediaMessageStatus

typedef TBuf < KMaxMultimediaMessageStatusSize > TMultimediaMessageStatus

Contains the Multimedia Transfer status information. RSat::TMmsTransferStatusV6

Typedef TNetworkSearchModeChangeEventV6Pckg

typedef TPckg < TNetworkSearchModeChangeEventV6 > TNetworkSearchModeChangeEventV6Pckg

Typedef TOpenChannelBaseV2Pckg

typedef TPckg < TOpenChannelBaseV2 > TOpenChannelBaseV2Pckg

Typedef TOpenChannelRspV2Pckg

typedef TPckg < TOpenChannelRspV2 > TOpenChannelRspV2Pckg

Typedef TOpenCsChannelV2Pckg

typedef TPckg < TOpenCsChannelV2 > TOpenCsChannelV2Pckg

Typedef TOpenCsChannelV5Pckg

typedef TPckg < TOpenCsChannelV5 > TOpenCsChannelV5Pckg

Typedef TOpenCsChannelV6Pckg

typedef TPckg < TOpenCsChannelV6 > TOpenCsChannelV6Pckg

Typedef TOpenGprsChannelV2Pckg

typedef TPckg < TOpenGprsChannelV2 > TOpenGprsChannelV2Pckg

Typedef TOpenGprsChannelV4Pckg

typedef TPckg < TOpenGprsChannelV4 > TOpenGprsChannelV4Pckg

Typedef TOpenGprsChannelV5Pckg

typedef TPckg < TOpenGprsChannelV5 > TOpenGprsChannelV5Pckg

Typedef TOpenGprsChannelV6Pckg

typedef TPckg < TOpenGprsChannelV6 > TOpenGprsChannelV6Pckg

Typedef TOpenLocalLinksChannelV2Pckg

typedef TPckg < TOpenLocalLinksChannelV2 > TOpenLocalLinksChannelV2Pckg

Typedef TOpenLocalLinksChannelV5Pckg

typedef TPckg < TOpenLocalLinksChannelV5 > TOpenLocalLinksChannelV5Pckg

Typedef TOpenLocalLinksChannelV6Pckg

typedef TPckg < TOpenLocalLinksChannelV6 > TOpenLocalLinksChannelV6Pckg

Typedef TOpenUiccServerModeChannelV7Pckg

typedef TPckg < TOpenUiccServerModeChannelV7 > TOpenUiccServerModeChannelV7Pckg

Typedef TPerformCardApduRspV2Pckg

typedef TPckg < TPerformCardApduRspV2 > TPerformCardApduRspV2Pckg

Typedef TPerformCardApduV2Pckg

typedef TPckg < TPerformCardApduV2 > TPerformCardApduV2Pckg

Typedef TPlayToneRspV1Pckg

typedef TPckg < TPlayToneRspV1 > TPlayToneRspV1Pckg

Typedef TPlayToneV1Pckg

typedef TPckg < TPlayToneV1 > TPlayToneV1Pckg

A packaged RSat::TPlayToneV1 .

Typedef TPlayToneV2Pckg

typedef TPckg < TPlayToneV2 > TPlayToneV2Pckg

A packaged RSat::TPlayToneV2 .

Typedef TPlayToneV5Pckg

typedef TPckg < TPlayToneV5 > TPlayToneV5Pckg

A packaged RSat::TPlayToneV5 .

Typedef TPlayToneV6Pckg

typedef TPckg < TPlayToneV6 > TPlayToneV6Pckg

A packaged RSat::TPlayToneV6 .

Typedef TPollingIntervalRspV3Pckg

typedef TPckg < TPollingIntervalRspV3 > TPollingIntervalRspV3Pckg

Typedef TPollingIntervalV3Pckg

typedef TPckg < TPollingIntervalV3 > TPollingIntervalV3Pckg

Typedef TPollingOffRspV3Pckg

typedef TPckg < TPollingOffRspV3 > TPollingOffRspV3Pckg

Typedef TPollingOffV3Pckg

typedef TPckg < TPollingOffV3 > TPollingOffV3Pckg

Typedef TPowerOffCardRspV2Pckg

typedef TPckg < TPowerOffCardRspV2 > TPowerOffCardRspV2Pckg

Typedef TPowerOffCardV2Pckg

typedef TPckg < TPowerOffCardV2 > TPowerOffCardV2Pckg

Typedef TPowerOnCardRspV2Pckg

typedef TPckg < TPowerOnCardRspV2 > TPowerOnCardRspV2Pckg

Typedef TPowerOnCardV2Pckg

typedef TPckg < TPowerOnCardV2 > TPowerOnCardV2Pckg

Typedef TProvisioningFileRef

typedef TBuf8 < KFileRefMaxSize > TProvisioningFileRef

A provisioning file, used with the LAUNCH BROWESER proactive command.

Typedef TProvisioningFileRefPckg

typedef TPckg < TProvisioningFileRef > TProvisioningFileRefPckg

Typedef TReceiveDataRspV2Pckg

typedef TPckg < TReceiveDataRspV2 > TReceiveDataRspV2Pckg

Typedef TReceiveDataV2Pckg

typedef TPckg < TReceiveDataV2 > TReceiveDataV2Pckg

Typedef TReceiveDataV5Pckg

typedef TPckg < TReceiveDataV5 > TReceiveDataV5Pckg

Typedef TReceiveDataV6Pckg

typedef TPckg < TReceiveDataV6 > TReceiveDataV6Pckg

Typedef TRefreshFileList

typedef TBuf16 < KRefreshedFileListMaxSize > TRefreshFileList

Part of a REFRESH proactive command. Contains the list of files that have been changed by the UICC. RSat::TRefreshV1

Typedef TRefreshRspV1Pckg

typedef TPckg < TRefreshRspV1 > TRefreshRspV1Pckg

Typedef TRefreshV1Pckg

typedef TPckg < TRefreshV1 > TRefreshV1Pckg

A packaged RSat::TRefreshV1 .

Typedef TRefreshV2Pckg

typedef TPckg < TRefreshV2 > TRefreshV2Pckg

A packaged RSat::TRefreshV2 .

Typedef TRemoteAddress

typedef TBuf8 < KRemoteAddressMaxSize > TRemoteAddress

Descriptor containing a remote entity's address. Maximum size is 237. RSat::TRemoteEntityAddress

Typedef TRetrieveMultimediaMessageRspV6Pckg

typedef TPckg < TRetrieveMultimediaMessageRspV6 > TRetrieveMultimediaMessageRspV6Pckg

Typedef TRetrieveMultimediaMessageV6Pckg

typedef TPckg < TRetrieveMultimediaMessageV6 > TRetrieveMultimediaMessageV6Pckg

Typedef TRunAtCommandRspV2Pckg

typedef TPckg < TRunAtCommandRspV2 > TRunAtCommandRspV2Pckg

Typedef TRunAtCommandV2Pckg

typedef TPckg < TRunAtCommandV2 > TRunAtCommandV2Pckg

Typedef TRunAtCommandV5Pckg

typedef TPckg < TRunAtCommandV5 > TRunAtCommandV5Pckg

Typedef TRunAtCommandV6Pckg

typedef TPckg < TRunAtCommandV6 > TRunAtCommandV6Pckg

Typedef TSatProfileV1Pckg

typedef TPckg < TSatProfileV1 > TSatProfileV1Pckg

Typedef TSatProfileV2Pckg

typedef TPckg < TSatProfileV2 > TSatProfileV2Pckg

Typedef TSatProfileV5Pckg

typedef TPckg < TSatProfileV5 > TSatProfileV5Pckg

Typedef TSatProfileV6Pckg

typedef TPckg < TSatProfileV6 > TSatProfileV6Pckg

Typedef TSatSmsV1Pckg

typedef TPckg < TSatSmsV1 > TSatSmsV1Pckg

Typedef TSatTelNumber

typedef TBuf < KMaxMobileTelNumberSize > TSatTelNumber

The phone number s digits and other valid dial-string characters, coded as Unicode characters. RSat::TSatTelNumber is part of a complete telephone number address, along with the type of number and the numbering plan.

Maximum size is 251 digits. RSat::TAddress

Typedef TSelectItemRspV1Pckg

typedef TPckg < TSelectItemRspV1 > TSelectItemRspV1Pckg

Typedef TSelectItemV1Pckg

typedef TPckg < TSelectItemV1 > TSelectItemV1Pckg

Typedef TSelectItemV2Pckg

typedef TPckg < TSelectItemV2 > TSelectItemV2Pckg

Typedef TSelectItemV5Pckg

typedef TPckg < TSelectItemV5 > TSelectItemV5Pckg

Typedef TSelectItemV6Pckg

typedef TPckg < TSelectItemV6 > TSelectItemV6Pckg

Typedef TSendDataRspV2Pckg

typedef TPckg < TSendDataRspV2 > TSendDataRspV2Pckg

Typedef TSendDataV2Pckg

typedef TPckg < TSendDataV2 > TSendDataV2Pckg

A packaged RSat::TSendDataV2 .

Typedef TSendDataV5Pckg

typedef TPckg < TSendDataV5 > TSendDataV5Pckg

A packaged RSat::TSendDataV5 .

Typedef TSendDataV6Pckg

typedef TPckg < TSendDataV6 > TSendDataV6Pckg

A packaged RSat::TSendDataV6 .

Typedef TSendDtmfRspV1Pckg

typedef TPckg < TSendDtmfRspV1 > TSendDtmfRspV1Pckg

Typedef TSendDtmfV1Pckg

typedef TPckg < TSendDtmfV1 > TSendDtmfV1Pckg

A packaged RSat::TSendDtmfV1 .

Typedef TSendDtmfV5Pckg

typedef TPckg < TSendDtmfV5 > TSendDtmfV5Pckg

A packaged RSat::TSendDtmfV5 .

Typedef TSendDtmfV6Pckg

typedef TPckg < TSendDtmfV6 > TSendDtmfV6Pckg

A packaged RSat::TSendDtmfV6 .

Typedef TSendSmRspV1Pckg

typedef TPckg < TSendSmRspV1 > TSendSmRspV1Pckg

Typedef TSendSmV1Pckg

typedef TPckg < TSendSmV1 > TSendSmV1Pckg

A packaged RSat::TSendSmV1 .

Typedef TSendSmV5Pckg

typedef TPckg < TSendSmV5 > TSendSmV5Pckg

A packaged RSat::TSendSmV5 .

Typedef TSendSmV6Pckg

typedef TPckg < TSendSmV6 > TSendSmV6Pckg

A packaged RSat::TSendSmV6 .

Typedef TSendSsRspV1Pckg

typedef TPckg < TSendSsRspV1 > TSendSsRspV1Pckg

Typedef TSendSsRspV2Pckg

typedef TPckg < TSendSsRspV2 > TSendSsRspV2Pckg

Typedef TSendSsV1Pckg

typedef TPckg < TSendSsV1 > TSendSsV1Pckg

A packaged RSat::TSendSsV1 .

Typedef TSendSsV6Pckg

typedef TPckg < TSendSsV6 > TSendSsV6Pckg

A packaged RSat::TSendSsV6 .

Typedef TSendUssdRspV1Pckg

typedef TPckg < TSendUssdRspV1 > TSendUssdRspV1Pckg

Typedef TSendUssdV1Pckg

typedef TPckg < TSendUssdV1 > TSendUssdV1Pckg

A packaged RSat::TSendUssdV1 .

Typedef TSendUssdV6Pckg

typedef TPckg < TSendUssdV6 > TSendUssdV6Pckg

A packaged RSat::TSendUssdV1 .

Typedef TServiceRecord

typedef TBuf8 < KServiceRecordMaxSize > TServiceRecord

Typedef TServiceSearchParam

typedef TBuf8 < KServiceSearchMaxSize > TServiceSearchParam

Part of a SERVICE SEARCH proactive command. RSat::TServiceSearchV2

Typedef TServiceSearchRspV2Pckg

typedef TPckg < TServiceSearchRspV2 > TServiceSearchRspV2Pckg

Typedef TServiceSearchV2Pckg

typedef TPckg < TServiceSearchV2 > TServiceSearchV2Pckg

Typedef TServiceSearchV5Pckg

typedef TPckg < TServiceSearchV5 > TServiceSearchV5Pckg

Typedef TServiceSearchV6Pckg

typedef TPckg < TServiceSearchV6 > TServiceSearchV6Pckg

Typedef TSetFramesRspV6Pckg

typedef TPckg < TSetFramesRspV6 > TSetFramesRspV6Pckg

Typedef TSetFramesV6Pckg

typedef TPckg < TSetFramesV6 > TSetFramesV6Pckg

Typedef TSetUpCallRspV1Pckg

typedef TPckg < TSetUpCallRspV1 > TSetUpCallRspV1Pckg

Typedef TSetUpCallRspV2Pckg

typedef TPckg < TSetUpCallRspV2 > TSetUpCallRspV2Pckg

Typedef TSetUpCallV1Pckg

typedef TPckg < TSetUpCallV1 > TSetUpCallV1Pckg

Typedef TSetUpCallV5Pckg

typedef TPckg < TSetUpCallV5 > TSetUpCallV5Pckg

Typedef TSetUpCallV6Pckg

typedef TPckg < TSetUpCallV6 > TSetUpCallV6Pckg

Typedef TSetUpEventListRspV1Pckg

typedef TPckg < TSetUpEventListRspV1 > TSetUpEventListRspV1Pckg

Typedef TSetUpEventListV1Pckg

typedef TPckg < TSetUpEventListV1 > TSetUpEventListV1Pckg

Typedef TSetUpIdleModeTextRspV1Pckg

typedef TPckg < TSetUpIdleModeTextRspV1 > TSetUpIdleModeTextRspV1Pckg

Typedef TSetUpIdleModeTextV1Pckg

typedef TPckg < TSetUpIdleModeTextV1 > TSetUpIdleModeTextV1Pckg

Typedef TSetUpIdleModeTextV5Pckg

typedef TPckg < TSetUpIdleModeTextV5 > TSetUpIdleModeTextV5Pckg

Typedef TSetUpIdleModeTextV6Pckg

typedef TPckg < TSetUpIdleModeTextV6 > TSetUpIdleModeTextV6Pckg

Typedef TSetUpMenuRspV1Pckg

typedef TPckg < TSetUpMenuRspV1 > TSetUpMenuRspV1Pckg

Typedef TSetUpMenuV1Pckg

typedef TPckg < TSetUpMenuV1 > TSetUpMenuV1Pckg

Typedef TSetUpMenuV2Pckg

typedef TPckg < TSetUpMenuV2 > TSetUpMenuV2Pckg

Typedef TSetUpMenuV5Pckg

typedef TPckg < TSetUpMenuV5 > TSetUpMenuV5Pckg

Typedef TSmsPpDownloadV3Pckg

typedef TPckg < TSmsPpDownloadV3 > TSmsPpDownloadV3Pckg

Typedef TSubAddress

typedef TBuf < KSubAddressMaxSize > TSubAddress

Sub-address of a telephone number. Maximum size is 21 digits.

It is used by the SET UP CALL and OPEN CHANNEL proactive commands. It is also used in call control.

RSat::NotifySetUpCallPCmd() RSat::NotifyCallControlRequest() RSat::NotifyOpenChannelPCmd() RMobileCall::TSubAddress

Typedef TSubmitMultimediaMessageRspV6Pckg

typedef TPckg < TSubmitMultimediaMessageRspV6 > TSubmitMultimediaMessageRspV6Pckg

Typedef TSubmitMultimediaMessageV6Pckg

typedef TPckg < TSubmitMultimediaMessageV6 > TSubmitMultimediaMessageV6Pckg

Typedef TTextAttributeBuf

typedef TBuf8 < KTextAttributeBufSize > TTextAttributeBuf

Contains text attribute data. A text attribute contains formatting information such as whether the text it is applied to is bold, underlined, aligned left, etc. The text to which the text attribute applies to depends on the specific proactive UICC command and is specified in ETSI TS 102 223. RSat::TTextAttribute

Typedef TTextString

typedef TBuf < KTextStringMaxSize > TTextString

Generic Text String

This text string definition is to be used through the API where a text string is required. Text string should be presented to the client in unicode format. This type can be used in envelope commands, proactive commands and terminal response. RSat::KTextStringMaxSize

Typedef TTextToDisplay

typedef TBuf < KTextToDisplayMaxSize > TTextToDisplay

Part of a DISPLAY TEXT proactive command. This contains the text to display. RSat::TDisplayTextV1 RSat::NotifyDisplayTextPCmd() RSat::NotifyDisplayMultimediaMsgPCmd()

Typedef TTimerExpirationV3Pckg

typedef TPckg < TTimerExpirationV3 > TTimerExpirationV3Pckg

Typedef TTimerMgmtRspV3Pckg

typedef TPckg < TTimerMgmtRspV3 > TTimerMgmtRspV3Pckg

Typedef TTimerMgmtV3Pckg

typedef TPckg < TTimerMgmtV3 > TTimerMgmtV3Pckg

Typedef TUrl

typedef TBuf8 < KUrlMaxSize > TUrl

Part of the LAUNCH BROWSER proactive command. Contains the URL to display. Maximum size is 243 bytes. RSat::TLaunchBrowserV2

Typedef TUssdDataDownloadV6Pckg

typedef TPckg < TUssdDataDownloadV6 > TUssdDataDownloadV6Pckg

Member Data Documentation

CSatPtrHolder * iEtelSatPtrHolder

CSatPtrHolder * iEtelSatPtrHolder [private]