**********************************************************************
*  Before installing v0.14a on your pilot, write down your config    *
*    if your current version is working and DELETE ANY OLDER VERSION *
**********************************************************************

The last informations are available at
        http://www.cybermail.net/~dbertran/faxpage.htm


 FAX 0.14 Alpha for USR PalmPilot  (5/30/97)

  For testing purpose only. NO COMMERCIAL USE ALLOWED.

 This document presents the first release of a program
intended to send faxes directly from the USR PalmPilot,
without the need of being connected to a Desktop.

DISCLAIMER

  As said previously, this program is in the early stages of
alpha testing and comes without warranty. The author of the
program can't be held responsible for some loss of data or damages
caused by it.

***************************************************************
*  BE SURE TO HAVE AN UP TO DATE BACKUP OF YOUR PILOT BEFORE  *
* TRYING THIS PROGRAM !!!                                     *
***************************************************************

REQUIREMENTS AND FUNCTIONS

 The program should work on both new and old pilots as it doesn't use
any of the functionalities of the last releases. (The development started
with a Pilot 5000 and now goes on with a PalmPilot Professional). I've not
tested the access to the MemoPad data on a Pilot 5000 or 1000. (I Hope the
database name was the same)

 To send a fax follow the next steps :
        1 - Choose the source
        2 - If the source is MemoPad, choose the record
        3 - Press the Send button

MANUAL

I - Configuring the page
--------------------------

 Tap on Menu then on Page Config in the Config Menu.

FAX ID : The identification string of your pilot. It will be sent
  to the remote fax to be stored in the reception journal.

SENDER NAME : Your identification which will be displayed in the header of
  the page

RESOLUTION : Normal or fine resolution. ONLY THE NORMAL RESOLUTION IS
  CURRENTLY SUPPORTED

ADD A HEADER, ADD A FOOTER : Enable you to add or remove the header or the
  footer

CHAR SIZE : Size of the characters in the body of the message. (2 or 3 is fine)

FONT : Choose one of the three fonts available to use as your default font
   in your faxes.
   You can also format the lines of your fax with different fonts
   (see FORMATTING the fax text)

LEFT and RIGHT margin : Those numbers are the values in cm of the margins
   that the fax will leave to the left and to the right of the page.
   Be careful, in this version, no validity test is implemented for those
   settings.

II - Configuring the communication
------------------------------------

 Tap on Menu then on Modem Config in the Config Menu

SPEED : The communication speed
        9600  ->  Pilot to Modem at 9600 Bds and Modem to remote fax at 9600 Bds
        19200 ->  Pilot to Modem at 19200 Bds and Modem to remote fax at 14400 Bds

LOCALLOOP : If this is checked, the modem will not dial any number. This enables
 you to connect your modem directly to your fax in the same room. It's what
 I use for test purposes, but IT'S PROBABLY NOT VERY GOOD FOR IMPEDENCE LEVELS.
 DO THAT AT YOUR OWN RISKS !!! The hardware is not designed for that use !!!

WAIT FOR XON : If this is checked, the program will wait for an XON from
 the modem before sending the data. Some modem don't require that (if think USR)
 so if it doesn't work with this checked, try unchecking it. Good luck !!!

USE CTS/RTS : If this box is checked, the CTS/RTS signals will be used . With
 some modems this can help. It seems that using CTS/RTS is the only
 way to "talk" to Pilot Modems. IF YOU HAVE A PILOT MODEM, check this 
 boxes.

USE XON/XOFF : This box is new in this version. The previous versions
 were always using XON/XOFF. If you uncheck this box, be sure to have
 USE CTS/RTS checked as a flow control method is needed.
 If you get some 'Comm Rec ...' errors when sending the fax, try unchecking
 this box.

MODEM TYPE : Try CLASS 2 first. If it doesn't work, try CLASS 2.0
 CLASS 2.0 is still not fully implemented. 

INIT STRING : Initialisation string for the modem. This string
 MUST PUT THE MODEM in the XON/XOFF mode for communication between
 Pilot and Modem

IDENT STRING : String Sent to Identify the modem when you request it in
 the menu.

DIAL PREFIX : The string of characters preceding the the number to dial.
 Typically ATDT for Tones and ATDP for Pulses.

TIMEOUT : This is the delay in seconds that the program will wait
 for an answer when attempting to connect to a remote fax.


III - Viewing the Log.
------------------------

 The program records the characters sent and received. Use Menu|Config|View log
to read this trace. The trace is erased each time you use the program.

 The "To Clipboard" button will copy the log to the clipboard. You can then
paste it to a memo and retrieve it on your PC.

IV - Sending a fax
--------------------

 FORMATTING the text of your fax

In this version , you can change the font used by the program to generate
the text of the fax. You can mix fonts in the same message, not on the same
line.

If a line contains              this line and the next lines will use

   &s                                   the Standard Font
   &l                                   the large font (Default)
   &b                                   the bold font

 In the fax application, select the source and the record if the source is
MemoPad. Then press the Send button.

V - Notes
-----------

* The clipboard has a limited capacity (1024 Bytes I think).
* The fax size is only limited by the size of the memory available
 (64K maxi in one heap) if sending a memopad report. However, I don't know
 for sure what would happen when running out of memory.
* You'll see some erasing problems in the texts displayed in some
 message boxes. This will be soon fixed, but I wanted to get some
 bug reports on the memopad feature very quickly.
* Always have a backup up to date. One of the previous versions
   completely crashed my Pilot. Only a hard reset worked.

VI - Configuration Tips
-------------------------

Reports from users

 Here are some settings that some users are using successfully with the Fax
application :

PILOT MODEM
        Speed           19200 or 9600
        Wait For XON    Yes (If it doesn't work, try No)
        Use CTS/RTS     Yes
        Use XON/XOFF    No (try Yes if it doesn't work)
        CLASS 2
        Init String     ATZ&K3 if XON/XOFF if false
                        ATZ&K4 if XON/XOFF if true
                         or AT&FX4 or AT\g1
        Ident String    ATI4
        Dial Pref       ATDT

USR SPORTSTER Voice 33.6 FaxModem
        Speed           19200 or 9600
        Wait For XON    Yes
        Use CTS/RTS     As you want
        CLASS 2
        Init String     ATZ&K4
        Ident String    ATI4
        Diat Pref       ATDT

OLITEC 28800 (Rockwell based)
        Speed           19200 or 9600
        Wait For XON    Yes
        Use CTS/RTS     As you want
        CLASS 2
        Init String     ATZ&K4
        Ident String    ATI4
        Diat Pref       ATDT

  The page at http://www.cybermail.net/~dbertran/faxpage.htm may be more
 up to date.



Works also with Zoom Pocket Modem but nobody gave me any config

VII - Troubleshooting
---------------------

 Try to follow the configurations below if it doesn't work :


   1) CLASS 2, Wait for XON On, 19200 Bds
   2) CLASS 2, Wait For XON On, 9600 Bds
   3) Idem 1 but Wait for XON off
   4) Idem 2 but Wait for XON off

   If none work, try the configs above with CLASS 2.0 set.
   If even the Modem Identification doesn't work, try with CTS/RTS checked
   If you get comm errors when transmitting, try to uncheck USE XON/XOFF.
  
  

 Have fun !!!

 Please email me the description of your config (Pilot type, Modem type,
Modem Config) if your modem is not listed above and a copy of the log for
any problem if you wish to help making this app better.

 Also have a look at http://www.cybermail.net/~dbertran/faxpage.htm

 D.BERTRAND (dberdran@gville.mindspring.com)



