# HG changeset patch # User fturovic # Date 1264186908 21600 # Node ID ad2d5f6b8dcb92a0baac2f344250c76ac6df2212 # Parent 5778753457c38831a994aec9095fabba405e56c9 BUG 8648 - revised images and remote connection info diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_carbide_setup.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_carbide_setup.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_carbide_setup.htm Fri Jan 22 13:01:48 2010 -0600 @@ -15,7 +15,7 @@
  • Symbian OS System TRK (not available in the Developer Edition) —used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.

    • By default, you can click the Debug icon () in the toolbar to launch the New Launch Configuration Wizard. This creates a launch configuration for the project based on project information and any additional input required, like COM port selection. It is the recommended method for creating new launch configurations. Or, use the Debug window to create a customized launch configuration.

    -

    +

    Figure 1. Debug launch configuration for on-device debugging (Application TRK shown)

    Defining a Customized Launch Configuration

    diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_bluetooth.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_bluetooth.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_bluetooth.htm Fri Jan 22 13:01:48 2010 -0600 @@ -6,15 +6,11 @@ Installing On-device Debug Agents using Bluetooth -

    Installing On-device Debug Agents using Bluetooth

    -

    Use Bluetooth to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-target debugging. The installation location of the on-device debug agent will vary 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.

    +

    Use Bluetooth to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-target debugging. The installation location of the on-device debug agent will vary based on the phone. Application TRK is usable on both consumer and RnD versions of the device. System TRK is only usable on RnD devices.

    +

    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.

    NOTE The following example shows how to install the SISX file from a PC running Windows XP SP2 using an internal Bluetooth device. The actions to install the SISX file may be different on your version of Windows. Refer to the OS documentation for information on transferring a file via a Bluetooth connection.

    Installing an On-device Debug Agent using Bluetooth

    diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_pcsuite.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_pcsuite.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_pcsuite.htm Fri Jan 22 13:01:48 2010 -0600 @@ -9,7 +9,8 @@

    Installing On-device Debug Agents using PC Suite

    -

    Use the PC Suite software that came with your device (Nokia PC Suite is one example) to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-device debugging. The installation location of the on-device debug agent will vary 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.

    +

    Use the PC Suite software that came with your device (Nokia PC Suite is one example) to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-device debugging. Application TRK is usable on both consumer and RnD versions of the device. System TRK is only usable on RnD devices.

    +

    The installation location of the on-device debug agent 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.

    Using PC Suite you can install any TRK debug agent on the device using a Bluetooth or USB connection.

    NOTE You can use the connection software that came with your device to install the on-device debug agent SISX file. See your phone's operating manual for assistance on using it's software.

    @@ -50,7 +51,7 @@
  • Connecting via Bluetooth
  • Connecting via USB
    • - + \ No newline at end of file diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_overview.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_overview.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_overview.htm Fri Jan 22 13:01:48 2010 -0600 @@ -22,6 +22,6 @@
  • On-Device Setup
  • On-device Debugging
    • - + \ No newline at end of file diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm Fri Jan 22 13:01:48 2010 -0600 @@ -9,21 +9,20 @@

    Preconditions to On-Device Debugging

    -

    Before you can use on-device debugging to debug 3rd edition and UIQ devices, the following preconditions must be met.

    +

    Before you can use on-device debugging to debug 3rd and 5th edition devices, the following preconditions must be met.

    Verifying On-device Debugging Preconditions

    1. Verify that your system has the following:
        -
      • S60 v3.x, UIQ 2.X or UIQ 3.X kit installed
        • +
      • S60 v3.x or S60 v5.x kit installed
      • ActivePerl installed
      • RVCT or GCCE compiler
        • -
      • USB or Bluetooth capable S60 3rd Edition or UIQ 3rd Edition device
      • USB or Bluetooth support on your PC
      • Nokia PC Suite (or equivilent software) for connecting and installing applications to the device
      2. -
    2. Download and install the current TRK SISX file using the On-Device Setup dialog for debugging S60 5th edition and UIQ devices
      3. +
    3. Download and install the current TRK SISX file using the On-Device Setup dialog

      4. The Application TRK debug agents are stored If not, install it now using the On-Device Connections > New Connection Wizard > Install remote agents pane.

      NOTE The Application TRK versions included with Carbide is for CE versions of devices only. They are not intended for use with RnD devices.

    4. Specify the communication method with the on-target device during the debug session
      5. @@ -45,7 +44,7 @@
    5. Installing On-device Debug Agents using Bluetooth
    6. Installing On-device Debug Agents using USB
      7. - + \ No newline at end of file diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm Fri Jan 22 13:01:48 2010 -0600 @@ -43,7 +43,7 @@ - + diff -r 5778753457c3 -r ad2d5f6b8dcb core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx_usb.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx_usb.htm Fri Jan 22 13:01:00 2010 -0600 +++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx_usb.htm Fri Jan 22 13:01:48 2010 -0600 @@ -15,11 +15,9 @@
    7. On the device
      1. Launch Application TRK or System TRK program on the device
        2. -
      2. +
      3. Select PC-Suite from the USB Mode list
      8. -
    8. Select PC-Suite from the USB Mode list
      9. -
    9. Launch the Application TRK program
    10. Halt the Bluetooth device search by pressing the Cancel soft key
    11. Click Options > Settings > Connection
    12. Change Connection type to USB and set connection options
      13. @@ -27,7 +25,7 @@

       

      Figure 1 - Change connection type to USB and set connection options

      -
    13. Select Back and start the TRK again and you should be connected
      14. +
    14. Select Back and start TRK again and you should be connected
    Related concepts
    @@ -42,7 +40,7 @@ - +