using the QBluetooth library with Symbian S60 5th Edition

recently, I started studying Symbian development with Qt. I even developed myself a few apps and, comparing to Symbian C++, I must say, it’s as lot easier. the Symbian C++ idiosyncrasies are a headache if you don’t have a strong basis. and I still don’t have it. or, as the wikipedia says:

Unfortunately, Symbian C++ programming has a steep learning curve, as Symbian C++ requires the use of special techniques such as descriptors, active objects and the cleanup stack. This can make even relatively simple programs harder to implement than in other environments.

the community itself recommends Qt for simple apps development, and Symbian C++ for lower level apps. even Nokia is giving increased support to Qt as Symbian development platform; a proof for that is the lauching of the Nokia Qt SDK, a full suite for Symbian development with Qt. much simple than the though Symbian C++, IMO.

playing around with it, I wanted to develop an app for my Symbian phone using some bluetooth for communication with another equipment. I found myself surprised after discovering that there wasn’t a official project putting together bluetooth, Qt and Symbian; usually, the devs out there do it with Symbian C++ for this kind of app.

after some search, I found the QBluetooth project page, which aims the creation of a Qt bluetooth library for Symbian. after a little time pulling my hair out to configure it right, I’ll post right down here the followed step-by-step I did to make things work.

needed tools

if you want to start downloading things already, here’s the list:

there are some considerations to be made about these tools:

  • I’m developing for Symbian S60v5 so things will change if you’re using a different version;
  • I tested the configuration posted here, but problems may occur depending on your environment;
  • I’m using Windows XP SP3;
  • every time I could, used the installation defaults; additional configs will be informed; however, always read any information that it may shows up;
  • I used a lot of information available on the QBluetooth official page. in case of any doubt, use the comments or the project forum.

installing the tools

1) start with ActivePerl- just execute and select the defaults;

2) extract the contents of the file in C:\

3) extract the contents of the file and execute the file S60_5th_Edition_SDK_v1_0_en\setup.exe . install it without modifying any option. after a while the wizard will ask for installing the CSL ARM Toolchain; choose “accept” and install it as well.

4) install the Qt 4.7.1 for Symbian, executing the file qt-symbian-opensource-4.7.1-s60.exe .  the wizard will show a window referencing the  S60 5th Edition SDK installation folder.

5) install the Qt Creator 2.0.1, executing the file qt-creator-win-opensource-2.0.1.exe . it will show some information about debugging stuff. ignore them and just select the defaults.

6) open the file . inside it, you’ll see another file named . open this file; inside it, there are two folders: epoc32 and plugins. you’ll put these folders in the directory C:\S60\devices\S60_5th_Edition_SDK_v1.0\ (please note that these folders already exists in the destination; you’ll only merge their contents).

compiling QBluetooth

the file (28 dec 2010) already has a precompiled version of QBluetooth, located in the file, in the folder \QBluetooth\bin\epoc32\InstallToDevice\QBluetooth_selfsigned.sisx . however, if you want to compile your version of  QBluetooth:

  1. extract the contents of to a folder wich full path doesn’t have any special character;
  2. ope the project QBluetooth\source\ with Qt Creator;
  3. compile it; it should not show any errors (but some warnings may occur)

the result of the compilation is a package called QBluetooth_0x2003328D.sis, and it should be in the folder QBluetooth\source\ . for more information about configurations concerning the QBluetooth compilation , please refer to the QBluetooth page.

installing the QBluetooth on your development environment

in this context, install is just make the QBluetooth visible to all you projects in Qt for Symbian. the easiest way I found to do this is copying the contents of the folder \QBluetooth\bin\epoc32\ to C:\S60\devices\S60_5th_Edition_SDK_v1.0\epoc32\ . please note that, inside the folder \QBluetooth\bin\epoc32\ there are three other folders: includeInstallToDevice and release. the folders include and release already exists in C:\S60\devices\S60_5th_Edition_SDK_v1.0\epoc32\ , so you’ll again only merge their contents.

compiling an example project

last but not least, lets compile the project QuteMessenger, provided as example by the QBluetooth crew. for that:

  1. extract the contents of the file to a folder witch address doesn’t have any special characters;
  2. open the project in Qt Creator;
  3. go to line 37 of the file; apparently, there is a little mistake; it shows:

    when it should be


    (please note the “$$” just before “(EPOCROOT)” )

  4. compile the project

and we’re done! install on you cell phone the application QuteMessenger.sis, located in the folder QuteMessenger after the compilation and do some visibility tests with another bluetooth device!

5 Comentários on “using the QBluetooth library with Symbian S60 5th Edition”

  1. […] visibily tests with another bluetooth device!using the QBluetooth library with Symbian S60 5th Edition AKPC_IDS+="3454,";Popularity: unranked [?]0savesSave function displayURL(data){var […]

  2. PGiZ disse:

    I ‘m flow to your step to install , config develop tools.
    and test project ‘qutemessenger’ , project is build all sucessfully.
    but when try to run on my symbian device (Xpress Music 5800)
    I ‘m got this error …

    “Could not start application: General OS-related error”

    Hmm. I think bequese .sis file not compatible with OS9.4 S60 5th ??

    • cacovsky disse:

      I’m using the same operating system in my Nokia 5530 XpressMusic. can you provide more details? have you looked up or google or something for similar cases?

  3. PGiZ disse:

    OK , I found this solution. I required update QT in mobile device from 4.6 to 4.7
    and i posted this same problem in QTBluetooth discuss forum here.

    Many thanks for reply🙂 .

    PGiZ @ Krabi Thailand

Deixe uma resposta

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do

Você está comentando utilizando sua conta Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s