convergedconnectionhandler/cchserver/inc/cchconnmonhandler.h
branchRCL_3
changeset 22 d38647835c2e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/convergedconnectionhandler/cchserver/inc/cchconnmonhandler.h	Wed Sep 01 12:29:57 2010 +0100
@@ -0,0 +1,321 @@
+/*
+* Copyright (c) 2007-2010 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:  CCCHConnMonHandler declaration
+*
+*/
+
+
+#ifndef C_CCHCONNMONHANDLER_H
+#define C_CCHCONNMONHANDLER_H
+
+// INCLUDES
+#include <e32std.h>
+#include <e32base.h>
+#include <rconnmon.h>
+
+// CONSTANTS
+// None
+
+// MACROS
+// None
+
+// DATA TYPES
+// None
+
+// FUNCTION PROTOTYPES
+// None
+
+// FORWARD DECLARATIONS
+class CCCHServerBase;
+class MCCHConnMonHandlerNotifier;
+
+// CLASS DECLARATION
+class TCCHConnectionInfo
+    {
+public:
+    TUint iIapId;
+    TUint iConnId;
+    };
+
+/**
+ *  CCCHConnMonHandler declaration
+ *  Handles Connection Monitor for CCH server
+ *  @lib cchserver.exe
+ *  @since S60 3.2
+ */
+NONSHARABLE_CLASS( CCCHConnMonHandler ) : public CActive,
+                                          private MConnectionMonitorObserver
+    {
+public: // Constructors and destructor
+
+    /**
+     * State's of object
+     */
+    enum TCCHConnMonHandlerState
+        {
+          EUninitialized,   /// Uninitialized
+          EInitialized,     /// Initalized
+          EGetIAPS,
+          EGetSNAPs,
+          EGetIAP,
+          EGetConnectionCount,
+          EError            /// Error condition
+        };
+
+    /**
+     * Two-phased constructor.
+     */
+    static CCCHConnMonHandler* NewL( CCCHServerBase& aServer );
+
+    /**
+     * Two-phased constructor.
+     */
+    static CCCHConnMonHandler* NewLC( CCCHServerBase& aServer );
+
+    /**
+     * Destructor.
+     */
+    virtual ~CCCHConnMonHandler();
+
+public: // New functions
+
+    /**
+     * Scan available networks
+     *
+     * @since S60 9.2
+     * @param aWlanScan ETrue if WLAN network scan needed
+     * @param aObserver Completion notified by method
+     *        NetworkScanningCompletedL() if set.
+     */
+    void ScanNetworks( TBool aWlanScan = EFalse,
+	    MCCHConnMonHandlerNotifier* aObserver = NULL );
+
+    /**
+     * Cancel network scanning
+     * @since S60 3.2
+     */
+    void ScanNetworksCancel();
+
+    /**
+     * Is Snap available
+     * @since S60 3.2
+     * @param aSNAPId
+     * @return ETrue if SNAP is available
+     */
+    TBool IsSNAPAvailable( TUint aSNAPId ) const;
+
+    /**
+     * Is IAP available
+     * @since S60 3.2
+     * @param aIapId
+     * @return ETrue if IAP is available
+     */
+    TBool IsIapAvailable( TUint aIapId ) const;
+
+    /**
+     * Sets observer to notify if SNAPs availability is changed
+     *
+     * @since S60 9.2
+     * @param aObserver Notifies by method
+     *        SNAPsAvailabilityChanged(). NULL turns off notify.
+     */
+    void SetSNAPsAvailabilityChangeListener( MCCHConnMonHandlerNotifier* aObserver );
+        
+	/**
+     * Collects all connected IAP Ids and Connection Ids to array.
+     */
+    void StartMonitoringConnectionChanges();
+	
+	/**
+     * Connected IAPs getter.
+     * @param aIapIds
+     */
+    void StopMonitoringConnectionChanges( RArray<TUint>& aIapIds );
+
+protected: // From base classes
+
+    /**
+     * From CActive
+     * @since Series 60 3.0
+     */
+    void RunL();
+
+    /**
+     * From CActive
+     * @since Series 60 3.0
+     */
+    void DoCancel();
+
+private: // From MConnectionMonitorObserver
+
+    /**
+     * @see MConnectionMonitorObserver, called when ConnMon event occured.
+     */
+    void EventL( const CConnMonEventBase &aConnMonEvent );
+
+private:
+
+    /**
+     * C++ default constructor.
+     */
+    CCCHConnMonHandler( CCCHServerBase& aServer );
+
+    /**
+     * By default Symbian 2nd phase constructor is private.
+     */
+    void ConstructL();
+
+    /**
+     * Get IAPs from Connection Monitor and performs network scan
+     * @since S60 3.2
+     * @param aBearerId Bearer specific connection id.
+     */
+    void GetIaps( TConnMonBearerId aBearerId );
+
+    /**
+     * Updates available IAP Array
+     * @since S60 3.2
+     * @param aIaps available IAPs
+     */
+    void UpdateIapArray( TConnMonIapInfo aIaps );
+
+    /**
+     * Get SNAPs from Connection Monitor
+     * @since S60 3.2
+     */
+    void GetSNAPs();
+
+    /**
+     * Updates available SNAP array
+     * @since S60 3.2
+     * @param aSNAPs available SNAPs
+     */
+    void UpdateSnapArray( TConnMonSNAPInfo aSNAPs );
+
+    /**
+     * Request SNAP/IAP availability notifications from Connection Monitor.
+     * @since S60 3.2
+     */
+    void NotifyL() ;
+
+    /**
+     * Stops notifications.
+     * @since S60 3.2
+     */
+    void StopNotify();
+
+    /**
+     * Call back function to the CPeriodic.
+     * 
+     * @since S60 9.2
+     * @param aAny A pointer to this class.
+     * @return Error code
+     */
+    static TInt PeriodicTimerCallBack(TAny* aAny);
+        
+	/**
+     * Connection count solver.
+     */
+    void GetConnectionCount();
+	
+	/**
+     * IAP Id solver.
+     */
+    void GetIapId();
+	
+	/**
+     * Remove connected IAP id from connected IAPs array.
+	 * @param aConnId disconnected connection id.
+     */
+    void RemoveIapId( TUint aConnId );
+
+private: // data
+
+    /**
+     * State of active object
+     */
+    TCCHConnMonHandlerState         iState;
+
+    /**
+     * Handle to server
+     */
+    CCCHServerBase&                 iServer;
+
+    /**
+     * Connection Monitor
+     */
+    RConnectionMonitor              iConnMon;
+
+    /**
+     * Package buffer for getting available IAPs
+     */
+    TConnMonIapInfoBuf              iIapsBuf;
+
+    /**
+     * Package buffer for getting available SNAPs
+     */
+    TConnMonSNAPInfoBuf             iSNAPbuf;
+
+    /**
+     * SNAP array
+     */
+    RArray<TUint>                   iAvailableSNAPs;
+
+    /**
+     * IAP Array
+     */
+    RArray<TUint>                   iAvailableIAPs;
+
+    /**
+     * Connection change listener timer.
+     * owns.
+     */
+    CPeriodic* iConnChangeListenerTimer;
+    
+    /**
+     * Network scanning observer
+     */
+    MCCHConnMonHandlerNotifier* iNetworkScanningObserver;
+	
+    /**
+     * SNAPs availability change observer
+     */
+    MCCHConnMonHandlerNotifier* iSNAPsAvailabilityObserver;
+    
+	/**
+     * pending async request
+     */
+    RArray<TCCHConnMonHandlerState> iPendingRequests;
+	
+	/**
+     * Unsolved connection ids
+     */
+    RArray<TUint>                   iUnsolvedConnIds;
+	
+	/**
+     * Connected IAP Ids
+     */
+    RArray<TCCHConnectionInfo>      iConnIapIds;
+	
+	/**
+     * Async helpers
+     */
+    TUint                           iConnIapId;
+    TUint                           iConnId;
+    TUint                           iConnCount;
+    };
+
+#endif // C_CCHCONNMONHANDLER_H
+
+// End of file