<?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-06A70B84-82A3-5A80-86D6-50BE01F96C38" xml:lang="en"><title>Template
Variant Overview</title><shortdesc>This document briefly describes the hardware-specific variant layer. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-0A55E86E-98E3-584D-9CE5-45AFC9FA7EC3"><title>Purpose</title> <p>The
variant layer is a kernel extension that contains a diverse collection of
hardware-specific operations. </p> </section>
<section id="GUID-A3FA8347-68A8-4C4B-B5CE-5570C332034C"><title>Variant library details</title> <p>The template DLL is identified
below. </p> <table id="GUID-BEA37757-181A-5629-8E9D-232A047E2E5A">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>DLL</entry>
<entry>LIB</entry>
<entry>Short description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>ecust.dll</filepath>  </p> </entry>
<entry><p> <filepath>None</filepath>  </p> </entry>
<entry><p>The variant. </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section id="GUID-A798FD80-5327-4735-B933-16089A4E14A6"><title>Description</title> <p>The hardware specific variant layer
handles: </p> <ul>
<li id="GUID-5313266B-1B1F-5B98-931B-7C1A34BEE0A8"><p>restart reasons (used
by the bootstrap) </p> </li>
<li id="GUID-E822FBCE-FB78-53E9-9AF1-BCAA061FBFFD"><p>ram zone configuration
for ram defrag </p> </li>
<li id="GUID-B0CB1E9D-5425-5C89-9B5A-FDF6F864E6AE"><p>variant specific initialization
(not the same as ASSP specific initialization) </p> </li>
<li id="GUID-D97A008D-7661-55D9-816B-7383D6C8DABA"><p>early debug output support </p> </li>
<li id="GUID-9DB4F182-5C80-5F09-AFAE-58021B10E94A"><p>hal functions </p> </li>
<li id="GUID-72A67B21-52E3-5FF5-AB4F-9717412DB684"><p>interrupt code </p> </li>
<li id="GUID-13447447-8A42-5B2E-9557-BA4C7441A244"><p>variant specific CPU
idle operations. </p> </li>
</ul> </section>
<section id="GUID-0E1826F2-3403-49F5-9508-2A1AB95D1C9D"><title>Using variant</title> <p>The DLL is made up of these template
files: </p> <ul>
<li id="GUID-71666BB6-8C20-5C48-B5F2-0743FC153CB1"><p>variant.cpp </p> </li>
<li id="GUID-13C34612-7B80-5F9C-B1C7-AA01F9A51AE9"><p>variant_interrupt.cpp </p> </li>
</ul> <p>These can be found in the directory <filepath>template\template_variant\specific\</filepath>. </p> <p>The
source files in the <filepath>template_assp</filepath> folder are quite well
commented and should provide ample information on usage. </p> </section>
</conbody></concept>