                 Yet Another RTTY Program (YARP)

                *** Version 2.1, October 1987 ***



                                   de   John Langner, WB2OSZ
                                        115 Stedman St.
                                        Chelmsford, MA 01824
                                        U.S.A.



                Copyright  1987 by John Langner.

    Permission is given to copy and distribute this version of
        the program and documentation but not for profit.




Features

     - Baudot (Murray) and ASCII operation.
     - Split screen display.
     - Status line including time & date.
     - CQ, RY, and QBF messages.
     - Automatic newlines with selectable line width.
     - Word editing to correct typing errors.
     - Type ahead buffer to prepare transmit messages while
          receiving.
     - Transmit text from a disk file.
     - Save received text into a file.
     - Printer output.


Version 2.1 Changes

     - Baud rate fixed for 67 WPM.
     - Smooth scrolling.
     - Does not hang up if printer not ready.
     - Unshift on Space.
     - Filtering of received data:  Carriage Return / Line Feed
          will always occur in pairs, most ASCII control 
          characters are discarded.
     - No delay switching between Transmit and Receive when
          buffer is empty.


Interface

Connection  to "terminal unit" (modem) is through the serial  port 
on the back of the ST.

     pin       name     function
     1         PG        cable shield
     2         TxD       transmitted data to modem
     3         RxD       received data from modem
     4         RTS       activate transmitter when positive
     7         SG        signal ground


Screen Layout

The screen is divided into several regions:

     +-------------------------------------------------+
     |    [ Prompt For Input ]                         |
     |                                                 |
     |                                                 |
     |                                                 |
     |              Received Data                      |
     |                                                 |
     |                                                 |
     +-------------------------------------------------+
     |    Status line                                  |
     +-------------------------------------------------+
     |                                                 |
     |              Transmitted Data                   |
     |                                                 |
     +-------------------------------------------------+
     |    Mini Help Line                               |
     +-------------------------------------------------+

Incoming  data  is  displayed in the top portion  of  the  screen.
Sometimes  the top line is used to prompt for and  collect  input, 
for example the name of a file to send.   Characters typed at  the 
keyboard  are  displayed in the lower region of  the  screen.  The 
bottom line contains a brief reminder of the function key uses.

The status line contains the following information:

     speed and mode --   "WPM" indicates Baudot in Words Per Minute.
                         "ASCII" indicates ASCII in Baud.

     transmit       --   "recv" means receive.
                         "XMIT" means transmit.
                         "xmit" means transmit steady mark tone
                         during the transition.

     lc/UC          --   Indicates whether whether letters will
                         be displayed in lower or upper case in
                         Baudot mode.
     
     Prnt           --   When present all received data is sent 
                         to the printer.

     file name      --   A file name is present when saving
                         received data into a file.

     w=72           --   Maximum width of a line sent from the
                         keyboard.

     b=0            --   Number of characters in the transmit
                         buffer.

     time & date    --   Current time and date.


The Keyboard

In this version, all input is through the keyboard.  The functions 
of special keys are listed below.   The abbreviations on the  mini 
help line are shown in parentheses after the name of the key.

Esc       -    Toggles between transmit and receive.   This  might 
               not be a  good choice because it is too easy to hit 
               accidentally next to the "1".

Undo      -    Exit the program.

Return    -    Start a new line.   It is usually not necessary  to 
               use  this  because a word too long to  fit  on  the 
               current  line will automatically be placed  on  the 
               next line.

Backspace,
Delete    -    Used to correct typing mistakes before the  current 
               word   is  transferred  to  the  transmit   buffer.  
               Explained in the next section.

F1 (Speed) -   Selects the next mode and speed.  This version has
                    Baudot at 60, 67, 75, and 100 WPM.
                    ASCII at 110 and 300 baud.

F2 (UC/lc) -   ASCII has both upper and lower case but Baudot  has 
               only  one case.   This key toggles a  switch  which 
               determines whether Baudot letters are displayed  as 
               upper or lower case.
 
F3 (SaveF) -   Save received data in a file.   After pressing this 
               key,  a prompt for the file name will appear on the 
               top line.  Type the file name and press Return.  If 
               the file was opened successfully,  its name will be 
               placed on the status line.   Otherwise a beep  will 
               signal an error.  To close the current file without 
               opening  another one,  just press Return  when  the 
               prompt appears.

F4 (Print) -   Toggles printer output on and off.   "Prnt" appears 
               on the status line when printer output is enabled.

F5 (Width) -   This  program  automatically  generates  new  lines 
               (CR/LF)  when input from the keyboard  exceeds  the 
               maximum line width.   Line widths available are 64, 
               72,  and 80.  The current value is displayed on the 
               status line and pressing this key selects the  next 
               one.

F6 (RY)   -    This is equivalent to typing a line of  alternating 
               "R"  and "Y" characters.   This combination is  the 
               traditional test pattern for Baudot because the two 
               characters  have  alternating  zero  and  one  bits 
               (01010 and 10101).   It would make sense to use "*" 
               and  "U"  in ASCII  (0101010,  1010101)  but  might 
               confuse people.

