1 /*

     2 * Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef CMMPHONEGSMWCDMAEXT_H

    21 #define CMMPHONEGSMWCDMAEXT_H

    22 

    23 //  INCLUDES

    24 #include "cmmphoneextinterface.h"

    25 #include "CMmPrivateUtility.h"

    26 #include "mmgsmwcdmaprivateutils.h"

    27 

    28 //  FORWARD DECLARATIONS

    29 class CMmPhoneTsy;

    30 class CMmMessageManagerBase;

    31 class CMmDataPackage;

    32 

    33 // CLASS DECLARATION

    34 

    35 /**

    36 *  CMmPhoneGsmWcdmaExt contains mode-dependent phone functionality

    37 *  for GSM phone.

    38 *  Extension request handles are stored in MM Phone object.

    39 */

    40 NONSHARABLE_CLASS( CMmPhoneGsmWcdmaExt ) : public CMmPhoneExtInterface

    41     {

    42 

    43 public:

    44      /*

    45      * Destructor

    46      */

    47     ~CMmPhoneGsmWcdmaExt();

    48 

    49     /**

    50      * Creates a new CMmPhoneGsmWcdmaExt object instance.

    51      *    

    52      *     

    53      * @param aMmPhoneTsy Phone TSY

    54      * @param aMessageManager Message manager object

    55      * @return gsm extension phone object

    56      */

    57     static CMmPhoneGsmWcdmaExt* NewL( 

    58         CMmPhoneTsy* aMmPhoneTsy, 

    59         CMmMessageManagerBase* aMessageManager );

    60 

    61     /**

    62      * Initializes the CMmPhoneGsmWcdmaExt object instance

    63      *   

    64      *      

    65      * @return error value

    66      */

    67     TInt InitSimL( void );

    68 

    69     /**

    70      * Default implementation of GetNITZInfo-method.

    71      *     

    72      *    

    73      * @param aNwtTimeInfo Pointer to time and date information

    74      * @return error value

    75      */ 

    76     TInt GetNITZInfo( 

    77         RMobilePhone::TMobilePhoneNITZ* aNwtTimeInfo );

    78 

    79     /**

    80      * Default implementation of GetCellInfo-method.

    81      *     

    82      *    

    83      * @return error value

    84      */ 

    85     virtual TInt GetCellInfoL(); 

    86 

    87     /**

    88      * Default implementation of NotifyCellInfoChange-method.

    89      *     

    90      *    

    91      * @return error value

    92      */ 

    93     virtual TInt NotifyCellInfoChangeL();

    94     

    95     /**

    96      * Get Network capabilities.

    97      *     

    98      *    

    99      * @param aCaps Pointer to client side NW caps

   100      * @return KErrNone

   101      */

   102     TInt GetNetworkCaps( TUint32* aCaps );

   103 

   104     /**

   105      * Get current Network, information version 1 implementation.

   106      *     

   107      *    

   108      * @param aNetInfo network information version 1

   109      * @param aArea location area

   110      * @return KErrNone

   111      */

   112     TInt GetCurrentNetworkV1( 

   113         RMobilePhone::TMobilePhoneNetworkInfoV1* aNetInfo,

   114         RMobilePhone::TMobilePhoneLocationAreaV1* aArea );

   115         

   116     /**

   117      * Get current Network, information version 2 implementation.

   118      *     

   119      * @param aNetInfo network information version 2

   120      * @param aArea location area

   121      * @return KErrNone

   122      */

   123     TInt GetCurrentNetworkV2( 

   124         RMobilePhone::TMobilePhoneNetworkInfoV2* aNetInfo,

   125         RMobilePhone::TMobilePhoneLocationAreaV1* aArea );

   126         

   127     /**

   128      * Get current Network, information version 5 implementation.

   129      *     

   130      *    

   131      * @param aNetInfo network information version 5

   132      * @param aArea location area

   133      * @return KErrNone

   134      */

   135     TInt GetCurrentNetworkV5( 

   136         RMobilePhone::TMobilePhoneNetworkInfoV5* aNetInfo,

   137         RMobilePhone::TMobilePhoneLocationAreaV1* aArea );

   138    

   139      /**

   140      * Get current Network, information version 8 implementation.

   141      *     

   142      *    

   143      * @param aNetInfo network information version 8

   144      * @param aArea location area

   145      * @return KErrNone

   146      */

   147     TInt GetCurrentNetwork( 

   148         RMobilePhone::TMobilePhoneNetworkInfoV8* aNetInfo,

   149         RMobilePhone::TMobilePhoneLocationAreaV1* aArea );

   150         

   151     /**

   152      * Get current Network (V1), but not the location area.

   153      *     

   154      *    

   155      * @param aNetInfo network information version 1

   156      * @return KErrNone

   157      */

   158     TInt GetCurrentNetworkNoLocationV1( 

   159         RMobilePhone::TMobilePhoneNetworkInfoV1* aNetInfo ); 

   160 

   161     /**

   162      * Get current Network (V2), but not the location area.

   163      *       

   164      * @param aNetInfo network information version 2

   165      * @return KErrNone

   166      */

   167     TInt GetCurrentNetworkNoLocationV2( 

   168         RMobilePhone::TMobilePhoneNetworkInfoV2* aNetInfo );

   169         

   170     /**

   171      * Get current Network (V5), but not the location area.

   172      *     

   173      *    

   174      * @param aNetInfo network information version 5

   175      * @return KErrNone

   176      */

   177     TInt GetCurrentNetworkNoLocationV5( 

   178         RMobilePhone::TMobilePhoneNetworkInfoV5* aNetInfo );   

   179         

   180     /**

   181      * Get current Network (V8), but not the location area.

   182      *     

   183      *    

   184      * @param aNetInfo network information version 8

   185      * @return KErrNone

   186      */

   187     TInt GetCurrentNetworkNoLocation( 

   188         RMobilePhone::TMobilePhoneNetworkInfoV8* aNetInfo );

   189         

   190     /**

   191      * Set current Network.

   192      *     

   193      *    

   194      * @param aNetInfo network information version 8

   195      * @param aArea location area

   196      * @return KErrNone

   197      */

   198     TInt SetCurrentNetwork( 

   199         const RMobilePhone::TMobilePhoneNetworkInfoV8& aNetInfo,    

   200         const RMobilePhone::TMobilePhoneLocationAreaV1& area );

   201         

   202     /**

   203      * Get home Network, version 1 implementation.

   204      *     

   205      *    

   206      * @param aNetInfo network information version 1

   207      * @return KErrNone or KErrNotFound

   208      */

   209     TInt GetHomeNetworkV1(

   210         RMobilePhone::TMobilePhoneNetworkInfoV1* aNetInfo );

   211 

   212     /**

   213      * Get home Network, version 2 implementation.

   214      *     

   215      *    

   216      * @param aNetInfo network information version 2

   217      * @return KErrNone or KErrNotFound

   218      */

   219     TInt GetHomeNetworkV2(

   220         RMobilePhone::TMobilePhoneNetworkInfoV2* aNetInfo );

   221         

   222     /**

   223      * Get home Network.

   224      *     

   225      *    

   226      * @param aNetInfo network information version 5

   227      * @return KErrNone or KErrNotFound

   228      */

   229     TInt GetHomeNetworkV5(

   230         RMobilePhone::TMobilePhoneNetworkInfoV5* aNetInfo ); 

   231 

   232 	/**

   233      * Get home Network.

   234      *     

   235      *    

   236      * @param aNetInfo network information version 8

   237      * @return KErrNone or KErrNotFound

   238      */

   239     TInt GetHomeNetwork(

   240         RMobilePhone::TMobilePhoneNetworkInfoV8* aNetInfo ); 

   241         

   242     /**

   243      * Update Nitz information.

   244      *     

   245      *    

   246      * @param aNITZInfo NITZ info

   247      */

   248     void ReceivedNITZInfo( 

   249         RMobilePhone::TMobilePhoneNITZ& aNITZInfo );

   250 

   251     /**

   252      * Get fixed dialling number service status

   253      *     

   254      *    

   255      * @param aStatus service status

   256      * @return error value

   257      */

   258     TInt GetFdnStatusL( void );

   259 

   260     /**

   261      * Set fixed dialling number service setting

   262      *     

   263      *    

   264      * @param aFdnSetting service setting

   265      * @return error value

   266      */

   267     TInt SetFdnSetting(

   268         RMobilePhone::TMobilePhoneFdnSetting* aFdnSetting );

   269 

   270     /**

   271      * Receive sim pn list information 

   272      *     

   273      *    

   274      * @param aStatus

   275      * @param aSSTFileData, pointer to sst file data

   276      * @return error value

   277      */

   278     TInt ReceivedSimPnListStatusResp( TUint8 aStatus, 

   279         SSSTFileData* aSSTFileData );

   280 

   281     /**

   282      * Receive sim table read information 

   283      * 

   284      *        

   285      * @param aStatus

   286      * @param AdnExtensionActive, boolean to tell if adn is active

   287      * @return error value

   288      */

   289     TInt ReceivedSimReadTableResp( TUint8 aStatus,

   290         TBool aAdnExtensionActive );

   291 

   292     /**

   293      * Get service provider name

   294      *   

   295      *

   296      * @return error value

   297      */

   298     TInt GetServiceProviderNameL( void );

   299 

   300     /**

   301      * Checks the state of the currently active PIN code.

   302      * 

   303      *        

   304      * @return KErrNone

   305      */

   306     TInt SimActivePinState( void );

   307 

   308     /**

   309      * Get ICC Type

   310      * 

   311      *        

   312      * @return status

   313      */

   314     TInt GetICCTypeL( void );

   315 

   316     /**

   317      * Set Complete Get ICC Type 

   318      * 

   319      *        

   320      * @param aDataPackage

   321      */

   322     void CompleteGetICCType( CMmDataPackage* aDataPackage );

   323 

   324     /*

   325      * Notify sim status ready

   326      * 

   327      *          

   328      * @return request error status

   329      */

   330     TInt NotifySimStatusReadyL( void );

   331 

   332     /*

   333      * Makes the MTC status request to adaptation

   334      * 

   335      *     

   336      * @return request error status

   337      */

   338     TInt MtcStateQueryL( void );

   339 

   340     /**

   341      * Updates security capabilities.

   342      * 

   343      *          

   344      * @param aEvent

   345      * @Return KErrNone

   346      */

   347     TInt UpdateSecurityCaps( 

   348         RMobilePhone::TMobilePhoneSecurityEvent aEvent );

   349 

   350     /**

   351      * Updates lock info

   352      * 

   353      *         

   354      * @param  aStatus

   355      * @param  aSetting

   356      * @param  aLock

   357      * @Return KErrNone

   358      */

   359     TInt UpdateLockInfo( 

   360         RMobilePhone::TMobilePhoneLockStatus aStatus,

   361         RMobilePhone::TMobilePhoneLockSetting aSetting,

   362         RMobilePhone::TMobilePhoneLock aLock );

   363 

   364     /**

   365      * Delivers security capabilities.

   366      * 

   367      *          

   368      * @param aCaps

   369      * @Return KErrNone

   370      */

   371     TInt GetSecurityCaps( TUint32* aCaps );

   372 

   373     /**

   374      * Changes the state of one of the security codes

   375      * 

   376      *          

   377      * @param aPackage

   378      * @Return KErrNone or error value

   379      */

   380     TInt ChangeSecurityCodeL( const TDataPackage& aPackage );

   381 

   382     /**

   383      * Sets new setting for a lock

   384      * 

   385      *          

   386      * @param aPackage 

   387      * @return KErrNone

   388      */

   389     TInt SetLockSettingL( CMmDataPackage* aPackage );

   390 

   391     /**

   392      * Handles Security Code verify

   393      * 

   394      *          

   395      * @param aPackage

   396      * @Return KErrNone or error value

   397      */

   398     TInt VerifySecurityCodeL( const TDataPackage& aPackage );

   399 

   400     /**

   401      * Handles SecurityCode abort

   402      *     

   403      *     

   404      * @param   aPackage

   405      * @param Return KErrNone or error value

   406      */

   407     TInt AbortSecurityCodeL( 

   408         const TDataPackage& aPackage );

   409     /**

   410      * Delivers password to extension for lock setting change

   411      *     

   412      *        

   413      * @param aCodes

   414      * @Return KErrNone

   415      */

   416     TInt DeliverCode( 

   417         RMobilePhone::TCodeAndUnblockCode aCodes );

   418     

   419     /**

   420      * Return extension mode

   421      * 

   422      *           

   423      * @param aMode, extension mode

   424      * @Return error value

   425      */

   426     TInt GetStaticExtensionMode( 

   427         RMobilePhone::TMobilePhoneNetworkMode* aMode );

   428 

   429     /**

   430      * Sets a network mode

   431      *     

   432      *        

   433      * @param aMode, Network Mode

   434      */

   435     void SetNetworkModeInExtensionPhone( 

   436         RMobilePhone::TMobilePhoneNetworkMode aMode );

   437 

   438     /**

   439      * Gets the list of detected networks

   440      * 

   441      *            

   442      * @return KErrNone or error code

   443      */

   444     TInt GetDetectedNetworksPhase1L( );

   445 

   446     /**

   447      * Selects a network

   448      * 

   449      *   

   450      * @param aDataPackage  

   451      * @return status: KErrNone or error code

   452      */

   453     TInt SelectNetworkL( const TDataPackage& aDataPackage );

   454 

   455     /**

   456      * Cancels an ongoing network selection

   457      * 

   458      *           

   459      * @return status: KErrNone or error code

   460      */

   461     TInt SelectNetworkCancelL( void );

   462 

   463     /**

   464      * Cancels an ongoing network search

   465      * 

   466      *           

   467      * @return status: KErrNone or error code

   468      */

   469     TInt GetDetectedNetworksCancelL( void );

   470 

   471     /**

   472      * Completes a network registration status changed in this extension

   473      * 

   474      *           

   475      * @param  aRegistrationStatus: new registration status

   476      */

   477     void CompleteNotifyNetworkRegistrationStatusChange

   478         ( RMobilePhone::TMobilePhoneRegistrationStatus aRegistrationStatus );

   479 

   480     /**

   481      * Gets the ICC access capabilites

   482      * 

   483      *             

   484      * @param aCaps, Pointer to return the capabilites value

   485      * @return KErrNone

   486      */

   487 	TInt GetIccAccessCaps ( TUint32* aCaps );

   488 

   489     /**

   490      * Sets the network selection setting

   491      * 

   492      *         

   493      * @param setting

   494      * @return status: KErrNone or error code

   495      */

   496     TInt SetNetworkSelectionSettingL( const TDataPackage& setting );

   497 

   498     /**

   499      * Gets the network registration status

   500      * 

   501      *        

   502      * @return status: KErrNone or error code

   503      */

   504     TInt GetNetworkRegistrationStatusL( void );

   505 

   506     /**

   507      * Gets the network registration status

   508      * 

   509      *        

   510      * @param aDataPackage

   511      */    

   512     void CompleteGetHomeNetwork( CMmDataPackage* aDataPackage );

   513     

   514     /**

   515      * Gets cached network's security level (encription level)

   516      * 

   517      *     

   518      * @param  aNetworkSecurity

   519      * @return status: KErrNone or error code

   520      */

   521     TInt GetNetworkSecurityLevel ( 

   522             RMobilePhone::TMobilePhoneNetworkSecurity& aNetworkSecurity ) const;

   523             

   524     /**

   525      * Sets cached network's security level (encription level)

   526      * 

   527      *        

   528      * @param  aNetworkSecurity

   529      * @return status: KErrNone or error code

   530      */

   531     TInt SetNetworkSecurityLevel ( 

   532             RMobilePhone::TMobilePhoneNetworkSecurity& aNetworkSecurity );

   533             

   534     /**

   535      * Gets the status of the ciphering indicator

   536      *     

   537      *     

   538      * @param const TDataPackage* aDataPackage

   539      * @return status: KErrNone or error code

   540      */

   541     TInt GetCipheringIndicatorStatusL( const TDataPackage* aDataPackage );

   542 

   543     /*

   544      * Returns the current ICCType

   545      * 

   546      *       

   547      * @return status: KErrNone or error code        

   548      */

   549     TInt CurrentICCType( void );

   550 

   551     /*

   552      * Gets the status and setting of a given lock

   553      * 

   554      *           

   555      * @param aPackage

   556      * @return request error status

   557      */

   558     TInt GetLockInfoL( const TDataPackage& aPackage );

   559     

   560 private: // Constructors

   561 

   562     /*

   563      * Constructor

   564      */

   565     CMmPhoneGsmWcdmaExt( void );

   566 

   567     /**

   568      * Class attributes are created in ConstructL

   569      */   

   570     void ConstructL( void );

   571     

   572 public: 

   573 

   574     /**  TICCType enumerates the SIM card types */

   575     enum TICCType

   576         {

   577         EICCTypeSim2GGsm,

   578         EICCTypeSim3G,

   579         EICCTypeSimUnknown

   580         };

   581 

   582     /**   TRequestedConditions */

   583     struct TRequestedConditions

   584         {

   585         TUint8 iTransactionId;

   586         CArrayFixFlat<TUint16>* iConditionArray;

   587         };

   588         

   589     /** TSetSSCallServiceStatusData  */

   590     struct TSetSSCallServiceStatusData

   591         {

   592         TUint8 iTransactionId;

   593         TUint8 iOperation;

   594         TUint16 iMmiSsCode;

   595         TUint8 iTypeOfNumber;

   596         TInt iNoReplyTime;

   597         TDesC16* iData;

   598         TUint8 iMmiBasicServiceCode;

   599         };

   600 

   601 private: // Data

   602 

   603     /**

   604      * Pointer to the mode independent Phone object

   605      * Not own.      

   606      */

   607     CMmPhoneTsy* iMmPhoneTsy;

   608 

   609     /**

   610      * Keeps track of pending service type requests for GetServiceTable

   611      */

   612     TUint8 iServiceTypesPending;

   613 

   614     /**

   615      * Indicates whether the whole service table is requested or just

   616      * one specific type info     

   617      */

   618     TBool iCompleteSTRequested;

   619 

   620     /**

   621      * pointer to the message manager

   622      * Not own.      

   623      */

   624     CMmMessageManagerBase* iMessageManager;

   625 

   626     /**

   627      * Keeps track of current SIM card type

   628      */

   629     TICCType iCurrentICCType;

   630 

   631     /**

   632      * Home network

   633      * Not own.      

   634      */

   635     RMobilePhone::TMobilePhoneNetworkInfoV8* iGsmHomeNetwork;  

   636 

   637     /**

   638      * Current network

   639      * Not own.      

   640      */

   641     RMobilePhone::TMobilePhoneNetworkInfoV8* iCurrentNwInfo; 

   642 

   643     /**

   644      * Current location id

   645      * Not own.      

   646      */

   647     RMobilePhone::TMobilePhoneLocationAreaV1* iCurrentLocationArea;

   648 

   649     /**

   650      * Fdn status is fetched

   651      */    

   652     TBool iFdnStatusFetched;

   653     

   654     /**

   655      * Adn is enabled

   656      */ 

   657     TBool iAdnEnabled;

   658     

   659     /**

   660      *  Adn status is fetched

   661      */    

   662     TBool iAdnStatusFetched;

   663 

   664     /**

   665      *  Empty buffer

   666      */

   667     TPtrC16 iEmptyBuffer;

   668 

   669     /**

   670      *  Nitz info

   671      */

   672     RMobilePhone::TMobilePhoneNITZ iNitzInfo;

   673 

   674     /**

   675      * All Call Services SupportedA?

   676      */    

   677     TBool iCallServicesSupportedAll;

   678 

   679     /**

   680      * call forwarding conditionally or unconditionally active

   681      */    

   682     RMobilePhone::TMobilePhoneCFActive iCallForwardingActiveType;

   683     

   684     /**

   685      * Call forwarding active service type

   686      */        

   687     RMobilePhone::TMobileService iCallForwardingActiveService;

   688 

   689     /**

   690      * Stored security capabilities

   691      */    

   692     TUint32 iSecurityCaps;

   693 

   694     /**

   695      * Variable for storing temporarily either PIN1 or Security code

   696      */    

   697     RMobilePhone::TMobilePassword iSecCode;

   698 

   699     /**

   700      * Status of security lock

   701      */    

   702     RMobilePhone::TMobilePhoneLockStatus iPhoneDeviceStatus;

   703     

   704     /**

   705      * Setting of security lock

   706      */    

   707     RMobilePhone::TMobilePhoneLockSetting iPhoneDeviceSetting;

   708 

   709     /**

   710      * Status of PIN1 lock

   711      */    

   712     RMobilePhone::TMobilePhoneLockStatus iICCStatus;

   713     

   714     /**

   715      * Setting of PIN1 lock

   716      */    

   717     RMobilePhone::TMobilePhoneLockSetting iICCSetting;

   718 

   719     /**

   720      * Status of security lock during the next start up

   721      */    

   722     RMobilePhone::TMobilePhoneLockStatus iPhoneToICCStatus;

   723     

   724     /**

   725      * Setting of security lock during the next start up

   726      */        

   727     RMobilePhone::TMobilePhoneLockSetting iPhoneToICCSetting;

   728 

   729     /**

   730      * Flag for home network info availability

   731      */

   732     TBool iIsHomeNetworkInfoAvailable;

   733 

   734     /**

   735      * Status of the network security (ciphering)

   736      */

   737     RMobilePhone::TMobilePhoneNetworkSecurity iNetworkSecurity;

   738 

   739     };

   740 

   741 #endif // CMMPHONEGSMWCDMAEXT_H

   742 

   743 // End of File