--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/bthci/bthci2/hctl/interface/hctlinterface.h	Fri Jan 15 08:13:17 2010 +0200
@@ -0,0 +1,137 @@
+// 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:
+//
+
+/**
+ @file
+ @publishedPartner
+ @released
+*/
+
+#ifndef HCTLINTERFACE_H
+#define HCTLINTERFACE_H
+
+#include <e32def.h>
+
+class MHCTLChannelObserver;
+class MHCTLDataObserver;
+class MHCTLEventObserver;
+class MControllerStateObserver;
+class MQdpPluginInterfaceFinder;
+
+class TDesC8;
+
+/**
+The UID of the hctl API. If the API ever has to change, a new UID and
+associated M class will be created. New implementations of CHCTLBase
+may implement the new API. Old (non-updated) implementations will still
+work as long as the old API is supported.
+*/
+const TInt KHCTLInterfaceUid = 0x102736E9;
+
+/**
+Mixin for the HCTL API.
+This interface is to be used via the HCTL Plugin.
+@see CHCTLBase::GetInterface(TUid)
+*/
+class MHCTLInterface
+	{
+public:
+	/**
+	Writes data out as a command frame.
+	The data should represent a single complete command frame.
+
+	@param aData Byte representation of a command frame.
+	@return KErrNone if success, otherwise one of the Symbian global error codes.
+	*/
+	virtual TInt MhiWriteCommand(const TDesC8& aData) = 0;
+	
+	/**
+	Writes data out as an ACL data frame.
+	The data should represent a single complete ACL data frame.
+	
+	@param aData Byte representation of an ACL data frame.
+	@return KErrNone if success, otherwise one of the Symbian global error codes.
+	*/
+	virtual TInt MhiWriteAclData(const TDesC8& aData) = 0;
+	
+	/**
+	Writes data out as a Synchronous data frame.
+	The data should represent a single complete Synchronous data frame.
+
+	@param aData Byte representation of a Synchronous data frame.
+	@return KErrNone if success, otherwise one of the Symbian global error codes.
+	*/
+	virtual TInt MhiWriteSynchronousData(const TDesC8& aData) = 0;
+
+	/**
+	Get the HCTL layer ACL data header and trailer size
+	@param aHeaderSize Outgoing parameter for retrieving ACL data header
+	size
+	@param aTrailerSize Outgoing parameter for retrieving ACL data trailer 
+	size
+	*/
+	virtual void MhiGetAclDataTransportOverhead(TUint& aHeaderSize, TUint& aTrailerSize) const = 0;
+
+	/**
+	Get the HCTL layer Synchronous data header and trailer size
+	@param aHeaderSize Outgoing parameter for retrieving Synchronous data header
+	size
+	@param aTrailerSize Outgoing parameter for retrieving Synchronous data trailer
+	size
+	*/
+	virtual void MhiGetSynchronousDataTransportOverhead(TUint& aHeaderSize, TUint& aTrailerSize) const = 0;
+
+	/**
+	Get the HCTL layer command header and trailer size
+	@param aHeaderSize Outgoing parameter for retrieving command header
+	size
+	@param aTrailerSize Outgoing parameter for retrieving command trailer
+	size
+	*/
+	virtual void MhiGetCommandTransportOverhead(TUint& aHeaderSize, TUint& aTrailerSize) const = 0;
+
+	/**
+	Setter for Data Observer
+	@param aDataObserver The data observer gets notification of incoming data from HCTL
+	*/
+	virtual void MhiSetDataObserver(MHCTLDataObserver& aDataObserver) = 0;
+
+	/**
+	Setter for Event Observer
+	@param aEventObserver The event observer gets notification of incoming events from HCTL
+	*/
+	virtual void MhiSetEventObserver(MHCTLEventObserver& aEventObserver) = 0;
+
+	/**
+	Setter for the channel observer
+	@param aChannelObserver The channel observer gets notification of channel open and close from HCTL
+	*/
+	virtual void MhiSetChannelObserver(MHCTLChannelObserver& aChannelObserver) = 0;
+
+	/**
+	Setter for the controller state observer
+	@param aControllerStateObserver The controller state observer gets notification of changes in the controller state such as power on and off
+	*/
+	virtual void MhiSetControllerStateObserver(MControllerStateObserver& aControllerStateObserver) = 0;
+
+	/**
+	Setter for the qdp plugin interface finder
+	@param aControllerStateObserver The qdp plugin interface finder may be used to access extended qdp functionality.
+	*/
+	virtual void MhiSetQdpPluginInterfaceFinder(MQdpPluginInterfaceFinder& aQDPPluginInterfaceFinder) = 0;
+	};
+
+#endif // HCTLINTERFACE_H
+