--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/bthci/hciextensioninterface/src/hciproxy.cpp	Fri Jan 15 08:13:17 2010 +0200
@@ -0,0 +1,269 @@
+// Copyright (c) 2001-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:
+// BT HCI Vendor Specific Command API
+// 
+//
+
+#include "hciproxy.h"
+#include "vendorspecific.h"
+
+#include <bluetooth/hci/hciconsts.h>
+#include <bluetooth/hci/hciframe.h>
+
+const TUint KNullIoctl=0xFFFFFFFF;
+
+/**
+two phase constructor to create an HCI Conduit. Note that access to an HCI Conduit from a thread
+other than that which creates the conduit is not supported
+@param aConduit The instance of MVendorSpecificHciConduit to receive notifications of conduit events
+@return pointer to allocated object
+*/
+EXPORT_C CHciExtensionConduit* CHciExtensionConduit::NewL(MVendorSpecificHciConduit& aConduit)
+	{
+	CHciExtensionConduit* self= new (ELeave) CHciExtensionConduit(aConduit);
+	CleanupStack::PushL(self);
+	self->ConstructL();
+	CleanupStack::Pop();
+	return self;
+	}
+	
+CHciExtensionConduit::CHciExtensionConduit(MVendorSpecificHciConduit& aConduit) 
+:	CActive(0),
+	iConduit(aConduit)
+	{
+	}
+
+/**
+2nd phase construction
+*/
+EXPORT_C void CHciExtensionConduit::ConstructL()
+	{
+	// Open a connection to the socket server, then the socket
+	User::LeaveIfError(iSocketServ.Connect((TUint)-1));
+	User::LeaveIfError(iSocket.Open(iSocketServ,
+									KBTAddrFamily, KSockBluetoothTypeVendorSpecific, KBTLinkManager));
+
+	// Register with the scheduler
+	CActiveScheduler::Add(this);
+	}	
+
+/**
+destructor
+*/
+EXPORT_C CHciExtensionConduit::~CHciExtensionConduit()
+	{
+	// Stop the active object 
+	Cancel();
+
+	// close the socket server and socket
+	iSocket.Close();
+	iSocketServ.Close();
+
+	// delete VS ioctl buff
+	delete iVSIoctl;
+	}
+
+EXPORT_C TInt CHciExtensionConduit::IssueCommandL(const TUint16 aOpcode, const TDesC8& aParameters)
+/**
+Issues a vendor specific command to the hardware.
+
+The client need not be concerned with the exact formatting of the HCI frame
+as the HCI only requires the opcode and the correctly fomatted parameters in
+order to construct the appropriate the vendor debug frame.  Note that the
+caller need NOT to be concerned with the HCTL framing at all.
+The HCI will only then copy this frame to the Host Controller after putting
+it in an HCTL frame.
+This command will be completed when the Bluetooth stack receives it. This API 
+should not be used if the caller wants to receive any data from an associated 
+command complete event. 
+
+Note: a command complete event is NOT a vendor debug event.
+
+@param aOpcodec The opcode for the frame, i.e. (KVendorDebugOGF & vendorOCFRequired)
+@param aParameters A descriptor containing the raw paramters for the command to be passed to hardware (maximum KHCIMaxCommandLength bytes)
+@return Error code indicating whether command could be passed to the hardware
+*/
+	{
+	return IssueCommandL(aOpcode, aParameters, KHCIWriteVendorSpecificFrameNoEventExpectedIoctl);
+	}
+
+EXPORT_C TInt CHciExtensionConduit::IssueCommandExpectingCompleteEventL(const TUint16 aOpcode, const TDesC8& aParameters)
+/**
+Issues a vendor specific command to the hardware. This command should have an associated command complete event.
+
+The client need not be concerned with the exact formatting of the HCI frame
+as the HCI only requires the opcode and the correctly fomatted parameters in
+order to construct the appropriate the vendor debug frame.  Note that the
+caller need NOT to be concerned with the HCTL framing at all.
+The HCI will only then copy this frame to the Host Controller after putting
+it in an HCTL frame.
+This command will not be completed until the hardware responds with the command complete event.
+Note: a command complete event is NOT a vendor debug event.
+
+Warning: If this command is used after the command IssueRequestL has been called, the associated callback,
+MVendorSpecificHciConduit::CommandCompleted, could receive the wrong CommandCompleteEvent data.
+
+@see MVendorSpecificHciConduit::CommandCompleted
+@param aOpcodec The opcode for the frame, i.e. (KVendorDebugOGF & vendorOCFRequired)
+@param aParameters A descriptor containing the raw paramters for the command to be passed to hardware (maximum KHCIMaxCommandLength bytes)
+@return Error code indicating whether command could be passed to the hardware
+*/
+	{
+	return IssueCommandL(aOpcode, aParameters, KHCIWriteVendorSpecificFrameIoctl);
+	}
+
+TInt CHciExtensionConduit::IssueCommandL(const TUint16 aOpcode, const TDesC8& aParameters, TUint aName)
+	{
+	__ASSERT_DEBUG((aParameters.Length() > 0) && (aParameters.Length() <= CHctlCommandFrame::KHCIMaxCommandLength), User::Panic(KHciExtConduitPanicCat, EInvalidParamSize));
+
+	if(IsActive())
+		{
+		if(iCurrentIoctl==KHCIWaitForVendorSpecificDebugEventIoctl)
+			{
+			//	Need to cancel the outstanding listening Ioctl before proceeding
+			Cancel();
+			}
+		else
+			{
+			//	Already have an outstanding Ioctl which we can't really cancel
+			return KErrInUse;
+			}
+		}
+
+	__ASSERT_ALWAYS(!IsActive(), User::Panic(KHciExtConduitPanicCat, EAlreadyActive));
+
+	iCurrentIoctl = aName;
+
+	if (iVSIoctl)
+		{
+		delete iVSIoctl;
+		iVSIoctl = NULL;
+		}
+
+	iVSIoctl = new(ELeave) THCIWriteVendorSpecificFrameBuf();
+
+	(*iVSIoctl)().iOpcode = aOpcode;
+	(*iVSIoctl)().iParams.Copy(aParameters);
+
+	iSocket.Ioctl(iCurrentIoctl, iStatus, iVSIoctl, KSolBtHCI);
+
+	SetActive();
+
+	return KErrNone;
+	}
+	
+/**
+This method allows a client to obtain the command complete event data when being notified of a CommandComplete.
+That is it can be called as part of his implementation of "CommandCompleted" in his MVendorSpecificHciConduit derived class.
+
+*** NOTE: If no event data is returned from the stack, as is the case if  IssueCommandL was called,	***
+*** this will return the original command data! 													***
+
+@see MVendorSpecificHciConduit
+*/
+EXPORT_C void CHciExtensionConduit::CommandCompleteEventData(TPtrC8& aOutPtrToData)
+	{
+	__ASSERT_DEBUG((!IsActive() && iVSIoctl), User::Panic(KHciExtConduitPanicCat, EUnexpectedCce));
+
+	// on output from the Ioctl the descriptor the iVSIoctl points to contains the command complete event data
+	aOutPtrToData.Set(*iVSIoctl);
+	}
+
+/**
+Instructs the conduit that vendor debug events are expected back from the hardware.
+The conduit will listen for events, and on reception of one will issue an upcall
+on the MVendorSpecificHciConduit derived object passed into the CHciExtensionConduit
+factory function.
+
+@return Error code indicating whether the conduit has switched into listening mode
+@publishedPartner
+@released
+*/
+EXPORT_C TInt CHciExtensionConduit::WaitForEvent()
+	{
+	if(IsActive())
+		{
+		//	We're already doing something
+		return KErrInUse;
+		}
+
+	iBuf.Zero();	//	Prepare the buffer for the returning values
+
+	iWaitForEvent=ETrue;
+	iCurrentIoctl=KHCIWaitForVendorSpecificDebugEventIoctl;
+	iSocket.Ioctl(iCurrentIoctl, iStatus, &iBuf, KSolBtHCI);
+
+	SetActive();
+
+	return KErrNone;
+	}
+
+/**
+Instructs the conduit that no more vendor debug events are expected back from the hardware.
+The conduit will issue no more upcalls on the MVendorSpecificHciConduit derived object passed 
+into the CHciExtensionConduit factory function.
+@publishedPartner
+@released
+*/
+EXPORT_C void CHciExtensionConduit::StopWaitingForEvent()
+	{
+	if(iCurrentIoctl==KHCIWaitForVendorSpecificDebugEventIoctl)
+		{
+		Cancel();
+		}
+	iWaitForEvent = EFalse;
+	}
+
+void CHciExtensionConduit::RunL()
+	{
+	switch(iCurrentIoctl)
+		{
+	case KHCIWriteVendorSpecificFrameIoctl:
+	case KHCIWriteVendorSpecificFrameNoEventExpectedIoctl:		
+		iCurrentIoctl=KNullIoctl;
+		iConduit.CommandCompleted(iStatus.Int());
+
+		// delete the VS IOCTL buf as the IOCTL has now completed
+		delete iVSIoctl;
+		iVSIoctl = NULL;
+
+		if(iWaitForEvent)
+			{
+			WaitForEvent();
+			}
+
+		break;
+
+	case KHCIWaitForVendorSpecificDebugEventIoctl:
+		//	Pass up the data, requeue waiting Ioctl if return value is ETrue
+		iCurrentIoctl=KNullIoctl;
+		iWaitForEvent=iConduit.ReceiveEvent(iBuf, iStatus.Int());
+		if(iWaitForEvent)
+			{
+			WaitForEvent();
+			}
+			//	No longer going to have a queued Ioctl.
+		break;
+
+	default:
+		User::Panic(KHciExtConduitPanicCat, EInvalidIoctl);
+		}
+	}
+
+void CHciExtensionConduit::DoCancel()
+	{
+	iSocket.CancelIoctl();
+	iCurrentIoctl=KNullIoctl;
+	}
+