Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_remote_connections.png has changed
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/exporting_remote_conns.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/exporting_remote_conns.htm Thu Sep 30 13:53:55 2010 -0500
@@ -30,7 +30,7 @@
<h5>Related references</h5>
<ul>
<li><a href="wnd_on_device_setup.htm">On-Device Connections</a></li>
- <li><a href="wnd_new_conn_install_tab.htm">Install latest TRK</a> </li>
+ <li><a href="wnd_new_conn_install_tab.htm">Install latest CODA</a> </li>
</ul>
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
</body>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/view_remote_connection.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/view_remote_connection.htm Thu Sep 30 13:53:55 2010 -0500
@@ -32,7 +32,7 @@
<li>Status - current connection status, i.e. Available, Not Accessible, Ready, etc.</li>
<li>Description - provides information on the current connection test status.</li>
</ul>
-<p align="center"><img src="../images/view_remote_connections.png" width="588" height="177"></p>
+<p align="center"><img src="../images/view_remote_connections.png" width="679" height="166"></p>
<p class="figure">Figure 1 - Remote Connections view</p>
<p>When the view is closed or another perspective opened, a small display appears in the trim area in the lower-right corner of the workspace showing the current active remote connection. Click the connection name to open the drop-down menu where you can open the Remote Connections view or switch between connections.</p>
<p align="center"><img src="../images/trim_remote_conns.png" width="212" height="44"></p>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_install_tab.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_install_tab.htm Thu Sep 30 13:53:55 2010 -0500
@@ -11,7 +11,7 @@
</head>
<body >
<h2>Install Remote Agents</h2>
-<p>Use the <strong>Install remote agents</strong> pane to select the latest remote agent version to download and install to the device. </p>
+<p>Use the <strong>Install Remote Agents</strong> pane to select the latest remote agent version to download and install to the device. </p>
<p align="center"><img src="../images/tab_new_conn_install_agent.png" width="525" height="576"></p>
<p class="figure">Figure 2 - New Connection wizard Install remote agents page</p>
<p>Table 1. Install Remote Agents pane</p>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_07.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_07.htm Thu Sep 30 13:53:55 2010 -0500
@@ -18,58 +18,29 @@
<li><a href="run_mode_debug_04.htm">Setup a virtual drive for Techview and Cust Kits</a></li>
<li><a href="run_mode_debug_05.htm">Set the default kit in Devices.xml </a></li>
<li><a href="run_mode_debug_06.htm">Install the SISX file on the target device</a></li>
- <li><b>Configure TRK connection on the device</b></li>
+ <li><b>Configure CODA connection on the device</b></li>
<li><a href="run_mode_debug_08.htm">Create a launch configuration</a></li>
</ol>
<div class="step">
<h4><a name="runConfig" id="runConfig"> </a>Configure CODA Connection on the Device</h4>
-<h5>Connecting with Bluetooth</h5>
- <ol>
- <li>On the device make sure the Bluetooth port is turned on</li>
- <li>On the phone launch CODA.</li>
- <p>The location of CODA (Carbide On-device Debug Agent) will vary based on the phone. On some phones it will be in the Installed folder, on others it may be in the My Own folder.</p>
- <li>CODA will ask which host you want to pair with. When requested, select your computer from the available Bluetooth devices list.</li>
- <li>After the host and phone are paired, CODA should be connected. Verify that CODA is running.</li>
- <li>On the PC:
- <ol type="a">
- <li>Right click on the Bluetooth icon in the System tray and select Advanced Configuration</li>
- <li>Click the Local Services tab</li>
- <li>Write down the Bluetooth COM Port number from the Local Services tab (Figure 1).</li>
- <p>The Port number will be used when configuring the CODA launch configuration. The Bluetooth COM Port number in the Local Services tab should match the COM port used in the Connections tab of the CODA launch configuration.</p>
- <li>Click OK to close the Bluetooth Configuration window</li>
- <p align="center"><img src="images/Bluetooth_localservices.png" width="460" height="437" /></p>
- <p class="figure">Figure 1. Bluetooth Configuration windows Local Services panel</p>
- </ol>
- </li>
- </ol>
-<h5>Connecting with PC Suite</h5>
+<h5>Connecting with Nokia Ovi/PC Suite</h5>
<ol>
+ <li>Verify Nokia Ovi/PC Suite are installed on the PC (drivers are required by Carbide)</li>
<li>Connect the USB cable to the PC and then to the target device</li>
- <li>On the device select PC suite from the USB mode list</li>
- <li>Launch the CODA agent</li>
- <p>The location of the CODA on-device debug agent will vary based on the phone. On some phones it will be in the Installed folder, on others it may be in My Own folder.</p>
- <li>Halt the Bluetooth device search by pressing Cancel</li>
+ <li>On the device select PC Suite from the USB mode list</li>
+ <li>On the device launch the CODA agent</li>
+ <p>The location of the CODA on-device debug agent will vary based on the phone. On some phones it will be in the <span class="code">Installed</span>, <span class="code">Applications</span>, or <span class="code">My Own</span> folder.</p>
<li>Click Options > Settings > Connection</li>
- <li>Change Connection type to USB and set connection options (Figure 2) </li>
+ <li>Change Connection type to USB and set connection options</li>
+ <p align="left"><img src="../trk/images/coda_options.png" alt="CODA options" width="180" height="165"></p>
<li>Select Back and start the CODA software again and you should be connected</li>
- <p align="center"><img src="images/TRK_USB_settings.png" width="211" height="250" /></p>
- <p class="figure">Figure 2. USB Connection Settings</p>
- <li>On the PC</li>
- <ol type="a">
- <li>Open Windows Computer Management by right-clicking My Computer and select Manage from the context menu to open the Computer Management window.</li>
- <li>Select System Tools > Device Manager > Ports (COM & LPT) to display all active ports</li>
- <li>Locate the S60 Phone USB (COMxx) item in the list</li>
-
- <p align="center"><img src="images/comp_manage_ports.png" width="507" height="546" /> </p>
- <p class="figure">Figure 3. Device Manager - Ports</p>
-
- <li>Write down the port ID and Communication Port Properties.</li>
- <p>The COM Port number in the Device Manager window should match the COM port used in the Connections tab of the CODA launch configuration.</p>
- <li>Close the Device Manager window </li>
+ <li>On the PC verify connection in Remote Connections view<br />
+ <p><img src="../../reference/images/view_remote_connections.png" alt="Remote Connections view" width="679" height="166"></p>
+ </li>
</ol>
- </ol>
- </div>
+ <p>With the remote device connected you are ready to start debugging.</p>
+</div>
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
</body>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_08.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_08.htm Thu Sep 30 13:53:55 2010 -0500
@@ -18,7 +18,7 @@
<li><a href="run_mode_debug_04.htm">Setup a virtual drive for Techview and Cust Kits</a></li>
<li><a href="run_mode_debug_05.htm">Set the default kit in Devices.xml </a></li>
<li><a href="run_mode_debug_06.htm">Install the SISX file on the target device</a></li>
- <li><a href="run_mode_debug_07.htm">Configure TRK connection on the device</a></li>
+ <li><a href="run_mode_debug_07.htm">Configure CODA connection on the device</a></li>
<li><b>Create a launch configuration</b></li>
</ol>
<div class="step">
@@ -30,8 +30,8 @@
<li>The <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears</li>
<p>To communicate between the Carbide.c++ debugger and the on-device debug agent or protocol interface you must define a debug launch configuration. The Debug window is where you define the type of debug launch configuration to use when debugging programs on the target device (Figure 4).</p>
<p><img src="images/Debug_Config_main.png" width="986" height="640" /></p>
- <p class="figure">Figure 4. Debug Window</p>
- <li>Select either a Symbian OS Device (Install SIS) or Symbian OS Device configuration type for on-device debugging and click New</li>
+ <p class="figure">Figure 4. Debug window</p>
+ <li>Select either a Symbian Device (Install SIS) or Symbian Device configuration type for on-device debugging and click New</li>
<p>For debug launch configurations using the CODA debug agent, the following pages require review and possible option settings:</p>
<ul>
<li><b>Main</b> - defines the project to be launched on the target device</li>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/attach_to_process.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/attach_to_process.htm Thu Sep 30 13:53:55 2010 -0500
@@ -25,8 +25,8 @@
<p class="note"><b>NOTE</b> The executable must include symbolics in order for debugging to work.</p>
</li>
<li>Click Debug (<img src="../../projects/images/icon_debug.png" alt="Debug icon" width="17" height="17" align="absmiddle">) to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Configuration Launch Wizard</a>.</li>
- <p>Select the Symbian OS Attach to Process launch configuration option and fill in the requested information.</p>
- <p align="center"><img src="../projects/images/attach_to_process_launch_config.png" alt="Attach to Process launch config" width="641" height="312"></p>
+ <p>Select the Symbian Device (Attach to Process) launch configuration option and fill in the requested information.</p>
+ <p align="center"><img src="../projects/images/attach_to_process_launch_config.png" alt="Attach to Process launch config" width="528" height="301"></p>
<p class="figure">Figure 2 -<b> Attach to Process</b> launch configuration</p>
<li>Click Debug.</li>
<p>The <b>Attach to Process </b>dialog appears. Click a column title to sort the processes in ascending or descending order to help you locate a specific process or use the filter text box to show specific processes. </p>
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/attach_to_process_launch_config.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/coda_options.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/coda_running.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/trk_device_manager.gif has changed
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_usb.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_usb.htm Thu Sep 30 13:53:55 2010 -0500
@@ -30,7 +30,7 @@
<p>The final step is to install the SISX program on the target device. </p>
<ol type="a">
<li>Locate and launch the SISX file to install </li>
- <li>Follow the instructions on the screen to finish installing the TRK debug agent</li>
+ <li>Follow the instructions on the screen to finish installing the CODA debug agent</li>
</ol>
</ol>
</div>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm Thu Sep 30 13:53:55 2010 -0500
@@ -9,23 +9,23 @@
</head>
<body >
<h2>Preconditions to On-Device Debugging</h2>
-<p>Before you can use on-device debugging to debug 3rd and 5th edition devices, the following preconditions must be met.</p>
+<p>Before you can use on-device debugging to debug 5th edition devices, the following preconditions must be met.</p>
<div class="step">
<h4>Verifying On-device Debugging Preconditions </h4>
<ol>
<li>Verify that your system has the following:
<ul>
<li>A current Symbian OS SDK is installed</li>
- <li>Perl installed</li>
+ <li>Perl is installed</li>
<li>RVCT or GCCE compiler</li>
- <li>USB or Bluetooth support on your PC </li>
+ <li>USB support on your PC </li>
<li>Nokia Ovi/PC Suite (or equivilent software) for connecting and installing applications to the device </li>
</ul>
</li>
<li>Download and install the current CODA SISX file using the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a> dialog</li>
<p>If CODA is not install, use the <a href="../../projects/launch/wiz_new_launch_config.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p>
<li>Specify the communication method with the on-target device during the debug session</li>
- <p>Start CODA on the device. During startup of CODA on the device you must specify the communication method the on-device agent uses to debug the device. Currently, those methods include <a href="trk_connection_bluetooth.htm">Bluetooth</a> and <a href="trk_connection_usb.htm">USB</a> or a null serial cable. For Bluetooth, you must pair the device with the PC and a valid serial port assigned. For USB, A USB cable must connect the PC to the device and a valid serial port assigned. Use <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a> dialog to make the identification and connection setup quick and easy. </p>
+ <p>Start CODA on the device. During startup of CODA on the device you must specify the communication method the on-device agent uses to debug the device. Currently, those methods include <a href="trk_connection_usb.htm">USB</a> or a null serial cable. For USB, A USB cable must connect the PC to the device and a valid serial port assigned. Use <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a> dialog to make the identification and connection setup quick and easy. </p>
</ol>
</div>
<h5>Related concepts</h5>
@@ -36,12 +36,10 @@
</ul>
<h5>Related reference</h5>
<ul>
- <li><a href="trk_start_sisx.htm">Starting the On-Device TRK Debug Agent</a></li>
+ <li><a href="trk_start_sisx.htm">Starting the On-Device CODA Software</a></li>
</ul>
<h5>Related tasks</h5>
-<ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
- <li><a href="trk_install_usb.htm">Installing On-device Debug Agents using USB </a></li>
+<ul><li><a href="trk_install_usb.htm">Installing On-device Debug Agents using USB </a></li>
</ul>
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm Thu Sep 30 13:53:55 2010 -0500
@@ -4,28 +4,29 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Starting the On-Device CODA Software</title>
+<title>Starting the CODA Software</title>
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
</head>
<body >
-<h2>Starting the On-Device CODA Software</h2>
+<h2>Starting the CODA Software</h2>
<div class="step">
- <p>The location of the CODA software varies based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
+ <p>The location of the CODA (Carbide On-device Debug Agent) software varies based on the phone. On some phones it will be the <span class="code">Installed</span>, <span class="code">Applications</span>, or the <span class="code">My Own</span> folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
<ol>
+ <li>Make sure CODA (Carbide On-device Debug Agent) is present on the device<br />
+ <p>To install CODA see <a href="../../reference/trk/wnd_new_conn_install_tab.htm">Install Remote Agents</a> tab in the <b>New Connections</b> dialog.</p>
+ </li>
<li>Launch the CODA program on the device</li>
- <li>When requested, select your computer from the available Bluetooth devices list</li>
- <p align="center"><img src="images/trk_bt_device_search_dialog.png" width="211" height="250" /></p>
- <p class="figure">Figure 1. Example device list on a S60 3rd Edition or UIQ device</p>
- <li>Verify the Bluetooth connection is working
-(Figure 2)
- <p align="center"><img src="images/trk_bt_connected.png" width="211" height="250" /></p>
- <p class="figure">Figure 2. COM port verification in TRK on a device</p>
+ <li>Verify the connection is working on the device and within Carbide
+ <p align="center"><img src="images/coda_running.png" alt="CODA status" width="216" height="384"> <img src="../../reference/images/view_remote_connections.png" alt="Remote Connections view" width="679" height="166"></p>
+ <p class="figure">Figure 1. Connection verified on device and Carbide</p>
</li>
<li>If CODA reports "Not Connected"
<ol type="a">
<li>Click Options > Settings soft key </li>
- <li>If Connection is not set to BlueTooth, choose BlueTooth </li>
- <li>Click Ok soft key</li>
+ <li>If Connection is not set to USB, choose USB<br />
+ <p><img src="images/coda_options.png" alt="CODA options" width="180" height="165"></p>
+ </li>
+ <li>Click Back soft key</li>
<li>Restart CODA </li>
</ol>
</li>
@@ -39,10 +40,6 @@
<ul>
<li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
</ul>
- <h5>Related tasks</h5>
- <ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth </a></li>
- </ul>
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
</body>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_troubleshooting.htm Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_troubleshooting.htm Thu Sep 30 13:53:55 2010 -0500
@@ -89,8 +89,8 @@
<blockquote>
<p>Normally, you can determine the COM port ID using the Device Manager if TRK is already connected via USB.
</p>
- <p>To check, choose Start > Settings > Control panel > System > Hardware > Device Manager. In the Device Manager, choose "Ports" to view the active ports (Figure 1).</p>
- <p align="center"><img src="images/trk_device_manager.gif" width="323" height="210" /></p>
+ <p>To check, choose <b>Start > Settings > Control panel > System > Hardware > Device Manager</b>. In the Device Manager, choose "Ports" to view the active ports (Figure 1).</p>
+ <p align="center"><img src="images/trk_device_manager.gif" width="387" height="258" /></p>
<p class="figure">Figure 1. Ports displayed in Ports section of Device Manager.</p>
<p>In some situations all USB virtual COM ports are installed under "Modems" in the Device Manager. In the Device Manager dialog, choose "Modems" and see if there are two COM ports listed. One of them will work for debugging. Most of the time, the higher port number works for debugging with TRK.</p>
</blockquote>
--- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Thu Sep 30 11:33:17 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Thu Sep 30 13:53:55 2010 -0500
@@ -226,6 +226,7 @@
</topic>
<topic label="Software Configuration Management" href="html/concepts/cvs.htm" />
</topic>
+
<topic label="Debugging projects" href="html/concepts/debugger_about.htm" >
<topic label="Running a program" href="html/debugger/debug/cmds_starting.htm" />
<topic label="Debug perspective" href="html/reference/perspective_debug.htm" >
@@ -240,6 +241,7 @@
</topic>
<topic href="html/reference/trk/wnd_on_device_setup.htm" label="On-Device Connections" >
+ <topic href="html/tasks/trk/trk_start_sisx.htm" label="Starting the CODA Software" />
<topic href="html/reference/trk/wnd_new_connection_wizard.htm" label="Setup Connection" />
<topic href="html/reference/trk/wnd_on_device_check_tab.htm" label="Test Connections" />
<topic href="html/reference/trk/wnd_new_conn_install_tab.htm" label="Install Remote Agents" />
