Bluetooth PBAP pre 0.46

The following is a summary of those two threads on talk.maemo.org:


 * "Car kit can not access contact information"
 * Announce - Bluetooth PBAP and IrMC / Carkit support is coming to N900....

For further information you might want to check these threads.

Please post to the second one to get support and share your experiences with this solution there as well!!!

PBAP
The Bluetooth Phone Book Access Profile (PBAP) allows to exchange Phone Book objects between carkits and mobile devices. In other words, PBAP profile gives your car unit read access to your mobile phone book (to be exact: to both, the phonebook stored on SIM card and the phone book stored on internal memory. But for the N900 only second one is relevant).

Described in a more specific way, whenever a connection between your carkit and your PBAP enabled phone is established, your phone book will be transfered to your carkit automatically. What happens from now with the transfered phone book of course depends on the features of your carkit. Typical use cases are browse and dial (voice-dial if supported by carkit) your contacts and show caller names for incoming calls. With an integrated In-Car Infotainment/Phone/Navigation/Whatever system it is even possible to use the contacts addresses as target for the navigation system.

By default N900 does NOT support PBAP and thus the in-car use cases described above are either not possible or require manual workarounds as the in other threads described "Petrovich workaround" (manual sending of vCards via Bluetooth) or OPP (Object Push Profile - A Bluetooth profile that enables a Bluetooth device to transfer (push) an object (e.g. contact) to another Bluetooth device).

IrMC
This project also aims to provide IrMC support. IrMC is another method to transfer the phone book to e. g. a car kit via Bluetooth which is by default not supported by N900.

Here comes the good news: NOW YOU CAN HAVE PBAB and IrMC ON YOUR N900 !!!

Credits
Credits for the achieved so far go to those who contributed in the old thread "Car kit can not access contact information" as well as the new thread Announce - Bluetooth PBAP and IrMC / Carkit support is coming to N900...:

Especially the developers: drdrewusaf, tuxy, jarmo2, hschmitt, Ossman, mirakels..., but of course also all the others who helped with testing and troubleshooting!

Disclaimer
!!! CAUTION !!!

This project is still in development stage, which means there are still some risks, downsides and issues to be solved before PBAB on N900 is ready for the average user...(see below).

Please read this summary carefully and evaluate the risks involved for yourself! (Keep in mind that this can cause problems for the phone. Backup your data, backup your config (apps > system > backup) and know how to reflash)

Whatever you do, you are doing it at your own risk!

However, if you want to have PBAB / IrMC and want to help out here -

You are more than welcome as a tester or even developer.

Of course, before you start playing with your phone, you should check if your carkit does support PBAP / IrMC.

If it does not, this solution can not help you - Sorry!

(Note: Carkits older than 2007 probably do NOT support PBAP)

Supported Carkits
So far, successful phonebook transfers were reported for the following carkits:

(If you are able to successfully transfer your phonebook to any carkit not listed here, please let us know or just add to following list!):

Via PBAP:
Built-In Carkits:


 * 2008 BMW 120d
 * 2010 BMW 1series
 * 2008 BMW 318d
 * 2008 BMW 320d with Business Navi
 * 2011 BMW 335d (US with NAV / iDrive)
 * 2008 BMW 535d Touring with Navigationsystem Professional
 * 2009 BMW 5series
 * 2010 BMW X1
 * 2007 BMW X5 E70
 * 2009 Audi A3 (facelift) with Radio Concert and bluetooth preparation
 * 2010 Audi A3 with RNS-E and bluetooth preparation
 * 2009 Audi with RNS-E
 * 2010 Audi A4 with MMI (usable, BUT reads double entries, looks like phonebook is both on N900 and on SIM-card)
 * 2009 Skoda Oktavia from 2009 (Model 2010)
 * 2010 Peugeot 5008 Connect Nav carkit
 * 2009 Seat Exeo
 * 2010 Toyota Prius MY
 * 2007 Ford Mondeo Navigationsystem NX with Touchscreen
 * 2010 Ford Galaxy Navigation with Touchscreen
 * Vauxhall (Model unknown)
 * Citroen (Model unknown)
 * 2010 Mini One

Stand alone devices:


 * Bury AD9060
 * Bury CC9056
 * Parrot MKi9100
 * Parrot MKi9200
 * Kenwood DNX6140
 * Kenwood DNX9960
 * Kenwood HD942U (with KCA-BT200 bluetooth module)
 * Navigon 8410
 * Alpine CDE-103BT (has an inbuilt parrot module)
 * Parrot CK3100
 * Parrot CK3200 LS-COLOR
 * Parrot LG 3200
 * Parrot LS 3200
 * Pioneer AVH-3200BT
 * Garmin nuvi 715

