IP-based Plug-in

The IP-based plug-in is an alternative to the STAT plug-in and is used to communicate between a Microsoft Windows PC and a Symbian OS device. It enables TestDriver to communicate with a Symbian OS device over an IP-based network.

The plug-in enables TestDriver to perform the following operations:

  • Run commands on a Symbian OS device,

  • Transfer files to or from a Symbian OS device,

  • Install or uninstall SIS files on a Symbian OS device.

These activities are remotely controlled on the device from a PC using the IP-based protocols, such as FTP or TELNET. To communicate with the emulator, WinTAP or a similar loopback system is required. For more information on WinTAP, refer to Setting up WinTAP.

You can set up an IP-based link between a Symbian OS device and a remote PC through a serial cable using Remote Access Service (NT RAS), or an USB cable using Remote Network Driver Interface Specification (RNDIS). If you are using an USB connection, you must include the RNDIS drivers in the ROM image. For example, the following BUILDROM commands create ROM images for Symbian OS v9.4 and v9.5 with the RNDIS driver:

For Symbian OS v9.4 and earlier versions

> buildrom -D_EABI=ARMV5 -DRVCT -D_CUSTOM_COMMSDAT h4hrp techview rndis.iby

For Symbian OS v9.5

> buildrom -D_EABI=ARMV5 -DRVCT -D_CUSTOM_COMMSDAT h4hrp techview rndis_9.5.iby

After creating the ROM image, use it to start the Symbian OS device. By default, TestDriver uses the STAT plug-in to communicate with the device. To use the IP-based plug-in instead of the STAT plug-in, run the following command:

> testdriver config --commplugin com.symbian.driver.plugins.comms.ftptelnet

Configuring the IP-based plug-in

The IP-based plug-in is configured to use the default ports, 21 and 23 for FTP and Telnet respectively. You can change the port numbers using the following command by replacing the information within angular brackets:

> testdriver config --plugin com.symbian.driver.plugins.comms.ftptelnet:ftpport|telnetport=<value>

For more information, refer to FTPTelnet plug-in reference.