--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/networkprotocolmodules/networkprotocolmodule/LbsAssistanceDataSourceInterface/inc/lbsassistancedatasourcemodule.h	Fri Jun 04 10:34:15 2010 +0100
@@ -0,0 +1,144 @@
+// Copyright (c) 2006-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 file defines the interface to the LBS Assistance Data Source Module. 
+// The interface is implemented by a SUPL protocol test module.
+// 
+//
+
+/**
+ @file
+ @publishedPartner
+ @test
+ @released
+*/
+#include <e32base.h>
+#include <lbs/lbsassistancedatabuilderset.h>
+#include <lbsposition.h>
+#include <lbs/lbsassistancedatabase.h>
+
+#ifndef LBSASSISTANCEDATASOURCEMODULEBASE_H_
+#define LBSASSISTANCEDATASOURCEMODULEBASE_H_
+
+const TUid KAssistanceDataSourceModuleUid = {0x101F9421};
+/**
+MLbsAssistanceDataSourceObserver used to inform the Network Simulator
+about completion of a request for Assistance Data.
+
+@see CLbsSuplTestMoudule
+*/
+class MLbsAssistanceDataSourceObserver
+	{
+public:
+	/** Call-back used to inform the Network Simulator
+	about completion of a request to obtain Assistance Data using the SUPL test module.
+	@param aError Standard Symbian OS error code
+	 */
+	virtual void DataSourceNotification(const TInt& aError) = 0;
+	};
+
+
+class TAssistanceDataSourceModuleConstructionParams
+/**
+This class is defines the construction parameters required by the 
+CAssistanceDataSourceModuleBase ECom interface.
+@see        CAssistanceDataSourceModuleBase
+*/
+	{
+	 public:
+
+     inline TAssistanceDataSourceModuleConstructionParams(MLbsAssistanceDataSourceObserver& aAssistanceDataSourceObserver);    
+ 
+	 public:
+ 
+     /** Reference to an assistance data source observer
+     */
+     MLbsAssistanceDataSourceObserver& iAssistanceDataSourceObserver; 
+     };
+
+/**
+CAssistanceDataSourceBase This class is used in partnership with MLbsAssistanceDataSourceObserver
+and CAssistanceDataSourceModuleBase and it represents a session with a remote server (i.e. a
+SUPL session).
+
+An instance of a specialization of this class is obtained by the Network Simulator by means
+of interface CAssistanceDataSourceModuleBase.
+
+The concrete subclass that gets instantiated will be determined by the implementation of interface
+CAssistanceDataSourceModuleBase that the Network Simulator is using (ie SUPL protocol), which is
+an ECom plug-in.
+
+The Network Simulator will use this interface to request retrieval of Assistance Data or to cancel
+a previous request.
+
+@see CLbsSuplTestMoudule
+*/
+class CAssistanceDataSourceBase
+	{
+public:
+	/** Call-back used to inform the Network Simulator
+	about completion of a request to obtain Assistance Data using the SUPL test module.
+	@param aError Standard Symbian OS error code
+	 */
+	virtual void GetAssistanceData(RLbsAssistanceDataBuilderSet& aBuilderSet, const TLbsAsistanceDataGroup& aAssistanceDataFilter, const TCoordinate& aPosition) = 0;
+	virtual void CancelGetAssistanceData() = 0;
+	inline virtual ~CAssistanceDataSourceBase ();
+	};
+	
+/**
+The CAssistanceDataSourceModuleBase is the abstract interface to a 
+assistance data source module (ex: SUPL). It is used by the 
+LBS' Network Simulator to gather GPS Assistance Data from
+a remote network server. 
+
+The CAssistanceDataSourceModuleBase class is used in partnership with
+MLbsAssistanceDataSourceObserver and CAssistanceDataSourceBase. The module
+instantiates a CAssistanceDataSourceBase (i.e. a SUPL protocol session)
+to gather the data and that object in turn responds to requests from the
+Network Simulator via the observer class. 
+
+An actual implementation of an Assistance Data Source module will derive from
+CAssistanceDataSourceModuleBase to provide the specific implementation of the interface methods. 
+
+@see MLbsAssistanceDataSourceObserver 
+*/
+
+class CAssistanceDataSourceModuleBase : public CBase
+	{
+public:
+
+	// Instantiate SUPL protocol test module ECOM plug-in
+	static CAssistanceDataSourceModuleBase* NewL(MLbsAssistanceDataSourceObserver& aObserver);
+
+	// wraps ECom object instantiation of a implementation UID
+	static CAssistanceDataSourceModuleBase* NewL(TUid aImplementationUid, MLbsAssistanceDataSourceObserver& aObserver);
+
+	// wraps ECom object destruction
+	~CAssistanceDataSourceModuleBase();
+	
+	inline CAssistanceDataSourceModuleBase();
+	
+    //static void ListAllImplementationsL(RImplInfoPtrArray& aImplInfoArray);
+    
+    //Get a new session to obtain assistance data from
+	virtual CAssistanceDataSourceBase* NewDataSourceL() = 0;
+	
+private:
+	// Instance identifier key
+    TUid iDtor_ID_Key;
+	};
+
+
+#include <lbs/lbsassistancedatasourcemodule.inl>
+
+#endif // LBSASSISTANCEDATASOURCEMODULEBASE_H_