      
               ---- PSION MC-400 DTMF Dialler Utility v1.0 ----  Apr. '95
      
      This ZIP file should contain:
      
           MCMF.OPO    The OPL executable
           MCMF.ICN    An Icon for installing MCMF into System window
           MCMF.OPL    The OPL source
           MCMF.TXT    This File!
   
      This utility written by Chris Farrow (cxf@cix.compulink.co.uk).
      
      Credits
      -------
      
      The OPL implementation of "Bring" used  in this program is based on  code
      originally written in C by Colly Myers and translated to Series 3 OPL  by
      Tom Dolbilin, adapted for the MC with help from David Wood at Psion.
      
      Disclaimer
      ----------
      
      You are free to use and modify MCMF  and the OPL source as you wish,  but
      the author cannot be held responsible for any problems or data loss  that
      may arise, from use of this program, modified or otherwise. This  program
      has only been tested on an MC-400 (Word) V2.60F.
      
      MCMF v1.0
      ---------
      
      This utility has two modes of operation:
      
      (i)  Edit Mode:  The number to  be dialled is entered  and can be  edited
      before pressing  <Enter> which  will cause  any diallable  digits in  the
      input string to be dialled.
      
      (ii)  Free-form  Mode:  Any  diallable  digit  entered  will  be  dialled
      immediately.
      
      The following parameters are changeable, and  are stored in a setup  file
      (MCMF.DEF) when the program runs.
      
           Tone time
           Delay time
           Pause time
           Tone volume
      
      Also the current mode of the program is stored so that when next run,  it
      will start up in the mode it was last used in.
      
      It is possible to "bring" data into  the dialler (Edit mode only) in  the
      same way as the native MC apps. For example, find an entry in a  database
      file, highlight the no. you  want to dial, switch  to MCMF and bring  the
      number on to the input line.
      
      
      Running MCMF
      ------------
      
      To install  MCMF into  the system  window, copy  the files  MCMF.OPO  and
      MCMF.ICN to the same directory on a local MC disk. From the system window
      select "Install..." (Psion-V). Use  the file selctor  to navigate to  the
      directory where you put MCMF.OPO and select this file. The telephone icon
      should now appear in the system window.
      Whenever MCMF is run it will look for a file in the root directory of the
      default drive called "MCMF.DEF", which  contains default values for  tone
      time and delay  time etc.  If it  is not present,  MCMF will  ask you  to
      confirm or change the defaults, and then create the file.
      The settings are:
         Tone Time: The time the MF tone is actually present
         Delay Time: The time between the MF tones
         Pause Time: The time the "," charcater pauses for (see below)
         Tone Volume: The volume the tone is played at, Quiet, Medium or  Loud
      Once the defaults have been set up,  you will be presented with a  screen
      like this:
      
                 --- MC-400 DTMF Dialler ---
      
             Input No. to be dialled then <Enter>
      
        ("U <Enter>" changes defaults, "X <Enter>" exits)
       ("L <Enter>" brings data, "M <Enter>" changes mode)
      
       ->
      
      Any text entered  will appear by  the cursor ("->"),  the delete key  and
      cursor keys are available to move along  the input line and edit it.  The
      escape key  will clear  the contents  of the  input line.  The number  is
      dialled by pressing "Enter". Diallable characters are  "0123456789ABCD*#"
      and ",". The "," character is used  to insert a delay (the time of  which
      is alterable), for instance if dialling via a PABX, where a dial-out code
      is needed, followed by  a pause before a  second dialling tone is  heard.
      Any non-diallable characters are  ignored and stripped  out of the  input
      string, so it doesn't matter if you  ener a number as "0151 254 3000"  or
      "0151-254-3000". After dialling a number  the previous string remains  on
      the input  line, and  is  available for  re-editing or  re-dialling.  The
      "Escape" key clears the input line.
      Should you wish to alter the default tone times etc. then enter "u" on  a
      blank line (Case is not important), and MCMF will allow you to change the
      settings. Currently all times are in 1/24ths of a second and are  minimum
      1/24ths and maximum 99/24ths.
      In Free-form mode the digit entered is dialled instantly and displayed by
      the cursor.
      Entering "x"  on a  blank line  exits  the program  (again, case  is  not
      important).
      
      I have  had a  100%  success rate  using this  program  to dial  on  many
      different types  of  phone, I  have  found that  holding  the  microphone
      approx. 10cm over the MC speaker gives best results.
      
      
      Limitations
      -----------
      
      Firstly, me! I do not pretend  to be the world's greatest programmer  and
      although I have tried to make this program as resilient as possible there
      are bound to be  some situations I have  overlooked. The delay times  are
      implementend with the OPL command "pause"  and as such cannot be  exactly
      guaranteed by  the system,  so you  may notice  irregular pauses  between
      digits. This should  not cause  any problems  though as  the delays  will
      always be *longer* than specified.
      In Free-form mode, don't dial too quickly! The program cannot respond  to
      input as quickly  as you  can type  it. At  present only  the last  digit
      dialled is displayed - this may change in future versions.
      If the Link is running and active (i.e. you are transferring files)  then
      there will be some degradation in  the quality of the MF tones,  possibly
      to the extent that they may  not be recognised by the telephone  network.
      For this reason it  is wise not  to attempt to use  this program to  dial
      while there is lots of background activity on the system.
      
      Any  bug  reports   or  comments   welcome,  preferably   by  e-mail   to
      cxf@cix.compulink.co.uk or failing that (as  a last resort only  please!)
      by phone to 01704 833776.
      
      Chris Farrow 3/4/95
