TonePad v1.0 Jun 1996
=====================

Introduction
------------

TonePad is a little utility that allows you to generate
long DTMF tones from your Psion Series 3a.

It is supplied as freeware, with OPL source in case you are
interested in modifying it.  TonePad uses a few techniques
which may be useful in other OPL programs:
1. Generating DTMF tones using async I/O;
2. Low-level polling of the keyboard (so that key-up can
   be detected);
3. Use of the FRC: device to time the key-presses to a 
   resolution of 1/1024 sec.


Author
------

Simon Pooley, email: spooley@cix.compulink.co.uk
or http://www.compulink.co.uk/~ropewalk/psion

I make no promise to support or enhance TonePad (which is why
I'm happy to give away the source), but if you have any ideas,
requests or comments then please feel free to email me.


Installation
------------

The distribution contains two versions of TonePad: TONEPAD.OPO and
TONEPAD.OPA.

If you want TonePad to appear with its own icon, copy TONEPAD.OPA
to the \APP\ directory on any drive, and install it on the system
screen using Psion-I.

If you want TonePad to appear under the RunOPL icon on the system
screen, copy TONEPAD.OPO to the \OPO\ directory on any drive.


Operation
---------

Launch TonePad by selecting its name under its own icon (TONEPAD.OPA)
or the name "Tonepad" under the RunOPL icon (TONEPAD.OPO) on the
system screen and pressing <Enter>.

TonePad displays a numeric keypad and an information panel.

Simply press the keys to generate the corresponding DTMF tone.
The tone will sound for as long as you hold the key down.

When you release the key, the length of time for which it was
pressed is displayed.  (Technical Note: TonePad uses the FRC:
device)


Limitations
-----------

1. There is a brief glitch every 8 secs when generating long tones.
   If this causes anyone a problem, let me know and I'll have a go
   at correcting it!

2. TonePad leaves the SND: device opened whilst it is running.
   This has the side-effect of preventing any alarms from sounding.
   So if you use your Psion as an alarm clock, remember to exit TonePad
   before going to bed at night!
   If there is sufficient interest, I'll enhance TonePad to release the
   SND: device when the Psion switches off.


Distribution
------------

The following files are contained in the distribution:

TONEPAD.OPO	OPO version of TonePad, for launching via the
		RunOPL icon.

TONEPAD.OPA	Application version of TonePad, for installation
		on the system screen.

TONEPAD.OPL	OPL source.

TONEPAD.PIC	Icon file.

TONEPAD.TXT	This file.


---end---
