// Copyright (c) 2004-2010 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 REMCONBEARERINTERFACE_H

#define REMCONBEARERINTERFACE_H

#include <e32base.h>

#include <remcon/clientid.h>

#include <remcon/messagetype.h>

#include <remcon/playertype.h>

class MRemConBearerObserver;

class TBearerParams;

class TRemConAddress;

/** 

The UID of the bearer API. If the bearer API ever has to change, a new UID and 

associated M class will be created. New implementations of CRemConBearerPlugin 

may implement the new API. Old (non-updated) bearers will still work as long 

as RemCon supports the old API.

*/

const TInt KRemConBearerInterface1 = 0x10208A78;

/**

Mixin for the bearer API.

*/

class MRemConBearerInterface

	{

public:

	/** 

	Called by RemCon to retrieve a response on a connection. Must only be 

	called as a result of a NewResponse up-call.

	@param aInterfaceUid The UID of the outer-layer client API specifying the 

	response.

	@param aTransactionId The command identifier used as a cookie for command/response 

	matching.

	@param aOperationId The ID of the response operation in the outer-layer 

	client API.

	@param aData API-specific message data. On success, ownership is 

	returned.

	@param aAddr The connection.

	@return Error.

	*/

	virtual TInt GetResponse(TUid& aInterfaceUid, 

		TUint& aTransactionId, 

		TUint& aOperationId, 

		RBuf8& aData, 

		TRemConAddress& aAddr) = 0;

	/** 

	Called by RemCon to retrieve a command on a connection. Must only be 

	called as a result of a NewCommand up-call.

	@param aInterfaceUid The UID of the outer-layer client API specifying the 

	command.

	@param aTransactionId The command identifier used as a cookie for command/response 

	matching.

	@param aOperationId The ID of the command operation in the outer-layer 

	client API.

	@param aData API-specific message data. On success, ownership is 

	returned.

	@param aAddr The connection.

	@return Error.

	*/

	virtual TInt GetCommand(TUid& aInterfaceUid, 

		TUint& aTransactionId, 

		TUint& aOperationId, 

		RBuf8& aData, 

		TRemConAddress& aAddr) = 0;

	/** 

	Called by RemCon to send a command on a connection. The connection is not 

	assumed to exist- the bearer is responsible for bringing up the requested 

	connection if necessary.

	@param aInterfaceUid The UID of the outer-layer client API specifying the 

	command.

	@param aOperationId The ID of the command operation in the outer-layer 

	client API.

	@param aTransactionId The command identifier used as a cookie for command/response 

	matching.

	@param aData API-specific message data. On success, ownership is passed. 

	@param aAddr The connection.

	@return Error. This request is synchronous. It should be completed by the 

	bearer when it has taken responsibility for sending the message. This will 

	involve checking that the message is well-formed, and possibly actually 

	trying to send it, or adding it to a queue.

	*/

	virtual TInt SendCommand(TUid aInterfaceUid, 

		TUint aOperationId, 

		TUint aTransactionId,  

		RBuf8& aData, 

		const TRemConAddress& aAddr) = 0;

	/** 

	Called by RemCon to send a response on a connection. The connection is not 

	assumed to exist- the bearer is responsible for bringing up the requested 

	connection if necessary.

	@param aInterfaceUid The UID of the outer-layer client API specifying the 

	response.

	@param aOperationId The ID of the response operation in the outer-layer 

	client API.

	@param aTransactionId The command identifier used as a cookie for command/response 

	matching

	@param aData API-specific message data. On success, ownership is passed.

	@param aAddr The connection.

	@return Error. This request is synchronous. It should be completed by the 

	bearer when it has taken responsibility for sending the message. This will 

	involve checking that the message is well-formed, and possibly actually 

	trying to send it, or adding it to a queue.

	*/

	virtual TInt SendResponse(TUid aInterfaceUid, 

		TUint aOperationId, 

		TUint aTransactionId, 

		RBuf8& aData, 

		const TRemConAddress& aAddr) = 0;

	/** 

	Called by RemCon to establish a bearer-level connection to another party. 

	Completion is signalled back in ConnectConfirm.

	@param aAddr The RemCon address to connect to.

	*/

	virtual void ConnectRequest(const TRemConAddress& aAddr) = 0;

	/** 

	Called by RemCon to destroy a bearer-level connection to another party. 

	Completion is signalled back in DisconnectConfirm.

	@param aAddr The RemCon address to disconnect from.

	*/

	virtual void DisconnectRequest(const TRemConAddress& aAddr) = 0;

	/**

	Called by RemCon when either (a) the number of controller clients changes 

	from 0 to 1 or from 1 to 0, or (b) the number of target clients changes 

	from 0 to 1 or from 1 to 0.

	@param aControllerPresent Is true if any controllers are present, EFalse otherwise.

	@param aTargetPresent Is true if any targets are present, EFalse otherwise.

	*/

	virtual void ClientStatus(TBool aControllerPresent, TBool aTargetPresent) = 0;

	/**

	Called by RemCon to get the capabilities required to make/destroy 

	connections over the bearer, and to send and receive messages over the 

	bearer.

	@return The bearer's security policy.

	*/

	virtual TSecurityPolicy SecurityPolicy() const = 0;

	};

/** 

The UID of the bearer API. If the bearer API ever has to change, a new UID and 

associated M class will be created. New implementations of CRemConBearerPlugin 

may implement the new API. Old (non-updated) bearers will still work as long 

as RemCon supports the old API.

*/

const TInt KRemConBearerInterface2 = 0x10285AD9;

