os/kernelhwsrv/kerneltest/e32test/dma/d_dma.h
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
sl@0
     1
// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0
     2
// All rights reserved.
sl@0
     3
// This component and the accompanying materials are made available
sl@0
     4
// under the terms of the License "Eclipse Public License v1.0"
sl@0
     5
// which accompanies this distribution, and is available
sl@0
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0
     7
//
sl@0
     8
// Initial Contributors:
sl@0
     9
// Nokia Corporation - initial contribution.
sl@0
    10
//
sl@0
    11
// Contributors:
sl@0
    12
//
sl@0
    13
// Description:
sl@0
    14
// e32test\dma\d_dma.h
sl@0
    15
// User-side API for LDD used to test DMA framework.
sl@0
    16
// 
sl@0
    17
//
sl@0
    18
sl@0
    19
#ifndef __D_DMA_H__
sl@0
    20
#define __D_DMA_H__
sl@0
    21
sl@0
    22
#include <e32cmn.h>
sl@0
    23
#ifndef __KLIB_H__
sl@0
    24
#include <e32std.h>
sl@0
    25
#endif
sl@0
    26
sl@0
    27
#ifdef __DMASIM__
sl@0
    28
_LIT(KTestDmaLddName, "TestDmaSim");
sl@0
    29
#else
sl@0
    30
_LIT(KTestDmaLddName, "TestDma");
sl@0
    31
#endif
sl@0
    32
sl@0
    33
inline TVersion TestDmaLddVersion() { return TVersion(1, 0, 1); }
sl@0
    34
sl@0
    35
class RTestDma : public RBusLogicalChannel
sl@0
    36
	{
sl@0
    37
public:
sl@0
    38
	struct TFragmentInfo
sl@0
    39
		{
sl@0
    40
		TInt iRequestIdx;
sl@0
    41
		TInt iSrcBufIdx;
sl@0
    42
		TInt iDestBufIdx;
sl@0
    43
		TInt iSize;
sl@0
    44
		TRequestStatus* iRs;
sl@0
    45
		};
sl@0
    46
	struct TOpenInfo
sl@0
    47
		{
sl@0
    48
		enum { EGetInfo, EOpen } iWhat;
sl@0
    49
		union
sl@0
    50
			{
sl@0
    51
			TAny* iInfo;
sl@0
    52
			struct
sl@0
    53
				{
sl@0
    54
				TUint32 iId;
sl@0
    55
				TInt iDesCount;
sl@0
    56
				TInt iMaxTransferSize;
sl@0
    57
				} iOpen;
sl@0
    58
			} U;
sl@0
    59
		};
sl@0
    60
	enum TControl
sl@0
    61
		{
sl@0
    62
		EAllocBuffer,
sl@0
    63
		EFreeAllBuffers,
sl@0
    64
		EFillBuffer,
sl@0
    65
		ECheckBuffer,
sl@0
    66
		EFragment,
sl@0
    67
		EExecute,
sl@0
    68
		EFailNext,
sl@0
    69
		EFragmentCount,
sl@0
    70
		EMissInterrupts,
sl@0
    71
		};
sl@0
    72
	enum { KMaxChannels = 32 };
sl@0
    73
	struct TInfo
sl@0
    74
		{
sl@0
    75
		TInt iMaxTransferSize;
sl@0
    76
		TUint iMemAlignMask;
sl@0
    77
		TInt iMaxSbChannels;
sl@0
    78
		TUint32 iSbChannels[KMaxChannels];
sl@0
    79
		TInt iMaxDbChannels;
sl@0
    80
		TUint32 iDbChannels[KMaxChannels];
sl@0
    81
		TInt iMaxSgChannels;
sl@0
    82
		TUint32 iSgChannels[KMaxChannels];
sl@0
    83
		};
sl@0
    84
public:
sl@0
    85
#ifndef __KERNEL_MODE__
sl@0
    86
	inline TInt GetInfo(TInfo& aInfo);
sl@0
    87
	inline TInt Open(TUint32 aId, TInt aDesCount, TInt aMaxTransferSize);
sl@0
    88
	inline TInt AllocBuffer(TInt aBufIdx, TInt aSize);
sl@0
    89
	inline void FreeAllBuffers();
sl@0
    90
	inline void FillBuffer(TInt aBufIdx, TUint8 aFillValue);
sl@0
    91
	inline TBool CheckBuffer(TInt aBufIdx, TUint8 aValue);
sl@0
    92
	inline TInt Fragment(TInt aRequestIdx, TInt aSrcBufIdx, TInt aDestBufIdx, TInt aSize, TRequestStatus* aRs=NULL);
sl@0
    93
	inline TInt Execute(const TDesC8& aCmd);
sl@0
    94
	inline TInt FailNext(TInt aFragmentCount);
sl@0
    95
	inline TInt FragmentCount(TInt aRequestIdx);
sl@0
    96
	inline TInt MissNextInterrupts(TInt aInterruptCount);
sl@0
    97
	inline TBool FragmentCheck(TInt aRequestIdx, TInt aExpectedCount);
sl@0
    98
#endif
sl@0
    99
	};
sl@0
   100
sl@0
   101
#ifndef __KERNEL_MODE__
sl@0
   102
sl@0
   103
