Changes between Version 4 and Version 5 of Getting-Started/Symbian

Timestamp:

May 6, 2009 9:41:26 AM (15 years ago)

Author:

ismangil

Comment:

--

Getting-Started/Symbian

@@ -39 +39 @@
 Connect the USB cable to the phone, and on the phone, select '''PC Suite''':
 
-[[Image(phone_usb.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:phone_usb.JPG)]]
 
 If this is the first time you connect your phone to the PC, then it may take some time for Windows to install the USB drivers for the phone. Wait for it to complete and the Nokia PC Suite and PC Sync icons on the task bar tray become green:
 
-[[Image(pc_suite.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:pc_suite.JPG)]]
 
 Leave PC Suite running with the device connected using the USB cable throughout this tutorial session.
@@ -64 +64 @@
 Run Carbide C++. When it asks the workspace location, enter a directory where you would want to put Carbide specific settings for PJSIP (or just accept the default value):
 
-[[Image(carbide-workspace.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:carbide-workspace.JPG)]]
 
 You will now be presented with Carbide Welcome page.
@@ -73 +73 @@
 Select '''File''' --> '''Import''' from the menu:
 
-[[Image(file_import.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:file_import.JPG)]]
 
 This dialog below will pop up. Select '''Symbian OS''' --> '''Symbian OS Bld.inf file''' from the list, then press '''Next''' button:
 
