wiki:plugins/gnokii-sync

Introduction

The gnokii-sync allows Nokia mobile phone to do a local synchronization. Gnokii supports synchronization via serial cable, bluetooth and USB. The latest version of gnokii provides a libusb driver for DKU2 cables. In openSUSE 10.2 Beta 2 there is no permission by default to access the USB raw device of your mobile phone as desktop user. We are planning to provide permission for the desktop user by default in the next version. To get this done we need the USB product and vendor ids of mobile phones, to identify the mobile phones and give the desktop user the permission. So, Please! Add your mobile phone to the "Tested Device" section.

Supported Objects Types

Contacts: YES Events: YES Todos: NO Notes: NO

Supported Devices

Nokia

{| border="1" ! Model !! Firmware !! Bluetooth !! USB !! USB Product ID !! USB Vendor ID !! Tester !! comments

| 6230
v5.50 {{y}} {{y}} 0x421 0x40f [[User:dgollub|dgollub]] With a firmware >= v5.50 it supports SyncML via OBEX

|}

Plugin Configuration

Connection

  <Connection>
    <ActiveConnection>Bluetooth</ActiveConnection>
    <Bluetooth>
      <MAC></MAC>
    </Bluetooth>
    <Serial>
      <DeviceNode></DeviceNode>
    </Serial>
  </Connection>

Resources

  <Resources>
    <Resource>
      <Enabled>1</Enabled>
      <Formats>
        <Format>
	  <!-- here it might also be "gnokii-contact", I am not sure about which one to set. -->
          <Name>xmlformat-contact</Name>
        </Format>
      </Formats>
      <Name>Contacts</Name>
      <ObjType>contact</ObjType>
    </Resource>
    <Resource>
      <Enabled>1</Enabled>
      <Formats>
        <Format>
	  <!-- here it might also be "gnokii-event", I am not sure about which one to set. -->
          <Name>xmlformat-event</Name>
        </Format>
      </Formats>
      <Name>Calendar</Name>
      <ObjType>event</ObjType>
    </Resource>
  </Resources>
</config>

Testcase Basics

For the following testcases you have to configure the command line tool gnokii.

Create a ~/.gnokiirc for Bluetooth connections:

[global]
connection = bluetooth
port = 00:0E:ED:61:6C:4D
model = 6230

[logging]
debug = on

or IrDA:

TODO

or USB connection with DKU2 cable:

[global]
connection = dku2libusb 
port = anything
model = 6230

[logging]
debug = on

In openSUSE 10.2 Beta 2 you will need root access. Please add your USB product and vendor code of your mobile phone to the "Test Device" list, so in the next release you can use your mobile phone by default as desktop user.

Testcases

The first testcases test only the basics of libgnokii, to see if libgnokii is full compatible with your mobile phone. In the end we will test gnokii-sync itself and synchronize all contacts and events in a directory (file-sync)

Connection test

gnokii --identify

Read contact entries

gnokii --getphonebook ME 1 end
gnokii --getphonebook SM 1 end

Read calendar entries

gnokii --getcalendarnote 1 end

Troubleshooting

Newer kernels (as of 2.6.34.7) provide the phonet and cdc_phonet modules which are not compatible with gnokii for the moment. You should remove them with rmmod and put them on the blacklist (in /etc/modprobe.d/50-blacklist.conf on openSUSE) if you encounter any connection issue.