<?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 task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task xml:lang="en" id="GUID-96975165-9194-5FDF-8160-3A020522263A"><title>Run PSY Tester </title><shortdesc>This section describes how to run PSY tester. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody><context><p>PSY Tester is run to select and test PSY(s). </p> <p>PSY Tester is implemented as a console application, which means that it has a limited UI. This is because it must be possible to use the same implementation of PSY Tester independently of the graphical UI of the phone on which it runs. </p> <p>The information in this document about which keys to press is valid for a Series 60 target device. For a translation list of the keys to be used when running the PSY Tester application on the emulator, see the key table in <xref href="GUID-1B03B926-8EA9-50B4-8300-B82EC1CDF658.dita">PSY Tester Reference</xref>. </p> </context> <steps id="GUID-8526C985-B9F8-5B28-A089-FFD2246CB0FA"><step id="GUID-FB2D2008-1AD7-5902-9D3A-28C300E7820A"><cmd>Start PSY Tester to show the Start View </cmd> <info>Start the PSY Tester application <filepath>psytester.exe</filepath> from a file browser or eshell. The Start View of Figure 1 is displayed. </info> <info><fig id="GUID-33BC9181-58CE-50AF-9563-07BEADBD7EAB"><title>

                  Figure 1: PSY Tester Start View 

                </title> <image href="GUID-A583E66D-D2ED-5C1C-AF2C-38060D926881_d0e462634_href.png" placement="inline"/></fig> </info> <info>The Start View is displayed every time PSY Tester is started. A user can obtain help be pressing the left soft key or H to show the Help View of Figure 2. This Help View shows the different commands that are used to control PSY Tester. <xref href="GUID-1B03B926-8EA9-50B4-8300-B82EC1CDF658.dita">PSY Tester Reference</xref> describes the commands in this menu. </info> <info><fig id="GUID-DF3D180F-D117-579E-8E44-47CC609BD8C8"><title>

                  Figure 2: PSY Tester Help View. 

                </title> <image href="GUID-299D0C57-F200-5135-B4D6-304002730A28_d0e462648_href.png" placement="inline"/></fig> </info> </step> <step id="GUID-C611DB0D-20B3-5C4C-86ED-64BC0B01096B"><cmd>List the installed PSYs and select one for test </cmd> <info>Press "Joystick Right" ("Arrow Right" in an emulator) to shift view. The PSY Tester List View is shown (figure 3) </info> <info>The List View lists the PSYs from index 1 to 4. If there are more PSYs installed than can be shown on one screen, they are listed when the user moves the joystick down (Arrow Down in an emulator). </info> <info><fig id="GUID-C0BA0422-A2E7-5B83-849E-571515B77073"><title>

                  Figure 3: PSY Tester List View. 

                </title> <image href="GUID-0B41947E-B710-5D89-AEEF-6EFF496BAD96_d0e462667_href.png" placement="inline"/></fig> </info> <info>By default, all installed PSYs are listed. If any of the installed PSYs must not be shown in the PSY Tester List view, the UID of the PSY can be specified in the PSY Tester resource file under <codeph>r_pos_psy_tester_psy_uid_excludes_list</codeph>. </info> <info>The PSY Tester List View shows PSY implementation information that has been retrieved from PSY resource files. The information presented for each PSY is as follows: </info> <substeps id="GUID-B838A035-C8CC-5450-850E-D0121B70E872"><substep id="GUID-6E8799B2-BCC6-550F-92F4-2684BAC61526"><cmd/><info>The first row shows the display name for the PSY as specified in the PSY resource file as <codeph>display_name</codeph>. In figure 3 the PSY display name for the PSY with index 25 has <codeph>display_name = "Test PSY5

                     Status"</codeph> in the PSY resource file. </info> <info>If the PSY name is too long to fit on one row, the extra characters are not shown. </info> </substep> <substep id="GUID-63BDE1F9-93D3-56AA-88A0-A1983518A365"><cmd/><info>The second row shows the implementation UID for the PSY, specified in the PSY resource file as <codeph>implementation_uid</codeph>. </info> <info>In figure 3, the implementation UID for the PSY with index 25 has i<codeph>mplementation_uid = 0x01ff0018</codeph> in the PSY resource file. </info> </substep> <substep id="GUID-D61DAA83-755C-5284-9394-DA5A20BA7DE3"><cmd/><info>The third row shows the version number of the PSY, specified in the resource file as <codeph>version_no</codeph>. </info> <info>In figure 3, the version number for the PSY with index 25 is specified as <codeph>version_no = 1</codeph> in the resource file. </info> </substep> </substeps> <info>To select PSY <codeph>"Test PSY5 Status"</codeph> (which has index number 25 in the list in figure 3) for testing, type 25. </info> <info>In response <codeph>PSY: 25</codeph> is displayed as shown in Figure 4. </info> <info><fig id="GUID-D9F61C36-95DD-530D-8ED5-20D929D826C2"><title>

                  Figure 4: PSY Tester List View with selected PSY. 

                </title> <image href="GUID-9B123F74-DD52-5975-8DD7-80304A1D1D63_d0e462743_href.png" placement="inline"/></fig> </info> </step> <step id="GUID-73937F10-68C9-50FE-9045-F62058C8255D"><cmd>(Optional) Change the number of location requests for the memory consumption test. </cmd> <info>Press "Joystick Right" ("Arrow Right" in an emulator) to show the PSY Tester Settings View (figure 5). </info> <info><fig id="GUID-1C4CAFC2-E04D-5DCE-85E0-ABD20B477AB5"><title>

                  Figure 5: PSY Tester Settings View. 

                </title> <image href="GUID-54C2B185-3F56-5602-9021-34E27F0C40A6_d0e462759_href.png" placement="inline"/></fig> </info> <info>In Settings View the user can override the default number of location requests made for the memory consumption test. </info> <info>The memory consumption test requires that PSY Tester makes a large number of requests. A default value of 1000 requests is defined in the PSY Tester configuration file. Such a large number of requests significantly affects the testing time. The user can override this default value in the Settings View. </info> <info>To change the default number of requests, enter a number and press the joystick (press Enter on an emulator). Figure 6 shows an example or reducing the number of requests to 30. </info> <info><fig id="GUID-D4E4CAD7-B2D4-56BB-B2B3-6BF167D5C66E"><title>

                  Figure 6: Overriding the number of location requests for the

                  memory consumption test. 

                </title> <image href="GUID-A0051B62-FC01-5693-9532-EDBDB25634AA_d0e462776_href.png" placement="inline"/></fig> </info> <info>The value typed in the PSY Tester Settings view is used for all memory tests until the user selects to override the value with a new one or until PSY Tester is restarted. </info> <info>If 0 is selected as the number of location requests for the memory consumption test, it is not performed. </info> <info>The default value from the resource file is used every time PSY Tester is started if the user does not override the value as described above. </info> <info>A help view (figure 7) available for the PSY Tester Settings view by typing H. </info> <info>This help view gives information on how to turn off memory tests (by selecting 0) as well as information on the default value for the number of location requests for memory consumption test (1000). </info> <info><fig id="GUID-CE526086-9D21-5B66-A8A8-FAB35B0AC0BB"><title>

                  Figure 7: Help view for the PSY Tester Settings view 

                </title> <image href="GUID-50930F20-0F6D-5FF6-A476-59F221DF5CD4_d0e462799_href.png" placement="inline"/></fig> </info> <info>Shift back to the PSY Tester List View by pressing Joystick Left (Arrow Left). </info> </step> <step id="GUID-C9D44F54-F608-52A6-A54F-383792D50F84"><cmd>Start the tests </cmd> <info>After selecting a PSY for test, press the joystick (Enter in emulator) to start the tests. </info> <info>A message is shown that states that the tests are running, followed later by a message when the tests are complete. </info> <info>The results for the tests are available in the log file. For log file details see <xref href="GUID-E6F4AC4E-7065-53BD-B9B3-B85D4257ED3C.dita">Read the test logs</xref>. </info> </step> </steps> <result><p>The PSY Tester runs the tests and writes test log files. </p> </result> <postreq><p>When the tests are finished, the user reads the log files to see the test results. </p> <p>See <xref href="GUID-E6F4AC4E-7065-53BD-B9B3-B85D4257ED3C.dita">Read the test logs</xref> for more information. </p> </postreq> </taskbody><related-links><link href="GUID-E6F4AC4E-7065-53BD-B9B3-B85D4257ED3C.dita"><linktext>Read

                the test logs</linktext> </link> <link href="GUID-5EED00FE-F39D-5942-BA22-1F286EFF38AA.dita"><linktext>PSY

                Tutorial</linktext> </link> </related-links></task>