Adaptation/GUID-C6ABE2CA-901E-55F1-9837-7018A1612BCF.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?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-C6ABE2CA-901E-55F1-9837-7018A1612BCF" xml:lang="en"><title>Set Up</title><shortdesc>Describes how to use the template port to start your port.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The code for the template port Sound Driver is split into two files: </p>
<ul>
<li id="GUID-6CF84764-1EE7-5891-8212-33A1548958B8"><p>This file holds the
code for the record driver channel </p> <p> <filepath> ...\template\template_variant\specific\soundsc_rx.cpp</filepath>  </p> </li>
<li id="GUID-3309787F-7D0E-5E9A-A7B0-B55E0A7AA0FB"><p>This file holds code
for the playback driver channel together with code which is common to both
channels. </p> <p> <filepath>...\template\template_variant\specific\soundsc_tx.cpp</filepath>  </p> </li>
</ul>
<p>The header file for the above can be found in: </p>
<p> <filepath>...\template\template_variant\inc\soundsc_plat.h</filepath>  </p>
<p>The template <filepath>.mmp</filepath> file can be found in: </p>
<p> <filepath>...\template\template_variant\soundsctemplate.mmp</filepath>  </p>
<p>Following the general pattern, your implementation is contained in the
directory: </p>
<p> <filepath>path to your variant\specific</filepath>  </p>
<p>For example, <filepath>...\omap_hrp\h4\specific</filepath>  </p>
<p>Now complete these steps: </p>
<ul>
<li id="GUID-77DD9781-8D04-50F9-A372-BCED22354FC3"><p>create a copy of the
template port implementation files <filepath>soundsc_rx.cpp</filepath> and <filepath>soundsc_tx.cpp</filepath>,
copy them into your variant specific directory </p> </li>
<li id="GUID-A6A250DB-F4D6-58F5-88A0-C86A919C7076"><p>create a copy of the
header file <filepath>soundsc_plat.h</filepath>, copy it to the include directory
for your variant </p> </li>
<li id="GUID-785D0DF1-7251-5408-ADEA-5BE2CF9CD4F6"><p>rename the Sound Driver
PDD factory class <filepath>DTemplateSoundScPddFactory</filepath>, to reflect
the name of your device </p> </li>
<li id="GUID-0D45F6BD-AB06-5F04-BCC7-D3A7B16FCE20"><p>rename the classes <filepath>DTemplateSoundScRxPdd</filepath> and <filepath>DTemplateSoundScTxPdd</filepath> to reflect the name of your device. </p> </li>
</ul>
<p><note> You should also be prepared to add your own private data and functions
to the Sound Driver. </note></p>
</conbody></concept>