1 /*

     2 * Copyright (c) 2005-2007 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:  Provide interface for the client requestin network availability.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef __MUSAVACONNECTIONAVAILABILITY_H__

    21 #define __MUSAVACONNECTIONAVAILABILITY_H__

    22 

    23 

    24 #include "musavaavailability.h"

    25 #include "musavatelephonystatusobserver.h"

    26 #include "musavaconnectionmonitorobserver.h"

    27 #include "musunittesting.h"

    28 #include <e32base.h>

    29 #include <etelmm.h>

    30 

    31 class MMusAvaObserver;

    32 class CMusAvaSharedObject;

    33 class CMusAvaConnectionMonitor;

    34 class CConnMonEventBase;

    35 class CMusAvaNetworkRegistrationStatus;

    36 class CMusAvaNetworkModeStatus;

    37 class TAvailabilityStatus;

    38 class CMusAvaSettingsImp;

    39 class TMobilePhoneRegistrationStatus;

    40 

    41 

    42 /**

    43  *  Implemets register vailability.

    44  *

    45  *  Provide interface for the client to availability class.

    46  *

    47  *  @lib musavailabilityplugin.lib

    48  *  @since S60 v3.2

    49  */

    50 class CMusAvaConnectionAvailability : public CMusAvaAvailability,

    51                                       public MMusAvaTelephonyStatusObserver,

    52                                       public MMusAvaConnectionMonitorObserver

    53 	{

    54 	public:

    55 	/**

    56      * Two-phased constructor

    57      *

    58      * @since S60 v3.2

    59      * @param aObserver Pointer to observer intercase

    60      * @param aName availability name

    61      * @param aModules is data container

    62      * @return Returns pointer to CMusAvaInterface object

    63      */

    64     static CMusAvaConnectionAvailability* NewL( MMusAvaAvailabilityObserver& aObserver,

    65     											CMusAvaSettingsImp& aSettings );

    66 

    67 	static CMusAvaConnectionAvailability* NewLC( MMusAvaAvailabilityObserver& aObserver,

    68 												 CMusAvaSettingsImp& aSettings );

    69 

    70 	/**

    71      * Destructor

    72      */

    73 

    74     ~CMusAvaConnectionAvailability();

    75 

    76 protected:

    77 

    78 	CMusAvaConnectionAvailability( MMusAvaAvailabilityObserver& aObserver,

    79 								   CMusAvaSettingsImp& aSettings );

    80 

    81 	void ConstructL();

    82 

    83 // from base class CMusAvaAvailability

    84 

    85 public:

    86 

    87     /**

    88      * Executes for the availability.

    89      *

    90      * @since S60 v3.2

    91      * @return KErrNone if ExecutePatternL operation was

    92      *         successfully executed; system wide error otherwise

    93      */

    94     virtual void DoExecuteL();

    95 

    96      /**

    97      * Stop the execution.

    98      */

    99     virtual void Stop();

   100 

   101     /**

   102      * From CMusAvaAvailability.

   103      * Returns availability name.

   104      *

   105      * @return Name of *this* availability.

   106      */

   107     virtual MMusAvaObserver::TAvailabilityName Name();

   108 

   109 public: // from MMusAvaTelephonyStatusObserver

   110 

   111 	/**

   112      * Current Network Mode Status

   113 	 *

   114      * @since  S60 v3.2

   115      * @return

   116 	 */

   117     void PhoneNetworkModeStatus(

   118                             RMobilePhone::TMobilePhoneNetworkMode aStatus );

   119     /**

   120      * Current Network Registration Status

   121      *

   122      * @since  S60 v3.2

   123      * @return

   124      */

   125     void NetworkRegistrationStatus(

   126                     RMobilePhone::TMobilePhoneRegistrationStatus aRegStatus );

   127 

   128 public: //from MMusAvaConnectionMonitorObserver

   129 

   130    	/**

   131 	 * Event from connection monitor server

   132 	 *

   133 	 */

   134     void EventL(const CConnMonEventBase& aConnMonEvent);

   135 

   136 

   137 

   138 private:

   139 

   140 	 /**

   141      * Check needs to have manual activation 

   142      *

   143      * @since  S60 v3.2

   144      * @return TAvailabilityStatus is returned

   145      */

   146 	MMusAvaObserver::TAvailabilityStatus ManualActivationL();

   147 

   148     /**

   149      * Current test network registration agains the settings

   150      *

   151      * @since  S60 v3.2

   152      * @return TAvailabilityStatus is returned

   153      */

   154     MMusAvaObserver::TAvailabilityStatus NetworkRegistrationAndSettingsL();

   155 

   156 private: // data

   157 

   158     /**

   159      * Pointer to CMusAvaNetworkRegistrationStatus object

   160      */

   161     CMusAvaNetworkRegistrationStatus* iNetworkRegistrationStatus;

   162 

   163     /**

   164      * Pointer to CMusAvaNetworkModeStatus object

   165      */

   166     CMusAvaNetworkModeStatus* iNetworkModeStatus;

   167 

   168     /**

   169     * Pointer to CMusAvaConnectionMonitor object

   170     */

   171     CMusAvaConnectionMonitor* iConnectionMonitor;

   172 

   173      /**

   174      * Pointer to CMusAvaSharedObject

   175      */

   176     CMusAvaSharedObject* iSharedObj;

   177 

   178      /**

   179      * Connection ID

   180      */

   181     TUint iConnectionID;

   182     

   183      /**

   184      * Reference to availability settings 

   185      */

   186     CMusAvaSettingsImp& iSettings;

   187 

   188     MUS_UNITTEST( UT_CMusAvaConnectionAvailability )

   189     };

   190 

   191 

   192 #endif // __MUSAVACONNECTIONAVAILABILITY_H__