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:

  • Synchronising services: Used for synchronising test cases.

  • TestDriver services: Used for configuring the slave device.

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