EcmtAgent

The EcmtAgent is a mobile application for Symbian devices that listens for incoming connections on the device. You can use the EcmtAgent for establishing a connection between a Symbian device and a computer for application testing purposes. You can use the EcmtAgent over Bluetooth, USB, or WLAN. In order to receive data from the EcmtAgent, the computer must be running the Device Connectivity Tool.

The EcmtAgent is included in Symbian SDKs for Nokia devices.

Note: On S60 3rd Edition FP2 and S60 5th Edition devices, the EcmtAgent modifies the device's Java Runtime settings every time it is launched. You cannot launch MIDlets normally on the device while the settings remain modified. To reset the Java Runtime settings, select Options > WLAN Java ODD > Disable Debug in the EcmtAgent and close the EcmtAgent.

To install and use the EcmtAgent:

  1. Install the EcmtAgent.sis file onto the device. You can find the file in the following folder on the computer:

    <SDK installation folder>\<tools folder>\Ecmt\

    Note: In S60 3rd Edition FP1 and earlier SDKs, the file is called EcmtAgent_MIDP.sis.

  2. On the device, launch the EcmtAgent and select the appropriate connection type from Options > Settings > Bearer.

    Note: If you are using a WLAN connection and have problems establishing it, switch to a non-secure WLAN network if possible. If you receive the error message Engine error -18 when trying to establish a WLAN connection, there are problems with the connection that you must resolve before continuing.

    Figure: EcmtAgent connected over Bluetooth

  3. If you are using a WLAN connection, specify the IP address and port of the computer if required. To determine the IP address of the computer, open the command console and run the ipconfig command. You can freely choose the port number, but it is limited to four digits. To see which ports are currently in use on the computer, open the command console and run the netstat -a command. Do not use the listed ports.

  4. Verify the installation by launching the Device Connectivity Tool and using it to establish a connection to the device. The EcmtAgent displays a timestamp followed by the text "Connected" when a successful connection has been established.

    Tip: If you are using a WLAN connection, you can first try pinging the IP address of the device by opening the command console and running the ping <device IP address> command. To determine the IP address of the device, find the corresponding item in the Options menu of the EcmtAgent.