Executing Tests

TEF, test suite software, and TEF lite can be executed on the target hardware or on an emulator platform.

Executing on target

TestExecute Framework and test suite software are downloaded and executed on a target board (for example, H4) over a serial or USB link between the board and a PC. The remote file download and execution is managed by XML files interpreted by TestDriver using the STAT protocol. For more information about running the tests refer to TestDriver documentation.

Alternatively, the TEF along with the test server binaries and the data are built into the ROM and manually loaded on to the hardware for execution. This is done by including the testexecute.iby file, the test suite's .iby file and the techview.oby in the buildrom command from the windows command prompt.

#ifndef __SAMPLESERVER_IBY__
#define __SAMPLESERVER_IBY__


file=ABI_DIR\BUILD_DIR\SampleServer.exe     Sys\Bin\SampleServer.exe


data=EPOCROOT##Epoc32\release\winscw\udeb\z\SampleTest\SampleTest.ini SampleTest\SampleTest.ini
data=EPOCROOT##Epoc32\release\winscw\udeb\z\SampleTest\SampleTest.script SampleTest\SampleTest.Script
data=EPOCROOT##Epoc32\release\winscw\udeb\z\SampleTest\SampleTest.cfg SampleTest\SampleTest.cfg

#endif

The way to build TEF lite into a Techview ROM is similar to normal TEF; the only difference is to add the command-line option -DTEF_LITE to buildrom.

When using rom.bat to build TEF lite into a base ROM, you must include base_testexecutelite.iby in the corresponding .oby files. For example, adding #include <rom\include\base_testexecutelite.iby> into tshell.oby.

To run TEF lite on target hardware, TEF lite's executable file name must be renamed to testexecute.exe, which is the same name as normal TEF. So, you can use the same command line to launch TEF lite as normal TEF.

Executing on an emulator

The TestExecute Framework and test suite software are built and executed on the PC under the WINSCW environment at \epoc32\release\winscw\(udeb\urel)\testexecute.exe. Build the test server binaries and use the following command to run the executables:

> TestExecute.exe <FullFilePath>\xxxFile.script

For further information about the syntax of TestExecute.exe, refer to TestExecute Syntax .

Note: If your system drive is other than C: drive, use the SYSDRIVE variable with the absolute file path to point to the system drive.

> TestExecute.exe <${SYSDRIVE}\FullFilePath>\xxxFile.script

To run TEF lite on the emulator, the executable file name of TEF lite must be changed to testexecutelite.exe. So, you must use testexecutelite.exe to launch TEF lite on the emulator.