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


Ignore:
Timestamp:
May 6, 2009 9:41:26 AM (11 years ago)
Author:
ismangil
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Getting-Started/Symbian

    v4 v5  
    3939Connect the USB cable to the phone, and on the phone, select '''PC Suite''': 
    4040 
    41 [[Image(phone_usb.JPG)]] 
     41[[Image(DevelopingSymbianAppWithCarbide:phone_usb.JPG)]] 
    4242 
    4343If 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: 
    4444 
    45 [[Image(pc_suite.JPG)]] 
     45[[Image(DevelopingSymbianAppWithCarbide:pc_suite.JPG)]] 
    4646 
    4747Leave PC Suite running with the device connected using the USB cable throughout this tutorial session. 
     
    6464Run 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): 
    6565 
    66 [[Image(carbide-workspace.JPG)]] 
     66[[Image(DevelopingSymbianAppWithCarbide:carbide-workspace.JPG)]] 
    6767 
    6868You will now be presented with Carbide Welcome page. 
     
    7373Select '''File''' --> '''Import''' from the menu: 
    7474 
    75 [[Image(file_import.JPG)]] 
     75[[Image(DevelopingSymbianAppWithCarbide:file_import.JPG)]] 
    7676 
    7777This dialog below will pop up. Select '''Symbian OS''' --> '''Symbian OS Bld.inf file''' from the list, then press '''Next''' button: 
    7878 
    79 [[Image(import.JPG)]] 
     79[[Image(DevelopingSymbianAppWithCarbide:import.JPG)]] 
    8080 
    8181On the next dialog, click '''Browse..''' button to select '''bld.inf''' file from PJSIP's {{{build.symbian}}} directory, then press '''Next''' button: 
    8282 
    83 [[Image(import_bld.JPG)]] 
     83[[Image(DevelopingSymbianAppWithCarbide:import_bld.JPG)]] 
    8484 
    8585Then 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'''): 
    8686 
    87 [[Image(import_sdk.JPG)]] 
     87[[Image(DevelopingSymbianAppWithCarbide:import_sdk.JPG)]] 
    8888 
    8989You will then presented with MMP selection dialog. Leave the default selection (normally it should select all MMPs) and press '''Next''': 
    9090 
    91 [[Image(import_mmp.JPG)]] 
     91[[Image(DevelopingSymbianAppWithCarbide:import_mmp.JPG)]] 
    9292 
    9393The project now is ready to be imported, press the '''Finish''' button: 
    9494 
    95 [[Image(import_finished.JPG)]] 
     95[[Image(DevelopingSymbianAppWithCarbide:import_finished.JPG)]] 
    9696 
    9797Carbide is now exporting the MMP files into the workspace and this progress window will be displayed: 
    9898 
    99 [[Image(import_creating.JPG)]] 
     99[[Image(DevelopingSymbianAppWithCarbide:import_creating.JPG)]] 
    100100 
    101101Wait for the process to complete. 
     
    103103Once it completes, you will see the PJSIP project tree on the bottom left part of the Carbide main window: 
    104104 
    105 [[Image(carbide_main.JPG)]] 
     105[[Image(DevelopingSymbianAppWithCarbide:carbide_main.JPG)]] 
    106106 
    107107On 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. 
     
    121121Select '''Phone Debug (GCCE) [S60_3rd_MR]''' from the menu: 
    122122 
    123 [[Image(build_config.JPG)]] 
     123[[Image(DevelopingSymbianAppWithCarbide:build_config.JPG)]] 
    124124 
    125125=== Build the Project === 
     
    127127Then 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''': 
    128128 
    129 [[Image(build.JPG)]] 
     129[[Image(DevelopingSymbianAppWithCarbide:build.JPG)]] 
    130130 
    131131Wait 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. 
     
    133133Once 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: 
    134134 
    135 [[Image(build_problems.JPG)]] 
     135[[Image(DevelopingSymbianAppWithCarbide:build_problems.JPG)]] 
    136136 
    137137We are now ready to build the .sis/.sisx file to be deployed to the phone. 
     
    152152Assign the .pkg file to be used by the project by selecting Project Properties: 
    153153 
    154 [[Image(project_properties_menu.JPG)]] 
     154[[Image(DevelopingSymbianAppWithCarbide:project_properties_menu.JPG)]] 
    155155 
    156156Then Project Properties dialog will appear. On this dialog: 
     
    164164The dialog window now should look like this: 
    165165 
    166 [[Image(project_properties.JPG)]] 
     166[[Image(DevelopingSymbianAppWithCarbide:project_properties.JPG)]] 
    167167 
    168168Press ''OK'' button to save the project configuration. 
     
    170170Now right click '''bld.inf''' (or '''pjproject''') and click '''Refresh''': 
    171171 
    172 [[Image(project_refresh.JPG)]] 
     172[[Image(DevelopingSymbianAppWithCarbide:project_refresh.JPG)]] 
    173173 
    174174Wait 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: 
    175175 
    176 [[Image(project_pkg.JPG)]] 
     176[[Image(DevelopingSymbianAppWithCarbide:project_pkg.JPG)]] 
    177177 
    178178Note: 
     
    201201Right click '''bld.inf''' or '''pjproject''' from the ''Symbian Project Navigator'' pane, and select '''Build Target Only''': 
    202202 
    203 [[Image(build.JPG)]] 
     203[[Image(DevelopingSymbianAppWithCarbide:build.JPG)]] 
    204204 
    205205The 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: 
     
    235235Install 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''': 
    236236 
    237 [[Image(trk_path.JPG)]] 
     237[[Image(DevelopingSymbianAppWithCarbide:trk_path.JPG)]] 
    238238 
    239239When asked if we want to install, click '''Yes''': 
    240240 
    241 [[Image(trk_install.JPG)]] 
     241[[Image(DevelopingSymbianAppWithCarbide:trk_install.JPG)]] 
    242242 
    243243On the PC, this window should be displayed.  
    244244 
    245 [[Image(trk_wait.JPG)]] 
     245[[Image(DevelopingSymbianAppWithCarbide:trk_wait.JPG)]] 
    246246 
    247247Leave it this way, the installation will start on the phone now. Your phone should display something like this: 
    248248 
    249 [[Image(trk_p_install.JPG)]] 
     249[[Image(DevelopingSymbianAppWithCarbide:trk_p_install.JPG)]] 
    250250 
    251251Click Yes. 
     
    253253Now the phone will display '''Details''' information: 
    254254 
    255 [[Image(trk_p_details.JPG)]] 
     255[[Image(DevelopingSymbianAppWithCarbide:trk_p_details.JPG)]] 
    256256 
    257257Click Continue. 
     
    259259Your phone may now display the target memory location: 
    260260 
    261 [[Image(trk_p_mem.JPG)]] 
     261[[Image(DevelopingSymbianAppWithCarbide:trk_p_mem.JPG)]] 
    262262 
    263263Select the memory and press '''Select''' menu. 
     
    265265Now the phone will display license agreement: 
    266266 
    267 [[Image(trk_p_lic.JPG)]] 
     267[[Image(DevelopingSymbianAppWithCarbide:trk_p_lic.JPG)]] 
    268268 
    269269Click '''OK''' (if you agree, of course). The phone should display installation progress window for couple of seconds now: 
    270270 
    271 [[Image(trk_p_progress.JPG)]] 
     271[[Image(DevelopingSymbianAppWithCarbide:trk_p_progress.JPG)]] 
    272272 
    273273Once it's done, '''Installation Complete''' window will appear briefly: 
    274274 
    275 [[Image(trk_p_complete.JPG)]] 
     275[[Image(DevelopingSymbianAppWithCarbide:trk_p_complete.JPG)]] 
    276276 
    277277TRK is now installed on the phone. Next step is to run it. 
     
    284284 1. The TRK window will appear. We can ignore the error message for now: 
    285285 
    286 [[Image(trk_r_welcome.JPG)]] 
     286[[Image(DevelopingSymbianAppWithCarbide:trk_r_welcome.JPG)]] 
    287287 
    288288 1. Select '''Options''' --> '''Settings''' menu. 
    289289 1. Change the '''Connection''' to USB, and leave all settings unchanged: 
    290290 
    291 [[Image(trk_p_usb.JPG)]] 
     291[[Image(DevelopingSymbianAppWithCarbide:trk_p_usb.JPG)]] 
    292292 
    293293 1. Click '''Back''' to get back to TRK main window. 
     
    295295 1. TRK main window should display '''Status: Connected''' now: 
    296296 
    297 [[Image(trk_p_connected.JPG)]] 
     297[[Image(DevelopingSymbianAppWithCarbide:trk_p_connected.JPG)]] 
    298298 
    299299Leave TRK running on the phone for the duration of this tutorial. 
     
    304304Find out which COM port is the phone connection mapped to, in Device Manager: 
    305305 
    306 [[Image(dev_mgr_com.JPG)]] 
     306[[Image(DevelopingSymbianAppWithCarbide:dev_mgr_com.JPG)]] 
    307307 
    308308In this case, the COM port is COM3. Note this COM port number, as we will need to specify it in Carbide. 
     
    317317Select '''Run''' --> '''Debug...''' from the main menu: 
    318318 
    319 [[Image(run_debug.JPG)]] 
     319[[Image(DevelopingSymbianAppWithCarbide:run_debug.JPG)]] 
    320320 
    321321'''Debug''' dialog will appear like below: 
    322322 
    323 [[Image(debug.JPG)]] 
     323[[Image(DevelopingSymbianAppWithCarbide:debug.JPG)]] 
    324324 
    325325==== Create a new Debug configuration for on-device debugging ==== 
     
    334334You should see something similar to the image below. 
    335335 
    336 [[Image(debug_main.JPG)]] 
     336[[Image(DevelopingSymbianAppWithCarbide:debug_main.JPG)]] 
    337337 
    338338Now click on '''Apply''' button. The configuration name on the left tree now will get updated. 
     
    342342Now 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: 
    343343 
    344 [[Image(debug_connection.JPG)]] 
     344[[Image(DevelopingSymbianAppWithCarbide:debug_connection.JPG)]] 
    345345 
    346346The ''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). 
     
    352352Now select the '''Installation''' tab. Browse the .sisx file from PJSIP's {{{build.symbian}}} directory: 
    353353 
    354 [[Image(debug_installation.JPG)]] 
     354[[Image(DevelopingSymbianAppWithCarbide:debug_installation.JPG)]] 
    355355 
    356356Now click '''Apply''' button 
     
    365365Carbide 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: 
    366366 
    367 [[Image(debug_download.JPG)]] 
     367[[Image(DevelopingSymbianAppWithCarbide:debug_download.JPG)]] 
    368368 
    369369When this window dissappear, you should see the application runs on the phone: 
    370370 
    371 [[Image(symbian_ua.JPG)]] 
     371[[Image(DevelopingSymbianAppWithCarbide:symbian_ua.JPG)]] 
    372372 
    373373You may make calls, receive calls, do presence stuffs, etc. Full debugging should also be possible; you may set breakpoints, step into functions, etc. 
     
    406406I 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). 
    407407 
    408 [[Image(trk_fail.JPG)]] 
     408[[Image(DevelopingSymbianAppWithCarbide:trk_fail.JPG)]] 
    409409 
    410410I'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. 
     
    412412=== TRKProtocolPlugin: Failed to continue thread === 
    413413 
    414 [[Image(trk_fail2.JPG)]] 
     414[[Image(DevelopingSymbianAppWithCarbide:trk_fail2.JPG)]] 
    415415 
    416416The solution is similar to above. 
     
    430430Like this dialog: 
    431431 
    432 [[Image(trk_not_running.JPG)]] 
     432[[Image(DevelopingSymbianAppWithCarbide:trk_not_running.JPG)]] 
    433433 
    434434If 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. 
     
    457457 
    458458 
     459