mmdevicefw/mdf/src/audio/HwDeviceAdapter/mdfhwdeviceadapter.h
author hgs
Wed, 13 Oct 2010 12:08:48 +0100
changeset 3 28bdc4aca325
parent 0 79dd3e2336a0
permissions -rw-r--r--
2010wk42_01
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     1
// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     2
// All rights reserved.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     3
// This component and the accompanying materials are made available
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     4
// under the terms of "Eclipse Public License v1.0"
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     5
// which accompanies this distribution, and is available
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     7
//
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     8
// Initial Contributors:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
     9
// Nokia Corporation - initial contribution.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    10
//
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    11
// Contributors:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    12
//
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    13
// Description:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    14
// mmfhwdeviceadapter.h
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    15
// 
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    16
//
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    17
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    18
/**
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    19
 @file
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    20
 @publishedPartner
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    21
 @prototype
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    22
 @see CMMFHwDevice
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    23
 @see MMdfInputPortObserver
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    24
 @see MMdfOutputPortObserver
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    25
 @see MMdfProcessingUnitObserver
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    26
 @see MMdfHwDeviceSetup
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    27
*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    28
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    29
#ifndef HWDEVICEADAPTER_H
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    30
#define HWDEVICEADAPTER_H
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    31
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    32
#include <mdf/mdfinputport.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    33
#include <mdf/mdfoutputport.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    34
#include <mdf/mdfprocessingunit.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    35
#include <mdf/mdfpuloader.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    36
#include <mmf/server/mmfhwdevice.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    37
#include <mmf/server/mmfdatabuffer.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    38
#include <mmf/server/mmfhwdevicesetup.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    39
#include <mmf/common/mmfutilities.h>
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    40
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    41
class CMMFBuffer;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    42
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    43
/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    44
Hardware Device Adapter class that uses Processing Units (and their associated Ports) in
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    45
order to decode and encode audio data.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    46
*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    47
class CMdfHwDeviceAdapter : public CMMFHwDevice,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    48
				    		public MMdfInputPortObserver,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    49
				    		public MMdfOutputPortObserver,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    50
				    		public MMdfProcessingUnitObserver,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    51
				    		public MMdfHwDeviceSetup
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    52
	{
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    53
public:	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    54
	/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    55
	The current state of the Hardware Device Adapter.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    56
	*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    57
	enum THwDevAdapterState
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    58
		{
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    59
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    60
		The PULoader has been loaded.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    61
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    62
		EProcessingUnitLoaderLoaded,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    63
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    64
		The Processing Units have been loaded.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    65
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    66
		EProcessingUnitLoaded,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    67
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    68
		The Processing Units are currently being initialised.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    69
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    70
		EProcessingUnitInitializing,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    71
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    72
		The Processing Units are currently in the idle state.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    73
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    74
		EProcessingUnitIdle,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    75
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    76
		The Processing Units are currently in the executing state.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    77
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    78
		EProcessingUnitExecuting,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    79
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    80
		The Processing Units are currently in the paused state.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    81
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    82
		EProcessingUnitPaused		
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    83
		};	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    84
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    85
public:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    86
	static CMdfHwDeviceAdapter* NewL();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    87
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    88
	// from CMMFHwDevice
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    89
	TInt Start(TDeviceFunc aFuncCmd, TDeviceFlow aFlowCmd);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    90
	TInt Stop();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    91
	TInt Pause();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    92
	TInt Init(THwDeviceInitParams& aDevInfo);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    93
	TAny* CustomInterface(TUid aInterfaceId);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    94
	TInt ThisHwBufferFilled(CMMFBuffer& aFillBufferPtr);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    95
	TInt ThisHwBufferEmptied(CMMFBuffer& aEmptyBufferPtr);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    96
	TInt SetConfig(TTaskConfig& aConfig);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    97
	TInt StopAndDeleteCodec();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    98
	TInt DeleteCodec();	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
    99
	~CMdfHwDeviceAdapter();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   100
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   101
	// from MMdfInputPortObserver
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   102
	void MipoWriteDataComplete(const MMdfInputPort* aPu, CMMFBuffer* aBuffer, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   103
	void MipoDisconnectTunnelComplete(const MMdfInputPort* aPu, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   104
	void MipoRestartTunnelComplete(const MMdfInputPort* aPu, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   105
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   106
	// from MMdfOutputPortObserver
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   107
	void MopoReadDataComplete(const MMdfOutputPort* aPu, CMMFBuffer* aBuffer, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   108
	void MopoDisconnectTunnelComplete(const MMdfOutputPort* aPu, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   109
	void MopoRestartTunnelComplete(const MMdfOutputPort* aPu, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   110
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   111
	// from MMdfProcessingUnitObserver
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   112
	void InitializeComplete(const CMdfProcessingUnit* aPu, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   113
	void ExecuteComplete(const CMdfProcessingUnit* aPu, TInt aErrorCode);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   114
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   115
	// from MMdfHwDeviceSetup	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   116
	void SetDataTypesL(TFourCC aSrcType, TFourCC aDestType);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   117
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   118
	// CMdfHwDeviceAdapter
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   119
	void GetState(THwDevAdapterState& aState) const;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   120
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   121
protected:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   122
	/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   123
	Hardware Device Adapter panics raised as a result of a programming error.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   124
	*/	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   125
	enum THwDeviceAdapterPanics
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   126
		{
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   127
		/*
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   128
		Raised when the Codec Processing Unit has not been initialised.
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   129
		@see CMdfHwDeviceAdapter::CustomInterface
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   130
		@see CMdfHwDeviceAdapter::SetDataTypesL
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   131
		*/
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   132
		EPanicCodecNotSet
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   133
		};	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   134
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   135
private:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   136
	CMdfHwDeviceAdapter();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   137
	void ConstructL();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   138
	TInt CreateBuffers();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   139
	TInt StartEncode();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   140
	TInt StartDecode();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   141
	TInt InitializeEncode();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   142
	TInt InitializeDecode();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   143
	TInt StartExecuting();
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   144
	void StopHwDevice(TInt error);
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   145
private:
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   146
	enum TPUType
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   147
		{
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   148
		EPcmPu,
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   149
		ESourceSinkPu
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   150
		};
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   151
	CMdfPuLoader* iPuLoader;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   152
	TUid iPuLoaderDtorKey;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   153
	MMdfInputPort* iCodecInputPort;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   154
	MMdfOutputPort* iCodecOutputPort;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   155
	MMdfInputPort* iSinkInputPort;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   156
	MMdfOutputPort* iSourceOutputPort;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   157
	CMdfProcessingUnit* iCodecPU;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   158
	CMdfProcessingUnit* iAudioDevicePU;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   159
	THwDevAdapterState iState;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   160
	TBool iPCMPUCallbackComplete;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   161
	TBool iSourceSinkPUCallbackComplete;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   162
	TBool iSourceSinkPuMopoStopCompleted;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   163
	TBool iPCMPuMopoStopCompleted;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   164
	TBool iPCMPuMipoStopCompleted;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   165
	TBool iStopping;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   166
	TInt iInitError;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   167
	TInt iExecuteError;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   168
	CMMFBuffer* iInputBuffer;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   169
	CMMFBuffer* iOutputBuffer;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   170
	TInt iInputPortBufferData;	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   171
	TInt iOutputPortBufferData;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   172
	CActiveSchedulerWait* iActiveWait;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   173
	TDeviceFunc iFuncCmd;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   174
	TFourCC iFirstFourCC;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   175
	TFourCC iSecondFourCC;
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   176
	};
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   177
	
79dd3e2336a0 2010wk36_01
hgs
parents:
diff changeset
   178
#endif // HWDEVICEADAPTER_H