Open Source Bluetooth PAN's Forum Nokia Blog

Symbian, Descriptors and Unicode

Carbider — Tue, 20 Jan 2009 11:41:47 +0200

While programming Bluetooth data transmission routines I've come across an encoding issue at Symbian. The task was to send and receive Unicode strings encoded in UTF-16. The data was moved by RSocket class.

The thing is, the RSocket's read and write methods are taking the 8 bit descriptors only (representing the binary data), so we need to convert the 8 bit descriptors to 16 bit and vice versa.
For example, we need to receive some UTF-16 string in Russian language from the server and display it on screen.

Some documents here suggest several solutions on converting descriptors, but they don't work as needed. Let me explain why.

The two common methods of conversion are:

1. To use Copy() method of first the descriptor to copy contents of the second one.

Example:

RBuf8  buf8     ;
RBuf16 buf16    ;


buf16.Copy(buf8);

As a result, the contents of buf8 descriptor would not be simply copied to buf16, but each character would be expanded to 16 bits.
So the string “Hello” would become something like “_H_E_L_L_O” after expanding.

Image 1 – Example of how the Copy() method works, and what we actually need.

On the contrary, when converting the 16 bit descriptor to an 8 bit descriptor, the contents of the first would be collapsed.

That is a behavior of Copy() method.

2. The second method is to use a CnvUtfConverter class provided in Symbian.

Example:

HBufC8 *heap8;
HBufC  *heap16 = CnvUtfConverter::ConvertToUnicodeFromUtf8L(*heap8);

This method will convert between the Unicode and UTF-8. That is again is not what I needed. What I need is the conversion between the descriptor classes themselves but not transforming their contents, that should stay without any change.

Solving

So to read the Unicode string presented in binary format from socket and display it on screen, we need to convert the descriptor's body (8 bit descriptor to 16 bit descriptor) but not the descriptor's contents.

Here is a method on how can it be done.
To pass the descriptor's contents from the descriptor of one type to another, we have to copy contents somehow. I chose the memcpy() function. If you find a better (or safer) way, please submit it here.
Example:

Copy the contents of 8 bit descriptor to the 16 bit one.
(without memory allocation routines)

TBuf8       sourceBuf8        ;
TBuf16      destBuf16         ;


TInt len = sourceBuf8.Length();


aOutDest.FillZ(len/2         ); // necessary to set the size
memcpy((TAny *)destBuf16.Ptr(), (TAny *)sourceBuf8.Ptr(), len);

This works smoothly for S60 3rd FP1, both emulator and Nokia E90 device.

I wrote the CBinaryConverter class that has two methods, doing these operations. It is attached to this post.

Example of using CBinaryConverter class:

RBuf8 source                      ;
RBuf   dest                       ;  // the same as Rbuf16
TInt destLength                   ;
source.Create(100                );


// Receive the 8 bit descriptor from socket that contains 16 bit data
iActiveSocket->RecvOneOrMore(source, 0, iStatus, iLen ); 


destLength = source.Length() / 2  ;  // 16 bit chars instead of 8 bit


dest.CleanupClosePushL()          ;  // to  Cleanup Stack
dest.Create( destLength          );


//Conversion
CBinaryConverter::copy8BitInto16BitDescriptorL(source, dest  ); 


// Show the note
CAknInformationNote *iInfNote     ;
iInfNote = new (ELeave) CAknInformationNote();
iInfNote->ExecuteLD(dest         );


CleanupStack::PopAndDestroy(&dest); // Pop RBuf from the Cleanup Stack

Screenshot of the application, that controls Juke Box holding songs in English and Russian languages over Bluetooth:

Download the source code

Download zip package:
BinaryConverter_class.zip

Or view directly:

BinaryConverter.cpp

view

BinaryConverter.h

view

--
Cheers
Konstantine

PAN service advertise

Carbider — Wed, 28 May 2008 14:47:37 +0300

It is interesting the PAN (Bluetooth Personal Area Networking) profile is listed at Symbian 9.2 abilities.
The PAN overview is here:
...symbian.com/developer/techlib/v9.2docs/...

And a small API mention is here:
...symbian.com/developer/techlib/v9.2docs/...

Despite the fact that there is no completely ready PAN API in S60 3rd there are some type definitions and constants related to the deal. They are defined at btsdp.h header file here:
...symbian.com/developer/techlib/v9.2docs/...

