1 /*

     2 * Copyright (c) 2007-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:   Definition of a signal level observer API

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef VCCSIGNALLEVELOBSERVER_H

    21 #define VCCSIGNALLEVELOBSERVER_H

    22 

    23 #include <e32base.h>

    24 #include <wlanmgmtcommon.h>

    25 

    26 class CVccSignalLevelHandler;

    27 

    28 /**

    29  *  Defines the API for the signal level observer

    30  *

    31  *

    32  *  @code

    33  *   ?good_class_usage_example(s)

    34  *  @endcode

    35  *

    36  *  @lib vcchotrigger.dll

    37  *  @since S60 v3.2

    38  */

    39 class MVccSignalLevelObserver

    40     {

    41 public:

    42 

    43     /** Signal RSS class */

    44     enum TSignalStrengthClass

    45         {

    46         /** Received signal level is 'normal'. */

    47         ESignalClassNormal,

    48         /** Received signal level is 'weak'. */

    49         ESignalClassWeak,

    50         /** Signal strength is not known yet, no handover. */

    51         ESignalClassUndefined

    52         };

    53 

    54     /**

    55      * WLAN signal level has been changed.

    56      *

    57      * @since S60 3.2

    58      * @param aRSS level in absolute dBm values.

    59      * @param aRssClass specifies the current class of the received signal.

    60      * @return ?description

    61      */

    62     virtual void WlanSignalChanged(

    63             TInt32 aSignalStrength,

    64             TSignalStrengthClass aClass ) =  0;

    65 

    66     /**

    67      * GSM signal level has been changed.

    68      *

    69      * @since S60 3.2

    70      * @param aRSS level in absolute dBm values.

    71      * @param aRssClass specifies the current class of the received signal.

    72      */

    73     virtual void GsmSignalChanged(

    74             TInt32 aSignalStrength,

    75             TSignalStrengthClass aClass ) =  0;

    76 

    77     };

    78 

    79 #endif // VCCSIGNALLEVELOBSERVER_H