PhoneMan for PalmOS 1.4.0
=========================

Contents
========

0   - Thanks
1   - What's new
2   - Features
3   - Operation
4   - Tested configurations
5   - Feedback
6   - Trouble shooting
6.1 - Ir connectivity
6.2 - PalmOS version < 3.3
6.3 - Ericsson SH888
6.4 - Motorola Timeport
7   - Coming soon to a PhoneMan near you
8   - Bug fixes
9   - License
10  - Disclaimer
11  - Copyright


0. Thanks
=========

Hi, thanks for trying PhoneMan for PalmOS devices.

If you wish to use PhoneMan after evaluating it then please register the application. See www.pinpoint-software.com for details on registering the application. Once registered you will be entitled to free upgrades when they become available.

See Trouble shooting below about downloading an IR update for the Palm so the PhoneMan will function correctly.


1. What's new
=============

PhoneMan is now freeware!

2. Features
===========
* Read phone book from the phones memory and SIM card - extended phone book support for Nokia 6210/7110 phones
* Sort phone book.
* Copy back phone book entries to the phone.
* Modify phone book entries or add new ones.
* Read SMS from the phone and SIM.
* Send new SMS.
* Delete SMS as they are being read form the phone (see preferences screen to turn this on of off).
* Delete SMS on the phone or SIM card.


3. Operation
============

The first time PhoneMan is run it is suggested that you go to the preferences screen and select the settings that best suit your configuration.

Note that you will need to find out the SMS service centre number if yoo want to send SMS. Please refer to your phone and or network operator. There is a list of operator SMS centre numbers at : http://home.swipnet.se/OsbyMikro/smsc.txt I don't know how up to date this list is.

**** NEW in 0.93 ****

The date & time display in the SMS view has made it neccessary to change the format of the applications database. The application can no longer read the old databases. It is recommended that you delete any previous version of PhoneMan.

There are two main views in PhoneMan. The PhoneBook view which shows the phone book entries that have been entered or downloaded from the phone.

To enter a new entry press the "new" button which will take you to the PhoneBook entry view where you can enter the details of the new entry. When you have finished press OK to save the entry of Cancel to discard it.

Tapping on an entry will highlight it and a second tap will popup a small list of functions that can be performed on that entry. These functions are:
* Modify - Edit this entry.
* Dial   - Dials this number.
* SMS to - Puts the app in the SMS entry view with the number already filled in.
* Delete - Deletes the entry without asking if you are sure - you have been warned !!!

Pressing the Sync button the app will prompt you for which memory that you would like to sync with. Upon pressing either button the app will connect to your phone and down load all the entries from the selected memory. On completion you will be prompted with the following choices:
* Cancel - ignores downloaded phone book
* Merge -  Merges the downloaded phone book with the one already in the apps memory.
* Replace- Replaces the phone book in the apps memory with the phone book just down loaded.

To copy the current phone book to the phone press the menu button and select commands->copy to phone. This will then prompt you for which memory you would like to copy to. Then it will connect to the phone and upload the phone book.

**** New in 1.0.1

To sort the phone book press the menu button and select sort entries. You can then select the sort criteria. The choices are "By name" or "By number". After making a selection the entries will be sorted.

To go to the other main view press the "SMS View" button. By tapping the popup arrow in the top right corner you can select either "inbox", "outbox" or "sent" catagories.
When a SMS is selected a preview of the message will apear in the bottom part of the screen. This preview is not editable.


**** NEW in 0.92 ****

You can now go to the inbox, outbox and sent view by selecting them from the drop down list in the top right corner.

In this view if you press the new button you will taken to the new SMS view. To make a new SMS enter the recipients number in the To field. Then enter your message in the field below. Note that the maximum size of a SMS message is 160 characters.

There are two ways of sending the message. To send it straight away press the send button (make sure the Palm is pointing at the phone). The other way of sending the SMS is to move it to the outbox and send it later.

If you go to the outbox view you can tap on an entry (if there are any) and with a second tap you will get a popup list:
* Send - sends the selected SMS
* Edit - takes you back to the SMS entry view
* Delete- Deletes the SMS.

In the Inbox view the popup menu allows you to
* Reply - Puts the app into the SMS entry view with the number filled out
* View - Puts the app into a full screen non-editable view of the message.
* Delete - deletes the SMS.

**** NEW in 0.93 ****