Here are some constants that seem to be tempting for my Bluetooth inquisitive mind:

Listing - 1

/** PAN Service Class UUID */
static const TInt KPanUUUID = 0x1115;
/** PAN NAP Service Class UUID */
static const TInt KPanNapUUID = 0x1116;
/** PAN GN Service Class UUID */
static const TInt KPanGnUUID = 0x1117;

These values represent identifiers of Bluetooth(c) services that could be advertised by device.

There is a Chat example that advertises the Serial Port service. I decided to try one's luck with PAN.

const TInt KServiceClass = 0x1101; // SerialPort

Chat example supplies the service's identifier constant by returning this value from function below:

Listing - 2

TInt CChatServiceAdvertiser::ServiceClass()
{
return KServiceClass;
}

The KServiceClass constant is assigned to '0x1101' by default. I've changed the function to this manner:

Listing - 3

TInt CChatServiceAdvertiser::ServiceClass(TInt aAttemptNumber)
{
    switch(aAttemptNumber) {
    case 0 :
        return 0x1115; // PAN
        break;
    case 1 :
     return 0x1116; // PAN NAP
     break;
    case 2 :
     return 0x1117; // PAN GN
     break;
    }
}

This gives me a possibility to supply the AttemptNumber parameter to the function - so to test all 3 service classes by turns.

In the similar manner I had rewritten the function that returns the service's symbolic name.

Listing - 4

const TDesC& CChatServiceAdvertiser::ServiceName(TInt aAttemptNumber)
{
switch(aAttemptNumber) {

  case 0 :
     return _L("PAN"    ); // PAN
     break;
  case 1 :
     return _L("PAN NAP"); // PAN NAP
     break;
  case 2 :
     return _L("PAN GN" ); // PAN GN
     break;


}
}

Each time I've started the chat server I’ve outputted the qualifying message in this way:

iLog.LogL( _L("Attempt#"), iAttemptNumber );

After building the application under Phone release (GCCE) I had signed it myself and sent to my device.

As a Contributor of the Month I have got one. It's a Nokia N95 8GB.
With that one I can test a lot. It really helps in development. And also that multimedia computer is cool one ;)

Then I started the app on the phone and turned on the PAN search service on the WinXP SP2 machine.
However after all three service classes were advertised one by one, the XP machine did not detect any.

Lost in the dark

Carbider — Thu, 21 Feb 2008 12:32:00 +0200

As you know, I've worked a lot to figure out a way of how to realize the BNEP protocol on Symbian platform.

The simple idea of catching and processing all the TCP stream with help of IP hook is impossible until purchase non-publick API.
Also, the idea to create a networking interface or serial protocol modules (this blog entries:attempt-to-create-a-csy-module, serial-protocol-modules, symbian-networking-interface) failed to due to lack of examples.

Now, I'm moving like in a dark. And can't find a way to realize the BNEP.
Boss said me to try for 2 more weeks, to find out.
I do not see much sense if this blog ends with purchasing a non-publick API.

If anyone can provide an idea, let me know.

Reset S60-3rd emulator defaults

Carbider — Wed, 23 Jan 2008 10:35:42 +0200

While pushing more and more Internet Access Points on the emulator, the CommDB database appeared to malfunction.

First of all, when deleted temporary IAP, some others have disappeared too.
Next, when creating new entry, those which were gone can suddenly appear.
In conclusion, after system attempts to retrieve connection data, it returns “General error -19” and “General error -20”

Undoubtedly the reason was in wrong DB’s records manipulation. During debug, some tables could be filled in, while the rest are untouched if the debug is stopped.

While searching for a method to reset the CommDB on emulator I’ve looked through an amount of posts and articles:

symbian-freak.com/...
newlc.com/topic-7653
developer.sonyericsson.com/...
discussion.forum.nokia.com/...
simplysymbian.com/...

One can reset a real phone softly by combination: #*7870#
And hardly (full) by combination: #*7370#
Also one can go to main menu, select settings, general, factory settings.

After all this methods fail to function at win emulator, I was ready (with a heavy heart) to reinstall the SDK.

Mine is S60 3rd FP1 (Symbian 9.2).

