/*

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

* All rights reserved.

* This component and the accompanying materials are made available

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

* which accompanies this distribution, and is available

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

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:   ?Description

*

*/

#ifndef C_VCCGSMSIGNALLEVELHANDLER_H

#define C_VCCGSMSIGNALLEVELHANDLER_H

#include <e32base.h>

#include <etel.h>

#include "vccsignallevelhandler.h"

#include "vccsignallevelobserver.h"

#include "vccgsmnotifications.h"

#include "vccunittesting.h"

/**

 *  VCC GSM signal level handler.

 *

 *  @code

 *  void CExampleClass::ConstructL()

 *      {

 *      //Scan time for low and high 5 sec, low strength -85, high -70 dBm

 *      TSignalLevelParams params = { 5e6, 5e6, 85, 70 };

 *

 *      //

 *      iGsmHandler = CVccGsmSignalLevelHandler::NewL( *this, params );

 *      }

 *

 *  void CExampleClass::StartMonitoringL()

 *      {

 *      // Start monitoring gsm signal levels.

 *      iGsmHandler->StartL();

 *      }

 *

 *  void CExampleClass::StopMonitoringL()

 *      {

 *      // Stop monitoring.

 *      iGsmHandler->StopL();

 *      }

 *

 *  // Called when signal level changes.

 *  void CExampleClass::SignalLevelL(

 *      const CVccSignalLevelHandler* aHandlerInstance,

 *      TInt32 aSignalStrength,

 *      TSignalStrengthClass aClass )

 *      {

 *      if ( iGsmHandler == aHandlerInstance )

 *          {

 *          // GSM signal changed, do whatever is needed

 *          MakeHandoverDecision( aSignalStrength, aClass );

 *          }

 *      }

 *

 *

 *  @endcode

 *

 *  @lib vcchotrigger.dll

 *  @since S60 v3.2

 */

class CVccGsmSignalLevelHandler : public CVccSignalLevelHandler,

                                  public MVccGsmNotifications

    {

public:

    /**

     * Two-phased constructor.

     * @param aObserver Observer of this signal handler

     * @param aParams Parameters for signal monitoring

     */

    static CVccGsmSignalLevelHandler * NewL( MVccSignalLevelObserver & aObserver,

    const TSignalLevelParams& aParams );

    /**

     * Two-phased constructor.

     * @param aObserver Observer of this signal handler

     * @param aParams Parameters for signal monitoring

     */

    static CVccGsmSignalLevelHandler * NewLC(

        MVccSignalLevelObserver & aObserver,

        const TSignalLevelParams& aParams );

    /**

    * Destructor.

    */

    virtual ~CVccGsmSignalLevelHandler();

private:

    /**

     * C++ constructor

     * @param aObserver Reference to signal level observer

     * @param aParams Reference to signal level parameters

     */

    CVccGsmSignalLevelHandler( MVccSignalLevelObserver & aObserver,

                               const TSignalLevelParams& aParams );

    /**

     * Symbian second-phase constructor

     */

    void ConstructL();

private:

// from base class CVccSignalLevelHandler

    /**

    * @see CVccSignalLevelHandler::GetStrength()

    */

    void GetStrength();

    /**

    * @see CVccSignalLevelHandler::EnableNotificationsL()

    */

    void EnableNotificationsL();

    /**

    * @see CVccSignalLevelHandler::DisableNotifications()

    */

    void DisableNotifications();

    /**

    * @see CVccSignalLevelHandler::CancelGetStrength()

    */

    void CancelGetStrength();

    /**

    * @see CVccSignalLevelHandler::NotifyChanges()

    */

    void NotifyChanges( TInt32 aSignalStrength,

                        MVccSignalLevelObserver::TSignalStrengthClass aClass );

// from base class MVccGsmNotifications

    /**

    * @see MVccGsmNotifications::GsmStrengthChanged()

    */

    void GsmStrengthChanged( TInt32 aStrength );

private: // data

    /**

     * Etel server

     * Own.

     */

    RTelServer iEtelServer;

    /**

     * Phone based functionality

     * Own.

     */

    RMobilePhone iPhone;

    /**

     * Gsm signal level notifier 

     * Own.

     */

    CVccGsmNotifications* iGsmNotifications;

    /** Value of the GSM indication bar */

    TInt8 iBar;

    VCC_UNITTEST( UT_CVccGsmSignalLevelHandler )

    };

#endif  // C_VCCGSMSIGNALLEVELHANDLER_H