Symbian3/PDK/Source/GUID-96975165-9194-5FDF-8160-3A020522263A.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 16 Jul 2010 17:23:46 +0100
changeset 12 80ef3a206772
parent 9 59758314f811
child 14 578be2adaf3e
permissions -rw-r--r--
Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     1
<?xml version="1.0" encoding="utf-8"?>
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     2
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     3
<!-- This component and the accompanying materials are made available under the terms of the License 
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     4
"Eclipse Public License v1.0" which accompanies this distribution, 
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     5
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     6
<!-- Initial Contributors:
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     7
    Nokia Corporation - initial contribution.
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     8
Contributors: 
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     9
-->
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    10
<!DOCTYPE task
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    11
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    12
<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>
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    13
                  Figure 1: PSY Tester Start View 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    14
                </title> <image href="GUID-A583E66D-D2ED-5C1C-AF2C-38060D926881_d0e464802_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>
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    15
                  Figure 2: PSY Tester Help View. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    16
                </title> <image href="GUID-299D0C57-F200-5135-B4D6-304002730A28_d0e464816_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>
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    17
                  Figure 3: PSY Tester List View. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    18
                </title> <image href="GUID-0B41947E-B710-5D89-AEEF-6EFF496BAD96_d0e464835_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
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    19
                     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>
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    20
                  Figure 4: PSY Tester List View with selected PSY. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    21
                </title> <image href="GUID-9B123F74-DD52-5975-8DD7-80304A1D1D63_d0e464911_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>
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    22
                  Figure 5: PSY Tester Settings View. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    23
                </title> <image href="GUID-54C2B185-3F56-5602-9021-34E27F0C40A6_d0e464927_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>
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    24
                  Figure 6: Overriding the number of location requests for the
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    25
                  memory consumption test. 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    26
                </title> <image href="GUID-A0051B62-FC01-5693-9532-EDBDB25634AA_d0e464944_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>
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    27
                  Figure 7: Help view for the PSY Tester Settings view 
12
80ef3a206772 Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 9
diff changeset
    28
                </title> <image href="GUID-50930F20-0F6D-5FF6-A476-59F221DF5CD4_d0e464967_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
9
59758314f811 Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    29
                the test logs</linktext> </link> <link href="GUID-5EED00FE-F39D-5942-BA22-1F286EFF38AA.dita"><linktext>PSY
1
25a17d01db0c Addition of the PDK content and example code for Documentation_content according to Feature bug 1607 and bug 1608
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    30
                Tutorial</linktext> </link> </related-links></task>