Services for Multi-Device Testing
The services that allow multi-device testing include standard and
user-defined (new) services. Symbian supplies two standard services to allow
multi-device testing with an automatic slave device configuration.
Standard services
The standard services are syncservice.exe
and
testdriverservice.exe
. For information on the standard services,
refer to the UCC components section.
Configuring the standard services
The following are the two standard services that allow multi-device
testing:
The services have .ini
files to configure their
operation. The .ini
files are located in the same directory as the
service binary.
Synchronisation service
The synchronisation service INI file has the following configurable
options:
-
Connection -Can be serial, IrDA, Bluetooth or
TCP/IP. The format for configuring the option is:
Connection = <serial | ir | bt | tcp>
-
SerialPort -Used if the connection is set to
serial
, ir
or bt
. The format for
configuring the option is:
SerialPort = <COM1 | COM2 … >
-
IPAddress -Used if the connection is set to
TCP/IP. The port number must always be set to 3000, as STAT is hardcoded to use
this port number. The format for configuring the option is:
IPAddress = <ip address>:<port number>
-
Poll -Sets the poll interval between attempts to
retrieve the synchronised test case status. The default value is 10 seconds.
The format for configuring the option is:
Poll = <poll interval in seconds>
-
Timeout -Sets the timeout for polling to retrieve
the synchronised test case status. The default value is 120 seconds. The format
for configuring the option is:
Timeout = <a timeout in seconds>
-
STAT -Location of the STAT DLL. The default folder
is \epoc32\tools\stat\stat.dll
. The format for configuring the
option is:
STAT = <full path and filename of the STAT dll>
An example of the options, which must be contained in
SyncService
section is shown below:
[SyncService]
Connection=tcp
IPAddress=169.254.159.234:3000
Timeout=60
Poll=2
TestDriver service
The TestDriver service INI file has the following configurable
options:
-
Port -Used when calling TestDriver for the
loopback TCP/IP connection for notifications. This defaults to port 3002. The
format for configuring the option is:
Port = <TCP port number>
-
Exe -Location of the testdriver.exe
file. This defaults to Drive:\testdriver\bin\TestDriver.exe
. The
format for configuring the option is:
Exe = <full path and filename of the TestDriver exe file>
-
Poll -Sets the poll interval between checks to the
TestDriver execution status. The default value is 5 seconds. The format for
configuring the option is:
Poll = <poll interval in seconds>
An example of the options, which must be contained in
TestDriverService
section is shown below:
[TestDriverService]
Port=3002
Exe=d:\testdriver\bin\testdriver.exe
Poll=5