Symbian3/PDK/Source/GUID-9B3CDA90-2BAE-5AF3-914A-6CB9FC84746A.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 11 Mar 2010 18:02:22 +0000
changeset 3 46218c8b8afa
parent 1 25a17d01db0c
child 5 f345bda72bc4
permissions -rw-r--r--
week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.

<?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-9B3CDA90-2BAE-5AF3-914A-6CB9FC84746A" xml:lang="en"><title>Generic
Board Support Packages Overview</title><shortdesc>Describes the generic board support packages used in Symbian platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-8AA53EA3-B5D7-4723-B37D-BCADC5620820"><title>Purpose</title> <p>The
Generic BSP provides a framework for developing a new BSP. </p> </section>
<section id="GUID-64AB7044-E473-4449-A280-95FBDD14011A"><title>Required background</title> <p>It
is assumed that you are familiar with the Board Support Packages used in Symbian
platform. </p> </section>
<section id="GUID-939B3E38-F9A7-44A1-9FEB-DAE5E85036E0"><title>Key concepts
and terms</title> <dl>
<dlentry>
<dt>ASSP</dt>
<dd><p>Contains software that supports a specific ASSP or ASIC. This would
be used by a BSP that was targeting a device that used the specified ASIC. </p> </dd>
</dlentry>
<dlentry>
<dt>Variant</dt>
<dd><p>This has the master build files and source for the device specific
peripherals. </p> </dd>
</dlentry>
<dlentry>
<dt>Board Support Package</dt>
<dd><p>Provides hardware-specific support code for a given hardware reference
board. A package may be delivered as a single component or in multiple components. </p> </dd>
</dlentry>
</dl> </section>
<section id="GUID-90192E63-3DF3-4F23-9470-B213AD68F8CC"><title>Architecture</title> <p>The
generic board support package architecture constitute the lowest layer of
the kernel. The kernel contains separate code for the ASSP and variant called
by the kernel. This acts as a framework on which a set of generic device drivers
for a common peripheral controllers such as LCD, UART, Keyboard, Digitizer
and NOR Flash Media Driver are customized at compile-time. These drivers are
made generic through a set of preprocessor macros which specify the customizes
parts like I/O base address and optional features . It also has template variant
that provide template code with placeholders to simplify development of a
variant for new hardware. It includes generic code for common extensions and
physical drivers. </p> </section>
<section id="GUID-3C050451-8FC3-4FCD-89A7-0E808365AF57"><title>Generic Board
Support Packages Summary</title> <p>Generic BSP provides the following framework
for the following: </p> <ul>
<li id="GUID-FCF3E7D2-E083-597A-88A7-276BA7B5F3D3"><p> <b>DMA Framework </b>  </p> <p> <filepath>dma.lib</filepath>  </p> <p>DMA
Platform Independent Layer that provides DMA Framework to transfer data using
DMA. </p> </li>
<li id="GUID-7B0DEC0C-5DB6-5105-A668-AA143A71FC6F"><p> <b>Binary Power Framework</b>  </p> <p> <filepath>bpower.cpp</filepath>  </p> <p>A
framework for managing power within the system, and the management of the
transition between power states. </p> </li>
<li id="GUID-43B546A0-3718-5D83-8441-17C2468DD1C5"><p> <b>Basic Resource Manager
Framework</b>  </p> <p> <filepath>resmanpsl.lib</filepath>  </p> <p>A framework
that provides essential or required functionality for static resources. </p> </li>
<li id="GUID-7D4B029C-73FA-5D46-AD66-1EB9BE299D08"><p> <b>Extended Resource
Manager Framework</b>  </p> <p> <filepath>resmanextenedpsl.lib</filepath>  </p> <p>A
framework that provides additional support for dynamic resources and resource
dependencies. </p> </li>
</ul> </section>
</conbody><related-links>
<link href="GUID-A91C6359-E547-51AD-AA8C-45BCAFBA98AC.dita#GUID-A91C6359-E547-51AD-AA8C-45BCAFBA98AC/GUID-B66850E3-11C9-58D6-ADB3-12ABBC1B792C">
<linktext>Kernel Architecture 2</linktext></link>
</related-links></concept>