But fortunately I’ve remembered that I have a backup copy of “Epoc32” folder stored when migrated from one machine to another. From one of the articles above I’ve learned that someone have installed the SDK to a different folder, then replaced old “Ecpoc32” with the fresh one.

So did I with backup’ed one.

With a sinking heart I was waiting while the emulator is starting again. After that I’ve unexpectedly found out former “cold” blue theme.

That was good. Emulator can start.

All previously installed apps were not there. But CommDB database works fine now and the whole behavior is quite adequate.

Attempt to create a CSY module

Carbider — Thu, 10 Jan 2008 14:55:52 +0200

So yes.
I've stand on the way of creating my own CSY module.

It is some kind of a reckless scheme for me. I have no any assurance it will help me in my researches. Furthermore, the web-search on "create custom CSY module" brings me back to my own blog post about serial protocols. Cool.
I call this adventure as a crazy attempt because it demands to throw together a lot of components without strong hope it will bring to essential result.

But the rays of hope are:

1. When creating new IAP, one of the Data Base fields is: "MODEM_CSY_NAME".
Some previous adventurers used it to set as "BTCOMM". Hmm good.
2. It is possible to create new serial modules. How? The search returns me back to my posts. The discussion boards speak only about connecting to modules.
3. There is a framework on Symbian OS called "Ecom". Ecom provides interaction between clients and polymorphic DLLs, which CSY modules, at my sight, are.

The Ecom's (symbian.com/../v9.2docs/../EcomArch) so-called plug-ins are polymorphic DLLs. Those DLLs provide the interface, the implementation and the factory functions (which instantiate concrete classes).

As it is said here, Serial protocol modules also have Service providers (interface implementations), Protocol Factories (that are called to instantiate serial service provider) as well.

Looks pretty familiar to understand the serial modules are finally polymorphic DLLs too.

Thus let’s try to accommodate my own DLL instead of BTCOMM.CSY.

By these conditions I've imported the Ecom example from SDK to launch and explore.
The example is situated in SDK folder:
/Symbian/9.2/S60_3rd_FP1/Examples/SysLibs/ECom/

and has 3 sub-folders:
-» InterfaceClient
-» InterfaceDefinition
-» InterfaceImplementation

After unsuccessful build I’ve noticed the given project depends on extra sources at the 'examples' folder.
It was 'CommonFramework' situated at '/Symbian/9.2/S60_3rd_FP1/Examples/'.

So I’ve copied entire 'CommonFramework' inside ‘Ecom’ and modified some paths.

In '/InterfaceClient/InterfaceClient.mmp'
USERINCLUDE ../..CommonFramework
to
USERINCLUDE ../CommonFramework

The familiar change at file: 'Ecom/.cdtproject'

So to be exact with my creepy idea we need:
-» Create new IAP,
-» Go to CommDB database and change this IAP record field 'MODEM_CSY_NAME' to newly-fledged polymorphic DLL.
-» See if there is any way DLL can be launched after user picks hackneyed IAP.
-» Maybe to rename DLL to CSY as well.
-» Of course, the final goal is that DLL to start working as serial module plug-in.

Besides there is work to divine the appropriate entry point to serial module DLL.

Meanwhile the project was built successfully and I've got two DLLs as a result.
The 'ExampleResolver.dll' and the 'EComExample.dll'.
As expected, they are not extension ".csy" provided.
The 'ExampleResolver.dll' is an Interface Definition.
The 'EComExample.dll' is an Interface Implementation.

Putting their names to CommDB records didn’t bring any results.
Even giving them 'csy' extension wouldn't help.

Being on this stage I'm still wondering if anybody knows:
1. How to write a proper CSY module.
2. How to create a Bluetooth Access Point. Which tables and rows of CommDB should be affected for this purpose.

I'll appreciate any comments on this subjects.

Serial protocol modules

Carbider — Fri, 21 Dec 2007 13:57:36 +0200

Continuing the last blog entry I can say it is impossible attach to an existing interface (with help of RConnection) in such a way that I can listen to all passing packets (or rather those sockets that I don’t own).

What is keeping me busy is creating Bluetooth® IAP (internet access point) after what I can get all the TCP/IP packets incoming to that IAP. As you read my blog I need this to transfer TCP packets over Bluetooth.

As I try to create BT IAP I mostly face with articles and forums related to distant 6th and 7th versions of Symbian.
Like this one.

