--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/kerneltest/e32test/examples/driver1/driver1_dev.h Mon Oct 19 15:55:17 2009 +0100
@@ -0,0 +1,157 @@
+// 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
+