// 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

 @publishedPartner

 @released

*/

#include <gavdp.h>

#include "gavdpInternal.h"

/**

Default Constructor

*/

EXPORT_C RGavdp::RGavdp() 

: iGavdpImp(NULL)

	{

	}

/**

Open a GAVDP session.

@note not to be confused with the "Open" primitive in the GAVDP spec. This is 

merely opening the handle in the Symbian OS sense.

@param aServiceUser a reference to a MGavdpUser mixin for GAVDP callback 

events.

@param aSocketServer reference to the client's Socket Server session. 

@return system-wide error

@see RegisterSEP

*/

EXPORT_C TInt RGavdp::Open(MGavdpUser& aServiceUser, RSocketServ& aSocketServer)

	{

	__ASSERT_ALWAYS(iGavdpImp==NULL,Panic(EGavdpAlreadyOpen));

	TRAPD(res, iGavdpImp = CGavdp::NewL(aServiceUser, aSocketServer, *this));

	return res;

	}

/**

Closes the GAVDP session and frees all resources associated with it.

This function should not be called from within a client's implementation of 

any MGavdpUser (upcall) method.

@note not to be confused with the "Close" primitive in the GAVDP spec. This is 

merely closing the handle in the Symbian OS sense.

@note However, if this is Closed when streams are active, the Bluetooth 

subsystem shall Release all Streams managed by this RGavdp instance.

@note that the closure of any bearer sockets created remains the 

responsibility of the client.

*/

EXPORT_C void RGavdp::Close()

	{

	delete iGavdpImp;

	iGavdpImp = NULL;

	}

/**

Cancel the outstanding client request.

As per usual Symbian OS Cancel semantics, this method does not guarantee that 

the outstanding request was "undone".

Therefore to reset each sides' state the client should consider sending an 

Abort too.

@see RGavdp::AbortStream

*/

EXPORT_C void RGavdp::Cancel()

	{

	if(iGavdpImp!=NULL)

		{

		iGavdpImp->Cancel();	

		}

	}

/**

Connects a GAVDP session - i.e. creates an AVDTP signalling channel to a 

remote device.

The signalling channel may already exist, in which case this session is added 

as a user of that channel.

The necessary multiplexing is implemented in AVDTP, so the client need not be 

concerned with this.

@param aRemoteAddr the Bluetooth device address of the remote GAVDP entity.

*/

EXPORT_C void RGavdp::Connect(const TBTDevAddr& aRemoteAddr)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->Connect(aRemoteAddr);

	}

/**

Discover the Stream endpoints (SEPs) on the remote device.

Callbacks on MGavdpUser will be called as a result of this call.

@pre a Signalling channel must have been successfully created

@see MGavdpUser::GAVDP_SEPDiscovered

*/

EXPORT_C void RGavdp::DiscoverRemoteSEPs()

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->DiscoverRemoteSEPs();

	}

/**

Get the capabilities of a remote Stream Endpoint (SEP).

Callbacks on MGavdpUser will be called for the intersection of capabilities 

that the remote supports and that the local GAVDP user is interested in using. 

@param aSEID the ID of the remote SEP for which capabilities are to be 

retrieved.

@param aInterestingCategories the categories the local GAVDP client is 

interested in.

*/

EXPORT_C void RGavdp::GetRemoteSEPCapabilities(TSEID aSEID, const TAvdtpServiceCategories& aInterestingCategories)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->GetRemoteSEPCapabilities(aSEID, aInterestingCategories);

	}

/**

Begin configuring (or reconfiguring) a remote SEP.

Subsequent calls are used to add each configuration required.

@see RGavdp::AddSEPCapability

@param aRemoteSEID the ID of the remote SEP.

@param aLocalSEID the ID of the local SEP.

@return system-wide error.

*/	

EXPORT_C TInt RGavdp::BeginConfiguringRemoteSEP(TSEID aRemoteSEID, TSEID aLocalSEID)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->BeginConfiguringRemoteSEP(aRemoteSEID, aLocalSEID);

	}

/**

Begin configuring (or reconfiguring) a local SEP.

Subsequent calls are used to add each configuration required.

@see RGavdp::AddSEPCapability

@param aSEID the ID of the local SEP.

@return system-wide error.

*/	

EXPORT_C TInt RGavdp::BeginConfiguringLocalSEP(TSEID aSEID)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->BeginConfiguringLocalSEP(aSEID);

	}

/**

Add a particular capability into a SEP.

When called on a local SEP this equates to adding capabilities into the SEP.

When called on a remote SEP this equates to configuring the SEP.

@param aCapability a capability

@see TAvdtpServiceCapability

@return system-wide error.

*/	

EXPORT_C TInt RGavdp::AddSEPCapability(const TAvdtpServiceCapability& aCapability)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->AddSEPCapability(aCapability);

	}

/**

Finalises the (re)configuration of the SEP

*/

EXPORT_C void RGavdp::CommitSEPConfiguration()

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->CommitSEPConfiguration();

	}

/**

Start stream

@param aSEID the SEID of the local or remote SEP that requires starting

*/

