# HG changeset patch # User fturovic # Date 1271104480 18000 # Node ID 06cdb02ae45064d3a63933dbc699f3fcfe6cf4cf # Parent 35847a7cd071ada24f07895d2e3c885af3b7850f implemented initial new connection dialog changes diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/images/tab_new_conn_install_agent.png Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/tab_new_conn_install_agent.png has changed diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/images/tab_new_conn_setup_conn.png Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/tab_new_conn_setup_conn.png has changed diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/images/tab_new_conn_test_conn.png Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/tab_new_conn_test_conn.png has changed diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_install_tab.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_install_tab.htm Mon Apr 12 14:10:48 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_install_tab.htm Mon Apr 12 15:34:40 2010 -0500 @@ -10,9 +10,9 @@ -

Install Remote Agents pane

-

Use the Install remote agents pane to select the latest remote agent version to download and install to the device.

-

+

Install Remote Agents

+

Use the Install Remote Agents pane to select the latest remote agent version to download and install to the device.

+

Figure 2 - New Connection wizard Install remote agents page

Table 1. Install Remote Agents pane

@@ -22,7 +22,7 @@ - @@ -40,8 +40,10 @@
Related references
- + diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_connection_wizard.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_connection_wizard.htm Mon Apr 12 14:10:48 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_connection_wizard.htm Mon Apr 12 15:34:40 2010 -0500 @@ -1,128 +1,61 @@ - - - - - - -New Connection Wizard - - - - -

New Connection Wizard

-

Use the Remote Connections view to monitor, create, edit, or remove common remote connection settings.

- -

Edit connection name and type

-

Use the Edit connection name and type page to assign a name and connection type to the new connection setup.

-

-

Figure 1 - New Connection wizard Edit connection name and type page

-

Table 1. Edit connection name and type page - options

-
Install remote agents

A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 5.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 3.1.2.

+

A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 5.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 3.2.6.

Additional information about the selected entry is displayed to the right to help you choose the correct version of TRK for the target device.

- - - - - - - - - - - - - - - - -
ItemExplanation
Connection Name

Enter a name for the connection.

Connection TypeSelect the type of connection this setup will use.
Supported Services

Shows a list of services supported by the connection type chosen.

-
    -
  • Bluetooth - serial port connection through Bluetooth
    • -
  • Serial - serial port connection through a COM serial port
    • -
  • USB - serial port connection through USB that supports TRK 3.x
    • -
-

Set Connection Settings pane

-

Use the Set Connection Settings pane to compare the version of remote agent installed on the device with the latest version available for Carbide. In this pane you can:

- -

-

Figure 2 - New Connection wizard Serial Connection Settings page

-

Table 2. Serial Connection Setting page - Set Connection Settings tab

- - - - - - - - - - - - - - - - - - - - - - - - - -
ItemExplanation
Serial Port A dropdown list of serial ports with known identifiers for selecting the communication port used by the PC to communicate with the device. A named COM port (COM4 - BthModem0) indicates an active port. Unnamed port numbers have usually not been opened and assigned by the PC.
Baud Ratea dropdown list of baud rates common to serial connections.
Device OS

A dropdown list of device OSes that are supported by the remote agent software. Select the OS used by the device before running a check.

Select a service to testClick to select a listed service for testing.
Test Service Status

Click Test Service Status to query the remote agent software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear should the Test Service Status version operation requires more than a few seconds.

-

NOTE The PC must have an internet connection to perform a remote agent version check.

-

Once the comparison is complete the Status text is updated with the result and further instructions as required.

-

-

If a connection fails, the errors normally fall into these two categories:

-
    -
  • connection failure - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (COM4 - BthModem0) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response.
    • -
  • remote agent not responding - this indicates that the COM port is open but the remote agent is not responding. First, verify that remote agent is up and running on the device. Second, the remote agent may be listening on a different COM port, so choose another named COM port and try again.
    • -
-

 

-

Install Remote Agents pane

-

Use the Install Remote Agents pane to select the latest remote agent version to download and install to the device.

-

-

Figure 2 - New Connection wizard Bluetooth Settings page

-

Table 3. Serial Connection Setting page - Install Remote Agents tab

- - - - - - - - - - - - - - - - - -
ItemExplanation
Install remote agents

A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 3.1.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 2.8.7.

-

Additional information about the selected entry is displayed to the right to help you choose the correct version of TRK for the target device.

-

NOTE Requires a network connection to query the remote agent site.

SaveClick Save to store a local copy of the currently selected TRK to disk. You can then manually install the file to your devices using the method of your choice.
Install

Click Install to download and install the TRK selected in the Install latest TRK list. A progress bar is shown if the install operation requires more than a few seconds to complete.

-

NOTE The SIS and SISX file types must be associated with an installer application like Nokia PC Suite in order to install them onto the device. Use the Save command above to perform a manual install to the device if you don't have an installer application.

-
Related references
- - - - - + + + + + + +Setup Connection + + + + +

Setup Connection

+

Use the Edit Connection page to assign a connection type, name, and connection settings to the new connection setup.

+

+

Figure 1 - New Connection wizard Setup Connection tab

+

