Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.
Nokia Connectivity Framework
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
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.
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.
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.
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
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
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
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.
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"
Click the "x" for bluetooth and InfraRed.
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".