Figure 1 – list of IAPs.

In Symbian_OS_Overview_To_Networking I’ve read that on Symbian OS there are Serial Protocol Modules (CSY) that are used to implement software serial port services. The Serial Protocol Module API (cs_port.h) allows developing new CSY modules.
Theoretically one can substitute the already existing BTCOMM.CSY with new module.

So current questions are:

Is it really possible (I didn’t find yet) to create new serial protocol modules (CSY). And how-to.
How to bind new IAP (see figure 1) with a new CSY so one can listen to all it’s packets.

And yes, have a nice Holidays!

Accomplish SSL connection from S60v3

Carbider — Mon, 19 Nov 2007 09:47:24 +0200

The PAN profile defines how to enable Bluetooth devices to participate in a personal area network.

One of the roles in PAN profile is a Network Access Point (NAP) that provides an Ethernet bridge to support network services to the PAN user. Read about it here: PAN specification.

For now I will try to simulate connection to a NAP from my phone. Why simulate? Because to achieve the real connection I need realization of BNEP protocol class which will transmit Ethernet payloads via Bluetooth.

Since Bluetooth can be eavesdropped in on, we want to use SSL as David said here in comments.

So the goal for now is to connect to some server using secure internet connection on my phone.

I chose the www.mozilla.org SSLv3 site as a server to connect to.

I found the CSecureSocket example at symbian.com/.../v9.2docs/.../ but not everything went of smoothly rather the connection was not established and system was completed with panics.

It seems that that example is pretty old even not for 3^rd edition. But I can’t assert so.

However I scoped the similar problems and documents over here and here.

When got tangled I used some parts of S60v3 Chat code example with insecure internet connection.

The “guiSetBluspan” application that was initiated at previous posts looks like this now:

you need to click “Options” menu then pick “Connect/Disconnect” item and then pick “NAP” item.

Diagram 1 – Connecting from application

After some seconds server will send SSL certificate. You need answer “Continue”.

Diagram 2 – Certificate question

After all steps of connection, handshaking, page request, getting server response and closing connection the notification will appear about successful operation.

Diagram 3 – Connection finished

The objects of these routines were to establish connection to secure HTTPS connection where NAP’s authorization page will be.

At next researches I need to connect to NAP server, provide user’s login and password. NAP is connected to Radius server which will verify user existence and will start accounting on him.

The source codes of application above are provided by this link: guiSetBluspan Zip archive v 0.003 (Nokia’s wiki)

See this posts here to know how to use sources.

The Secure Connection engine in focused in /Core/ folder and is called from “guiSetBluspanSettingItemListView.cpp”

Insert Multiselection list into GUI

Carbider — Tue, 06 Nov 2007 11:09:53 +0200

One of my favorite classes that Symbian grants to build User Interface is Multiselection List. I’ve learned about it recently.

This is a type of Vertical lists which draws a set of elements each of them can be marked by checkbox.

At future BluSPAN GUI there is “Chat settings” view. User can determine which types of files can be accepted by chat. Example: .bmp, .jpeg, .avi, .mpeg, wav and so on. See diagram 1.

Diagram 1 – Multiselection list at Chat settings view.

To build Multiselection List into my application I had to read about a lot of stages how to use it.

I divided this stages to:

» Defining Multiselection List in resource (.rss) file

» Code implementation in source (.cpp) to Popup it.

» Get results of user choice.

1. Defining Multiselection List in .rss file

I’ve read the Resources_Dialogs.pdf at S60_Platform_Avkon_UI_Resources documentation series. Upon this I’ve formed the resource definition as below:

Listing 1

// Multiselection list query dialog

RESOURCE DIALOG r_accept_type_multiselection_query

{

flags = EGeneralQueryFlags;

buttons = R_AVKON_SOFTKEYS_OK_CANCEL;

items =

{

DLG_LINE

{

type = EAknCtListQueryControl;

id = EListQueryControl;

control = AVKON_LIST_QUERY_CONTROL

{

listtype = EAknCtSingleGraphicPopupMenuListBox;

listbox = LISTBOX

{

flags = EAknListBoxMultiselectionList;

height = 3;

width = 3;

array_id = r_accept_types_multiselection_query_list_item;

};

heading = "Select types:";

};

}

};

}

