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.