-[[Image(import.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:import.JPG)]]
 
 On the next dialog, click '''Browse..''' button to select '''bld.inf''' file from PJSIP's {{{build.symbian}}} directory, then press '''Next''' button:
 
-[[Image(import_bld.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:import_bld.JPG)]]
 
 Then on the SDK selection dialog, select the build configurations that you want to support. For this tutorial, select WINSCW and GCCE from S60 3rd Edition MR SDK, and press '''Next''' button ('''do not select ARMV5 unless you have the commercial ARMV5 compiler'''):
 
-[[Image(import_sdk.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:import_sdk.JPG)]]
 
 You will then presented with MMP selection dialog. Leave the default selection (normally it should select all MMPs) and press '''Next''':
 
-[[Image(import_mmp.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:import_mmp.JPG)]]
 
 The project now is ready to be imported, press the '''Finish''' button:
 
-[[Image(import_finished.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:import_finished.JPG)]]
 
 Carbide is now exporting the MMP files into the workspace and this progress window will be displayed:
 
-[[Image(import_creating.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:import_creating.JPG)]]
 
 Wait for the process to complete.
@@ -103 +103 @@
 Once it completes, you will see the PJSIP project tree on the bottom left part of the Carbide main window:
 
-[[Image(carbide_main.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:carbide_main.JPG)]]
 
 On the '''Problems''' pane (bottom center of the main window) you can see there is one ''Warning'' about duplicate path, but we can ignore this for now.
@@ -121 +121 @@
 Select '''Phone Debug (GCCE) [S60_3rd_MR]''' from the menu:
 
-[[Image(build_config.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:build_config.JPG)]]
 
 === Build the Project ===
@@ -127 +127 @@
 Then right click ''Bld.inf'' or ''pjproject'' item from ''Symbian Project Navigator'' pane from the bottom left part of the main window, and select '''Build Target Only''':
 
-[[Image(build.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:build.JPG)]]
 
 Wait for the build process to complete. You may take a peek on what Carbide is doing by clicking on ''Console'' pane/tab in the bottom part of main window.
@@ -133 +133 @@
 Once it completes, watch out for any errors in the ''Problems'' pane (at the bottom center). There shouldn't be any errors, although there may be few warnings which I think can be ignored, for now:
 
-[[Image(build_problems.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:build_problems.JPG)]]
 
 We are now ready to build the .sis/.sisx file to be deployed to the phone.
@@ -152 +152 @@
 Assign the .pkg file to be used by the project by selecting Project Properties:
 
-[[Image(project_properties_menu.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:project_properties_menu.JPG)]]
 
 Then Project Properties dialog will appear. On this dialog:
@@ -164 +164 @@
 The dialog window now should look like this:
 
-[[Image(project_properties.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:project_properties.JPG)]]
 
 Press ''OK'' button to save the project configuration.
@@ -170 +170 @@
 Now right click '''bld.inf''' (or '''pjproject''') and click '''Refresh''':
 
-[[Image(project_refresh.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:project_refresh.JPG)]]
 
 Wait for few seconds (30 seconds on my computer) for Carbide to do its job, once it's done, you will see the .pkg file in the ''Project Navigator'' pane:
 
-[[Image(project_pkg.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:project_pkg.JPG)]]
 
 Note:
@@ -201 +201 @@
 Right click '''bld.inf''' or '''pjproject''' from the ''Symbian Project Navigator'' pane, and select '''Build Target Only''':
 
-[[Image(build.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:build.JPG)]]
 
 The build process will start. You can take a peek on the '''Console''' tab to see what's being done. Once the build process completes, you should see something like this on the '''Console''' tab:
@@ -235 +235 @@
 Install TRK support on the phone. The TRK application can be found in '''{{{C:\Program Files\Nokia\Carbide.c++ v1.2\plugins\com.nokia.carbide.trk.support_1.2.0.29\trk\s60}}}''' directory. For my phone, the one that works is '''{{{s60_3_0_app_trk_2_7.sisx}}}'''. Right click this .sisx file and select '''Install with Nokia Application Installer''':
 
-[[Image(trk_path.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_path.JPG)]]
 
 When asked if we want to install, click '''Yes''':
 
-[[Image(trk_install.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_install.JPG)]]
 
 On the PC, this window should be displayed. 
 
-[[Image(trk_wait.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_wait.JPG)]]
 
 Leave it this way, the installation will start on the phone now. Your phone should display something like this:
 
-[[Image(trk_p_install.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_install.JPG)]]
 
 Click Yes.
@@ -253 +253 @@
 Now the phone will display '''Details''' information:
 
-[[Image(trk_p_details.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_details.JPG)]]
 
 Click Continue.
@@ -259 +259 @@
 Your phone may now display the target memory location:
 
-[[Image(trk_p_mem.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_mem.JPG)]]
 
 Select the memory and press '''Select''' menu.
@@ -265 +265 @@
 Now the phone will display license agreement:
 
-[[Image(trk_p_lic.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_lic.JPG)]]
 
 Click '''OK''' (if you agree, of course). The phone should display installation progress window for couple of seconds now:
 
-[[Image(trk_p_progress.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_progress.JPG)]]
 
 Once it's done, '''Installation Complete''' window will appear briefly:
 
-[[Image(trk_p_complete.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_complete.JPG)]]
 
 TRK is now installed on the phone. Next step is to run it.
@@ -284 +284 @@
  1. The TRK window will appear. We can ignore the error message for now:
 
-[[Image(trk_r_welcome.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_r_welcome.JPG)]]
 
  1. Select '''Options''' --> '''Settings''' menu.
  1. Change the '''Connection''' to USB, and leave all settings unchanged:
 
-[[Image(trk_p_usb.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_usb.JPG)]]
 
  1. Click '''Back''' to get back to TRK main window.
@@ -295 +295 @@
  1. TRK main window should display '''Status: Connected''' now:
 
-[[Image(trk_p_connected.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_p_connected.JPG)]]
 
 Leave TRK running on the phone for the duration of this tutorial.
@@ -304 +304 @@
 Find out which COM port is the phone connection mapped to, in Device Manager:
 
-[[Image(dev_mgr_com.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:dev_mgr_com.JPG)]]
 
 In this case, the COM port is COM3. Note this COM port number, as we will need to specify it in Carbide.
@@ -317 +317 @@
 Select '''Run''' --> '''Debug...''' from the main menu:
 
-[[Image(run_debug.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:run_debug.JPG)]]
 
 '''Debug''' dialog will appear like below:
 
-[[Image(debug.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:debug.JPG)]]
 
 ==== Create a new Debug configuration for on-device debugging ====
@@ -334 +334 @@
 You should see something similar to the image below.
 
-[[Image(debug_main.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:debug_main.JPG)]]
 
 Now click on '''Apply''' button. The configuration name on the left tree now will get updated.
@@ -342 +342 @@
 Now select '''Connection''' tab. Choose the '''Serial Port''' to the COM port where your phone connection is mapped to, which you have found out from the step above (look at the Device Manager). In my case, it was COM3:
 
-[[Image(debug_connection.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:debug_connection.JPG)]]
 
 The ''Baud Rate'' setting should match the setting on the TRK application running on the phone. Since we have not changed this setting, just accept the default value (115200).
@@ -352 +352 @@
 Now select the '''Installation''' tab. Browse the .sisx file from PJSIP's {{{build.symbian}}} directory:
 
-[[Image(debug_installation.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:debug_installation.JPG)]]
 
 Now click '''Apply''' button
@@ -365 +365 @@
 Carbide now may rebuild the project (you may take a peek on what it's doing by looking at '''Console''' tab). Once it's done, Carbide will switch to ''Debug Perspective'' and the SIS file will be downloaded to the phone and this window will appear briefly:
 
-[[Image(debug_download.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:debug_download.JPG)]]
 
 When this window dissappear, you should see the application runs on the phone:
 
-[[Image(symbian_ua.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:symbian_ua.JPG)]]
 
 You may make calls, receive calls, do presence stuffs, etc. Full debugging should also be possible; you may set breakpoints, step into functions, etc.
@@ -406 +406 @@
 I had experienced this few times. The file seems to be downloaded to the phone fine (the download progress bar shows progress), but once debugging starts Carbide displays "Carbide Alert": "Load Failed", "TRKProtocolPlugin: Failed to download the specified file to target" (as shown in the picture below).
 
-[[Image(trk_fail.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_fail.JPG)]]
 
 I'm not sure what's causing this, but closing TRK on the phone, then reconnecting the USB cable and restarting TRK seems to have fixed this.
@@ -412 +412 @@
 === TRKProtocolPlugin: Failed to continue thread ===
 
-[[Image(trk_fail2.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_fail2.JPG)]]
 
 The solution is similar to above.
@@ -430 +430 @@
 Like this dialog:
 
-[[Image(trk_not_running.JPG)]]
+[[Image(DevelopingSymbianAppWithCarbide:trk_not_running.JPG)]]
 
 If you see TRK is running on the phone, it means that your phone is hung now. Restart the phone by disconnecting the USB cable, taking of the battery, put it back on, start the phone, connect the USB cable, and re-run TRK again.
@@ -457 +457 @@
 
 
+