<?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-A0A7B5B7-57F6-5FDF-BB7A-2FA40561A737" xml:lang="en"><title>Kernel

Tests Guide</title><shortdesc>Provides a number of automatic and manual tests to verify that

kernel and peripherals are functioning as expected in your development environment. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-BDCBD7CB-D933-44A2-944A-A6DA56147625"><title>Purpose</title> <p>The

kernel tests provide performance bench marking for kernel and peripheral devices

and ensures that all required components are working as expected. </p> </section>

<section id="GUID-F06EC66A-ED2B-4D39-9711-2F169DF39316"><title>Building a

test</title> <p>Tests are built using the Symbian ROM build utility. </p> <p>A

handy script has been produced to simplify test building: </p> <p>To build

a series of automatic tests execute <filepath>rom.bat,</filepath> found in <filepath>\e32\rombuild</filepath>.

You will need to set the attributes and options to tell the system which tests

to run. </p> <p>For example, to build a debug MISA ROM image, using the ARM4

Instruction set, containing both the E32Test and F32Test tests, enter: </p> <p><userinput>cd <parmname>\e32\rombuild</parmname> </userinput> </p> <p><userinput>rom <cmdname>--assp</cmdname> =<parmname>misa</parmname> <parmname>--inst</parmname> =<parmname>arm4</parmname> <cmdname>--build</cmdname> =<parmname>urel</parmname> <cmdname>--type</cmdname> =<parmname>alltests</parmname> </userinput> </p> <p>Which

creates <filepath>misabaarm4.img</filepath>,<filepath> rombuild.log</filepath> and <filepath>rom.oby</filepath> in<filepath> \e32\rombuild</filepath>. The <codeph>*.img</codeph> image file should be renamed and then transferred

to the target hardware as appropriate for the target device. </p> <p>Test

configuration can be customized by editing <filepath>e32test\group\bld.inf</filepath> and

adding or removing device drivers or kernel tests as required. All tests included

in the default build are part of the automatic test, those marked as manual

need to be explicitly included. </p> </section>

<section id="GUID-8A26BDB3-B4DD-42C9-8529-0F0B1E381789"><title>Executing tests</title> <p>The

kernel tests can be built and executed as automatic or manual tests. </p> <p> <note/>  </p> <ul>

<li id="GUID-6BAC5BC4-3A87-5773-8154-79965CFE8D58"><p> <b>Automatic test</b>  </p> <p>Tests

flagged as automatic are built into test scripts, which are then built into

the ROM image. </p> </li>

<li id="GUID-91A433D5-BB6A-50EA-BD1F-BF8AD911FAF6"><p> <b>Manual test</b>  </p> <p>Some

of the manual tests do not produce the log data via serial port which is indicated

in the test reference document. The successful completion of these tests should

be verified by monitoring the screen output, rather than referring to the

log data at the end of a testing session. </p> </li>

</ul> </section>

<section id="GUID-5D14B23B-1747-4985-9F74-7F487CA2F8FE"><title>Verification

of the test results</title> <p><b>Automatic test </b> </p> <p>All automatic

tests output a log file via serial port. Such output should be captured using

HyperTerminal or a tool with similar functionality. Each test uses the <xref href="GUID-D16A6778-660E-302A-A3B5-DD98A088B7EC.dita"><apiname>RTest</apiname></xref> class

which is part of the EPOC base. The log data output is specific to the test,

however there are few elements of the output that are similar across all tests. </p> <p>If

the output generated by <codeph>RTest</codeph> shows </p> <codeblock id="GUID-75FFCCA8-39E7-5D25-B1B9-9EAC2BC10E8B" xml:space="preserve">FAIL : T_DSPACE failed check 1 at line Number: 660</codeblock> <p>it means a particular test case in the test program has failed. The line

and check number of the failed test case is displayed. This will help to track

the defect in the test code. </p> <p>If the output generated by RTest shows </p> <codeblock id="GUID-9282986C-9FA6-58EC-8A22-0C49BC182287" xml:space="preserve">RTEST: SUCCESS : T_OPEN test completed O.K.</codeblock> <p>it

means the test is successful. </p> <p><b>Manual test </b> </p> <p>For manual

tests that output log file the procedure is the same as explained above. For

tests that do not output serial logs, successful completion of the test should

be verified by monitoring the screen output. Since these tests are still RTest

based the output will still follow the patterns outlined above. </p> </section>

</conbody><related-links>

<link href="GUID-6BD9D6ED-99EA-5611-AF58-A6694ADE95F4.dita"><linktext>Kernel Utilities

Test Guide</linktext></link>

<link href="GUID-8C2B9DC3-9D96-560A-B27A-A8EB6C9A342C.dita"><linktext>SDIO test

Guide</linktext></link>