gssettingsuis/Gs/GSNetworkPlugin/Inc/GSNetworkPluginModel.h
author hgs
Thu, 04 Nov 2010 13:38:47 +0800
changeset 68 13e71d907dc3
permissions -rw-r--r--
201044
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
68
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  Network Settings model.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
#ifndef GSNETWORKPLUGINMODEL_H
hgs
parents:
diff changeset
    20
#define GSNETWORKPLUGINMODEL_H
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
#include <e32base.h>
hgs
parents:
diff changeset
    23
#include <e32property.h>
hgs
parents:
diff changeset
    24
#include <centralrepository.h>
hgs
parents:
diff changeset
    25
#include <PsetCSP.h>
hgs
parents:
diff changeset
    26
#include <MPsetNetworkModeObs.h>
hgs
parents:
diff changeset
    27
#include <PsetNetwork.h>
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
#include "GSNetworkPluginContainer.h"
hgs
parents:
diff changeset
    30
#include "GsNetworkPlugin.hrh"
hgs
parents:
diff changeset
    31
hgs
parents:
diff changeset
    32
// CONSTANTS
hgs
parents:
diff changeset
    33
hgs
parents:
diff changeset
    34
const TUint32 KGSNetworkModeCapsNotUpdated = KMaxTUint32;
hgs
parents:
diff changeset
    35
hgs
parents:
diff changeset
    36
// Used only for debugging. Init value for network mode debug strings.
hgs
parents:
diff changeset
    37
const TInt KGSNetworkModeDebugStrLen = 50;
hgs
parents:
diff changeset
    38
hgs
parents:
diff changeset
    39
hgs
parents:
diff changeset
    40
// Panic codes for used in this compilation unit
hgs
parents:
diff changeset
    41
enum TGSTelPluginModelPanicCodes
hgs
parents:
diff changeset
    42
    {
hgs
parents:
diff changeset
    43
    EGSTelPluinModelPanicNullPtr = 1
hgs
parents:
diff changeset
    44
    };
hgs
parents:
diff changeset
    45
// MACROS
hgs
parents:
diff changeset
    46
hgs
parents:
diff changeset
    47
// DATA TYPES
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
// FUNCTION PROTOTYPES
hgs
parents:
diff changeset
    50
hgs
parents:
diff changeset
    51
// FORWARD DECLARATIONS
hgs
parents:
diff changeset
    52
class MPsetNetworkModeObserver;
hgs
parents:
diff changeset
    53
class CPsetContainer;
hgs
parents:
diff changeset
    54
class CGSNetworkPluginContainer;
hgs
parents:
diff changeset
    55
class CGSNetworkPlugin;
hgs
parents:
diff changeset
    56
hgs
parents:
diff changeset
    57
// CLASS DEFINITION
hgs
parents:
diff changeset
    58
/**
hgs
parents:
diff changeset
    59
*  CGSNetworkPluginModel is the model class of GS network plugin.
hgs
parents:
diff changeset
    60
*  It provides functions to get and set setting values.
hgs
parents:
diff changeset
    61
*  @lib GSNetworkPlugin.lib
hgs
parents:
diff changeset
    62
*  @since Series 60_3.1
hgs
parents:
diff changeset
    63
hgs
parents:
diff changeset
    64
*/
hgs
parents:
diff changeset
    65
class CGSNetworkPluginModel : public CBase,
hgs
parents:
diff changeset
    66
                              private MPsetNetworkModeObserver
