×
Namespaces

Variants
Actions

Nokia Connectivity Framework

From Nokia Developer Wiki
Jump to: navigation, search
Article Metadata
Compatibility
Platform(s):
Series 40
Symbian
Article
Created: jimgilmour1 (19 Mar 2007)
Last edited: hamishwillee (17 Jun 2013)

Contents

Introduction

Nokia Connectivity Framework 1.2 (NCF) is a tool to visualize, construct, maintain, and modify emulation or testing environments that utilize Nokia SDK emulators. The Connectivity Framework facilitates connectivity between Nokia Developer Platform SDK emulators, between an emulator and a device, and between an emulator and a server application, which assists in the creation and testing of connected applications for Nokia devices. Bluetooth, Short Message Service (SMS), and Multimedia Messaging Service (MMS) connectivity technologies are supported.

This article will show how to configure NCF v1.2, to work with Bluetooth USB adaptors supported by Windows XP Service Pack 2.

There is a lot information and it’s worth taking 30 minutes to PRINT OFF THE WHOLE ARTICLE AND READ ALL SECTIONS.

Please carry out each section IN THE ORDER GIVEN there are boring reasons for this which cause big problems if not carried out in the given sequence

Administration rights

You WILL need to have Administrator rights, PRIMARY DOMAIN CONNECTED PC'S SEEM TO FAIL TO INSTALL PRODUCTS CORRECTLY. DOMAIN CONNECTED WINDOWS XP PROFESSIONAL LOCK DOWN POLICY WILL PREVENT THE WORKING OF THIS PROCEDURE.

This does not apply to Windows XP Home Service Pack 2. Windows 2000 Service Pack 5 uses devices only supported by NCF.

Generally this works better with standalone machines. If you have problems a freshly installed copy of Windows XP Service Pack 2 works better.

DO NOT attempt to modify the SDK kits. If they wont install there is probably an operating system restriction preventing you from installing new hardware of software. On Windows XP Professional you must use the Adminstrator account at all times.

Liability

No responsibility is accepted for any problems however caused to your PC for any software/hardware. The users of this procedure are responsible for any problems that occur

Nokia does not support software/hardware or test against USB devices.


Therefore this is "unsupported" by Nokia but hopefully supported by the Community developer members.

Nokia PC Suite bluetooth connection

Before starting this procedure you should make sure that you bluetooth hardware is working. This can be checked by seeing if PC Suite can "pair" with your phone. If PC Suite does not work then this procedure will not work. Getting PC Suite working is outside the scope of this article.

Download install products

Download products from S60 page

Make sure you have your registration numbers for the products NCF 1.2 ready

Install S60 2nd Edition SDK for, Feature Pack 1

Now download the correct version of s60 SDK 2.0 Feature Pack 1 Symbian SDK's And select the bottom one in the list "2nd Edition, FP 1, CW (115 MB)"

Install S60 2nd Edition SDK for, Feature Pack 2

Now download the correct version of S60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 2.

Symbian SDK's

For C++, Supporting CodeWarrior (150MB) currently 4 from top called "2nd Edition, FP 2, CW (150 MB)"

Install S60 2nd Edition SDK for, Feature Pack 3

Now download the correct version of S60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 3.

Symbian SDK's

For C++, Supporting CodeWarrior (152MB) On the drop down currently 7th from bottom called "2nd Edition, FP 3, CW (152 MB)"

When installation is complete select "2nd Edition, FP 3" as the default SDK.

Download NCF 1.2

NCF Link Install NCF 1.2 making sure you have your registration number

Making the S60 Emulator see the USB Bluetooth Dongle

Unplug/remove the BT USB stub from the PC.

Have you installed the BT USB driver? Start->All Programs->Nokia Developer->Nokia Connectivity Framework->Install BT USB driver or C:\Nokia\Tools\Nokia_Connectivity_Framework\configuration\addons\ncfbt\setup.exe


Push BT USB back in The "NCF BT USB driver" is detected and loaded.

If there is a problem:- Then unplug/remove the BT USB stub from the PC. Wait 10 seconds. Push BT USB back in The "NCF BT USB driver" is detected and loaded this time

Go to control panel -> Hardware -> Device Manager -> look at USB devices expand the list and check that the NCF USB driver is loaded.

If its not working reboot *without the BT USB plugged* in and try to run install program “Install BT USB driver” again.

Then plug in BT USB. Check the following file to see if your BT USB in on the list if still not detected

C:\Nokia\Tools\Nokia_Connectivity_Framework\configuration\addons\ncfbt\ncfbt.inf

Check chip details with XpUSBviewer Click on device and look at value in the right hand pane.

My BT USB is an CSR so it on the list and it works. %DeviceDescription%=Install, USB\VID_0A12&PID_0001  ; CSR VID&PID

NCF and PC Suite conflict warning

WARNING! NCF 1.2 BT USB driver will have disabled PC Suite bluetooth connections. Restore with

Start->All Programs-> Nokia Developer->Nokia Connectivity Framework->Uninstall BT USB driver. Remove the BT USB and insert again to enable Win XP drivers and restart PC Suite

Starting up NCF and creating NCF Virtual ports drivers

Start up NCF in full (NOT LITE).

Start->All Programs->Nokia Developer->Nokia Connectivity Framework-> Nokia Connectivity Framework Full or C:\Nokia\Tools\Nokia_Connectivity_Framework\bin\NCFStart.exe full

