Preference reference

This page provides a quick reference to the TestDriver preferences, the commands and the switches to be used to set these preferences to achieve specific results while using the TestDriver. The preferences can be modified using the switches provided in the TestDriver commands. For example, to set the task that the TestDriver has to run, set the 'entryPointAddress' preference using '-s' switch in the config, build, run or runremote commands.

To view the possible configuration settings, type 'testdriver config'. This displays the following list of settings with the preferences to show the internal name and the corresponding settings that can be modified while using the TestDriver.

To change the INTERNAL preferences, use the 'testdriver config --import' command.

PreferenceDescriptionCommandsSwitchDefault value

buildmake

If true, runs bldmake command during the build process.

config

--buildmake

true

buildNumber

Retrieved from \epoc32\data\buildinfo.txt

INTERNAL

Not Applicable

0

cert

The certificate file used to sign the SIS file. By default, the TestDriver uses testdriver.cert certification file.

config

--cert

testdriver.cert

clean

If true, runs abld reallyclean command while building the code. Note: This applies only to config command.

config, build

--clean

true

client

Remoting: The name of the client PC.

config, runremote

--cl

localhost

commDB

The CommsDat settings used to setup the emulator to work with WinTAP

config, run

--commdb

false

entryPointAddress

The location where the test has to be started

config, build, rbuild, run, runremote

-s

taskA.taskB.taskC

epocRoot

The path of Symbian epoc32 root directory.

config

-e

.

jobfolder

Remoting: The location to save the jobs data and the results on the remote server.

config

--jobs

c:\Jobs

jobID

Remoting: The unique ID used to identify the remote job.

INTERNAL

Not Applicable

0

kernel

The kernel type of the Symbian device. The default value is computed from the build number version. In case the build number is not found, the default value is EKA2.

config, run

-k

EKA2

key

The key file used to sign SIS files. By default, the TestDriver uses testdriver.key file.

config

--key

testdriver.key

mode

The mode of tracking the progress of remote job. This can be sync or async. Also applies to runremote.

config

-m

sync

platform

The build platform to use.

config, build, rbuild, run and package

-p

armv5

platsec

If true, adheres to Platform Security. This also applies to runremote.

config, build, rbuild and run.

--platsec

true

recovery

Used to enable/disable crash recovery. If ON, crash recovery is enabled.

config, run

--recovery

OFF

rdebug

The COMM port to use with RDebug.

run, runremote

-l

com1

repositoryRoot

The location where to store the repository

config

--repos

.\repository

resultRoot

The directory where the results are stored

config, run and results

-c

.\results

rom

Remoting: The ROM to use in the remote server

config and runremote

-r

Not Applicable

runNumber

A unique ID generated after each run

INTERNAL

Not Applicable

0

server

Remoting: The address to the remote server, that is, //server_name/service/. Also applies to results command.

config, runremote, jobstatus, and cancel.

--srv

//localhost/RemoteTestDriver

server_name

Remoting: The remote server name, specified on the remote PC

config

--server

//localhost

service

Remoting: The remote service name, specified on the remote PC

config, runremote, jobstatus and cancel

--service

RemoteTestDriver

sourceRoot

The location where all the source is located.

config

-c

.

sysbin

Used with STATLite to install to the sys\bin directory.

The --statlite option of TestDriver must be used instead of the --sysbin option from SITKv1.3 onwards, as --sysbin will be deprecated.

config, build, rbuild, run and runremote

--sysbin

false

testExecute

If true installs all the TestExecute Framework dependencies onto the device.

config and runremote

--testexecute

true

testPackage

Remoting: The location of the test package

config, runremote, package, emulatorpackage and installpackage

--tp

.\test.pkg

transport

The transport to be used by STAT to communicate to the board

config, run and runremote

-t

serial1

trgtest

Remoting: The port on the remote server to transfer the ROM with the trgtest tool

config

--port

0

uidFirst

The first UID in the range of UIDs used for a build.

config

--uid

0x10210D02

uidLast

The last UID in the range of UIDs used for a build.

config

--uid

0x10210D32

uccAddress

The UCC address.

run

-f

192.168.0.3

variant

The build variant to use during build and run.

config, build, rbuild, run and runremote

-b

udeb

wintap

Emulator: Used to communicate with the emulator through WinTap

INTERNAL

Not Applicable

192.168.0.3

workingPath

Used in remoting to specify the location to place the ROM and .tpkg files

config and runremote

-I

.

xmlRoot

The root directory and location of TestDriver XML files and driver files.

config and import

-x

.

statlite

Used to specify whether the STAT lite version is used on the device to communicate with TestDriver.

build, config, rbuild, run, runremote

--statlite

OFF

teflite

Used to specify whether the TEF lite version is used.

build, config, rbuild, run, runremote

--teflite

Auto

Remoting indicates that the preferences are set to run the tests remotely.