-- README-Symbian
-- Notes, bugs and a todo list for the Symbian (Nokia Series 60) phones --

* Notes *

First of all: Phones supported by this driver so far are:
 * Nokia 3650 (S60 1st)
 * Nokia 6600 (S60 2nd)
 * Siemens SX1 (S60 1st)

untested, but it has to work:
 * S60 1st
   o Nokia 3660
   o Nokia 7650
   o Nokia N-Gage
   o Nokia N-Gage QD
   o Sendo X
 * S60 2nd
   o Nokia 3230
   o Nokia 6260
   o Nokia 6630
   o Nokia 6670
   o Nokia 6680
   o Nokia 6681
   o Nokia 6682
   o Nokia N70
   o Nokia N72
   o Nokia N90
   o Panasonic X700
   o Panasonic X800
   o Samsung SGH-D710
   o Samsung SGH-D720
   o Samsung SGH-D730
   o 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
   o Nokia 3250
   o Nokia 5500
   o Nokia E50-1
   o Nokia E50-2
   o Nokia E60
   o Nokia E61
   o Nokia E61i
   o Nokia E65
   o Nokia E70
   o Nokia E90
   o Nokia N71
   o Nokia N73
   o Nokia N73ME
   o Nokia N76
   o Nokia N80
   o Nokia N91
   o Nokia N92
   o Nokia N93
   o Nokia N93i
   o Nokia N95
 * S80 1st
   o Nokia 9110
   o Nokia 9110i
   o Nokia 9210
   o Nokia 9210i
 * S80 2nd
   o Nokia 9300
   o Nokia 9300i
   o Nokia 9500
 * UIQ 2nd
   o Arima U300
   o Benq P30
   o Motorola A920
   o Motorola A925
   o Motorola A1000
   o Motorola A1010
   o SonyEricsson P800
   o SonyEricsson P900
   o SonyEricsson P910
 * UIQ 3rd
   o SonyEricsson P990i
   o SonyEricsson M600i
   o 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 (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

* Bugs *

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

* TODO *

 * implement the missing things :-)