inline TInt RTestDma::GetInfo(TInfo& aInfo)
sl@0
   104
	{
sl@0
   105
	TPckgBuf<TOpenInfo> infoBuf;
sl@0
   106
	infoBuf().iWhat = TOpenInfo::EGetInfo;
sl@0
   107
	infoBuf().U.iInfo = &aInfo;
sl@0
   108
	return DoCreate(KTestDmaLddName, TestDmaLddVersion(), 0, NULL, &infoBuf) == KErrDied ? KErrNone : KErrGeneral;
sl@0
   109
	}
sl@0
   110
sl@0
   111
inline TInt RTestDma::Open(TUint32 aId, TInt aDesCount, TInt aMaxTransferSize)
sl@0
   112
	{
sl@0
   113
	TPckgBuf<TOpenInfo> infoBuf;
sl@0
   114
	infoBuf().iWhat = TOpenInfo::EOpen;
sl@0
   115
	infoBuf().U.iOpen.iId = aId;
sl@0
   116
	infoBuf().U.iOpen.iDesCount = aDesCount;
sl@0
   117
	infoBuf().U.iOpen.iMaxTransferSize = aMaxTransferSize;
sl@0
   118
	return DoCreate(KTestDmaLddName, TestDmaLddVersion(), 0, NULL, &infoBuf, EOwnerThread);
sl@0
   119
	}
sl@0
   120
sl@0
   121
inline TInt RTestDma::AllocBuffer(TInt aBufIdx, TInt aSize)
sl@0
   122
	{
sl@0
   123
	return DoControl(EAllocBuffer, (TAny*)aBufIdx, (TAny*)aSize);
sl@0
   124
	}
sl@0
   125
sl@0
   126
inline void RTestDma::FreeAllBuffers()
sl@0
   127
	{
sl@0
   128
	DoControl(EFreeAllBuffers, NULL, NULL);
sl@0
   129
	}
sl@0
   130
sl@0
   131
inline void RTestDma::FillBuffer(TInt aBufIdx, TUint8 aFillValue)
sl@0
   132
	{
sl@0
   133
	DoControl(EFillBuffer, (TAny*)aBufIdx, (TAny*)(TUint)aFillValue);
sl@0
   134
	}
sl@0
   135
sl@0
   136
inline TBool RTestDma::CheckBuffer(TInt aBufIdx, TUint8 aValue)
sl@0
   137
	{
sl@0
   138
	return DoControl(ECheckBuffer, (TAny*)aBufIdx, (TAny*)(TUint)aValue);
sl@0
   139
	}
sl@0
   140
sl@0
   141
inline TInt RTestDma::Fragment(TInt aRequestIdx, TInt aSrcBufIdx, TInt aDestBufIdx, TInt aSize, TRequestStatus* aRs)
sl@0
   142
	{
sl@0
   143
	TFragmentInfo info;
sl@0
   144
	info.iRequestIdx = aRequestIdx;
sl@0
   145
	info.iSrcBufIdx = aSrcBufIdx;
sl@0
   146
	info.iDestBufIdx = aDestBufIdx;
sl@0
   147
	info.iSize = aSize;
sl@0
   148
	info.iRs = aRs;
sl@0
   149
	if (aRs != NULL)
sl@0
   150
		*aRs = KRequestPending;
sl@0
   151
	return DoControl(EFragment, &info, NULL);
sl@0
   152
	}
sl@0
   153
sl@0
   154
inline TInt RTestDma::Execute(const TDesC8& aCmd)
sl@0
   155
	{
sl@0
   156
	return DoControl(EExecute, (TDesC8*)&aCmd, NULL);
sl@0
   157
	}
sl@0
   158
sl@0
   159
inline TInt RTestDma::FailNext(TInt aFragmentCount)
sl@0
   160
	{
sl@0
   161
	return DoControl(EFailNext, (TAny*)aFragmentCount, NULL);
sl@0
   162
	}
sl@0
   163
sl@0
   164
inline TInt RTestDma::FragmentCount(TInt aRequestIdx)
sl@0
   165
	{
sl@0
   166
	return DoControl(EFragmentCount, (TAny*)aRequestIdx, NULL);
sl@0
   167
	}
sl@0
   168
sl@0
   169
inline TInt RTestDma::MissNextInterrupts(TInt aInterruptCount)
sl@0
   170
	{
sl@0
   171
	return DoControl(EMissInterrupts, (TAny*)aInterruptCount, NULL);
sl@0
   172
	}
sl@0
   173
sl@0
   174
/**
sl@0
   175
@param The number of fragments expected, 0 means don't check
sl@0
   176
*/
sl@0
   177
inline TBool RTestDma::FragmentCheck(TInt aRequestIdx, TInt aExpectedCount)
sl@0
   178
	{
sl@0
   179
	if(aExpectedCount)
sl@0
   180
		{
sl@0
   181
		TInt actualCount = FragmentCount(aRequestIdx);
sl@0
   182
		if(actualCount == aExpectedCount)
sl@0
   183
			return ETrue;
sl@0
   184
		else
sl@0
   185
			{
sl@0
   186
			RDebug::Printf("Fragment count error: expected %d, got %d", aExpectedCount, actualCount);
sl@0
   187
			return EFalse;
sl@0
   188
			}
sl@0
   189
		}
sl@0
   190
	else
sl@0
   191
		return ETrue;
sl@0
   192
	}
sl@0
   193
#endif // #ifndef __KERNEL_MODE__
sl@0
   194
sl@0
   195
#endif