Table 1. Setup Connection page - options

+ + + + + + + + + + + + + + + + + +
ItemExplanation
Connection Type

Select the type of connection and its supported services from the drop down list of options. The types of connections include:

+
    +
  • Bluetooth - serial port connection through Bluetooth
    • +
  • Serial - serial port connection through a COM serial port
    • +
  • USB - serial port connection through USB that supports TRK 3.x
    • +
+

And the supported services may include:

+
    +
  • TRK
    • +
  • Tracing
    • +
  • and others
    • +
Connection Name

Enter a name for the connection.

Connection Settings

Shows a list of services supported by the connection type chosen.

+
    +
  • Bluetooth - serial port connection through Bluetooth
    • +
  • Serial - serial port connection through a COM serial port
    • +
  • USB - serial port connection through USB that supports TRK 3.x
    • +
+
Related references
+ + + + + diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_on_device_check_tab.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_on_device_check_tab.htm Mon Apr 12 14:10:48 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_on_device_check_tab.htm Mon Apr 12 15:34:40 2010 -0500 @@ -1,70 +1,58 @@ - - - - - - -Initiate Service Testing - - - - - -

Initiate Service Testing

-

Use the Set Connection Settings pane to compare the version of remote service installed on the device with the latest version available for Carbide. A remote service is any software on the device that can communicate with Carbide. This includes TRK, Performance Investigator, and other services. In this pane you can:

- -

Options presented may differ based on the connection setting type chosen.

-

-

Figure 1 - Set Connection Settings pane in the New Connection dialog

-
Table 1 Set Connection Settings pane — items
- - - - - - - - - - - - - - - - - - - - - -
ItemExplanation
Device OS

A dropdown list of device OSes that are supported by the TRK debug agent software. Select the OS used by the device before running a check.

Serial Port A dropdown list of serial ports with known identifiers for selecting the communication port used by the PC to communicate with the device. A named COM port (COM4 - BthModem0) indicates an active port. Unnamed port numbers have usually not been opened and assigned by the PC.
Select a service to testSelect the remote service type to query on the remote device.
Initiate service testing

Click Initiate service testing to query the remote software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear when the operation requires more than a few seconds.

-

NOTE The PC must have an internet connection to perform a remote service version check.

-

Once the comparison is complete the Status text is updated with the result and further instructions as required.

-

-

If a connection fails, the errors normally fall into these two categories:

-
    -
  • connection failure - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (COM4 - BthModem0) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response.
    • -
  • Service not responding - this indicates that the COM port is open but the remote service is not responding. First, verify that remote service is up and running on the device. Second, the remote service may be listening on a different COM port, so choose another named COM port and try again.
    • -
-
-
Related references
- - - - + + + + + + +Test Connection + + + + +

Test Connection

+

Use the Set Connection Settings pane to compare the version of remote service installed on the device with the latest version available for Carbide. A remote service is any software on the device that can communicate with Carbide. This includes TRK, Trace, Performance Investigator, and other services. In this pane you can:

+ +

Options presented may differ based on the type of connection setting chosen.

+

+

Figure 1 - Test Connection pane in the New Connection dialog

+
Table 1 Test Connection pane — items
+ + + + + + + + + + + + + + + + + +
ItemExplanation
Device OS

A dropdown list of device OSes that are supported by the TRK debug agent software. Select the OS used by the device before running a check.

Select a service to testSelect the remote service type to query on the remote device.
Initiate service testing

Click Initiate service testing to query the remote software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear when the operation requires more than a few seconds.

+

NOTE The PC must have an internet connection to perform a remote service version check.

+

Once the comparison is complete the Status text is updated with the result and further instructions as required.

+

+

If a connection fails, the errors normally fall into these two categories:

+
    +
  • connection failure - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (COM4 - BthModem0) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response.
    • +
  • Service not responding - this indicates that the COM port is open but the remote service is not responding. First, verify that remote service is up and running on the device. Second, the remote service may be listening on a different COM port, so choose another named COM port and try again.
    • +
+
Related references
+ + + + diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_on_device_setup.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_on_device_setup.htm Mon Apr 12 14:10:48 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_on_device_setup.htm Mon Apr 12 15:34:40 2010 -0500 @@ -1,28 +1,31 @@ - - - - - - -On-Device Connections - - - - -

On-Device Connections

-

Use the New Connection wizard to verify and update Carbide software services on a device. Click the Help > On-Device Connections... menu option to open. Currently, the only service available is TRK, but look for others in future releases. The following tabs are present:

- -

-

Figure 1 - New Connection dialog

-
Related references
- - - - + + + + + + +On-Device Connections + + + + +

On-Device Connections

+

Use the New Connection wizard to verify and update Carbide software services on a device. Click the Help > On-Device Connections... menu option to open. Current services available include TRK, Tracing, and others. The following tabs are present:

+ +

+

Figure 1 - New Connection dialog

+
Related references
+ + + + diff -r 35847a7cd071 -r 06cdb02ae450 core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml --- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Mon Apr 12 14:10:48 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Mon Apr 12 15:34:40 2010 -0500 @@ -240,9 +240,11 @@ - + + + + -