cbsref/telephonyrefplugins/atltsy/atcommand/generic/inc/tsyconfg.h
author hgs
Tue, 22 Jun 2010 11:02:32 +0100
changeset 44 8b72faa1200f
permissions -rw-r--r--
201024_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
44
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     1
// Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     2
// All rights reserved.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     3
// This component and the accompanying materials are made available
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     4
// under the terms of "Eclipse Public License v1.0"
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     5
// which accompanies this distribution, and is available
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     7
//
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     8
// Initial Contributors:
8b72faa1200f 201024_02
hgs
parents:
diff changeset
     9
// Nokia Corporation - initial contribution.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    10
//
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    11
// Contributors:
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    12
//
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    13
// Description:
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    14
// @file tsconfig.h
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    15
// This contains CTsyConfig which manage to get the modem settings from CommDB.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    16
// 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    17
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    18
#ifndef __TSYCONFG_H
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    19
#define __TSYCONFG_H
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    20
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    21
// system include
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    22
#include <e32base.h>
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    23
#include <d32comm.h>
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    24
#include <etelmm.h>
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    25
#include <commsdattypesv1_1.h>
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    26
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    27
// use name space
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    28
using namespace CommsDat;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    29
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    30
enum TConfigType
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    31
	{
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    32
	EConfigTypePreInit,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    33
	EConfigTypeInit,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    34
	EConfigTypeConnect,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    35
	EConfigTypeHangUp,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    36
	EConfigTypeFull,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    37
	EConfigTypeQuickInit,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    38
	EConfigTypeDDBugWorkAroundStart,
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    39
	EConfigTypeDDBugWorkAroundEnd
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    40
	};
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    41
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    42
/** 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    43
 * CTsyConfig Class
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    44
 * Creating the class will load the current modem settings.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    45
 * They may be refreshed by calling ReloadSettings.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    46
 * The ModemName, PortDriverName, CommPortName and String functions 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    47
 * will return descriptors to the relevant settings taken from 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    48
 * the current modem's settings.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    49
 * The CommConfig function will return a reference to the Configuration 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    50
 * structure in the current modem's settings. 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    51
 * All file closing, tidying and memory deallocation should be done 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    52
 * in the ~CTsyConfig destructor.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    53
 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    54
class CTsyConfig : public CBase
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    55
	{
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    56
public:
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    57
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    58
	 * Factory function.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    59
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    60
	 * @return A newly created CTsyConfig Object
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    61
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    62
	static CTsyConfig* NewL();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    63
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    64
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    65
	 * Virtual destructor
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    66
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    67
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    68
	~CTsyConfig();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    69
    
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    70
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    71
	 * Set current table view.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    72
	 * Try to get current table view by 10 times.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    73
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    74
	void SetCurrentTableViewL();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    75
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    76
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    77
	 * Get the field value by the name from modem Bearer record table in commdb.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    78
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    79
	 * @param aStringTag The field name
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    80
	 * @param aString The field value
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    81
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    82
	TInt ConfigModemStringL(const TDesC& aStringTag, TDes8& aString);
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    83
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    84
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    85
	 * Get the field value by the name from modem Bearer record table in commdb.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    86
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    87
	 * @param aStringTag The field name
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    88
	 * @param aString The field value
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    89
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    90
	TInt ConfigModemStringL(const TDesC& aStringTag, TDes16& aString);
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    91
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    92
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    93
	 * Gets the port config settings and masks out appropriate handshaking settings
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    94
	 * according to whether state is about to initialise, just connected or about to hang up
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    95
	 */ 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    96
	TInt PortConfig(TCommConfig& aConfigPckg, TConfigType aConfigType);
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    97
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    98
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
    99
	 * Stores the Speaker Preferences settings internally. These settings are stored on construction
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   100
	 * of the CTsyConfig object.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   101
	 * @param aSpeakerSetting Speaker Preference setting
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   102
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   103
	void GetSpeakerSettingPref(RCall::TMonitorSpeakerControl& aSpeakerSetting);
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   104
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   105
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   106
	 * Stores the Speaker Volume Preferences settings internally. These settings are stored on construction
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   107
	 * of the CTsyConfig object.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   108
	 * @param aSpeakerVolume Speaker Volume setting
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   109
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   110
	void GetSpeakerVolumePref(RCall::TMonitorSpeakerVolume& aSpeakerVolume);
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   111
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   112
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   113
	 * Stores the Dial Tone Preferences settings internally. These settings are stored on construction
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   114
	 * of the CTsyConfig object.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   115
	 * @param aWaitForDialTonePref Wait for Dial Tone Preference setting
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   116
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   117
	void GetWaitForDialTonePref(RCall::TWaitForDialTone& aWaitForDialTonePref);
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   118
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   119
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   120
	 * Opens a handle to CCommsDatabase	and positions the view on the default modem specified 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   121
	 * in the current Connected Modem record.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   122
	 * Note that the TSY does not keep the handle to the CCommsDatabase opened all the time, 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   123
	 * therefore this method is used to open the handle only when needed. The methods using 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   124
	 * this method are also responsible for calling ResetCurrentTableViews() to close the
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   125
	 * handle to the CCommsDatabase and to clean up the table views.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   126
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   127
	void GetCurrentTableViewsL();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   128
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   129
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   130
	 * Gets some commonly used settings from the Location and Modem Table Views and stores them
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   131
	 * internally as these are not likely to change. 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   132
	 * If some of these settings are not found in the table view then a predefined default values are
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   133
	 * used.
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   134
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   135
	void GetLocationModemSettingsL();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   136
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   137
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   138
	 * Closes the handle to CCommsDatabase and clears the view on the default modem specified 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   139
	 * in the current Connected Modem record. This method needs to be called after 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   140
	 * GetCurrentTableViewsL().
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   141
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   142
	void ResetCurrentTableViews();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   143
