// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "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 Kernel side interfaces to example Logical and Physical Device Drivers

 @publishedPartner

 @released

*/

#ifndef __DRIVER1_DEV_H__

#define __DRIVER1_DEV_H__

/**

  Physical Device (factory class) for 'Driver1'

*/

class DDevice1PddFactory : public DPhysicalDevice

	{

public:

	DDevice1PddFactory();

	~DDevice1PddFactory();

	// Inherited from DPhysicalDevice

	virtual TInt Install();

	virtual void GetCaps(TDes8& aDes) const;

	virtual TInt Create(DBase*& aChannel, TInt aUnit, const TDesC8* aInfo, const TVersion& aVer);

	virtual TInt Validate(TInt aUnit, const TDesC8* aInfo, const TVersion& aVer);

public:

	TInt iHardwareInUse;

private:

	enum TMinimumLDDVersion

		{

		EMinimumLddMajorVersion=1,

		EMinimumLddMinorVersion=0,

		EMinimumLddBuild=0 //Not used

		};

public:

	TDynamicDfcQue* iDfcQ;

	};

/**

  Logical Device (factory class) for 'Driver1'

*/

class DDriver1Factory : public DLogicalDevice

	{

public:

	DDriver1Factory();

	~DDriver1Factory();

	//	Inherited from DLogicalDevice

	virtual TInt Install();

	virtual void GetCaps(TDes8& aDes) const;

	virtual TInt Create(DLogicalChannelBase*& aChannel);

	};

class DDriver1;

/**

  Logical Channel class for 'Driver1'

*/

class DDriver1Channel : public DLogicalChannel

	{

public:

	DDriver1Channel();

	virtual ~DDriver1Channel();

	//	Inherited from DObject

	virtual TInt RequestUserHandle(DThread* aThread, TOwnerType aType);

	// Inherited from DLogicalChannelBase

	virtual TInt DoCreate(TInt aUnit, const TDesC8* anInfo, const TVersion& aVer);

	// Inherited from DLogicalChannel

	virtual void HandleMsg(TMessageBase* aMsg);

private:

	// Panic reasons

	enum TPanic

		{

		ERequestAlreadyPending = 1

		};

	// Implementation for the differnt kinds of messages sent through RBusLogicalChannel

	TInt DoControl(TInt aFunction, TAny* a1, TAny* a2);

	TInt DoRequest(TInt aReqNo, TRequestStatus* aStatus, TAny* a1, TAny* a2);

	void DoCancel(TUint aMask);

	// Accessor for the PDD

	inline DDriver1* Pdd();

	// Methods for configuration

	TInt GetConfig(TDes8* aConfigBuf);

	TInt SetConfig(const TDesC8* aConfigBuf);

	void CurrentConfig(RDriver1::TConfig& aConfig);

	// Methods for processing a SendData request

	TInt SendData(TRequestStatus* aStatus,const TDesC8* aData);

	void SendDataCancel();

	void DoSendDataComplete();

	static void SendDataDfc(TAny* aPtr);

	// Methods for processing a ReceiveData request

	TInt ReceiveData(TRequestStatus* aStatus,TDes8* aBuffer);

	void ReceiveDataCancel();

	void DoReceiveDataComplete();

	static void ReceiveDataDfc(TAny* aPtr);

public:

	// Interface methods for use by PDD

	virtual void SendDataComplete(TInt aResult);

	virtual void ReceiveDataComplete(TInt aResult);

private:

	DThread* iClient;

	// Members used for processing a SendData request

	TRequestStatus* iSendDataStatus;

	TDfc iSendDataDfc;

	TInt iSendDataResult;

	TBuf8<256> iSendDataBuffer;

	// Members used for processing a ReceiveData request

	TDes8* iReceiveDataDescriptor;

	TRequestStatus* iReceiveDataStatus;

	TDfc iReceiveDataDfc;

	TInt iReceiveDataResult;

	TBuf8<256> iReceiveDataBuffer;

	};

inline DDriver1* DDriver1Channel::Pdd()

	{ return (DDriver1*)iPdd; }

/**

  Interface to 'Driver1' physical device

*/

class DDriver1 : public DBase

	{

public:

	/**

	Structure for holding PDD capabilities information

	*/

	class TCaps

		{

	public:

		TVersion iVersion;

		};

public:

	virtual TInt BufferSize() const =0;

	virtual TInt Speed() const =0;

	virtual TInt SetSpeed(TInt aSpeed) =0;

	virtual TInt SendData(const TDesC8& aData) =0;

	virtual void SendDataCancel() =0;

	virtual TInt ReceiveData(TDes8& aBuffer) =0;

	virtual void ReceiveDataCancel() =0;

public:

	DDriver1Channel* iLdd;

	};

#endif