Gnapplet driver

From GnokiiWiki

1 Supported phones
2 Bugs
3 TODO

Supported phones

This driver should support all 1st and 2nd Edition Symbian phones. If your phone isn't listed below you're welcome to add it or to inform the mailing list.

Phones reported to work with this driver so far are:

Nokia 3650
Nokia 6600
Siemens SX1

untested, but it has to work:

S60 1st
- Nokia 3660
- Nokia 7650
- Nokia N-Gage
- Nokia N-Gage QD
- Sendo X
S60 2nd
- Nokia 3230
- Nokia 6260
- Nokia 6630
- Nokia 6670
- Nokia 6680
- Nokia 6681
- Nokia 6682
- Nokia N70
- Nokia N72
- Nokia N90
- Panasonic X700
- Panasonic X800
- Samsung SGH-D710
- Samsung SGH-D720
- Samsung SGH-D730
- Samsung SGH-Z600

These are Symbian phones that will NOT work with this driver. You can get limited functionality for them with gnokii using AT driver:

S60 3rd
- Nokia 3250
- Nokia 5500
- Nokia E50-1
- Nokia E50-2
- Nokia E60
- Nokia E61
- Nokia E61i
- Nokia E65
- Nokia E70
- Nokia E90
- Nokia N71
- Nokia N73
- Nokia N73ME
- Nokia N76
- Nokia N80
- Nokia N91
- Nokia N92
- Nokia N93
- Nokia N93i
- Nokia N95
S80 1st
- Nokia 9210
- Nokia 9210i
S80 2nd
- Nokia 9300
- Nokia 9300i
- Nokia 9500
UIQ 2nd
- Arima U300
- Benq P30
- Motorola A920
- Motorola A925
- Motorola A1000
- Motorola A1010
- SonyEricsson P800
- SonyEricsson P900
- SonyEricsson P910
UIQ 3rd
- SonyEricsson P990i
- SonyEricsson M600i
- SonyEricsson W950i

Most of the modern phones are based on the Symbian OS. These phones have broken the convention and replaced the traditional FBUS protocol framework by a new one. The new protocol provides synchronizational functionality, but the older one was more powerful. This is one of the reasons we decided that analysis of the new protocol is time wasting. Our plan is to create a client-server application. The client part is built into libgnokii, the server part runs on the phone. These communicate with our own protocol.

The client and the server application is tightly coupled, so you have to use the same version on both side. The source code of the server application (called gnapplet) is licensed under the GNU GPL, it can be downloaded from the gnokii cvs. Compiling gnapplet requires special tools, you can look into gnupoc (http://www.gnupoc.org). Installing the Nokia SDK isn't easy, so we provide a pre-compiled version. You can find the appropriate version in the Docs/ directory of the tarball (called gnapplet.sis).

You can install the SIS file in the same way as another symbian application. You can transfer it to the phone over the OBEX protocol (OBEX is available over IrDA or Bluetooth or cable connection).

You can use the following settings in your gnokiirc to access the phone:

Bluetooth connection

   [global]
   port = _bluetooth_address_
   rfcomm_channel = 14
   model = symbian
   connection = bluetooth

IrDA connection

   [global]
   port = /dev/ircomm0
   model = symbian
   connection = irda

TCP/IP connection

This is disabled by default, you have to edit gnapplet.ini on your phone to enable it.

   [global]
   port = 169.254.1.68:1912	(put the IP address of your phone here)
   model = symbian
   connection = tcp

You have to start gnapplet first (you'll find it in the menu), then start gnokii or xgnokii. After gnokii disconnects (or you won't connect in 30 seconds), the application will terminate.

The current code is able to:

identify the phone
read/write/delete phonebook entries
read/delete call log (missed, received, dialled calls)
read the memory status
read network info
read RF/battery level
read/set clock, read/set alarm
read/write/delete calendar entries
read/write/delete todo entries
send/receive sms
read profile entries, read/set the active profile

Bugs

phonebook handling is quite limited:
- name isn't set or read correctly
- missing attributes
- no group handling
- missing SIM memory handling
gnapplet seems to not work on SymbianOS v3 devices (eg. Nokia 5500)