<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 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: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-8552E66E-73D6-51DA-8F53-DDF437186CD6" xml:lang="en"><title>Validation</title><shortdesc>Describes the DMA test code to validate the port of DMA framework.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>The same set of source code is used to build two different DMA test harnesses: </p>

<ol id="GUID-57C2BE90-6771-5C69-804F-CC08AEB43E88">

<li id="GUID-778D3856-4605-5156-826F-9B4FCEC296CE"><p>It builds: <filepath>T_DMASIM.EXE</filepath>, <filepath>D_DMASIM.LDD</filepath>,

and <filepath>DMASIM.DLL</filepath>. This is a software-simulated implementation

of DMA. This harness is used mainly for debugging and validating the PIL (platform-independent

layer) as it simulates every kind of DMA controller. The DMA simulator and

associated PSL (platform-specific layer) is in <filepath>...\e32test\dma\dmasim.cpp</filepath>. </p> </li>

<li id="GUID-69027EF2-66D9-56C3-B63C-269D729382D5"><p>It builds: <filepath>T_DMA.EXE</filepath>, <filepath>D_DMA.LDD</filepath>.

The source code for building these executables is in <filepath>...\e32test\dma\t_dma.cpp</filepath> and <filepath>...\e32test\dma\d_dma.cpp</filepath> respectively </p> </li>

</ol>

<p> <filepath>T_DMA.EXE</filepath> is a user-side harness, and is an automatic

test included in the E32TEST suite. It assumes that the underlying DMA controller

supports memory to memory transfers. This executable delegates most of the

work to D_DMA.LDD (built from base\e32test\dma\d_dma.cpp), a logical device

driver that acts as a client for the DMA Framework. D_DMA.LDD links statically

against DMA.DLL, the DMA Framework kernel extension and as such must be built

from the variant. </p>

<p> <filepath>T_DMA.EXE</filepath> delegates most of the work to <filepath>D_DMA.LDD</filepath>,

which is a logical device driver that acts as a client for the DMA Framework. <filepath>D_DMA.LDD</filepath> links

statically against <filepath>DMA.DLL</filepath>, the DMA Framework kernel

extension, and as such must be built from the variant. In practice, this means

that <filepath>D_DMA.LDD</filepath> must be specified in the test <filepath>bld.inf</filepath> for

the variant being ported. See <filepath>...\template_variant\test\bld.inf</filepath> for

an example. </p>

<p> <filepath>D_DMA.LDD</filepath> calls the <codeph>DmaTestInfo()</codeph> function

in the PSL to discover the capacities of the PSL: number of channels, maximum

transfer size, etc. This is the template implementation: </p>

<codeblock id="GUID-AB52EDB6-B76A-5362-B8F6-64DBF7E39460" xml:space="preserve">TDmaTestInfo TestInfo =

    {

    0,

    0,

    0,

    0,

    NULL,

    0,

    NULL,

    0,

    NULL

    };

</codeblock>

<codeblock id="GUID-8A365AA3-9D88-5A62-9DE8-F5D7DFDEBAC4" xml:space="preserve">EXPORT_C const TDmaTestInfo&amp; DmaTestInfo()

//

//

//

    {

    return TestInfo;

    }

</codeblock>