In NCF open up the "Products-> Hardware" you should see a "BT USB Adapter" with green square next to it.

In NCF open up the "Products-> Terminal SDKs" you should see "S60 SDK 2.1 for Symbian OS, Nokia Edition".

Click Menu File-> Open C:\Nokia\Tools\Nokia_Connectivity_Framework\examples\Example_BTUSB_Environment.env

If this is the first time of loading the XP drivers "NCF Virtual Port" drivers will start to load. Please wait complete, over 125 seconds, on my XP system.

When install is complete the NCF environment should show a BT USB and a Icon with "S60 SDK 2.1 for Symbian OS, Nokia Edition" underneath.

Click the green start icon on the NCF toolbar to start the environment.

Wait for over 150 seconds for start-up to complete for the first time, Go and find your Nokia mobile phone and start bluetooth and set phone discoverable.


Using the emulator to pair with another mobile phone

In the emulator use the down arrow to communications (initially off emulator Screen) Select Communications. Click bluetooth in the box "My Bluetooth Name" enter the name as the way a SMS text message. Select Bluetooth, currently off. Click OK. Label changes to ON. Press the right hand roller button.

Press, "Options" Select "New Paired Device" after a few seconds. A “Searching for devices” message appears, after a delay due to emulation, "Devices found:" list appears and hopefully your real mobile phone will be on it. Select your phone from the list. Wait 5 seconds for the "Enter passkey message to appear". Enter "1234" press ok On your real Nokia phone answer "yes" to request to pair with emulator. Now enter the passkey code "1234" on your real phone press ok.

The devices pair up ok and you can now see you real phone name on the emulators paired devices list.

Bluetooth command log

In The NCF Environment screen lots of messages appear. In my system these went up to ID=53 Click bluetooth tab in NCF to see the bluetooth commands

Well that finished for "S60 SDK 2.1 for Symbian OS, Nokia Edition". Click the square box, next to the green start button on menu toolbar, to stop NCF environment

Initial setup

Using "S60 2nd Ed. SDK for Symbian OS Supporting Feature Pack 3 - For C++ - Supporting Metrowerks CodeWarrior" for bluetooth

In the NCF Message Environment page right click on "S60 SDK 2.1 for Symbian OS, Nokia Edition" and select Delete.

In NCF open up the "Products-> Terminal SDKs" you should see "S60 2nd Ed. SDK for Symbian OS FP 3 Metrowerks CodeWarrior". Click and drag it into “Messaging” environment area, on right of BT icon, to replace previous Product icon.

Click the green start icon on the NCF toolbar to start the environment.

Wait for over 150 seconds for start-up to complete for the first time, go and find your Nokia mobile phone and start bluetooth and set phone discoverable.

Follow the section "Using the emulator to pair with another mobile phone" earlier.

Troubleshooting Section

Set up Bluetooth

In "Communication Technology Click on word BTUSB change. Select "Virtual Serial port" In "Content Type" and select HCI UART Transport Layer (H4). In the bottom display is DEVICE name and should hopefully be COM3.

This comes from back during S60 2nd Edition Feature Pack 1 load right back at beginning, if you followed procedure.

Set up Infrared

Second line is IrDA In "Communication Technology Click on Word BTUSB change. Select "Virtual Serial port" In "Content Type" and select "IrLAP Async". In the bottom display is DEVICE name and should hopefully be COM4.

Set up MMS and SMS if needed

Third line is MMS In "Communication Technology Click on Word BTUSB change. Select "File" In "Content Type" and select "MMS Encapsulation". In the bottom display is Inbox is "_PRODUCT_HOME_/winscw/c/mmsin/" In the bottom display is Outbox is "_PRODUCT_HOME_/winscw/c/mmsout/" InboxFileExtension is "mms" OUtboxFileExtension is "mms"

Fourth line is SMS In "Communication Technology Click on Word BTUSB change. Select "File" In "Content Type" and select "S60 Symbian 2.0". In the bottom display is Inbox is "_PRODUCT_HOME_/winscw/c/smsin/" In the bottom display is Outbox is "_PRODUCT_HOME_/winscw/c/smsout/" InboxFileExtension is "sms" OUtboxFileExtension is "sms"

You do not need to set SMS or MMS, unless you intend to use them.


Click the "x" for bluetooth and InfraRed.

Leave MMS and SMS clear. Can be enabled when required.

You can alter setting by right clicking on the S60 SDK name and selecting Properties. Select the "Technology" tab to move to settings.

Now recheck the settings as above. Click ok to finish. Shutdown NCF using the NCF icon in the bottom right

Configuring emulator for bluetooth

If still not working check the following parameters

  • Important*:- Reboot the PC to reload drivers and flush out old code

Shutdown NCF after reboot, using the NCF icon in the bottom right, don’t want NCF going whilst configuring emulator preferences

Start->All Programs->S60 Developer Tools -> Emulator In emulator Menu Tools-> Preferences.

Select the PAN (Personal Area Network) In bluetooth chose enable.

  • Select COM: = 3
  • Select HCI: = H4

In IrDA Infrared Select COM: = 4 In IrDA chose disable

Click Apply you will get a message about restarting the emulator. Click Ok


Hopefully you will see your real mobile phone (Nokia any BT enabled) that was paired with whilst setting up "S60 2nd Edition Feature Pack 3".

This page was last modified on 17 June 2013, at 07:26.
164 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×