/*

 * 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:

 * This is a header file for following classes:

 * ConnMonScanWlanAps.

 */

#ifndef WLANQTUTILSCONMONWRAPPER_S60_P_H_

#define WLANQTUTILSCONMONWRAPPER_S60_P_H_

// INCLUDES

#include <e32base.h>

#include <rconnmon.h>

#include "wlanqtutilscommon.h"

class ConMonWrapper;

QT_BEGIN_NAMESPACE

// CLASS DECLARATION

/**

 * ConnMonScanWlanAps class.

 */

class ConnMonScanWlanAps : public CActive

    {

public:

    // Constructor and destructor

    /**

     * Default constructor

     */

    ConnMonScanWlanAps(ConMonWrapper *wrapper);

    /**

     * Destructor

     */

    ~ConnMonScanWlanAps();

public:

    // New functions    

    /**

     * scanAvailableWlanAPs

     * scans all available WLAN APs

     * @return error code

     */

    int scanAvailableWlanAPs();

private:

    // From CActive

    /**

     * Implements cancellation of an outstanding request.

     */

    void DoCancel();

    /**

     * Handles an active object's request completion event.

     */

    void RunL();

    /**

     * conMon2WlanQtUtilsSecModeMap

     * Maps Connection monitor's WLAN security mode value into WlanQtUtilsWlanSecMode.

     * @aSecMode: security mode, ConnMon style,

     * @return: security mode, Wlan Qt Utilities style.

     */

    WlanQtUtilsWlanSecMode conMon2WlanQtUtilsSecModeMap(TUint aSecMode);

private:

    // Data

    /**

     * q_ptr pointer to ConMonWrapper

     * Owned by ConnMonScanWlanAps object, instantiated in

     * constructor.

     */

    ConMonWrapper *q_ptr;

    /**

     * Handle to Connection Monitor Server

     */

    RConnectionMonitor iMonitor;

    /**

     * Scan package used with Connection Monitor Server scan request

     * Owned by ConnMonScanWlanAps object.

     */

    CConnMonWlanNetworksPtrArrayPckg* wlanBuf;

    /**

     * wlan pointer variable used with Connection Monitor Server scan request

     */

    TPtr wlanPtr;

    };

// CLASS DECLARATION

/**

 * ConnMonConnInfo class.

 */

class ConnMonConnInfo : public MConnectionMonitorObserver

    {

public:

    // Constructor and destructor

    /**

     * Default constructor

     */

    ConnMonConnInfo(ConMonWrapper *wrapper);

    /**

     * Destructor

     */

    ~ConnMonConnInfo();

public:

    // New functions    

    /**

     * Return active connection information.

     * 

     * @return Information of active connection, if one exists.

     */ 

    WlanQtUtilsActiveConn *activeConnection();

    /**

     * Returns information of a connection with the given connection ID.

     * 

     * @param[in] connectionId Connection ID.

     * @return Information of the given connection, if one exists.

     */ 

    WlanQtUtilsActiveConn *connectionInfo(uint connectionId);

    /**

     * Updates information of a given active connection. Missing information will be filled in

     * and information that is dynamic in nature will be updated.

     * 

     * @param[in] activeConn Current data of an active connection which will be updated.

     *                       Connection ID and bearer type have to be valid.

     */

    void activeConnInfoUpdate( WlanQtUtilsActiveConn *activeConn );

private:

    // New private functions

    /** 

     * Starts monitoring observer events

     */

    void StartMonitoringL();

    /** 

     * Stops monitoring observer events

     */

    void StopMonitoring();

    /**

     * Event method is called every time an event occures

     */

    void EventL(const CConnMonEventBase& aConnMonEvent);

    /**

     * Maps Connection Monitor's WLAN connection mode value into

     * WlanQtUtilsWlanConnMode.

     *

     * @param aConnMode Connection mode in Connection Monitor's style.

     * @return Connection mode in Wlan Qt Utilities style.

     */

    static WlanQtUtilsWlanConnMode connMon2WlanQtUtilsConnModeMap(TInt aConnMode);

    /**

     * Maps Connection Monitor's connection status value into WlanQtUtilsConnectionStatus.

     *

     * @param aConnectionStatus Connection status as used by Connection Monitor server.

     *                          These status are defined in nifvar.h.

     * @return Connection status in Wlan Qt Utilities style.

     */

    static WlanQtUtilsConnectionStatus connMon2WlanQtUtilsConnectionStatusMap(TInt aConnectionStatus);

    /**

     * Maps Connection Monitor's bearer type value into WlanQtUtilsBearerType.

     *

     * @param aBearerType Bearer type as used by Connection Monitor server.

     * @return Bearer type in Wlan Qt Utilities style.

     */

    static WlanQtUtilsBearerType connMon2WlanQtUtilsBearerTypeMap(TInt aBearerType);

private:

    // Data

    /**

     * q_ptr pointer to ConMonWrapper

     * Owned by ConMonWrapperPrivate object, instantiated in

     * constructor.

     */

    ConMonWrapper *q_ptr;

    /** Handle to Connection Monitor Server. */

    RConnectionMonitor iMonitor;

    /** Request status. */

    TRequestStatus iStatus;

    /** Indicates whether connection monitoring is ON. */

    TBool iMonitoring;

private: // Friend classes

    // TestWlanQtUtils is defined as a friend class in order to be able to

    // call event handlers of wrappers.

    friend class TestWlanQtUtils;

    };

// CLASS DECLARATION

/**

 * ConnMonConnDisconnect class.

 */

class ConnMonConnDisconnect : public CActive

    {

public:

    // Constructor and destructor

    /**

     * Default constructor

     */

    ConnMonConnDisconnect(ConMonWrapper *wrapper);

    /**

     * Destructor

     */

    ~ConnMonConnDisconnect();

public:

    // New functions    

    /**

     * disconnectConnection

     * Stop connection

     */

    void disconnectConnection(int iapId);

private:

    // From CActive

    /**

     * Implements cancellation of an outstanding request.

     */

    void DoCancel();

    /**

     * Handles an active object's request completion event.

     */

    void RunL();

private:

    // Data

    /**

     * q_ptr pointer to ConMonWrapper

     * Owned by ConMonWrapperPrivate object, instantiated in

     * constructor.

     */

    ConMonWrapper *q_ptr;

    /**

     * Handle to Connection Monitor Server

     */

    RConnectionMonitor iMonitor;

    };

QT_END_NAMESPACE

#endif /* WLANQTUTILSCONMONWRAPPER_S60_P_H_ */

// End of file