class MRemConBearerInterfaceV2 : public MRemConBearerInterface

	{

public:

	/** 

	Called by RemCon to retrieve a notify command on a connection. Must only be 

	called as a result of a NewNotify up-call.

	@param aInterfaceUid The UID of the outer-layer client API specifying the 

	notify command.

	@param aTransactionId The command identifier used as a cookie for command/response 

	matching.

	@param aOperationId The ID of the command operation in the outer-layer 

	client API.

	@param aData API-specific message data. On success, ownership is 

	returned.

	@param aAddr The connection.

	*/

	virtual TInt GetNotifyCommand(TUid& aInterfaceUid, 

		TUint& aTransactionId, 

		TUint& aOperationId, 

		RBuf8& aData, 

		TRemConAddress& aAddr) = 0;

	/**

	Called by RemCon when either

	a) The TSP does not address a command to any clients

	b) The TSP does not permit the response from any commands

	c) All the clients disconnect from remcon before the response is sent,

	to send a reject on a connection. RemCon will call this function after bringing

	up the connection.

	@param aInterfaceUid The UID of the outer-layer client API that the command

	was sent to

	@param aOperationId The ID of the command operation sent to remcon

	@param aTransactionId The command identifier used as a cookie for command/response 

	matching.

	@param aAddr The connection.

	*/

	virtual void SendReject(TUid aInterfaceUid, 

			TUint aOperationId, 

			TUint aTransactionId, 

			const TRemConAddress& aAddr) = 0; 

	};	

/** 

The UID of the bearer API. If the bearer API ever has to change, a new UID and 

associated M class will be created. New implementations of CRemConBearerPlugin 

may implement the new API. Old (non-updated) bearers will still work as long 

as RemCon supports the old API.

*/

const TInt KRemConBearerInterface3 = 0x10285ADB;

class MRemConBearerInterfaceV3 : public MRemConBearerInterfaceV2

	{

public:

	/** 

	Called by RemCon to send a notify command on a connection. The connection is not 

	assumed to exist- the bearer is responsible for bringing up the requested 

	connection if necessary.

	@param aInterfaceUid The UID of the outer-layer client API specifying the command.

	@param aOperationId The ID of the command operation in the outer-layer client API.

	@param aTransactionId The command identifier used as a cookie for command/response matching.

	@param aData API-specific message data. On success, ownership is passed. 

	@param aAddr The connection.

	@return Error. This request is synchronous. It returns KErrNone when the 

	bear has taken responsibility for sending the message. This will 

	involve checking that the message is well-formed, and possibly actually 

	trying to send it, or adding it to a queue.

	*/

	virtual TInt SendNotifyCommand(TUid aInterfaceUid, 

			TUint aOperationId, 

			TUint aTransactionId,  

			RBuf8& aData, 

			const TRemConAddress& aAddr) = 0;

	/** 

	Called by RemCon to retrieve a notify response on a connection. Must only be 

	called as a result of a NewNotifyResponseL up-call.

	@param aInterfaceUid The UID of the outer-layer client API specifying the response.

	@param aTransactionId The command identifier used as a cookie for command/response matching.

	@param aOperationId The ID of the response operation in the outer-layer client API.

	@param aData API-specific message data. On success, ownership is returned.

	@param aAddr The connection.

	@return Error.

	*/

	virtual TInt GetNotifyResponse(TUid& aInterfaceUid, 

			TUint& aId, 

			TUint& aOperationId, 

			RBuf8& aCommandData, 

			TRemConAddress& aAddr,

			TRemConMessageSubType& aSubMessageType)=0;

	/**

	Called by RemCon when a client has become available for addressing.  Once this

	call has been made the bearer may use the provided TRemConClientId to address

	incoming commands and notifys to this client until RemCon calls ClientNotAvailable

	with this TRemConClientId.

	@param aId A unique identifier for this client, that can be used when addressing 

	incoming commands.

	@param aClientType The basic type of this client

	@param aClientSubType More detailed type information on this client

	@param aName The name of this client in UTF-8.  This remains valid until ClientNotAvailable 

				 is called for this player.

	*/

	virtual void ClientAvailable(TRemConClientId& aId, TPlayerType aClientType, TPlayerSubType aClientSubType, const TDesC8& aName) = 0;

	/**

	Called by RemCon when a client is no longer available for addressing.  Once this

	call has been made the bearer shall not use this client id when addressing incoming

	commands and notifys until informed that the client is available again via

	ClientAvailable.

	@param aId The client that has ceased to be available.

	*/

	virtual void ClientNotAvailable(TRemConClientId& aId) = 0;

	/** 

	Called by RemCon when the TSP has requested this bearer use a different addressed

	client.

	@param aId The client to which this bearer should route addressed commands.

	*/

	virtual TInt SetLocalAddressedClient(TRemConClientId& aId) = 0;

	/**

	Called by RemCon when a controller client is opened or closed to provide the 

	current set of interfaces supported by controller sessions.  This is not

	guaranteed to have changed since the last time the function was called.

	@param aSupportedInterfaces An RArray of interface UIDs.  Ownership is retained

				by RemCon and its lifetime is not guaranteed to last beyond the scope

				of this function.  Each supported interface appears once in the array

				irrespective of how many controller sessions support that interface.

	*/

	virtual void ControllerFeaturesUpdated(RArray<TUid>& aSupportedInterfaces) = 0;

	/**

	Called by RemCon when a target client registers new interfaces after being made available.

	@param aId The target client that has regitered new interfaces.

	@param aPlayerType The basic type of this client after registration of new interfaces.

	@param aPlayerSubType More detailed type information on this client after registration of new interfaces.

	@param aName The name of this client in UTF-8. This remains valid until ClientNotAvailable 

				 is called for this player.

	*/

	virtual void TargetFeaturesUpdated(const TRemConClientId& aId, TPlayerType aPlayerType, TPlayerSubType aPlayerSubType, const TDesC8& aName) = 0;

	};

#endif // REMCONBEARERINTERFACE_H