Symbian3/PDK/Source/GUID-A0A7B5B7-57F6-5FDF-BB7A-2FA40561A737.dita
changeset 14 578be2adaf3e
parent 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-A0A7B5B7-57F6-5FDF-BB7A-2FA40561A737.dita	Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-A0A7B5B7-57F6-5FDF-BB7A-2FA40561A737.dita	Fri Aug 13 16:47:46 2010 +0100
@@ -1,61 +1,61 @@
-<?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>
+<?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>
 </related-links></concept>
\ No newline at end of file