Archived:Demonstration of Carbide.c++ 1.3 on-device app debug
Article Metadata
The debugging setup process in Carbide.c++ 2.0 and later has been improved and differs from the process documented here. For the latest information on using the debugging features in Carbide.c++ please see the "Debugging projects" section of the Carbide.c++ help.
Contents |
Preparations
Various editions of Carbide.c++ support emulator debugging, on-device debugging, and external debugging with JTAG. On-device debugging is a very important way for develpers to run the applications on device hardware and locate issues in the code that may not be identified when using the SDK emulators.
Carbide.c++ provides two levels of on-device debugging, applicaiton debugging and system debugging. System debugging is integrated into the OEM edition of Carbide. As application debugging is used more often by third party developers, we will concentrate on on-device application debugging here.
To debug applicaitons on device, the on-device agent is required. It is called Application TRK. The agent's installation file is included with Carbide.c++ Professional edition. It can be found in [your carbide installation path]\plugins\com.nokia.carbide.trk.support_1.3.0.020\trk\s60\.
Below are the steps to debug an S60 application. As we know, a S60 application can be a standalone GUI program or a GUI program plus engine. Application TRK is capable of debugging both types of program.
It is assumed that the Application TRK has been installed on the target device. The next step is to connect the target device with the PC to used for debugging. The connection can be setup via using a USB or Bluetooth connection. Bluetooth is the case we use here.
You need to know the port number the Bluetooth connection is using on the debugging PC. Check this in the Bluetooth configuration (usually found in Control Pannel) and write down the port number. It will be used in the Carbide.c++ debugging configuration. See 00 bluetoothport.png.
To illustrate debugging import the example GUIEngine project found in S60 3rd Edition SDK supporting Feature Pack 2.
Settings
The debug window is opened first, then the developers need to feed the proper settings accordingly.
Figure 2 and Figure 3 above show how to open and start a new debugging setting. We set up the debugging configuration for Symbian OS Application TRK.
In the follwoing three diagrams Figure 4, Figure 5, and Figure 6, the red arrows and under lines indicated what we have done to configure the debugging settings for GUIEngine app.
The port number is used here, make it as same as the one we got from bluetooth configuration just now.
The app needs to be packaged and singed in advance. for instruction of Symbian signed, please refer to Symbian signed
Connection
Back to target S60 device, start the Application TRK, find and connect to the debugging PC. If the connection is good, the developers shall see on the screen of mobile phone
Welcome to TRK for Symbian OS
Status: Connected
BT Dev Name: (PC's name)
BT Port number: 1
If some problems happened, check the regular bluetooth connection settings and bluetooth port number.
Afer the connection between the target S60 device and the debugging PC is set, press button Run in debug window, Carbide starts downloading the app, here GUIEngine to target device and debugging session.
If all steps are right, the developers should see Figure 7.
if not, Figure 8,
Debug
Meanwhile, Carbide IDE makes the debug view (Figure 9) visible.
As a sequence of operations, we set the break points in both GUI and engine part, continue the debug session, do debugging regularly (shown in Figure 10 - 14).
As one reminding, sometimes the break points are set not in reight place, so we get unresolved break points. We can also disable break points on purpose (Figure 15).
- All the figures here
Figure 1. Bluetooth port number
Figure 2. Open debug window 1
Figure 3. Open debug window 2
Figure 4. Debug window settings 1
Figure 5. Debug window settings 2
Figure 6. Debug window settings 3
Figure 7. Launch successfully
Figure 8. Launch failed
Figure 9. Debug viewk
Figure 10. Set break points
Figure 11. Debugging 1
Figure 12. Debugging 2
Figure 13. Debugging 3
Figure 14. Debugging 4
Figure 15. Disable break points
even this article is a outdated article still it shows how developer can use carbide.c++ for ODD . only complain with this article is the images are not embedded so reader need to jump between article & images while reading.