bluetoothmgmt/bluetoothclientlib/inc/btbaseband.h
changeset 0 29b1cd4cb562
child 14 f8503e232b0c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/bluetoothmgmt/bluetoothclientlib/inc/btbaseband.h	Fri Jan 15 08:13:17 2010 +0200
@@ -0,0 +1,118 @@
+// 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:
+//
+
+#ifndef BTBASEBAND_H
+#define BTBASEBAND_H
+
+/** 
+@file
+@internalTechnology
+@released
+*/
+
+#include <e32base.h>
+#include <es_sock.h>
+#include <btsockaddr.h>
+#include <bttypes.h>
+#include <btbasebandpolicy.h>
+#include <bluetooth/lmoptions.h>
+
+NONSHARABLE_CLASS(RBTBaseband)
+/** API useful for Bluetooth as seen from a single physical link perspective
+@internalTechnology
+@released
+WARNING: For internal use ONLY. Compatibility is not guaranteed in future releases.
+*/
+	{
+public:
+	RBTBaseband();
+	//API useful for Bluetooth as seen from a single physical link perspective
+	TInt Open(RSocketServ& aSocketServ, RSocket& aSocket);
+	TInt Open(RSocketServ& aSocketServ, const TBTDevAddr& aDevAddr);
+	void Close();
+	TInt PhysicalLinkState(TUint32& aState);
+	TInt BasebandState(TUint32& aState); 
+	TInt PreventRoleSwitch();
+	TInt AllowRoleSwitch();
+	TInt RequestMasterRole();
+	TInt RequestSlaveRole();
+	TInt PreventLowPowerModes(TUint32 aLowPowerModes);
+	TInt AllowLowPowerModes(TUint32 aLowPowerModes);
+	TInt ActivateSniffRequester();
+	TInt ActivateParkRequester();
+	TInt CancelLowPowerModeRequester();
+	TInt RequestExplicitActiveMode(TBool aActive);
+	TInt RequestChangeSupportedPacketTypes(TUint16 aPacketTypes);
+	//THE TWO NOTIFY METHODS BELOW MUST NOT BE CALLED CONCURRENTLY
+	//Method to be used if only the next event should be notified
+	void ActivateNotifierForOneShot(TBTBasebandEvent& aEventNotification, 
+		                            TRequestStatus& aStatus, 
+									TUint32 aEventMask);
+	//Method to be used if it is intended to call it again 
+	//(or call CancelNextBasebandChangeEventNotifier) when it completes 
+	// - this sets up a continuous monitoring of events on the server.
+	//Each time ActivateNotifierForOneShot is called it will either return
+	//the next event in the servers notification queue or if the
+	//queue is empty it will await the next event. 
+	void ActivateNotifierForRecall(TBTBasebandEvent& aEventNotification, 
+		                           TRequestStatus& aStatus, 
+								   TUint32 aEventMask);
+	void ReadNewPhysicalLinkMetricValue(TRequestStatus& aStatus,
+								TDes8& aData,
+								TBTLMIoctls aIoctl);
+	void CancelPhysicalLinkMetricUpdate();
+	void CancelNextBasebandChangeEventNotifier();
+	TInt Authenticate();
+	
+	//API useful for Bluetooth as seen from a device perspective
+	TInt Open(RSocketServ& aSocketServ);
+	void Connect(const TBTDevAddr& aDevAddr, TRequestStatus& aStatus);
+	void Connect(const TPhysicalLinkQuickConnectionToken& aToken, TRequestStatus& aStatus);
+	TInt Broadcast(const TDesC8& aData); // testing broadcast writes
+	TInt ReadRaw(TDes8& aData);
+	TInt Enumerate(RBTDevAddrArray& aBTDevAddrArray, TUint aMaxNumber);
+	void TerminatePhysicalLink(TInt aReason);
+	void TerminatePhysicalLink(TInt aReason, TRequestStatus& aStatus);
+	void TerminatePhysicalLink(TInt aReason, const TBTDevAddr& aDevAddr, TRequestStatus& aStatus);
+	void ShutdownPhysicalLink(TRequestStatus& aStatus);
+	void TerminateAllPhysicalLinks(TInt aReason);
+	void TerminateAllPhysicalLinks(TInt aReason, TRequestStatus& aStatus);
+	TInt SubSessionHandle() const;
+	
+private:
+	TInt RequestRole(TBTLMOptions aRole);
+	void LocalComplete(TRequestStatus& aStatus, TInt aErr);
+	void SetClientPending(TRequestStatus& aStatus);
+	void DoConnect(TRequestStatus& aStatus);
+	TInt Enumerate(TDes8& aData);
+	TInt Construct();
+		
+private:
+	TAny*					iUnusedPointer;
+	RSocket					iSocket;
+
+	TRequestStatus*							iClientRequestStatus;
+	TBTSockAddr								iSocketAddress;				
+	TPhysicalLinkQuickConnectionTokenBuf	iConnectToken;
+	TBuf8<1>								iConnectInData; // not used yet - needed tho!
+	TBuf8<1>								iDummySCOShutdownDescriptor;
+	
+	// This data padding has been added to help prevent future binary compatibility breaks	
+	// Neither iPadding1 nor iPadding2 have been zero'd because they are currently not used
+	TUint32     iPadding1; 
+	TUint32     iPadding2; 	
+	};
+
+#endif // BTBASEBAND_H