Via IrMC
Built-In Carkits:


 * Citroen C4 hatch 2010
 * Citroen C4 picasso
 * Renault Megane Scenic 2010

Stand alone devices:


 * Kenwood DNX6140
 * Parrot MK6000

Known issues / problems

 * Broken PC Suite connectivity
 * False Maemo 5 update announcement in App Manager
 * In some cases broken file transfer via BT to certain devices
 * Lists for outgoing/incoming/missed calls are not supported (some carkits maintain own lists)
 * Installing/Removing requires manual steps in xTerm



Installation Guide
Mirakels created two deb-files in order to make the installation more user friendly. This installation is based on obexd-0.30 and provides
 * PBAP support
 * IrMC support
 * PC Suite support
 * Multiple phone numbers per contact
 * Skip SIM contact requests (means contacts are not shown twice)
 * vCards are separated correctly with CRLF between ENV:VCARD and BEGIN:VCARD.

Step 0
In case you played with obex on your phone before / had previous versions of this project installed, please perform a downgrade to original version first by following the steps described in section Downgrade to Original State

Step 1
Download these 2 .deb packages provided by mirakels:

libopenobex2_1.5_armel.deb

obexd2_0.30-0maemo1_armel.deb

Step 2
Place them in a folder on the N900, say

Step 3
As root run (replace /home/user/mypackages with the path to the folder where you placed the files):

Step 4
Reboot the phone. Test and ENJOY - hopefully ;-)

-> Please share your results !!!

Old/Obsolete Installation Guide
Note: The following installation steps are not necessary anymore and just kept for better understanding of what was going on so far.

Step 1

Download the following 3 files and copy them to your phone (provided by drdrewusaf):


 * Openobex 1.5-2 libraries
 * Openobex 1.5-2 apps
 * obexd

Step 2

Open a root terminal and navigate to the folder you saved the 3 files in (where "/path/to/files" is the real path to your downloaded files):

Step 3

Install the packages. As root run:

Step 4

Download the latest version of obexd zipped binary provided by mirakels from here

obex download

This version provides:
 * PBAP support (actually the plain PBAP that is in the 0.29 repo)
 * IRMC sync support (only full phonebook retrieves)
 * extra CR/LF between contacts
 * support for multiple phone numbers per contact
 * PC-Suite support (based on the patch test from hschmitt)

BUGS: pbap sends phonebook twice.

Step 5

Replace the current obexd in  with the new one from mirakels, as root run:

Make sure that it is excecutable

Step 6

Edit the obex start command in /usr/share/dbus-1/services/obexd.service:
 * for PBAB include the option --pbap (already added after previous steps),
 * for IRMC include the option --irmc (both is possible too),
 * for PC Suite connection add --capability !/usr/bin/gen-obex-capability.sh

Step 7

Reboot, test and ENJOY - hopefully ;-)

-> Please share your results !!!

Troubleshooting
For troubleshooting install and use hcidump and/or syslog

Download and install hcidump
First you need to add the developer repository, see Documentation/devtools/maemo5.

After adding the repository, run the following command as root:

OR if the above fails, try the following steps:


 * 1) Download the deb-package containing hcidump from here: hcidump download
 * 2) Unpack it (alien on Linux, 7-zip on Windows)
 * 3) Copy   to the N900
 * 4) In xTerm as root:

Usage of hcidump
For testing/debugging with hcidump, run the following command (where "/some/path/somefilename" is a real path and any name you choose for your output file.)

right before turning your head unit/car on. Then, do what you would normally do to get contacts to show up and wait for it to finish/fail. Then, press ctrl+c on the phone to exit hcidump. Finally, you can view the output/dump file with Wireshark or upload your dump files so we can see what's going on.

'''-> Please share your results !!! '''

Install syslogd and enable obexd debug option
For further troubleshooting information you may also want to try to enable obexd syslog debugging messages:

Step 1) Install syslogd. As root run Step 2) Kill running obexd process. As root run Step 3) Restart obexd with enabled debug option. As root run: OR

Add the --debug option in the /usr/share/dbus-1/services/obexd2.service file (for example just before the --nodaemon option).

Step 4)

Sysklogd will create a file

After your test copy this file to some other location (do not delete the original) and edit out the relevant part and post it here.

Downgrade to Original State
To reinstall the original packages:

Step 1
Download these 2 .deb packages:

libopenobex1 1.4

obexd 0.18

Step 2
Place them in a folder on the N900, say

Step 3
As root run (replace /home/user/mypackages with the path to the folder where you placed the files):

Step 4
Reboot the phone.

OR run as root

Reboot the phone.

OR run as root

Reboot the phone.