LDFLAGS -> LDLIBS
[gnokii.git] / Docs / README-3810
1 -- README-3810                                     --
2 -- Notes, bugs and a todo list for the 3810 series --
3
4 * Notes *
5
6 Phones in the 3810 series that have been tested to date are
7 3110, 3810, 8110, 8110i with either the DAU-4F cable or in
8 one or two cases a home made cable.  Specific phone/
9 network combinations appear in the main README file.
10
11 After some digging in to the protocol it has become apparent
12 that there aren't many more functions we can support, compared
13 to our 5110/6110 cousins!  Remaining functionality which I would
14 like to add appears in the To-do section below, suggestions
15 are welcome.
16
17 The code for reading/writing phonebook entries has had limited testing
18 but the read code is believed to be solid.  It has been observed
19 that the write code occasionally fails to write a location for
20 reasons as yet unknown.  The format of the input to the write
21 option is relatively unforgiving and does only very basic parsing.
22 This format should be compatible with the output from the Windows
23 NCDS software.
24
25 Routines for retrieving SMS messages have been tested and appear
26 to be bug free.  The 3810 used for testing appears to ignore the
27 memory type field however. 
28
29 Sending SMS is still something of "black art".  This has been tested
30 on a 3810 on the Australian Optus/Hutchison network.  Most of the
31 time the messages are sent as expected but occasionally they
32 fail for no apparent reason.  The code is designed to re-try up
33 to four times before giving up if a 0x65 0x26 response is received.
34
35 Sometimes however error codes are seen 0x65 0xYY, the meaning
36 of which is unknown.  Any light you can cast on this is welcome.
37 It is possible that switching off the phone and switching
38 on again may help but this may be just a coincidence.
39
40 It should also be noted that the SMS header message sent by
41 FB38_TX_Send0x23_SendSMSHeader code has no less than 10 bytes
42 in it that aren't understood.  The values used are simply those
43 that have been observed.  They may have to be totally different
44 on your network :(  They may inadvertently route the message to
45 a distant land or just not work at all.
46
47 Having said all of the above about SMS sending, a number of people
48 have now tested SMS sending on various networks around the world and
49 in the main have found it to work correctly.
50
51 * Functionality *
52  
53 The following functions/facilities are available for the 3810 series
54 phones.
55
56 - Retrieving and writing single or multiple phone book entries from
57   either SIM or (in the case of the 8110s) internal memory.
58   
59 - Retrieving and deleting single or multiple stored SMS messages from
60   either SIM or (again in the case of 8110s) internal memory.
61   
62 - Sending an SMS message to a specified recipient via a specified
63   message center number.
64   
65 - By way of a message in --monitor mode, receive notification 
66   of the following occuring;
67   
68   + Incoming call being received, answered and hung up.
69   + Outgoing call being made, answered and hung up.
70   + Incoming SMS message
71   + Current phone status (connected to network, call progress etc.)
72
73 - Retrieve current RF and battery level
74   
75 - Retrieve IMEI, Model and Revision information
76
77  
78 * Known Bugs *
79
80 fbus-3810 code cannot (yet) automatically determine the maximum
81 length of the name and phone number fields in the SIM.  Similarly
82 it cannot yet determine the maximum number of SIM locations. 
83 These are defined in fbus-3810.h
84
85 The status (read or unread, sent or unsent) of SMS messages
86 retrieved from memory is not known so these flags are always
87 set to read / sent.
88
89 * To-do *
90 Add support to automatically determine the maximum number of SIM
91 entries and lengths of phonebook and name fields.
92
93 Try building under Win32 and report success/failure to the list.