home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / rtty / rtty_03 / amsoft.iii next >
Text File  |  1997-02-01  |  8KB  |  172 lines
  1.     TTY VERSION 3.7 ... A HALF DUPLEX RADIOTELETYPE PROGRAM FOR THE IBM PC
  2.     Written by AA4L Bob Johnson 11305 Rums Hill, Raleigh NC 27614
  3.     919/847/5606..... April 5,1985
  4.  
  5.      TTY37 provides half duplex baudot and ascii radioteletype
  6.     communications for the IBM PC. The program requires a 128K system, at
  7.     least one disk drive SS or DS, an 80 column display mono or color, and
  8.     an async com adapter installed as "COM1:". It has not been tested with
  9.     any of the "compatibles." It will not run on the PC Jr.
  10.  
  11.      TTY37 is written in IBM PC Advanced BASIC Version 2.0 and Assembly
  12.     language. It was assembled, compiled and linked using the Macro
  13.     Assembler, BASIC Compiler 1.0, and Linker 2.1. The program is
  14.     distributed on a DOS 2.1 single sided disk as an EXE file. The EXE file
  15.     has been placed in PUBLIC DOMAIN by the author, and may be freely
  16.     copied and distributed. Experienced programmers who are licensed
  17.     amateurs may obtain may obtain source code from the author for use for
  18.     the benefit of the Amateur Radio Service.
  19.  
  20.      Files used by TTY37:
  21.  
  22.         TTY37.EXE    The program file...enter "TTY37" to run the
  23.                 program.
  24.  
  25.         TTY.TXT     This documentation file
  26.  
  27.         MSG1 & MSG2    Standard ascii file to be transmitted by
  28.                 the F1 and F2 keys in transmit mode.
  29.                 Intended for use as "brag tapes", net
  30.                 callups, etc. Create these files offline
  31.                 using a text editor.
  32.  
  33.         MSG3        Default file to be transmitted by F3 key.
  34.                 However, the F3 key may be re-programmed
  35.                 from the menu to transmit a file of any name.
  36.  
  37.         PERSNLIZ.TXT    Created from the menu. This file contains
  38.                 information unique to your station. It is
  39.                 loaded automatically whenever TTY37 is
  40.                 loaded.
  41.  
  42.         PARMS.ARF    Created from the menu. Contains unique
  43.                 ascii transmission parameters for the
  44.                 "special ascii" mode.
  45.  
  46.         RECEIVE.TXT    File to which received messages may be
  47.                 copied under control of the F3 key. May
  48.                 be renamed from the menu.
  49.  
  50.      TTY37 uses the COM1: async comm adapter. Pin 2 (TD) and pin 3
  51.     (RD) perform their normal functions. Pin 4 (RTS) is active in transmit
  52.     mode and inactive during receive mode. It may be used for TU and
  53.     transceiver control. Pin 7 is signal ground. Other pins are not used by
  54.     the program. The program was not designed to interface with any
  55.     particular brand of TU.
  56.  
  57.      The program has three modes: Receive, Transmit and Menu. Switching
  58.     between modes is accomplished by the <up arrow>, <down arrow>, and F10
  59.     keys. The Menu mode is self documenting. If you switch from Receive
  60.     mode to Menu mode and back to Receive, the program continues to receive
  61.     while you are in Menu for up to 2048 characters. The screen will catch
  62.     up when you return to Receive. Switching to Transmit mode terminates
  63.     Receive. The program may seem to hang when you try to exit Transmit
  64.     mode. This is normal, and is caused by the fact that characters to be
  65.     transmitted are printed to the screen at the time that they are placed
  66.     in the BASIC transmit buffer. Hence the screen may be 128 characters
  67.     ahead of the comm adapter. Transmit mode will not terminate until the
  68.     buffer is empty. When you switch to Transmit mode the program sends
  69.     eight ascii DEL characters (hex 7F) if you have selected an ascii
  70.     speed, or eight Baudot "ltrs" characters if you have selected Baudot
  71.     code. These characters are sent for the purpose of synchronizing the
  72.     receiving station's equipment. They are not displayed.
  73.  
  74.      The upper screen is active only in Receive mode. The lower screen,
  75.     in Receive mode, displays data which may be keyed into a fifty line
  76.     keyboard buffer during Receive mode.  The backspace key may be used for
  77.     limited editing capability when keying into the keyboard buffer. In
  78.     Transmit mode the lower screen displays characters as they are
  79.     accepted by the BASIC transmit buffer.
  80.  
  81.      Function Keys -- Receive mode
  82.  
  83.     F1        (Toggle) The normal communications line ending sequence is
  84.         one or more <cr> folowed by <lf>. Since <cr> and <lf> mean
  85.         essentiallly the same thing to the PC, <cr> is normally
  86.         stripped from the receive data stream to avoid multiple
  87.         line spacing. If the F1 toggle is ON, <cr> characters are
  88.         printed and filed as received.
  89.  
  90.     F2        Toggles the printer (LPT1:) ON and OFF.
  91.  
  92.     F3        When ON, received data is appended to the disk file named
  93.         from the menu. (The default name is RECEIVE.TXT).
  94.  
  95.     F4        For best copy under poor conditions, the program normally
  96.         operates in the amateur standard "unshift on space & <lf>"
  97.         mode. If this toggle is OFF, the unshift feature is
  98.         disabled. This key has no effect in the ASCII modes.
  99.  
  100.     F1+ALT    Select Baudot speeds 60, 75, and 100 wpm and ASCII speeds
  101.      thru    110, 150,300 and the "special" speed from the file
  102.     F7+ALT    PARMS.ARF. Selected speed is displayed on the screen
  103.         separator.
  104.  
  105.     F10+ALT    Clears the communication screens.
  106.  
  107.     F9+SHIFT    Clears all data from the keyboard buffer, without
  108.         transmitting.
  109.  
  110.      Function Keys -- Transmit mode:
  111.  
  112.     F1 & F2    Transmits disk message files MSG1 and MSG2.
  113.  
  114.     F3        Transmits the message file named from the Menu. The default
  115.         name is MSG3.
  116.  
  117.     F4        Transmits your personal CQ message. (From PERSNLIZ.TXT)
  118.  
  119.     F5        Transmits your personal DE message. (From PERSNLIZ.TXT)
  120.  
  121.     F6        Transmits a test message.
  122.  
  123.     F7        Transmits a date/time group.
  124.  
  125.     F8        A "temporary" one line message (such as the callsign of the
  126.         station with whom you are in contact) may be entered from
  127.         the Menu. This message remains resident until changed or
  128.         until the program is terminated, and may be transmitted
  129.         repeatedly by the F8 key.
  130.  
  131.     F9        Transmits the keyboard buffer which was generated while in
  132.         Receive mode.
  133.  
  134.     The program will transmit and receive at baudot "60","75" and "100"
  135.     speeds.  In ascii mode, the embedded speeds are 110, 150 and 300 baud.
  136.     However, provision is made to enter "custom" ascii speeds and protocols
  137.     via file PARMS.ARF.  The program has been tested from 75 to 1200 baud,
  138.     but 2400, 4800 and 9600 may be entered, and will probably work in some
  139.     applications.  The speed currently in use is displayed at the left end
  140.     of the screen separator.  Speeds are selected from Receive mode.
  141.     Function keys alt-F1 through alt-F7 select speeds 60 Baudot through
  142.     "special" ASCII.
  143.  
  144.     In Receive mode, function key alt-F10 may be used to clear the screens.
  145.  
  146.     Menu selection <6> allows you to enter a "header" which will be
  147.     transmitted whenever you enter Transmit mode. Similarly, a "trailer"
  148.     may be entered which will be transmitted whenever you leave Transmit.
  149.     This function was provided for use with certain types of store and
  150.     forward repeaters, but it may also by used to transmit your callsign at
  151.     the beginning of each transmission, and "K" or "ga pls" at the end.
  152.     The header and trailer remain resident until changed or until the
  153.     program session is terminated.
  154.  
  155.     The program contains enough error trapping routines to keep itself from
  156.     crashing under normal conditions. A missing disk file, an open drive
  157.     door, or a not ready printer will not dump you back to DOS. The error
  158.     recovery philosophy is primarily not to disrupt communication. For
  159.     instance, if the printer is out of paper, the error recovery scheme is
  160.     to beep once, close the printer file, and keep going. Most (not all)
  161.     missing disk files or drive not ready conditions will print out some
  162.     kind of a notice. I am sure that there are some hardware or media
  163.     errors that are not trapped. In this case you may receive a cryptic
  164.     message from DOS or from the compiler library. These are probably
  165.     "fatal errors" anyway, so do the best that you can. The program has
  166.     been in use for several years on a couple of machine configurations,
  167.     and most, if not all, of the software bugs have been beaten out of it.
  168.     If you convince yourself that you have found a bug, let me know, but
  169.     please check your hardware first. 73
  170.  
  171.     GL de AA4L.
  172.