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

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

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

    12 <concept id="GUID-9B52E0C3-9EBB-44C6-A1BF-2F95711FFBA4" xml:lang="en"><title>Template

    13 Source Code</title><shortdesc>This document discusses the template code from which device drivers

    14 are created.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <section id="GUID-2AE61413-CECE-4E72-86AA-0DD4FFC60EC3">       <title>Template

    16 source code</title>       <p>To help enable a base port be produced quickly,

    17 Symbian platform provides template source code for drivers for most peripherals.

    18 The template implements a framework and protocols for the type of peripheral;

    19 the base port implementer then supplies additional implementation for the

    20 particular hardware device. For example, for the UART driver, the PDD template

    21 implements the standard hardware abstraction interfaces for serial communication,

    22 such as the <codeph>DComm</codeph> class. It leaves some sections marked as

    23 "TBD", which are specific to the device. Driver developers can start with

    24 these templates and fill in the "TBD" functions to create a basic driver.

    25 If required, additional functionality can then be added to this. </p> <p>The

    26 template drivers are located in the <filepath>sf\os\kernelhwsrv\bsptemplate\asspandvariant\template_variant</filepath> source

    27 directory. The <filepath>template</filepath> directory provides a variant

    28 base port that includes all the drivers required to do the minimal base port

    29 for any variant. </p> <p>Details of the templates for particular drivers are

    30 discussed in the relevant sections of the <i>Base Porting Guide</i>. This

    31 tutorial presents an additional example device driver. </p>     </section>

    32 </conbody></concept>