RESOURCE ARRAY r_accept_types_multiselection_query_list_item

{

items =

{

LBUF { txt = "1t.Bmp"; },

LBUF { txt = "1t.Jpg"; },

LBUF { txt = "1t.Avi"; },

LBUF { txt = "1t.Mp3"; },

LBUF { txt = "1t.Wav"; }

};

}

I have put this listing to [project_name].rss file. After that you can call ExecuteLD() function with Reference to this resource object. This will be shown below.

2. Popuping list. Code implementation.

With UI designer help, choose the Event tab for “Accept types” menu item. Double click on event to generate Handler function.

In this function we need to create an Instance of CAknListQueryDialog class and Execute it. The source code below shows it.

Listing 2

// Run a dialog of “Acceptance of data types”

CArrayFixFlat<TInt>* indexArray = new(ELeave)CArrayFixFlat<TInt>(5);

CleanupStack::PushL(indexArray);

CAknListQueryDialog* dlg = new (ELeave)

CAknListQueryDialog(indexArray);

if ( dlg->ExecuteLD(R_ACCEPT_TYPE_MULTISELECTION_QUERY ) )

{

Here we will take results of User’s choice

}

CleanupStack::PopAndDestroy();// indexArray

By this code the Multiselection List will Popup and user can mark preferable items.

3. Geting results of user choice

That task was not easy due to Specific Array type of CArrayFixFlat<TInt>. I could not retrieve data from it. I found a way with help of the similar topic of this forum.

The source code below should be placed at Listing 2 to the “if ( dlg->ExecuteLD)” branch. This source code takes result from List and shows indexes of selected items on screen (diagram 2).

Listing 3

if ( dlg->ExecuteLD(R_ACCEPT_TYPE_MULTISELECTION_QUERY ) )

{

TBufC<136> resultString;

TPtr ptr = resultString.Des();

//temporary string to convert from TInt to text

TBufC<136> temporaryString;

TPtr ptrTemporaryString = temporaryString.Des();

TInt intValue;

//How much elements did user select from Multiselection list

TInt elementsAmount = indexArray->Count();

//Retrieve all element that user have picked up

for (TInt elementI = 0; elementI < elementsAmount; elementI++) {

intValue = (*indexArray)[elementI];

ptrTemporaryString.Format(_L("%d "), intValue);

ptr.Append(temporaryString);

}

//Show the elements user have picked up

CAknInformationNote* Notelnformation;

Notelnformation = new (ELeave) CAknInformationNote;

Notelnformation ->ExecuteLD(resultString);

} // If

Diagram 2 – Results of user’s choice. Indexes of selected items

Download source code here: guiSetBluspan Zip Archive v 0.002 (Nokia’s wiki)

See this posts here to know how to use sources.

Switching Avkon Views

Carbider — Wed, 31 Oct 2007 13:20:39 +0200

All of the views in my application which is shown here are represented as “Setting Item List” components (classes). Even main screen does. Here I reported vagueness about how to switch from one view (screen) to another. For example as I pick a “PAN” setting from main option menu I should be redirected to new PAN settings screen.

Now I can tell you how it can be done.

The way to this was laid through “MultiViews” S60 SDK example. It is found at “S60_3rd_FP1 / S60Ex / MultiViews” folder. I was solving the rebuses and found out that the final switching comes through AppUi()->ActivateLocalViewL() call. This function takes TUid parameter which is a View’s Identifier.

The accordance between the View and it’s ID is defined as Enumeration at [projectName].hrh file like this:

Listing 1:

enum TguiSetBluspanViewUids

{

EGuiSetBluspanSettingItemListViewId = 1,

EGuiSetBluspanSettingItemList2SettingsPanViewId,

EGuiSetBluspanSettingItemList2SettingsZeroconfViewId,

EGuiSetBluspanSettingItemList2SettingsUserViewId

…

};

So I assigned the Handler function to PAN menu-item click and implemented code:

AppUi()->ActivateLocalViewL(TUid::Uid(EGuiSetBluspanSettingItemList2SettingsPanViewId ) );

Yeah, this name is true long but was generated automatically.

Diagram 01 – Switch from main screen to PAN settings screen.

As I implemented analogous code for the rest Views at Settings submenu (diagram 2)

I discovered that the new child view has Exit soft button which will exit the application if was clicked. But I need it to return back to the main screen not exit.

