// Copyright (c) 2004-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
 @note PAN helper server client API
 @internalTechnology
*/

#ifndef PANHELPER_H
#define PANHELPER_H

#include <e32std.h>
#include <e32base.h>
#include <es_sock.h>
#include <bt_sock.h>
#include "pancommon.h"
#include "panprog.h"


namespace PanHelper
{

_LIT(KPanHelperName, "PANHelper");

enum TPanHelperPanic
/**
Panic helper server panic codes
@internalComponent
*/
	{
	EInvalidIapId,
	ENullSdpAttrValue,								//< The SDP query returned a NULL SDP attribute value record
	ESecondQueryWhileFirstStillActive, //< A second SDP query was initiated while the first was still active
	};

void PanHelperPanic(TPanHelperPanic aPanicCode);

/** 
Flags for support of various roles
@see TPanDeviceRolesList
@internalComponent
*/
//@{
const TUint KPanDeviceRolesListNone	  = 0x00;
const TUint KPanDeviceRolesListPanU   = 0x01;
const TUint KPanDeviceRolesListPanGn  = 0x02;
const TUint KPanDeviceRolesListPanNap = 0x04;
const TUint KPanDeviceRolesListAll	  = KPanDeviceRolesListPanU | KPanDeviceRolesListPanGn | KPanDeviceRolesListPanNap;
//@}

NONSHARABLE_CLASS(TPanDeviceRolesList)
/**
PAN roles array, to provide an easy way of passing around which roles a remote device supports
@internalTechnology
@released
*/
	{	
public:

	IMPORT_C TPanDeviceRolesList();
	
	IMPORT_C TBool SupportsU() const;
	IMPORT_C TBool SupportsGn() const;
	IMPORT_C TBool SupportsNap() const;
	
	IMPORT_C void SetSupportsU();
	IMPORT_C void SetSupportsU(TBool aSupportsU);
	IMPORT_C void SetSupportsGn();
	IMPORT_C void SetSupportsGn(TBool aSupportsGn);
	IMPORT_C void SetSupportsNap();
	IMPORT_C void SetSupportsNap(TBool aSupportsNap);

	IMPORT_C TBool IsSupported(TBluetoothPanRole aPanRole) const;

private:
	TInt iSupportedRoles;
	};
	
NONSHARABLE_CLASS(TPanDeviceWorthTryingRolesList)
/**
PAN roles array, to provide an easy way of passing around which roles are worth trying with a remote device
@internalTechnology
@released
*/
	{	
public:

	IMPORT_C TPanDeviceWorthTryingRolesList();

	IMPORT_C TBool IsWorthTryingU() const;
	IMPORT_C TBool IsWorthTryingGn() const;
	IMPORT_C TBool IsWorthTryingNap() const;
	
	IMPORT_C void SetWorthTrying(TBluetoothPanRole aPanRole, TBool aWorthTrying);

	IMPORT_C void SetWorthTryingU();
	IMPORT_C void SetWorthTryingU(TBool aWorthTryingU);
	IMPORT_C void SetWorthTryingGn();
	IMPORT_C void SetWorthTryingGn(TBool aWorthTryingGn);
	IMPORT_C void SetWorthTryingNap();
	IMPORT_C void SetWorthTryingNap(TBool aWorthTryingNap);

	IMPORT_C TBool IsWorthTryingARole(TBluetoothPanRole aPanRole) const;
	IMPORT_C void ResetWorthTryingRoles();

private:
	TInt iWorthTryingRoles;
	};
	
	
class CPanHelperRemoteSdpQuerier;
NONSHARABLE_CLASS(RPanRemoteSdpQuerier) 
/**
Client side of PAN SDP query engine, for looking up SDP records on remote devices
@internalTechnology
@released
*/
	{
public:
	IMPORT_C TInt Open();
	IMPORT_C void Close();
		
	IMPORT_C TInt Query(const TBTDevAddr& aAddr, TDes8& aSupportedRemoteRoles, TRequestStatus& aStatus);
	IMPORT_C void CancelQuery();

private:
	CPanHelperRemoteSdpQuerier* iSdpQuerier;
	};
	
class CPanHelperDeviceDiscoverer;
NONSHARABLE_CLASS(RPanRemoteDeviceDiscoverer) 
/**
Client side of remote device discovery engine, for discovering which devices are around us and
selecting one from the supplied list
@internalTechnology
@released
*/
	{
public:
	IMPORT_C TInt Open();
	IMPORT_C void Close();
		
	IMPORT_C void FindDevice(TDesC& aDeviceAddrList, TDes8& aDeviceAddr, TRequestStatus& aStatus);
	IMPORT_C void CancelFindDevice();

private:
	CPanHelperDeviceDiscoverer* iDeviceDiscoverer;
	};
	
} // PanHelper

#endif // PANHELPER_H