home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / rtty / rtty_05 / amsoft.iii next >
Text File  |  1997-02-01  |  20KB  |  516 lines
  1.           R T T Y   2 2 0 0 . 0 0   for IBM-PC MSDOS SYSTEMS
  2.  
  3.                        BY Perry Taylor, W0SE
  4.  
  5.                           JAN 1st., 1986
  6.  
  7.        The  RTTY  2000  series of Amateur Radio Teletype Programs
  8.     were originally developed for  Heathkit  Computers,  and  are
  9.     based  on much of the original work of Irv Hoff, W6FFC, Keith
  10.     Peterson, W8SDZ, and others, on the Heath Computer net.  This
  11.     series of programs has added split screen,  and  consolidated
  12.     some of the concepts and programs, originated by the group on
  13.     the net.
  14.  
  15.        One  of  features  of the program, that may be new to many
  16.     who first use this program, is the 3rd and 4th level transmit
  17.     and receive of ASCII characters, via the BAUDOT  level  code.
  18.     By  adding a third and fourth level shift, to the two already
  19.     available in the BAUDOT code, it is possible to send all  the
  20.     ASCII  characters,  over the BAUDOT channel.  This is done by
  21.     making a third shift of BLANK-FIGS, and a  fourth  of  BLANK-
  22.     LTRS.   The  use  of this feature is explained in the body of
  23.     this file.
  24.  
  25.        Prior  to  using this version of RTY.EXE, please remove or
  26.     erase any previous RTY.CFG file. Set TIME/DATE for MS-DOS, as
  27.     this  is used in the RTY program.  Use all "UPPER-CASE" while
  28.     configuring the RTY program.
  29.  
  30.        This  version  of  RTY  requires  192k or more of RAM, and
  31.     version 2.0 or higher of MSDOS.  The FILES parameter  in  the
  32.     CONFIG.SYS  file  should  be  reviewed.  See page 9.19 in the
  33.     MSDOS version 2.0 Heath Manual for details.  This program can
  34.     use as many as four files at one  time,  and  the  CONGIF.SYS
  35.     file should be set for 4 or more FILES.
  36.  
  37.     OPERATION:
  38.  
  39.        When  calling  up  RTY.EXE  for  the first time, the first
  40.     thing that will be shown is the "TITLE SCREEN".  Hit any key,
  41.     and the "CONFIGURATION" screen will be available.  Enter  the
  42.     values  on  this  screen to fit your requirements and station
  43.     hardware.  This builds a configuration record  which  can  be
  44.     saved  on  disk  by pressing the "f7" key.  The next time the
  45.     program is called, this configuration  record  will  be  read
  46.     from disk.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                 Page 2 - RTTY 2200 IBM PC (MSDOS)
  68.  
  69.  
  70.     CONFIGURATION ITEMS:
  71.  
  72.         Using all capital letters, fill in the items shown on the
  73.     screen, customized as desired.
  74.  
  75.     ITEM:                               COMMENTS:
  76.  
  77.     File Name for Sending:              File name of file to be
  78.                                         sent or saved with "Alt-N"   
  79.     File Name Disk Out:                 File name for file copy
  80.  
  81.     Max File Size:                      File copy max size
  82.  
  83.     Margin:                             Custom left margin
  84.  
  85.     Baud Rate Index (RTTY):             Index from chart at right
  86.  
  87.     Transmit Line Length:               Length of line sent
  88.  
  89.     Call Sign:                          Your station call sign
  90.  
  91.     Time Zone:                          Your time zone
  92.  
  93.     Pace:                               Delay between chars sent
  94.  
  95.     Length of Diddle:                   Number of chars in callup
  96.                                         diddle line
  97.  
  98.     RTTY Port (A or B):                 Port A=COM1, B=COM2      
  99.  
  100.     ASCII Printer Port (A, B, or Z):    Which port for Printer?
  101.  
  102.     Baud Rate Index (Printing):         From index at right
  103.  
  104.     Printer Ready Low(Y or N)           DTS High="N"
  105.  
  106.     Printer Line Length:                How long a printer line
  107.  
  108.     Print Received (Y or N):            Print incoming data
  109.  
  110.     Print Sent (Y or N):                Print outgoing data
  111.  
  112.     Disk Out Mode ( R, T, B, of N):     What do you want to copy?
  113.  
  114.     Pix Mode (Y or N):                  Pix, anyone?
  115.  
  116.     Auto Run Mode:                      Start with RUN SCREEN
  117.  
  118.     New Line for BAUDOT:                What will you have?
  119.  
  120.     New Line for ASCII:                 Ditto.
  121.  
  122.     Screen Saver:                       "Y" for 10 min. blank
  123.  
  124.     Split Line Location:                Split line location
  125.  
  126.     WRU on callsign only (Y or N):      Yes=response on ZW only
  127.  
  128.  
  129.  
  130.  
  131.                 Page 3, RTTY 2200.00 IBM PC (MSDOS)
  132.  
  133.     DISCUSSION:
  134.  
  135.     DISK COPY:
  136.  
  137.        This  program  can  "LOG" both incoming and outgoing copy.
  138.     In the field "DISK OUT MODE", "R" means "RECEIVE", "T"  means
  139.     "TRANSMIT",  "B"  means  "BOTH"  and "N" means "NEITHER".  If
  140.     this field has been programmed "N", and when  in  "RUN",  the
  141.     CONTROL-Y is pressed, the "N" will change to "R".  "DISK COPY
  142.     MODE"  comes  up automatically if "CONFIGURED" for "R","T" or
  143.     "B" and a fname.ext has  been  entered  in  the  "DISK  COPY"
  144.     field.   It is suggested that a fname.ext such as "JAN01.AAA"
  145.     be  used  so  that  each  day's  DISK  COPY  can  be   easily
  146.     identified.
  147.  
  148.     MAX DISK OUT SIZE:
  149.  
  150.        The  number  of  characters  for a disk output file can be
  151.     specified, to allow editing of the  file  by  small  editors.
  152.     When  the  output  file  reaches  this  size it is closed and
  153.     another is opened, with an incremented fname.ext.  If set  to
  154.     zero  of  blank, then the maximum will be the amount of space
  155.     left on the disk.
  156.  
  157.     FILE NAMES :
  158.  
  159.        All disk file names can include directory names.  The only
  160.     restriction is that the fully qualified name length can be no
  161.     more  than 26 characters.  For directory display, a path name
  162.     can be used and all files at the end of that  path  name  are
  163.     listed.   A blank path name defaults to the current drive and
  164.     directory.  If all files on a non-default  drive  are  to  be
  165.     listed, then the colon must be used.  e.g.  "d:"
  166.  
  167.     OUTPUT FILE NAME:
  168.  
  169.         The output file name is incremented in the last character
  170.     shown, even if there is no extension.
  171.  
  172.     e.g. FILEA, FILEB, FILEC,......,FILEZ if named without an
  173.          extension.
  174.          FILEA.RYA, FILEA.RYB,......,FILEA.RYZ if named with an 
  175.          extension, such as RYA...
  176.  
  177.     END OF LINE SEQUENCES:
  178.  
  179.        This  controls  the  sequence  sent whenever a new line is
  180.     started from the transmitted text.  It is  triggered  by  the
  181.     RETURN  key,  automatic wrap of a line being entered into the
  182.     buffer, or by a NEWLINE (0AH, same as  LINE  FEED)  character
  183.     from  a disk input file.  Baudot allows CARRIAGE RETURN (CR),
  184.     LINE FEED (LF), LETTERS (LTRS), or FIGURES (FIGS).  ASCII
  185.     allows CARRIAGE RETURN (CR), LINE FEED (LF), or NULL (00H).
  186.     If left blank, the default sequence is LINE FEED (one).
  187.  
  188.     PROGRAMMABLE LINES:
  189.  
  190.        Program the "PROGRAMMABLE LINES "A" and "B".  Line "A" and
  191.     "B" will be put into the "CONFIGURATION" record, but each can
  192.     be  changed  by  going  to  the "CONFIGURATION" screen at any
  193.     time.
  194.  
  195.  
  196.  
  197.                 Page 4, RTTY 2200.00 IBM PC (MSDOS)
  198.  
  199.     AUTO RUN:
  200.  
  201.        A  new  option has been added on the CONFIGURE screen that
  202.     allows specifying "AUTOMATIC or MANUAL" operation,  when  the
  203.     program  is  called.   This  will make possible the automatic
  204.     re-booting of the program, after a power glitch  or  failure,
  205.     and  continued operation of the RTY program.  The RTY program
  206.     will start with the RUN screen, if the item "AUTO  RUN  MODE"
  207.     is  a "Y".  To modify the configuration, the CONFIGURE screen
  208.     is still available by hitting the F1 key.  Of course, the RTY
  209.     program must be called from an "AUTOEXEC.BAT" file,  for  the
  210.     "AUTO RUN MODE" to be effective, upon a re-boot.
  211.  
  212.     BAUD RATES:
  213.  
  214.        The  lower  right  corner of the screen will show "Receive
  215.     Mode" if receiving and "Send Mode" if transmitting.  Just  to
  216.     the left of the Mode indication there will be a letter "B" or
  217.     "A"  and  a baud rate.These are from the configuration screen
  218.     and indicate Baudot or ASCII and the baud rate for  the  RTTY
  219.     input  and  output  speed.  The input and output speed can be
  220.     set from the "RUN" screen by hitting keys  "f2  or  f3".   f2
  221.     will program 45 baud BAUDOT, and f3 will step through all the
  222.     normal BAUDOT and ASCII baud rates.
  223.  
  224.     PRINTER:
  225.  
  226.        If  the printer has been programmed "ON" and the middle of
  227.     the 24th line shows "PRINTER", this means that the printer is
  228.     either not "READY" of the "HANDSHAKE" line  is  not  properly
  229.     set.
  230.  
  231.     3RD AND 4TH LEVEL OPERATION:
  232.  
  233.        One  of the newest features of this program is called "3rd
  234.     and 4th level BAUDOT".   This  is  a  programming  method  of
  235.     sending  the  full ASCII character set over a BAUDOT channel.
  236.     This  program  always  transmits  with  3rd  and  4th   level
  237.     characters, and is always available.
  238.  
  239.       Unlock the "CAPS LOCK", to send lower case data.  The print
  240.    on  a TTY machine, or on a CRT (with other than this program),
  241.    will show as if it were  normal  Baudot.   Of  course,  normal
  242.    ASCII at 100 WPM can also be used, if desired.
  243.  
  244.       Toggle  3rd  and 4th level receive by hitting the "f7 key",
  245.    (while in RUN) and note the "3/4" on the  left  of  the  Split
  246.    line,  which  means  that  the  3rd  and  4th level receive is
  247.    active.  The program comes up in 3/4 mode. 
  248.  
  249.        Irv  Hoff's  IRTTY  HDOS  program will receive 3rd and 4th
  250.     level BAUDOT and some of his HDOS and CP/M drivers will  send
  251.     3rd and 4th level.
  252.  
  253.     DISK OPERATIONS:
  254.  
  255.       When using "DISK COPY or DISK TRANSMIT", a word in the left
  256.    half  of  the 24th line will show "IN" or "OUT", meaning "Disk
  257.    INput of Disk OUTput".  If there is an error, then  the  error
  258.    will be indicated next to the "IN" or "OUT" depending on which
  259.    has the problem.
  260.  
  261.  
  262.  
  263.                 Page 5, RTTY 2200.00 IBM PC (MSDOS)
  264.  
  265.        From  the  "RUN" screen, "Alt-N" will allow you to enter a
  266.     "d:fname.ext"  to  send  without  going  to  the  "CONFIGURE"
  267.     screen.   The entry made will be placed into the field called
  268.     "Filename for Sending".  End by typing RETURN.
  269.  
  270.        "CTRL-D"  calls  up  the  file  to  be  sent, and a second
  271.     "CTRL-D", stops or aborts the file.  Call up the  file  where
  272.     ever in the pre-typing or transmit, the file should be sent.
  273.  
  274.        SAVE  PRE-TYPE  BUFFER  TO  DISK.   Prepare the doc in the
  275.     pre-type buffer that you wish to put into a special fname.ext
  276.     file.  Then hit "Alt-N", and then follow  directions  on  the
  277.     lower  area  of  the  screen.   The  contents of the pre-type
  278.     buffer will remain unchanged but the data will be written  to
  279.     the  disk.  The pre-type buffer can then be cleared by typing
  280.     "Alt-V".  After that, the file can be reloaded, at  any  time
  281.     to send it, by typing "CRTL-D" in the normal manner.
  282.  
  283.        DELETE  FILE  FROM  DISK.  To delete a file from disk, hit
  284.     the "Alt-N", and follow directions given on the lower lines.
  285.  
  286.     HELP SCREEN:
  287.  
  288.        From  the  "RUN"  screen,  hit  "Alt-H"  to see all of the
  289.     programs controls that are available.  Type "RETURN" to  exit
  290.     the  Help screen.  No incoming data will be lost when looking
  291.     at the control  menu.   The  unsent  pre-type  data  will  be
  292.     scrolled  back  into  the  pre-type area when the "RETURN" is
  293.     hit.  Transmit will stop while in the "HELP" screen, but will
  294.     resume when "RETURN" is hit.
  295.  
  296.        DISPLAY OF DISK DIRECTORY.  Type "CTRL-A" while the "HELP"
  297.     screen  is displayed.  Then type the ID (in UPPERCASE) of the
  298.     drive on which there is a disk  mounted,  that  you  want  to
  299.     display the directory.Type "A","B","C", or "D" for the MS-DOS
  300.     drive  directory.   Type  "RETURN"  to  return  to the "HELP"
  301.     screen, and a second "RETURN" to return to the "RUN" mode.
  302.  
  303.     FAST BREAKIN:
  304.  
  305.        This  mode  is  toggled by "Alt-B".  The letters "bk" will
  306.     appear  on  the  left  of  the  split  line,  when  operating
  307.     "BREAKIN".   The  "CTRL-G" will send "-BK-", and turn off the
  308.     transmitter with out the 4 N's.  "CTRL-X" will  send  only  4
  309.     diddles,  and then the pre-typed data, when in this mode.  Do
  310.     not use "BREAKIN" mode unless you are truely using  "BREAKIN"
  311.     as  most  demodulators  can  not  start  printing with so few
  312.     start-up diddles.
  313.        
  314.     RELAY:
  315.  
  316.        In   the  "RELAY"  mode,  there  is  a  timer  to  prevent
  317.     untransmitted  relay  messages  to  linger  in  the  Pre-type
  318.     buffer.   Ths  timer  is  one  hour long, which prohibits any
  319.     relay message longer than 30 minutes.  If the timer  expires,
  320.     the  relay message is cleared and the relay function is armed
  321.     for another usage.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                 Page 6, RTTY 2200.00 IBM PC (MSDOS)
  330.  
  331.     NOTE: To use the relay system, follow these steps:
  332.  
  333.     1.   Send  call  of  station having a RTY program operational
  334.     with ZC.
  335.    
  336.         callsignZC "CR" (puts relay station into RELAY MODE)
  337.         callsignZC "CR" (send a second time to assure reception)
  338.  
  339.     2. Send normal message to station: "W0NW de W0SE etc."
  340.  
  341.     3. Send "CR" then "four N's" and a "CR"
  342.  
  343.     4. Send call of station being used for relay,with ZR
  344.  
  345.            callsignZR (tells relay station to relay)
  346.  
  347.     5. Hit CTRL-V to leave the air immediately
  348.  
  349.     6. Watch relay being made.
  350.  
  351.     PIX:
  352.  
  353.        In  the  "PIX  MODE",  the "UNSHIFT ON SPACE" is disabled.
  354.     The shift stays the same as it was before the space. 
  355.  
  356.     BUFFERS:
  357.  
  358.        Depending  of the amount of RAM available, the size of the
  359.     buffers is displayed at the  bottom  of  the  "CONFIGURATION"
  360.     screen.   There  are  three  buffers  of  this size: Received
  361.     Characters, Pretype for sending, and DISK OUTPUT.
  362.  
  363.     LENGTH OF DIDDLE:
  364.  
  365.         The number of diddles (LTRS in BAUDOT, NULL in ASCII),
  366.     sent at the start of each "non break-in" mode transmission,
  367.     can be specified. The value can be from 1 to 99, and if left
  368.     blank or set to zero, then the default value of 32 is used.
  369.  
  370.     WRU on CALLSIGN:
  371.  
  372.         If this item is set to "Y", the WRU will not respond to
  373.     the :DISK of :TIME command, but only to callsignZW. This mode
  374.     is indicated on the left of the split line by a reverse video
  375.     "I". A count is kept of the number of times a WRU is requested
  376.     of the station (whether it is sent of not). The count is dis-
  377.     played on the right of the split line. This count will alert
  378.     the operator of possible messages in the copy.
  379.  
  380.     PACE:
  381.  
  382.        To  smooth  out the transmitted output, when a slow typist
  383.     is typing in "real time", a delay between characters  can  be
  384.     programmed  on the line called "PACE".  Any number from blank
  385.     to 999 will  add  from  none,  to  999  millaseconds  between
  386.     characters, thus smoothing out the output. Characters are
  387.     still send at the programmed rate, but the average speed is
  388.     reduced to smooth out the typing.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                 Page 7, RTTY 2200.00 IBM PC (MSDOS)
  397.  
  398.     Following are the controls for RTTY 2200.00 (MS-DOS)
  399.  
  400.        CTRL-x means key x, while holding down the CONTROL key.
  401.  
  402.                 CTRL-A - Play string A
  403.                 CTRL-B - Play BELL
  404.                 CTRL-C - Enter twice to return to MS-DOS
  405.                 CTRL-D - Toggle Disk Input to Transmit ON/OFF
  406.                 CTRL-E - Play String B
  407.                 CTRL-F - Replay Previous or Manual (ZR)
  408.                 CTRL-G - Go to Receive After NNNN 
  409.                 CTRL-K - Kill Transmitter Immediately
  410.                 CTRL-L - Turn up newline/fancy margin
  411.                 CTRL-N - Play Station ID
  412.                 CTRL-R - Play RYRY (U*U*U* in ASCII)
  413.                 CTRL-T - Play Time/Date
  414.                 CTRL-U - Send WRU
  415.                 CTRL-V - Go to Receive Mode without NNNN
  416.                 CTRL-W - Force DISK COPY write
  417.                 CTRL-X - Go to Send Mode with X diddles
  418.                 CTRL-Y - Toggle Disk Copy ON/OFF
  419.                 CTRL-Z - Toggle Gimic ON/OFF (fig in upper right)
  420.                 CTRL-_ - Clear Receive Screen
  421.  
  422.  
  423.                 f1 Key - Toggle RUN/CONFIGURATION Screens
  424.                 f2 Key - 45.45 baud (Baudot 60 WPM)
  425.                 f3 Key - 50 baud to 9600 baud stepping 
  426.  
  427.                 Alt-A - Toggle 3/4 Level Receive
  428.                 Alt-B - Toggle Break Mode
  429.                 Alt-C - Same as Ctl_C
  430.                 Alt-F - Force Relay Record
  431.                 Alt-H - Display This Screen (HELP)
  432.                 Alt-N - Enter DIsk Input Fname
  433.                         (or Save Pretype BUffer
  434.                         or Delete File)
  435.                 Alt-P - Clear Print Buffer
  436.                 Alt-Q - Play "Quick Brown Fox etc."
  437.                 Alt-R - Toggle Relay Mode
  438.                 Alt-V - Clear Pretype Buffer
  439.  
  440.                 ESC-RETURN - Send Bare CR (PIX ONLY)
  441.  
  442.  
  443.        This version of RTY will respond to the following incoming
  444.     commands, if preceeded by either a CR of LF, and the Pre-type
  445.     buffer of the called station, is clear or empty.
  446.  
  447.         callsignZC - Set RELAY to copy incoming
  448.         callsignZR - Relay message, with VIA etc.
  449.         callsignZP - Replay previous transmission
  450.         callsignZD - Put incoming to disk, if in DISK COPY
  451.         callsignZW - Play WRU
  452.         callsignZL - See Below Explanation for Remote WRU
  453.         callsignZM - See Below Explanation for Remote WRU
  454.         :TIME - Play all WRU'S
  455.         :DISK - Play all WRU'S if in DISK COPY
  456.         :xTIME - Play x call area WRU's (use 0 to 9 for x)
  457.         :xDISK - Play x call area WRU's (use 0 to 9 for x)
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                 Page 8, RTTY 2200.00 IBM PC (MSDOS)
  466.  
  467.     REMOTE WRU FUNCTION:
  468.  
  469.        To  determine  if a remote station is active, when you can
  470.     not hear the  station  on  a  direct  path,  the  REMOTE  WRU
  471.     function is available.  The function will only work when this
  472.     version of the RTY program is in use at the relay station and
  473.     the  remote  station.   Any  local  station  can activate the
  474.     function.
  475.  
  476.        By  the use of specific "Z" signals, a remote, but unheard
  477.     station, can be triggered to send its WRU,  through  a  relay
  478.     station, and thus be heard by the originating station.
  479.  
  480.         Following is the procedure to activate this feature:
  481.  
  482.         ------------        -----------          -----------
  483.         : Original :        : Relay   :          : Remote  :
  484.         : Station  :----\---: Station :-----\----: STATION :
  485.         :          :        :         :          :         :
  486.         ------------        -----------          -----------
  487.  
  488.     Callsigns:
  489.            aaaaa              bbbbb                ccccc
  490.  
  491.     Action:                             Comments:
  492.  
  493.     aaaaa Sends:                        Calling station
  494.     bbbbbZLccccc<ret>                   Request bbbbb to call WRU
  495.     NNNN                                Hit CTRL-G, for NNNN's
  496.     -
  497.     bbbbb Sends:                        Response from bbbbb
  498.     cccccZMbbbbb                        Ask ccccc to relay WRU
  499.     NNNN                                Normal 4 N's
  500.     -
  501.     ccccc Sends:                        Response from ccccc
  502.     bbbbbZC                             Set relay at bbbbb
  503.     WRU for ccccc                       Normal WRU from ccccc
  504.     bbbbbZR                             Request bbbbb relay
  505.     -
  506.     bbbbb then relays the WRU of ccccc, for all to hear.
  507.     -
  508.        No operator intervention is required at any station, other
  509.     than  at the originating station.  The remote station must be
  510.     "ON", and its Pre-type buffer empty.
  511.      
  512.  
  513.     Have FUN!!!!  And have any kind of a day you would like.....
  514.  
  515.     de W0SE AND W0NW...
  516.