/*

* Copyright (c) 2007-2008 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:   Definition of the WLAN signal level handler

*

*/

#ifndef VCCWLANSIGNALLEVELHANDLER_H

#define VCCWLANSIGNALLEVELHANDLER_H

#include <e32base.h>

#include <wlanmgmtcommon.h>

#include "vccsignallevelhandler.h"

#include "vccsignallevelobserver.h"

class CWlanMgmtClient;

class CVccEngPsProperty;

/**

 *  WLAN signal level observer

 *

 *

 *  @code

 *

 *  TSignalLevelParams params = { 8e6, 8e6, 80, 40 };

 *

 *  CMyClass::ConstructL()

 *      {

 *      iSignalLevelHandler = CVccWlanSignalLevelHandler::NewL( *this, params );

 *      iSignalLevelHandler->StartL();

 *      }

 *

 *  CMyClass::StopMonitoring()

 *      {

 *      iSignalLevelHandler->Stop();

 *      }

 *

 *  CMyClass::SetNewParametersAndStartL()

 *      {

 *      TSignalLevelParams params = { 8e6, 10e6, 80, 20 };

 *

 *      iSignalLevelHandler->SetParams( params );

 *

 *      // Start using new parameters

 *      iSignalLevelHandler->StartL();

 *      }

 *

 *  CMyClass::~CMyClass()

 *      {

 *      delete iSignalLevelHandler;

 *      }

 *

 *

 *  CMyClass::WlanSignalChanged(

 *      TInt32 aRss,

 *      TSignalRssClass aRssClass )

 *      {

 *      // Signal level changed. Must do something

 *      if ( aRssClass == ESignalClassWeak )

 *          {

 *          // Do handover if the signal is very weak

 *          if ( aRss > EReallyBadSignalLevel )

 *              {

 *              }

 *          }

 *      }

 *

 *

 *

 *  @endcode

 *

 *  @lib vcchotrigger.dll

 *  @since S60 v3.2

 */

class CVccWlanSignalLevelHandler : public CVccSignalLevelHandler,

                                   public MWlanMgmtNotifications

    {

public:

    /**

     * Two-phased constructor.

     * @param aObserver Observer which will be notified upon signal changes.

     * @param aParams Parameters for the timer and signal levels.

     */

    static CVccWlanSignalLevelHandler * NewL(

            MVccSignalLevelObserver& aObserver,

            const TSignalLevelParams& aParams, CVccEngPsProperty& aPsProperty );

    /**

     * Two-phased constructor.

     * @param aObserver Observer which will be notified upon signal changes.

     * @param aParams Parameters for the timer and signal levels.

     */

    static CVccWlanSignalLevelHandler* NewLC(

            MVccSignalLevelObserver& aObserver,

            const TSignalLevelParams& aParams, CVccEngPsProperty& aPsProperty );

    /**

    * Destructor.

    */

    virtual ~CVccWlanSignalLevelHandler();

private:

    /**

     * Symbian second-phase constructor

     *

     * @since S60 3.2

     */

    void ConstructL();

    /**

     * C++ constructor

     *

     * @since S60 3.2

     * @param aObserver Observer which will be notified upon signal changes.

     * @param aParams Parameters for the timer and signal levels.

     */

    CVccWlanSignalLevelHandler( MVccSignalLevelObserver& aObserver,

                               const TSignalLevelParams& aParams, CVccEngPsProperty& aPsProperty);

// 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 MWlanMgmtNotifications

    /**

     * @see MWlanMgmtNotifications::RssChanged()

     */

    void RssChanged( TWlanRssClass aRssClass, TUint aRss );

    /**

     * @see MWlanMgmtNotifications::BssidChanged()

     */

    void BssidChanged( TWlanBssid& aNewBSSID );

    /**

     * @see MWlanMgmtNotifications::OldNetworksLost()

     */

    void OldNetworksLost();

private: // data

    /**

     * WLAN management client.

     * Own.

     */

    CWlanMgmtClient* iWlanMgmt;

    /**

     * for informing the states

     */

    CVccEngPsProperty& iVccPsp;

    };

#endif // VCCWLANSIGNALLEVELHANDLER_H