Diagram 02 – Settings submenu

At properties menu I picked OPTIONS_BACK instead of OPTIONS_EXIT (diagram 3).

Diagram 03 – Options menu properties

But it did not cause the required effect. The button’s name was changed but it still executed Exit function. The reason is the following block of code, situated at HandleCommandL( TInt aCommand ) function:

Listing 2:

// [[[ begin generated region: do not modify [Generated Code]

if ( aCommand == EAknSoftkeyBack )

{

AppUi()->HandleCommandL( EEikCmdExit );

}

// ]]] end generated region [Generated Code]

I changed the code above to this one:

Listing 3:

if ( aCommand == EAknSoftkeyBack )

{

AppUi()->ActivateLocalViewL( TUid::Uid( EGuiSetBluspanSettingItemListViewId ) );

// The ID is in the [projectName].hrh file too

}

So, I’ve activated the Main screen (view) by this call. It works well but there is a problem: the code is situated in the middle of following framework:

// [[[ begin generated region: do not modify [Generated Code]

// ]]] end generated region [Generated Code]

It means that after any change to given View (with help of UI designer) my code would be rewritten with those one that’s shown at listing 2. That are not good news and I didn’t find more appropriate decision yet.

The last version of BluSPAN GUI source code can be found over this Zip Archive here.

Extract files from it, than create new workspace and import Bld.inf file as was shown at previous posts here.

Konstantine Voytenko

Code implementation for GUI

Carbider — Thu, 25 Oct 2007 09:28:15 +0300

At post: Assembling GUI set reflecting future BluSPAN functionality I have shown the GUI that will take place at BluSPAN application. Now I will tell you about some difficulties I’ve faced during this.

Since the “Status” menu-item in Options menu was created, I wanted it to perform Query List popup for user can select his status. This was done with “List Single Query Dialog” component.

After lots of research, and looking at examples, I knew that after this component is placed onto designer, the “RunListQuery1L();” is generated.

So I’ve implemented the “selected” event with call to it:

… ::HandleStatusMenuItemSelectedL( TInt aCommand )

{

// Run the Single Query list Of Status

int resultIndex = RunListQuery1L();

return ETrue;

}

And it worked.

Picture 1 – Event tab in Carbide С++

Creating new UI design in current application

To allow user customize the “USER”, “PAN” and other settings I had to create new designs with Settings Lists.

To do that, just right click on a project, and select:

“New->Other->Symbian OS->S60 UI Design”

Select “Setting Item List” type of interface. Write appropriate name. For example: “SettingsPAN” and click Finish. After that you can start customizing new UI design by arranging the components.

Once a User Settings design, was created, I’ve put “Text Editor” component there for user’s nickname . After Build the error occurred:
“object 'KEdit1MaxLength' redefined”.

But that was not so definitely, because I’ve made a lot of Designs to that time, and I’ve got a lot of similar errors. After examination it was clear that UI Designer generated the same code for newer “Text Editor” as it was for main application’s design (there was “Text Editor” too). Is it so clear?

But I’ve changed Component’s name from “edit1” to “User_edit1”. The errors stepped back.

At current stage I have a lot of Design screens with BluSPAN settings. But I don’t know how to switch between them. When new Design is created, the remark is shown: “Use View Switching: Avkon View-Switching architecture uses the View Server to activate your designs”. But I did find how to use it.

Picture 2 – The questions is: How to switch UI designs in application?

Did anybody face this challenge?

Assembling GUI set reflecting future BluSPAN functionality

Carbider — Wed, 24 Oct 2007 16:31:51 +0300

Hello. Recent days I was busy on assembling the GUI set which should reflect the functionality of future BluSPAN application.

I used Carbide’s C++ UI Designer tool. It’s pretty handy to drag-and-drop elements at design’s workspace while the appropriate code is generated. But I’m still confused with that code, which is too complicated to novice’s sight.

Documentation

I tried to approach this task reading a lot of material.

» I observed the possibilities of UI with help of
“Introduction_to_S60_UI_Components” and I’ve got good notion about it.

» Very basic information about UI Designer
UI Designer White Papers

» The manual for developers is: Avkon UI Resources

» Downloaded and executed some examples:

landmarks example

dynamic setting list example

Current results

