home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / MCMF10 / MCMF.TXT < prev   
Encoding:
Text File  |  1995-04-03  |  6.4 KB  |  136 lines
  1.       
  2.                ---- PSION MC-400 DTMF Dialler Utility v1.0 ----  Apr. '95
  3.       
  4.       This ZIP file should contain:
  5.       
  6.            MCMF.OPO    The OPL executable
  7.            MCMF.ICN    An Icon for installing MCMF into System window
  8.            MCMF.OPL    The OPL source
  9.            MCMF.TXT    This File!
  10.    
  11.       This utility written by Chris Farrow (cxf@cix.compulink.co.uk).
  12.       
  13.       Credits
  14.       -------
  15.       
  16.       The OPL implementation of "Bring" used  in this program is based on  code
  17.       originally written in C by Colly Myers and translated to Series 3 OPL  by
  18.       Tom Dolbilin, adapted for the MC with help from David Wood at Psion.
  19.       
  20.       Disclaimer
  21.       ----------
  22.       
  23.       You are free to use and modify MCMF  and the OPL source as you wish,  but
  24.       the author cannot be held responsible for any problems or data loss  that
  25.       may arise, from use of this program, modified or otherwise. This  program
  26.       has only been tested on an MC-400 (Word) V2.60F.
  27.       
  28.       MCMF v1.0
  29.       ---------
  30.       
  31.       This utility has two modes of operation:
  32.       
  33.       (i)  Edit Mode:  The number to  be dialled is entered  and can be  edited
  34.       before pressing  <Enter> which  will cause  any diallable  digits in  the
  35.       input string to be dialled.
  36.       
  37.       (ii)  Free-form  Mode:  Any  diallable  digit  entered  will  be  dialled
  38.       immediately.
  39.       
  40.       The following parameters are changeable, and  are stored in a setup  file
  41.       (MCMF.DEF) when the program runs.
  42.       
  43.            Tone time
  44.            Delay time
  45.            Pause time
  46.            Tone volume
  47.       
  48.       Also the current mode of the program is stored so that when next run,  it
  49.       will start up in the mode it was last used in.
  50.       
  51.       It is possible to "bring" data into  the dialler (Edit mode only) in  the
  52.       same way as the native MC apps. For example, find an entry in a  database
  53.       file, highlight the no. you  want to dial, switch  to MCMF and bring  the
  54.       number on to the input line.
  55.       
  56.       
  57.       Running MCMF
  58.       ------------
  59.       
  60.       To install  MCMF into  the system  window, copy  the files  MCMF.OPO  and
  61.       MCMF.ICN to the same directory on a local MC disk. From the system window
  62.       select "Install..." (Psion-V). Use  the file selctor  to navigate to  the
  63.       directory where you put MCMF.OPO and select this file. The telephone icon
  64.       should now appear in the system window.
  65.       Whenever MCMF is run it will look for a file in the root directory of the
  66.       default drive called "MCMF.DEF", which  contains default values for  tone
  67.       time and delay  time etc.  If it  is not present,  MCMF will  ask you  to
  68.       confirm or change the defaults, and then create the file.
  69.       The settings are:
  70.          Tone Time: The time the MF tone is actually present
  71.          Delay Time: The time between the MF tones
  72.          Pause Time: The time the "," charcater pauses for (see below)
  73.          Tone Volume: The volume the tone is played at, Quiet, Medium or  Loud
  74.       Once the defaults have been set up,  you will be presented with a  screen
  75.       like this:
  76.       
  77.                  --- MC-400 DTMF Dialler ---
  78.       
  79.              Input No. to be dialled then <Enter>
  80.       
  81.         ("U <Enter>" changes defaults, "X <Enter>" exits)
  82.        ("L <Enter>" brings data, "M <Enter>" changes mode)
  83.       
  84.        ->
  85.       
  86.       Any text entered  will appear by  the cursor ("->"),  the delete key  and
  87.       cursor keys are available to move along  the input line and edit it.  The
  88.       escape key  will clear  the contents  of the  input line.  The number  is
  89.       dialled by pressing "Enter". Diallable characters are  "0123456789ABCD*#"
  90.       and ",". The "," character is used  to insert a delay (the time of  which
  91.       is alterable), for instance if dialling via a PABX, where a dial-out code
  92.       is needed, followed by  a pause before a  second dialling tone is  heard.
  93.       Any non-diallable characters are  ignored and stripped  out of the  input
  94.       string, so it doesn't matter if you  ener a number as "0151 254 3000"  or
  95.       "0151-254-3000". After dialling a number  the previous string remains  on
  96.       the input  line, and  is  available for  re-editing or  re-dialling.  The
  97.       "Escape" key clears the input line.
  98.       Should you wish to alter the default tone times etc. then enter "u" on  a
  99.       blank line (Case is not important), and MCMF will allow you to change the
  100.       settings. Currently all times are in 1/24ths of a second and are  minimum
  101.       1/24ths and maximum 99/24ths.
  102.       In Free-form mode the digit entered is dialled instantly and displayed by
  103.       the cursor.
  104.       Entering "x"  on a  blank line  exits  the program  (again, case  is  not
  105.       important).
  106.       
  107.       I have  had a  100%  success rate  using this  program  to dial  on  many
  108.       different types  of  phone, I  have  found that  holding  the  microphone
  109.       approx. 10cm over the MC speaker gives best results.
  110.       
  111.       
  112.       Limitations
  113.       -----------
  114.       
  115.       Firstly, me! I do not pretend  to be the world's greatest programmer  and
  116.       although I have tried to make this program as resilient as possible there
  117.       are bound to be  some situations I have  overlooked. The delay times  are
  118.       implementend with the OPL command "pause"  and as such cannot be  exactly
  119.       guaranteed by  the system,  so you  may notice  irregular pauses  between
  120.       digits. This should  not cause  any problems  though as  the delays  will
  121.       always be *longer* than specified.
  122.       In Free-form mode, don't dial too quickly! The program cannot respond  to
  123.       input as quickly  as you  can type  it. At  present only  the last  digit
  124.       dialled is displayed - this may change in future versions.
  125.       If the Link is running and active (i.e. you are transferring files)  then
  126.       there will be some degradation in  the quality of the MF tones,  possibly
  127.       to the extent that they may  not be recognised by the telephone  network.
  128.       For this reason it  is wise not  to attempt to use  this program to  dial
  129.       while there is lots of background activity on the system.
  130.       
  131.       Any  bug  reports   or  comments   welcome,  preferably   by  e-mail   to
  132.       cxf@cix.compulink.co.uk or failing that (as  a last resort only  please!)
  133.       by phone to 01704 833776.
  134.       
  135.       Chris Farrow 3/4/95
  136.