F7 (QBF)  -    Send  the Quick Brown Fox message to test  all  the 
               letters in the alphabet.

F8 (deCall) -  Send "de" followed by your call.

F9 (SendF) -   Send a file.   You will be prompted for the name of 
               the file at the top of the screen.  Transmission of 
               it  can  be terminated by pressing this  key  again 
               before it is finished.

F10 (CQ)  -    Turn  on the transmitter,  send a CQ  message,  and 
               turn the transmitter off again.


Word Editing

As printable characters are pressed on the keyboard,  they  appear 
in the transmit (lower) region of the screen.   Rather than  being 
transmitted  immediately,  they are saved in a section  of  memory 
called  the  word buffer.   This allows corrections to be  to  the 
current word.   (Here a "word" is defined as any group of adjacent  
printable characters.)  For example, suppose you typed:

          Location is Chelmsfid

Trailing  characters  of  the  current word   may  be  removed  by 
pressing  either the Backspace or Delete key.   In  this  example, 
pressing Backspace twice would leave the following:

          Location is Chelmsf

You could then complete the word by typing "ord".  The word buffer 
is emptied each time a group of printable characters is terminated 
by  a space or Return.   In this example,  it would have been  too 
late to go back and fix up the first two words.   

When groups of letters are removed from the word buffer,  they are 
not  transmitted  immediately.   Instead they are  placed  in  the 
transmit buffer.   While receiving,  the characters just sit there 
waiting.   This allows you to start typing your next  transmission 
while still receiving.   (The number of characters in the transmit 
buffer  is displayed on the status line.)   During  transmit,  the 
characters are sent as fast as the serial port can handle them.


Problem Reports, Suggestions, Updates, etc.

This program was ported from another machine with a minimum number 
of changes so it does not use any of the GEM features such as  the 
file selector dialog box.  This version is adequate to get your ST 
on the air but it's missing many desirable features.    

I  will  fix  any serious problems reported but  plan  no  further 
development  of  this program.   I have several  more  interesting 
projects in the queue and too little time left over after work  at 
a start-up company, little kids, and other responsibilities.  

For  those who would like to customize this program or just  learn 
more  about  the ST,  source code is available  for  $10.   It  is 
written  in  C and reasonably well commented so  you  should  have 
little difficulty figuring out what is going on.   Source code  is 
copyrighted and will be provided only under the condition that you 
agree to not give it to anyone else. 

For  any  program derived from YARP,  I ask that you  mention  its 
heritage and share it with others through user groups such as  the 
Atari  Microcomputer Network.   There is surprizingly  little  ham 
radio and electronics software available for the ST.   Will you do 
your part to help correct this?  Or will you sit back and watch PC 
clones dominate the world?


Atari Microcomputer Network

There  is  an organization dedicated to Amateur  radio  and  Atari 
computers  (both  the  ST  and  old  8-bit  models).    For   more 
information  contact  one of the following and/or tune in  to  the 
weekly net Sundays 16:00 UTC on 14.325 MHz.

     Net Coordinator:    Dave Byrd, KD7VA
                         1513 Commanche Drive
                         Las Vegas, Nevada 89109  U.S.A.

     Editor:             Gil Frederick, VE4AG
                         130 Maureen Street
                         Winnipeg, Manitoba R3K 1M2  Canada

     Librarian:          John Adams, KC5FW
                         17106 Happy Hollow
                         San Antonio, Texas 78232  U.S.A.

   
Accessories to Enhance Your RTTY Pleasure

Tired  of  struggling  to tune  in  signals?   Frustrated  by  old 
fashioned  methods such as signal strength  meters,  dual  ellipse 
patterns on an oscilloscope or just plain random fiddling until it 
works?  You need the WB2OSZ digital tuning indicator.  This unique 
device  features  a  LED  bar  graph  display  with  each  segment 
corresponding  to  a  narrow  range  of  frequencies.   The  basic 
principle is illustrated below.   "*" indicates a lit LED segment.  
"v" represents a mark on the front panel.

     
          v              v    _               
     |    *                   |         Mark tone

          v              v    _             
     |                   *    |         Space tone
     
          v              v    _               
     |    *              *    |         Properly tuned FSK signal
     
          v              v    _               
     |  *              *      |         Tones too low
   
          v              v    _               
     |      *          *      |         Shift too narrow
     

You can instantly see 
     - if signal is steady frequency or FSK.
     - whether tones are too high, too low, or just right.
     - amount of frequency shift.

The digital circuitry offers greater accuracy and versatility than 
analog designs.   It's crystal controlled so it never requires any 
calibration.  
   
See  73 for Radio Amateurs,  August 1986 (special packet  issue!), 
page 40 for all the details.   A later revision of the circuit has 
a larger EPROM and switch selection of different tone pairs.

Unfortunately  Valley  Electronics  had some problems  and  is  no 
longer  in the electronic kit business.   A more  experienced  kit 
manufacturer  has  shown  some interest in  producing  this  handy 
gadget  and  is  currently evaluating  a  unit.   If  this  sounds 
interesting send me an SASE and I'll let you if it works out.