In the SMS views the date and time of the SMS is visible. To change the format of the date go to the preferences dialog and choose the appropriate setting from the drop down list.

**** NEW in 1.0.1 ****

To help facilitate defect tracking a logging feature has been added. To enable logging go to the preferences dialog and select "enable logging". The logging feature will be turned off when PhoneMan is restarted. Once started the logging facility will write all communications between PhoneMan & a phone to a new memo. The new PhoneMan log can be read by the built in memo app found on the PalmOS device.

When the PalmOS device is next HotSync'd the memo database will be transfered to the PC. If you have MS Outlook then the log will appear in the notes section. Please use this note when reporting problems with PhoneMan. If you don't have Outlook, then it should be possible to access the log by starting the Palm desktop application then selecting the memo. You can then copy & paste the log into a mail when providing feedback.

Please note that any personal information within logs sent to SGSoftware.com Limited will only be used for debugging of PhoneMan and will be destroyed after use.

**** NEW in 1.2.5 ****

BlueTooth support
=================

Once you have installed the Bluetooth card and software you will need to pair the Palm and a phone (see the bluetooth documentation).
To use BlueTooth from PhoneMan select "BlueTooth Phone" in the preferences screen. At the moment PhoneMan will only connect to the last device in the trusted device list (I will add a choice list later).
That's all there is to it. You can now enable BlueTooth on the phone and you should be able to communicate with it.



4. Tested configurations
========================

During development PhoneMan as been tested with the following configurations have been used and work:
Palm Tungsten T and Ericsson R520 (Bluetooth & IR), Ericsson T610 (Bluetooth & IR), Nokia 6310i
Palm IIIx (OS 3.1) and Ericsson SH888,Nokia 6210/7110(including extended phonebook), Motorola Timeport & Nokia 6150
Palm V (OS 3.3) and Ericsson SH888,Nokia 6210/7110(including extended phonebook), Motorola Timeport, Ericsson R380 & Nokia 6150
Palm IIIc (OS 3.5)and Ericsson SH888,Nokia 6210/7110 (including extended phonebook), Motorola Timeport & Nokia 6150, Samsung SGH-300
Palm m505 (OS 4.0) Nokia 6210/7110 (including extended phonebook), Samsung SGH-300, Ericsson R520(BlueTooth mode)


5. Feedback
===========

If you are sending a bug report please be a specific as possible in the description of the fault as possible including what configuration you are using. Also, if you able reproduce the fault then please make a log (see above on how to make logs) and attach it to the feedback.


6. Trouble shooting
===================

6.1. Ir connectivity **** New in 0.92 ****
--------------------

**** New in 1.1 ****

For Nokia 61xx users you can ignore the text below as PhoneMan doesn't need the Ir enhancement to support these phones. Just select the Nokia 6110 phone in the preferences screen and the comms will automatically be selected.


You only have to install the IR update if you have PalmOS < 3.3. To see which version of PalmOS you have go to"info" selection in the "app" menu from the main PalmOS screen (e.g no apps running). To find the PalmOS version press the version button and you will see the PalmOS version at the top.
If you have PalmOS >= 3.3 i.e. Palm V or Palm III with the upgraded ROM or Palm Vx or Palm IIIx then PhoneMan will detect this and will be able to communicate via the Ir port without any further users interaction. 
Hopefully users with keyboards will be able to use PhoneMan and their keyboards simultaneously, though I can't test it as I don't have keyboard - if anybody can test this for me it would be great.


6.2. PalmOS version < 3.3
-------------------------

You will have to install the IR update on your Palm device before PhoneMan will work. This update is currently available at : http://www.palm.com/support/downloads/irenhanc.html
However, it might move one day so you might have to search a bit. You have to install all of the update.
To make PhoneMan work with the update go to the prefs app and select "Serial/IR" from the drop down list, then choose "Infrared".
Please note on Palm III (I have tried it with a IIIx) devices selecting "Infrared" will stop the cradle hotsyncs working. To re-enable hotsyncs you will have to select "Cradle".


6.3. Ericsson SH888
-------------------

If you have an Ericsson SH888 (or possibly other Ericsson phones) select Ericsson SH888 in the preferences view. If you forget this you will encounter problems with international numbers when they are stored in the phone.


6.4. Motorola Timeport
----------------------

Support for this phone has been enhanced. Now when multiple copies of SMS are no longer downloaded from the phone.

6.6. Ericsson R380s
===================