EXPORT_C void RGavdp::StartStream(TSEID aSEID)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->StartStream(aSEID);

	}

/**

Suspend stream

@note that the remote may not support Suspend, and an 

AVDTP NOT_SUPPORTED_COMMAND error may result.

In this case the client should consider Closing the stream.

@param aSEID the SEID of the local or remote SEP that requires suspending.

*/

EXPORT_C void RGavdp::SuspendStream(TSEID aSEID)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->SuspendStream(aSEID);

	}

/**

Abort stream

@note that once complete the state of the SEP will be Idle. Thus to restream, 

the SEP has to be reconfigured, opened and started.

@param aSEID the SEID of the local or remote SEP that requires aborting.

*/	

EXPORT_C void RGavdp::AbortStream(TSEID aSEID)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->AbortStream(aSEID);

	}

/**

Send security control data to remote SEP.

The meaning of this is dependent on the configured Content Protection method. 

@see TAvdtpContentProtectionCapabilities

@param aSEID the seid of the remote SEP

@param aSecurityData the security data

*/

EXPORT_C void RGavdp::SendSecurityControl(TSEID aSEID, const TDesC8& aSecurityData)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	iGavdpImp->SendSecurityControl(aSEID, aSecurityData);	

	}

/**

Register an extra local SEP.

@param aInfo reference containing SEP information. Note the SEID assigned by 

AVDTP will be written back into aInfo.

@return system-wide error

*/

EXPORT_C TInt RGavdp::RegisterSEP(TAvdtpSEPInfo& aInfo)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->RegisterSEP(aInfo);

	}

/**

Listen for inbound signalling channel connections.

This is useful when the signalling channel is lost.

Note: This function will not connect the session to any existing connected 

signalling channels.

The session will only be connected upon the next channel being connected. 

Users should use Connect instead if they intend to connect to existing 

signalling channels.

@pre At least SEP shall have been registered

@see RGavdp::RegisterSEP(TAvdtpSEPInfo& aInfo)

@panic The client thread will be panicked if Listen is called prior to any 

SEPs being registered.

@return system-wide error code

*/

EXPORT_C TInt RGavdp::Listen()

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->Listen();

	}

/**

Creates bearers (in the form of sockets) for sessions on the stream.

The sessions are media + optional reporting + optional recovery.

The sockets will be created on the client's Socket Server session.

The sockets may then be passed into RTP for its use.

If the sockets are passed to RTP the client still has the responsibility of 

closing them.

 - i.e. neither RTP nor GAVDP will close the sockets.

The reporting/recovery config is already known by the stream. All the required

bearers will be created.

@param aSEID The SEID of the remote SEP for which the sockets are required.

@param aIgnored1 Source compatibility place holder

@param aIgnored2 Source compatibility place holder

@return system-wide error code

@see RGavdp::CreateBearerSockets(TSEID aSEID)

@deprecated

*/

EXPORT_C TInt RGavdp::CreateBearerSockets(TSEID aSEID, TBool /*aIgnored1*/, TBool /*aIgnored2*/)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->CreateBearerSockets(aSEID);

	}

/**

Creates bearers (in the form of sockets) for sessions on the stream.

The sessions are media + optional reporting + optional recovery.

The sockets will be created on the client's Socket Server session.

The sockets may then be passed into RTP for its use.

If the sockets are passed to RTP the client still has the responsibility of 

closing them.

 - i.e. neither RTP nor GAVDP will close the sockets.

The reporting/recovery config is already known by the stream. All the required

bearers will be created. 

@param aSEID The SEID of the remote SEP for which the sockets are required.

@return system-wide error code

*/

EXPORT_C TInt RGavdp::CreateBearerSockets(TSEID aSEID)

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	return iGavdpImp->CreateBearerSockets(aSEID);

	}

/**

This function returns the deprecated value KMaxAvdtpSecurityControlInfo so as 

to ensure that the return value is what partners will expect during the 

transition period from the use of the old constant to this new API.

When the constant is removed from BluetoothAV.h it should be moved to an 

internal header.

@return KMaxAvdtpSecurityControlInfo

*/

EXPORT_C TInt RGavdp::MaxSecurityControlLength()

	{

	return KMaxAvdtpSecurityControlInfo;

	}

/**

Disconnects the RGavdp session from the signalling channel, but does not destroy the local SEPs owned

by the signalling channel. Must only be called if the remote SEP has not yet been configured -

if the remote SEP has been configured then AbortStream() should be called.

@return system-wide error code

@panic If remote SEP configured

*/

EXPORT_C TInt RGavdp::Shutdown()

	{

	__ASSERT_ALWAYS(iGavdpImp!=NULL,Panic(EGavdpNotOpen));

	TInt ret = iGavdpImp->Shutdown();

	if (ret==KErrNotReady) 

		{

		Panic(EGavdpShutdownNotPermittedAfterRemoteSEPConfigured);

		}

	return ret;

	}

void RGavdp::UnbindBody()

	{

	iGavdpImp = NULL;

	}

// EOF