Connection Proxy

The connection proxy establishes a connection to a Sony Ericsson mobile phone and opens one or more TCP/IP sockets. The connection proxy serves as a bridge between the mobile phone and the SDK's debug tools that run on the PC. The connection proxy can be used to connect the phone to a PC using USB, Bluetooth or a serial COM port. From JP-8, TCP/IP ports are used instead of COM ports.

SYNOPSIS

connectionproxy [ flags ]

DESCRIPTION

When the connectionproxy command is executed, a window is opened to indicate that the proxy is running. The connection proxy will attempt to open a connection to the phone. If successful, the state will be changed to "connected". Click on the "Disconnect" button to close the connection to the phone. Click on the "Connect" button to establish a new connection to the mobile phone.

For handsets up to JP-7:

COM ports are used for communications between the handset and connection proxy. The COM port and baud rate that is used by the connection proxy can be set by clicking on "Settings" (the cog wheel). Other serial port settings are located in the properties file as described below.

For handsets from JP-8:

TCP/IP ports are used for communications between the handset and connection proxy. An interface and device name should be chosen instead of a COM port in connection proxy's Settings dialog. For USB, the interface name begins with Sony Ericsson Device xx USB. If several handsets are connected with USB, the different handsets are distinguished by the #nr at the end. For Bluetooth, a typical interface name will contain the word "Bluetooth. A few settings on the handset are required before it is ready to be used with connection proxy:

- Java Developer mode must be set to "On". The Java Developer mode menu can be found under the Service menu. To get to the Service menu, press: [joystick right] [star] [joystick left] [joystick left] [star] [joystick left] [star].

- If a USB cable is used, the USB network type must be set to "Via computer". To set USB network type, go to "Settings" -> "Connectivity" -> "USB" -> "USB network" -> "USB network type".

Other settings are located in the properties file as described below.
 

NOTE:If it is not already started, the proxy will be automatically launched when it is needed by the SDK debug tools. For example, the command line tool and the device explorer will launch the proxy.

FLAGS

-nonslip

For debug purposes only. Support for this flag may be removed in future releases of the SDK. This flag directs the connection proxy to display in a separate window all text and data on the COM port that is not recognized by the SLIP layer.

PROPERTIES

The proxy recognizes the following entries in the properties file ([SDK HOME]\lib\sdkme.properties):

comm: COM1

Specifies the serial communications port to be used. For example, COM1.
NOTE: This property is ignored if the COM port is set using the settings dialog.

baud: 115200

Specifies the baud rate. For example, 115200, 57600, 9600, etc.
NOTE: This property is ignored if the baud rate is set using the settings dialog.

flowcontrol.in:

Specifies the setting for input flow control. For example, None, Xon/Xoff, or RTS/CTS.

flowcontrol.out: None

Specifies the setting for output flow control. For example, None, Xon/Xoff, or RTS/CTS.

parity; None

Specifies the setting for parity. For example, None, Even, Odd.

databits: 8

Specifies the number of data bits. For example, 8, 7, 6 or 5.

stopbits: 1

Specifies the number of stop bits. For example, 1, 1.5 or 2.

jdm.start: AT*SESSTCP

Specifies the AT command that is used to place the handset into SSTCP mode. The default value for this property is AT*SESSTCP.

segment.size: 256

Specifies data segment size: For example, 64, 128, 256, 512, 1024, 2048 or 4096.

serialproxy.disable_cable_pull_listener: false

Setting this property to true will disable the cable pull listener. This can be useful if the proxy is not able to maintain a connection with the phone.

timeout.readatcmd: 500

Specifies the time in milliseconds to wait for the phone to respond to the AT command. Setting this property to 0 will disable the time out.

ping.time.sstcp: 10000

The proxy periodically checks if the phone is connected to the PC (a "ping"). This property specifies the ping interval in milliseconds. Setting this property to 0 will disable the periodic check. Valid for handsets up to JP-7.

ping.time: 2000

The proxy periodically checks if the phone is connected to the PC (a "ping"). This property specifies the ping interval in milliseconds. Setting this property to 0 will disable the periodic check. Valid for handsets from JP-8.

timeout.ping: 10000

Specifies the time in milliseconds to wait for a "ping" response from the phone. Valid for handsets from JP-8.

timeout.proxy: 4000

Specifies the time in milliseconds to wait for a response from the phone. Setting this property to 0 will disable the time out.

port.sstcpmap.tcpip.XXX: YYY

This type of property maps a TCP/IP port on the PC (port number XXX) to a handset connection (port number YYY). The handset port numbers are pre-defined by the handset and do not correspond to port numbers on the PC. There is one entry for each type of connection that is mapped to the handset. Valid for handsets up to JP-7.

WARNING: Use caution when modifying this type of property.

port.sstcpmap.kdwp.XXX: YYY

Similar to the TCP/IP port map described above, this mapping is a special case for KDWP connections. Valid for handsets up to JP-7.

WARNING: Use caution when modifying this type of property.

port.tcpipmap.tcpip.XXX: YYY

This type of property maps a TCP/IP port on the PC (port number XXX) to a handset connection (port number YYY). The handset port numbers are pre-defined by the handset and do not correspond to port numbers on the PC. There is one entry for each type of connection that is mapped to the handset. Valid for handsets from JP-8.

WARNING: Use caution when modifying this type of property.

port.tcpipmap.kdwp.XXX: YYY

Similar to the TCP/IP port map described above, this mapping is a special case for KDWP connections. Valid for handsets from JP-8.

WARNING: Use caution when modifying this type of property.

port.instancecontrol: 6079

Identifies the TCP/IP port that is used to limit the proxy to starting a single instance of itself.

logfile.proxy: logs/connectionproxy.log

Name and relative location of the proxy's log file.

logs.proxy: 3

The number of log files to maintain.