Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]

Introduction

To run the tests on a device remotely from a PC, make sure that:

  1. the STAT tool is available, and at the right location on the device

  2. the connection to the device is set up correctly.

STAT tool

STAT tool is used to communicate between the MS-Windows PC and the Symbian OS device be it a board or the emulator. It is made of two components, one on each platform: a win32 DLL on one side and a Symbian OS application on the other side.

TestDriver uses STAT to communicate with the Symbian device, copy files, create directories and execute the arbitrary command line. These activities are remotely controlled on the device by an attached PC through the serial cable (TCP/IP, or any standard protocol), infrared, USB or Bluetooth. It can be started manually from the device, or be built into a ROM, using the techview_statapi.oby file. You need WinTAP, or a similar loopback system to allow STAT to communicate with the emulator. For more details on Wintap, see Setting up WINTAP.

NOTE: When STAT tool is built into a ROM, it must be run in a full graphical environment, such as Techview.

STAT tool provides commands to:

Configuring the STAT

There are two ways of launching STAT:

  1. Using buildrom

  2. From the device

Using buildrom

The standard BUILDROM commands are used to build the ROM. For more details, see Rebuilding Symbian OS reference ROMs. The ROM built is simple as it is built without the test code.

The following example builds the ROM and launches the STAT at the time of system bootup:

buildrom –D_EABI=ARMV5 –DRVCT –D_STARTUPMODE2 -DUSE_STRONG_CRYPTOGRAPHY h4hrp techview platsec statauto.iby"

where,

If you include testexecute.iby, or similar file in the ROM, switch the TestExec to OFF. This can be done by running the following command:

TestDriver.cmd config --testexec OFF

If testexecute.iby is not included in the ROM, run the following command.

TestDriver.cmd config --testexec ON

From the device

You can launch STAT by including the stat.ini file in the Compact Flash (CF) card on the sys\data directory.

Before communication can be established and test results collected, you need to copy five files onto the device.

The files are in the following location under the epoc32 directory on your PC:

Complete the following steps to configure STAT:

  1. Copy the above files to the CF card at the following locations:

    • system\data\stat.ini

    • system\programs\statapi.exe

    • system\libs\cinidata.dll

    • system\libs\testexecuteLogClientExt.dll

    • system\libs\econs.dll

      NOTE: Rename the file econsext.dll to econs.dll.

  2. Insert the CF card into the CF slot and power up the device.

  3. Browse to the drive mapped to the CF card and then browse to the location system\programs.

  4. Start the STAT tool manually by double-clicking on it.

    Press 'b' on the device to run STAT in the background. Press 'ESC' to close the application.

Modify the c:\system\data\stat.ini file on the EPOC device. Set the communication type and the logging settings.

[Top]

Transport for communicating with the device

Currently the following four transport modes are available for communicating with the device.

  1. Using serial connection

  2. Using TCP/IP

  3. Using Bluetooth

  4. Using USB

Setup the connections on the device side and on the PC side when using the above transport modes to run the tests.

[Top]

Transport for communicating with the emulator

WINTAP is the mode of transport for communicating with the emulator. It uses the default network connection on the PC for external connectivity. WINTAP allows you to access the IP services running on the desktop, or using Internet Connection Sharing on the desktop's default internet connection. For details on setting up the WinTap, see Setting up WINTAP

[Top]

See also

[Previous] [Top] [Next]