--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Adaptation/GUID-66E5F769-1156-54CA-94BC-8912159A1240.dita	Fri Oct 15 14:32:18 2010 +0100
@@ -0,0 +1,62 @@
+<?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-66E5F769-1156-54CA-94BC-8912159A1240" xml:lang="en"><title>Testing
+the PRM PSL</title><shortdesc>This document describes using the test suite for the PRM. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-A009D3D3-BD1B-40B8-B39D-8F35AD5FCF1E"><title>Purpose</title> <p>Use this test suite to ensure that your
+Power Resource Manager implementation runs correctly. </p> <p><b>Introduction</b> </p> <p> <codeph>T_PRMACCTST</codeph> is
+a test application that verifies the resources registered with the PSL of
+the PRM. For more information refer to the description of individual test
+cases in <filepath>e32test/resourceman/acctst/t_prmacctst.cpp</filepath>. </p> <p>The
+following tasks are preformed by the test suite: </p> <ul>
+<li id="GUID-86D22263-7F34-5F98-A673-909C64F1B929"><p>enumerate all registered
+resources, </p> </li>
+<li id="GUID-82F19722-C930-55CA-B7DF-B10F23660F5E"><p>check that resources
+behave consistently with their properties, </p> </li>
+<li id="GUID-37BA8D2B-E226-55EE-99DE-B0DA34D2CD1C"><p>ensure that resources
+are reset to their default level when not in use, </p> </li>
+<li id="GUID-6A399DB5-996B-503D-AE5B-F89797FB6722"><p>ensure all actual resources
+dependencies have been declared (only the extended version of the PRM allows
+dependencies). </p> </li>
+</ul> <p>To ensure that single-user resources are available to the test application, <codeph>T_PRMACCTST</codeph> is
+coupled with a kernel extension, <codeph>D_PRMACCTST</codeph> that takes control
+of such resources immediately after the PRM has been initialised. It then
+releases the resources when the test application ends. </p> </section>
+<section id="GUID-99C0A3AE-5C14-4B6E-9623-FE536E259D08"><title>Using the test suite</title> <p>The instructions to run the
+PRM acceptance test suite are as follows: </p> <ol id="GUID-2C3603D2-1CFD-55AF-B2D1-9532A09FA6A3">
+<li id="GUID-90FBCCDF-C195-5007-AB19-C2910D7CD1AB"><p>build the test code
+in <filepath>e32test/resourceman/acctst</filepath>, </p> </li>
+<li id="GUID-5DA609A8-64D1-5533-820D-2115B0412D8A"><p>build a rom for H4HRP
+of type <codeph>prmacctst</codeph> in <filepath>e32/rombuild</filepath>: </p> <p><userinput>rom
+-v=h4hrp -I=armv5 -b=urel -t=prmacctst</userinput> </p> <p>This command generates
+a self-starting ROM. The test output is captured from the default debug port
+of the device. </p> </li>
+</ol> <p>To build a manual test ROM (so the test application does not run
+automatically), use the <codeph>-d=MANUALROM</codeph> option. The usual ESHELL
+command prompt will be displayed and the test application can be run by calling <codeph>T_PRMACCTST</codeph>. </p> <p> <b>Note</b>:
+This test must be run with minimal required components because the test driver
+is a kernel extension and takes control of all single-user resources during
+its entry point. This test randomly changes the state of all the resources
+between a minimum and maximum value. If there are any restrictions on a resources
+state change (i.e. the resource state can be only be changed to a certain
+value) then that resource should not be registered while running this test. </p> </section>
+</conbody><related-links>
+<link href="GUID-2ECF13A1-9D56-5740-A09F-8267E6A45DD9.dita"><linktext>Porting the
+Power Resource Manager</linktext></link>
+<link href="GUID-B1CE51BC-B452-5FC9-9C00-35447AF40671.dita"><linktext>Implement
+the controllable power resources</linktext></link>
+<link href="GUID-66FD040B-133E-57CF-80DD-9369F62709C6.dita"><linktext>Implement
+the PSL for the target</linktext></link>
+<link href="GUID-E7F91A65-235D-589C-9A8C-0B207D19A24B.dita"><linktext>Port client
+drivers to use the PRM</linktext></link>
+<link href="GUID-C8DF0CB0-92F4-5F9E-A8F1-7DE50954C4F1.dita"><linktext>Debugging
+the PRM</linktext></link>
+</related-links></concept>
\ No newline at end of file