private:
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   144
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   145
	 * Constructor 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   146
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   147
	CTsyConfig();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   148
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   149
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   150
	 * 2nd constructor
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   151
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   152
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   153
	void ConstructL();
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   154
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   155
	/*
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   156
	 * Scan through the table for records containing Phonetsy.tsy
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   157
	 * Stop at the first instance of such a record and return the id
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   158
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   159
	 * @param aBearerId The Bearer ID in modem bearer table
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   160
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   161
 	void GetModemBearerIdL(TUint32& aBearerId);  	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   162
 	/*
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   163
 	 * Scan through the table for records containing MM.TSY
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   164
 	 * Stop at the first instance of such a record and return the id
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   165
 	 *
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   166
 	 * @param aBearerId The Bearer ID in modem bearer table
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   167
 	 * @param aLocationId 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   168
 	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   169
 	void GetLocationIdL(const TUint32& aBearerId, TUint32& aLocationId); 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   170
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   171
private:
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   172
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   173
	 * Store the modem configuration for connecting with AT Modem
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   174
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   175
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   176
	TCommConfigV01 iConfig;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   177
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   178
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   179
	 * The CommDB session
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   180
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   181
	 * Own
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   182
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   183
	CMDBSession* iDbSession;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   184
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   185
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   186
	 * Store the IAP number for the selected modem
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   187
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   188
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   189
	TUint32 iModemBearer;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   190
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   191
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   192
	 * Location ID
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   193
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   194
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   195
	TUint32 iLocationId;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   196
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   197
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   198
	 * An integer value that indicates the time to pause after using the dial-ot code
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   199
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   200
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   201
	TInt iInterval;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   202
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   203
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   204
	 * Monitor speaker control setting flags
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   205
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   206
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   207
	RCall::TMonitorSpeakerControl iSpeakerSetting;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   208
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   209
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   210
	 * Monitor speaker volume control setting flags
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   211
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   212
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   213
	RCall::TMonitorSpeakerVolume iSpeakerVolume;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   214
	
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   215
	/**
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   216
	 * Wait for dial tone flags
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   217
	 * 
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   218
	 */
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   219
	RCall::TWaitForDialTone iWaitForDialTonePref;
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   220
	};
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   221
8b72faa1200f 201024_02
hgs
parents:
diff changeset
   222
#endif