So I started creating my GUIs. Here is a picture of those, I’ve created:

Picture 1 – Screen of Main app’s window

Picture 2 – Options menu

Picture 3 – Settings screens of all parameters BluSPAN will care

At next posts I’ll tell you what difficulties I’ve faced, the troubles I could overcome and those ones which are still barrier for project progress.

Bluetooth Driver for S60 SDK

Carbider — Mon, 22 Oct 2007 12:45:02 +0300

To use Bluetooth in S60 emulator you have to install BT driver.

After some customizing emulator will use your hardware - Bluetooth Dongle.

If you try to customize it by yourself (without installing driver) in purpose to use Bluetooth Dongle, than, for sure, emulator will die.

If you have S60 SDK FP2, the BT driver will be located at

“<S60_SDK_installation_directory>S60ToolsS60Bt” directory.

But I have S60 FP 1, so I've downloaded it from

http://www.forum.nokia.com/info/sw.nokia.com/id/9d50801f-1f95-4c83-87bc-cb83d4a21bef/S60_SDK_BT_Driver.zip.html

The installation procedure is described in this distribution package as *pdf.

After that you need to start emulator, and at PAN tab set HCI to USB, then restart it.

Everything is described in detail in previous guide.

As I restarted it, I've immediately got an advertisement message :) from the juke-box which is assembled in our office.

Now I can play with Bluetooth examples which are provided with SDK.

BlueZ port using P.I.P.S. environment

Carbider — Tue, 16 Oct 2007 15:01:58 +0300

After unsatisfactory attempt to port BlueZ system to Symbian due to <sys/signal.h> differences, David advised me to look at P.I.P.S libraries. P.I.P.S. are Symbian libraries that are compatible with POSIX standard.

http://developer.symbian.com/wiki/display/oe/P.I.P.S.+Home

That could mean reducing efforts while migrating the project to mobile device.

That was true on several positions. But there still was a trouble with <sys/system.h>.

It has sigaction{} structure inside. But BlueZ needs sigaction() function too.

I don’t know, if the trouble is that BlueZ doesn’t support POSIX. Or it is a Symbian’s trait.

But there is a paragraph here http://developer.symbian.com/wiki/download/attachments/1411/PIPS_Essential_Booklet.pdf

[PIPS_Essential_Booklet.pdf]

Which says: “The P.I.P.S. environment does not support signals”.

Other functions that are not supported:

sigfillset()

sigdelset()

I had to examine what Signals are used for. I came to conclusion that they are used to halt child processes.

Sigaction()function was used to specify the action to be associated with a specific signal. After that the process generates his child instance (with fork and exec) which can be killed by sending “halt” signal with this statement:

kill(pid, SIGHUP)

So, I did not still find the replacement to this function to kill child processes. I’m thinking about Symbian’s RProcess class. Any ideas?

I found that Carbide C++ is very strict to data types. Even more strict than unix c.

I had to replace statements like:

struct bnep_setup_conn_req *req;

req = (void *) pkt;

req = (struct bnep_setup_conn_req *) pkt;

At this 2 documents:

http://www3.symbian.com/faq.nsf/0/D23BCB0AF8B1DC168025729F003FF465?OpenDocument

http://www3.symbian.com/faq.nsf/0/0C3AC88AA406F6108025729F00402E3A?OpenDocument

I found recommendations how to substitute ther “fork”, “exec” operations with other posix functions. The main is posix_spawn().

I tried to follow this idea, outflanking the forks and execs with posix_spawn().It worked well.

At run_script() function there is instruction:

execv(script, argv);

Before run_script()is used, the fork()function is called to create the instance of program itself.

This “execv+fork”pair is replaced by one

posix_spawn(&Childpid,script,NULL,NULL,argv,NULL);

call.

There are still lots of goals to reach. I don’t know how to pass command line arguments to Carbide’s console application.

The sdp.c is not implemented in this version of port because it still makes too much errors and it will take time to solve.

I think there will be resulting GUI application which will run main PAND console instances. After that they should get into single signed SIS installation file.

Please look the sources of port using P.I.P.S. at my CVS repository http://bluspan.cvs.sourceforge.net/bluspan/pand_port_06/

The CVS checkout process to Carbide C++ IDE is described in my post: Get project from CVS to Carbide C++.

Please, checkout the newest pand_port_06 version.