Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Using TCP/IP

TestDriver allows you to use a TCP connection over a serial port. To do this you need to install and configure the NTRAS. For instructions on installing NTRAS, see Setting up NTRAS.

The diagram below shows how to connect a null modem cable when using TCP/IP as the transport mode.

Connection using TCP/IP.

Connection using TCP/IP.

Use Comm:0, the default port where NTRAS is installed on the device.

The PC serial port that is used can be modified, however, should always match the port to which NTRAS has been configured.


Setting up NTRAS

Remote Access Service (NT RAS) is available on the Windows NT and Windows 2000 operating systems. This setup requires the PC to have two COM ports that are connected through a null-modem cable. The Symbian OS emulator talks to one of the COM ports and the NT RAS service talks to the other.

Using NTRAS involves the following steps:

[Top]


Installing a null modem

Complete the following steps to install a null modem:

  1. Open the Control Panel.

  2. Open Phone and Modem Options.

Complete the following modem settings:

  1. Select Modems tab.

  2. Select Add.

  3. Check 'Don't detect my modem; I will select it from a list' box.

  4. Click Next.

  5. Select (Standard Modem Types) - Communications cable between two computers.

  6. Select the appropriate com port.

  7. Click Finish.

Set the following properties to the modem you have installed.

[Top]


Configuring NTRAS

Complete the following steps to configure the NTRAS:

  1. Open the Control Panel.

  2. Open Networking and Dial-up Connections.

  3. Open Make New Connection.

  4. Click Next.

  5. Select Accept incomming connections and click Next.

  6. Check the modem you have just installed and click Next.

  7. Select Do not allow virtual private connections and click Next.

Complete the following steps to add a new user:

  1. Click Add.

  2. Enter the valid username and password.

  3. Click OK. Make sure that the new user is checked.

  4. Click Next.

Continue with these steps to configure the NTRAS:

  1. Setup the Networking Components.

  2. Click Next.

  3. Enter a name for the connection.

  4. Click Finish.

  5. Open the Properties of the connection you have just set.

  6. Go to Users tab. Make sure that "Always allow directly......... a password" check box is unchecked.

  7. Click OK.

[Top]


Starting NTRAS

Complete the following steps to start the Remote Access Services (RAS):

  1. Open the Control Panel.

  2. Open Administrative Tools.

  3. Open Services.

  4. Ensure that the following services are started and the startup type is set to automatic.

    • Remote Access Connection Manager.

    • Remote Access Auto Connection Manager.

  5. Close the services window.

[Top]


Setting up TCP/IP connection

The following procedure needs to be followed when using a TCP/IP connection.

[Top]


Device side

Modify the \epoc32\data\Z\System\data\stat.ini file as shown in the example below. Note that NTRAS should be left on comm:0 on the device.

[SectionOne]
comport= 0     
[SectionTwo]
transport= tcpip
[SectionThree]
logging= 0
debugport=3

Currently the com port setting in SectionOne is ignored, and commdb is used.

[Top]


PC side

  1. Install NTRAS on COM2 of the PC.

  2. Start the Remote Access Service.

Get the IP address that is assigned to the device from the static address pool that is set in the Control Panel. The address to be used is the next value that is specified in the "Begin" field.

When a PPP connection is established, it will show up in the windows tool remote access admin. If you are unable to make a connection, you may need to edit the Comms database to remove all modems, except the null modem on comm:0. This change should enable the communication.

[Top]


Example

The command line option for running a test over a TCP/IP connection is:

> Testdriver run -p arm4 -b urel -s root.syncmlclient.rtest -t tcp  --ip 10.1.0.2 

NOTE: If the -t option is not specified, the transport defaults to serial2 i.e. com port 2.

[Top]


CommDB

The CommDB (Communication Database) provides a storage mechanism for communications and networking related data.

[Top]


See also