hgs
parents:
diff changeset
    67
    {
hgs
parents:
diff changeset
    68
    public:  // Constructor and destructor
hgs
parents:
diff changeset
    69
hgs
parents:
diff changeset
    70
        /**
hgs
parents:
diff changeset
    71
         * Overloaded constructor meant to be used from container
hgs
parents:
diff changeset
    72
         */
hgs
parents:
diff changeset
    73
        static CGSNetworkPluginModel* NewL(
hgs
parents:
diff changeset
    74
                CGSNetworkPluginContainer* aContainer,
hgs
parents:
diff changeset
    75
                CGSNetworkPlugin* aPlugin );
hgs
parents:
diff changeset
    76
hgs
parents:
diff changeset
    77
        /**
hgs
parents:
diff changeset
    78
        * Destructor
hgs
parents:
diff changeset
    79
        */
hgs
parents:
diff changeset
    80
        ~CGSNetworkPluginModel();
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
    public: // new ones
hgs
parents:
diff changeset
    83
        /**
hgs
parents:
diff changeset
    84
        * Gets CSP status
hgs
parents:
diff changeset
    85
        *
hgs
parents:
diff changeset
    86
        * @return ETrue: CSP is set
hgs
parents:
diff changeset
    87
        *         EFalse: CSP is not set
hgs
parents:
diff changeset
    88
        */
hgs
parents:
diff changeset
    89
        TBool GetCSPStatus();
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
        /**
hgs
parents:
diff changeset
    92
        * Sets CSP Active
hgs
parents:
diff changeset
    93
        * @param aValue TBool
hgs
parents:
diff changeset
    94
        * @return ETrue: CSP is set
hgs
parents:
diff changeset
    95
        *         EFalse: CSP is not set
hgs
parents:
diff changeset
    96
        */
hgs
parents:
diff changeset
    97
        void SetCSPActiveL( TBool aValue );
hgs
parents:
diff changeset
    98
hgs
parents:
diff changeset
    99
         /**
hgs
parents:
diff changeset
   100
        * Get the network mode status from Shared data. This value is used
hgs
parents:
diff changeset
   101
        * to display/hide the "network mode UI" list item under network
hgs
parents:
diff changeset
   102
        * folder. Currently, this value is ONLY read and not written.
hgs
parents:
diff changeset
   103
        * @return ETrue if the value is 1 in SD.
hgs
parents:
diff changeset
   104
        */
hgs
parents:
diff changeset
   105
        TBool IsNetworkModeVisible();
hgs
parents:
diff changeset
   106
hgs
parents:
diff changeset
   107
        /**
hgs
parents:
diff changeset
   108
        * Returns if CSP setting is supported
hgs
parents:
diff changeset
   109
        * @param aSettingNumber TInt
hgs
parents:
diff changeset
   110
        * @return ETrue: CSP is supported
hgs
parents:
diff changeset
   111
        *         EFalse: CSP is not supported
hgs
parents:
diff changeset
   112
        */
hgs
parents:
diff changeset
   113
        TBool IsSettingSupported( TInt aSettingNumber );
hgs
parents:
diff changeset
   114
hgs
parents:
diff changeset
   115
                /*
hgs
parents:
diff changeset
   116
        * Returns MCN value from shared data.
hgs
parents:
diff changeset
   117
        * @param aId value of shared data key
hgs
parents:
diff changeset
   118
        * @return ETrue: no errors
hgs
parents:
diff changeset
   119
        *         EFalse: an error has occurred
hgs
parents:
diff changeset
   120
        */
hgs
parents:
diff changeset
   121
        TBool GetMCNSettingValue( TInt& aId );
hgs
parents:
diff changeset
   122
hgs
parents:
diff changeset
   123
        /*
hgs
parents:
diff changeset
   124
        * Sets MCN value to shared data.
hgs
parents:
diff changeset
   125
        * @param aId value of shared data key
hgs
parents:
diff changeset
   126
        * @return ETrue: no errors
hgs
parents:
diff changeset
   127
        *         EFalse: an error has occurred
hgs
parents:
diff changeset
   128
        */
hgs
parents:
diff changeset
   129
        TBool SetMCNSettingValue( TInt& aId );
hgs
parents:
diff changeset
   130
hgs
parents:
diff changeset
   131
        /*
hgs
parents:
diff changeset
   132
        * Gets the supported network mode list from shared data.
hgs
parents:
diff changeset
   133
        * @return the bit-masked value from shared data
hgs
parents:
diff changeset
   134
        */
hgs
parents:
diff changeset
   135
        TInt GetSupportedNetworksL();
hgs
parents:
diff changeset
   136
hgs
parents:
diff changeset
   137
        /**
hgs
parents:
diff changeset
   138
        * Check if graphical network list is supported.
hgs
parents:
diff changeset
   139
        * This is handled using GS local variation
hgs
parents:
diff changeset
   140
        * @return ETrue if supported.
hgs
parents:
diff changeset
   141
        */
hgs
parents:
diff changeset
   142
        TBool GraphicalNetworkListSupportedL();
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
        /**
hgs
parents:
diff changeset
   145
        * Return local variation value for automatic network search
hgs
parents:
diff changeset
   146
        * support. Local key = EGSConfigNoAutoToAutoNetworkSearch
hgs
parents:
diff changeset
   147
        * See GeneralSettingsVariant.hrh for details
hgs
parents:
diff changeset
   148
        * @return local variation value
hgs
parents:
diff changeset
   149
        */
hgs
parents:
diff changeset
   150
        TBool AutomaticNetworkSearchSupportedL();
hgs
parents:
diff changeset
   151
hgs
parents:
diff changeset
   152
hgs
parents:
diff changeset
   153
        /**
hgs
parents:
diff changeset
   154
        *  Creates phone settings engine.
hgs
parents:
diff changeset
   155
        *  @param aContainer Container object as reference
hgs
parents:
diff changeset
   156
        */
hgs
parents:
diff changeset
   157
        void CreatePhoneSettingsEngineL();
hgs
parents:
diff changeset
   158
hgs
parents:
diff changeset
   159
        /**
hgs
parents:
diff changeset
   160
        * StartAsynGetCurrentNetworkModeSelectionL 
hgs
parents:
diff changeset
   161
        */
hgs
parents:
diff changeset
   162
        void StartAsynGetCurrentNetworkModeSelectionL();     
hgs
parents:
diff changeset
   163
        
hgs
parents:
diff changeset
   164
        /**
hgs
parents:
diff changeset
   165
         * StartSynGetCurrentNetworkModeSelectionL
hgs
parents:
diff changeset
   166
         */
hgs
parents:
diff changeset
   167
        void StartSynGetCurrentNetworkModeSelectionL();
hgs
parents:
diff changeset
   168
        
hgs
parents:
diff changeset
   169
        /**
hgs
parents:
diff changeset
   170
        * GetNetworkSelectionMode
hgs
parents:
diff changeset
   171
        */
hgs
parents:
diff changeset
   172
        MPsetNetworkSelect::TSelectMode GetNetworkSelectionMode();
hgs
parents:
diff changeset
   173
hgs
parents:
diff changeset
   174
        /**
hgs
parents:
diff changeset
   175
        * See iNetworkMode.
hgs
parents:
diff changeset
   176
        * @return TUint32 Current network mode value,  RMmCustomAPI::KCapsNetworkModeUmts etc...
hgs
parents:
diff changeset
   177
        */
hgs
parents:
diff changeset
   178
        TUint32 GetNetworkMode();
hgs
parents:
diff changeset
   179
        
hgs
parents:
diff changeset
   180
        /**
hgs
parents:
diff changeset
   181
        * SetNetworkModeL 
hgs
parents:
diff changeset
   182
        */
hgs
parents:
diff changeset
   183
        void SetNetworkModeL( TUint32 aNetworkMode );
hgs
parents:
diff changeset
   184
hgs
parents:
diff changeset
   185
        /**
hgs
parents:
diff changeset
   186
        * Prints model state to debug output in case of debug build.
hgs
parents:
diff changeset
   187
        */
hgs
parents:
diff changeset
   188
        void PrintState();
hgs
parents:
diff changeset
   189
hgs
parents:
diff changeset
   190
        /**
hgs
parents:
diff changeset
   191
        * Used only in debug mode: verifies network state with the UI selection.
hgs
parents:
diff changeset
   192
        * For debugging purposes only.
hgs
parents:
diff changeset
   193
        */
hgs
parents:
diff changeset
   194
        void CheckState( TGSNetworkModeItems aMode );
hgs
parents:
diff changeset
   195
        
hgs
parents:
diff changeset
   196
        /**
hgs
parents:
diff changeset
   197
        * Get net work mode change key value.
hgs
parents:
diff changeset
   198
        * @return the net work mode change key value
hgs
parents:
diff changeset
   199
        */
hgs
parents:
diff changeset
   200
        TInt GetPsmNetworkModeChangeL();
hgs
parents:
diff changeset
   201
hgs
parents:
diff changeset
   202
hgs
parents:
diff changeset
   203
        TBool IsCallActive();
hgs
parents:
diff changeset
   204
hgs
parents:
diff changeset
   205
    private: // Private constructors
hgs
parents:
diff changeset
   206
hgs
parents:
diff changeset
   207
        /**
hgs
parents:
diff changeset
   208
        * Default C++ contructor
hgs
parents:
diff changeset
   209
        */
hgs
parents:
diff changeset
   210
        CGSNetworkPluginModel( CGSNetworkPluginContainer* aContainer,
hgs
parents:
diff changeset
   211
                               CGSNetworkPlugin* aPlugin );
hgs
parents:
diff changeset
   212
hgs
parents:
diff changeset
   213
        /**
hgs
parents:
diff changeset
   214
        * Symbian OS default constructor
hgs
parents:
diff changeset
   215
        * @return void
hgs
parents:
diff changeset
   216
        */
hgs
parents:
diff changeset
   217
        void ConstructL();
hgs
parents:
diff changeset
   218
hgs
parents:
diff changeset
   219
        void ConstructBaseItemsL();
hgs
parents:
diff changeset
   220
hgs
parents:
diff changeset
   221
        /**
hgs
parents:
diff changeset
   222
        * Initialize CenRep keys used in this class
hgs
parents:
diff changeset
   223
        */
hgs
parents:
diff changeset
   224
        void InitializeCentralRepositoryL();
hgs
parents:
diff changeset
   225
hgs
parents:
diff changeset
   226
        /**
hgs
parents:
diff changeset
   227
        * Un-initialize CenRep keys used in this class
hgs
parents:
diff changeset
   228
        */
hgs
parents:
diff changeset
   229
        void UninitializeCentralRepository();
hgs
parents:
diff changeset
   230
hgs
parents:
diff changeset
   231
    private: // from base class MPsetNetworkModeObserver
hgs
parents:
diff changeset
   232
hgs
parents:
diff changeset
   233
        /**
hgs
parents:
diff changeset
   234
        * @@see MPsetNetworkModeObserver::HandleNetworkSystemModeEventsL.
hgs
parents:
diff changeset
   235
        * @since 2.6
hgs
parents:
diff changeset
   236
        */
hgs
parents:
diff changeset
   237
        void HandleNetworkSystemModeEventsL(
hgs
parents:
diff changeset
   238
            const MPsetNetworkModeObserver::TServiceRequest aRequest,
hgs
parents:
diff changeset
   239
            const TUint32 aNetworkModeCaps );
hgs
parents:
diff changeset
   240
hgs
parents:
diff changeset
   241
hgs
parents:
diff changeset
   242
        /**
hgs
parents:
diff changeset
   243
        * @@see MPsetNetworkModeObserver::HandleNetworkErrorL.
hgs
parents:
diff changeset
   244
        * @since 2.6
hgs
parents:
diff changeset
   245
        */
hgs
parents:
diff changeset
   246
        void HandleNetworkErrorL(
hgs
parents:
diff changeset
   247
            const MPsetNetworkModeObserver::TServiceRequest aRequest,
hgs
parents:
diff changeset
   248
            const TInt aError );
hgs
parents:
diff changeset
   249
hgs
parents:
diff changeset
   250
    private:
hgs
parents:
diff changeset
   251
        // Central repository objects
hgs
parents:
diff changeset
   252
        CRepository* iNetworkRepository;
hgs
parents:
diff changeset
   253
        CRepository* iGSVariationRepository;
hgs
parents:
diff changeset
   254
  		CPsetCustomerServiceProfile* iCSP; //check if CSP is active
hgs
parents:
diff changeset
   255
  		TInt iLocalVariationValues; //local variated constants
hgs
parents:
diff changeset
   256
hgs
parents:
diff changeset
   257
        // PhoneSettings engine object for network mode
hgs
parents:
diff changeset
   258
        CPsetNetwork* iPhoneSettingsEngine;
hgs
parents:
diff changeset
   259
        CPsetContainer* iSettingsContainer;
hgs
parents:
diff changeset
   260
hgs
parents:
diff changeset
   261
        // Current network mode value from RMmCustomAPI::TNetworkModeCaps.
hgs
parents:
diff changeset
   262
        // enum RMmCustomAPI::TNetworkModeCaps
hgs
parents:
diff changeset
   263
        //    {
hgs
parents:
diff changeset
   264
        //    KkNetworkModeGsm = 0x01,
hgs
parents:
diff changeset
   265
        //    KCapsNetworkModeUmts = 0x02,
hgs
parents:
diff changeset
   266
        //    KCapsNetworkModeDual = 0x04
hgs
parents:
diff changeset
   267
        //    };
hgs
parents:
diff changeset
   268
        // and in addition: KGSNetworkModeCapsNotUpdated
hgs
parents:
diff changeset
   269
        //
hgs
parents:
diff changeset
   270
        // Stores value aNetworkModeCaps from:
hgs
parents:
diff changeset
   271
        // MPsetNetworkModeObserver::HandleNetworkSystemModeEventsL(..., TUint32 aNetworkModeCaps )
hgs
parents:
diff changeset
   272
        //
hgs
parents:
diff changeset
   273
        TUint32 iNetworkMode;
hgs
parents:
diff changeset
   274
        
hgs
parents:
diff changeset
   275
        // Temporarily value of the requested network mode. Stores requested 
hgs
parents:
diff changeset
   276
        // mode which is updated to iNetworkMode in case request succeeds and 
hgs
parents:
diff changeset
   277
        // HandleNetworkSystemModeEventsL is called.  
hgs
parents:
diff changeset
   278
        TUint32 iRequestedNetworkMode;
hgs
parents:
diff changeset
   279
hgs
parents:
diff changeset
   280
        // Pointer for communicating with container. Not owned.
hgs
parents:
diff changeset
   281
        CGSNetworkPluginContainer* iContainer;
hgs
parents:
diff changeset
   282
hgs
parents:
diff changeset
   283
        // Reference to network plugin. Not owned.
hgs
parents:
diff changeset
   284
        CGSNetworkPlugin* iPlugin;
hgs
parents:
diff changeset
   285
    };
hgs
parents:
diff changeset
   286
hgs
parents:
diff changeset
   287
#endif //GSNETWORKPLUGINMODEL_H
hgs
parents:
diff changeset
   288
hgs
parents:
diff changeset
   289
// End of File