As mentioned above it seems impossible to read SMS from this phone. Sending SMS works though as does reading the phone book from the SIM.

6.7. Ericsson R520m (Bluetooth)
===============================

Sometimes (most times on my R520) this phone will hang when reading the phone book. This seems to be an issue with the phone.

6.8. Nokia 6310
===============

PhoneMan can read, write & erase the extended phone book via Ir. Bluetooth should work, but you'll need a version of the 6310 SW that can pair with the Palm


7. Coming soon to a PhoneMan near you
=====================================
* Send & receive ICQ messages as SMS
* Nokia 7110 extended phone book support
* Long SMS.
* Multiple recipients.
* Custom phone book catagories.
* Custom SMS catagories.
* Send operator logos to Nokia phones.
* Send ring tones to nokia phones.

8. Bug Fixes
============
0.9.1 Removed some debugging code.
0.9.2 Removed the need for Ir update with OS >= 3.3
0.9.2 Added move to SMS/Phonebook views from drop down lists.
0.9.2 Fixed various comms related crashes.
0.9.3 Fixed bug reading phone memory phone book.
0.9.3 Fixed scroll bar update.
0.9.3 Added date and time to SMS views
0.9.3 Improved SMS send acknowledgement handling
0.9.3a Fixed sending SMS larger than 127 chars
0.9.3a Fixed phonebook view display problem
0.9.3a Increased comms timeout duration 
0.9.5  Fixed copy phonebook to phone bug
0.9.5 Fixed delete sms as read
0.9.5 improved comms timeout errors - should work with more phones.
1.0.1 Added logging
1.0.1 Added sorting
1.0.2 Added Nokia 8290 option.
1.0.2 Fixed phonebook processing bug
1.0.2 Fixed down loading SMS from Timeport bug.
1.1   Added phonebook support for Nokia 61xx phones.
1.1   Fixed view drawing funnies
1.1.1 Added SMS get, send & delete for 61xx
1.1.1 Added dial number for 61xx
1.1.1 Improved 61xx comms - hopefully
1.1.2 Fixed registration bug
1.1.2 Scroll bar fix
1.1.2 delete SMS fix for some Nokia phones
1.1.3 SMS view problem fixed
1.1.3 Receiving SMS > 50 chars fixed for Nokia 61xx
1.1.4 Fixed SMS number decoding bug.
1.2   Added extended phonebook functionality
1.2   Swapped name & number positions on screen
1.2   Fixed SMS sending error with SMS centres with more than 10 numbers
1.2.1 SMS scroll bar logic improved.
1.2.1 Adding phone book entries(non 7110 mode) fix
1.2.1 IR comms work around for m505 Palms - still not 100% with my 7110
1.2.1 Can now add fields correctly.
1.2.2 Can now write entries back to the 6210 & 7110
1.2.2 Fixed modify dialog problems
1.2.2 various fixes in other phone comms code
1.2.3 Imporved ineternal memory management.
1.2.3 Added text mode SMS support for Samsung phones
1.2.3 Added address book import.
1.2.3 IrDa fix for m50x Palms.
1.2.4 Fixed phone book write problem
1.2.4 Fixed Samsung handling
1.2.5 Fix address book import keeping names from previous entries
1.2.5 Added initial BlueTooth support
1.2.5 Updated IrDa driver
1.2.5 Fixed some spurious crashes
1.2.5 Fixed date problem with SMS view
1.2.5 Can now erase entries on 6210/7110
1.2.5 Fixed reading large phone books on 6210/7110 by reconnecting to phone
1.2.5 Added delete all sms from sms views
1.2.5 Add read support for 6310 via Ir
1.3.0 Add write support for 6310 via Ir
1.3.1 fix comms code for 6310i
1.3.1 Add erase support for 6310

9. License
==========

PhoneMan is not free software. You are licensed to use this software for evaluation purposes without payment for a period of 30 days. If you use this software after the 30 days evaluation period a registration payment is required. When payment is received you will be sent an unlock code which can be entered into the software. The code you are sent will work in later releases of the software unless otherwise stated on the release notes of the update. An update fee maybe payable for major updates to the software.

The evaluation version of PhoneMan may be freely distributed as long as it is kept in its original form and no charge is made for it in anyway whatsoever without the prior written agreement from Pinpoint Software.

10. Disclaimer
==============

Pinpoint Software will not accept any claims for loss of data due to the use of this application.


10. Copyright
=============

Copyright 2004 Pinpoint Software