home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 500 / 419 / rttytalk.doc < prev    next >
Text File  |  1984-07-01  |  6KB  |  109 lines
  1.          "Documentation" for the RTTY program.
  2.  
  3.          The  basic  program you will recognize as PC-TALK III and all
  4.          credit due the authors is hereby acknowledged.  My  objective
  5.          was  to  not  modify  any of the functions of PC-TALK III and
  6.          best I know that's the case.  The only exception I can  think
  7.          of  is that <ALT-J> in the original PC-TALK III does the same
  8.          thing as <ALT-K> (redefine the function  keys)  and  I  stole
  9.          <ALT-J> for another function.  Otherwise refer to the PC-TALK
  10.          III  documentation  first  and  then  look   here   for   the
  11.          modifications  I  made.   I am assuming an AEA CP-1 interface
  12.          with with a  serial  interface.   Whether  it  will  work  on
  13.          anything  else...that's  up to you.  I used an article is the
  14.          September 1981 issue of QST as a reference  for  the  speeds,
  15.          codes  and general RTTY stuff.  Other reference material that
  16.          might help ( and that I used ) were the  Technical  Reference
  17.          Manual for the IBM-PC and the Basic Manual for the IBM-PC.
  18.  
  19.          <ALT-?> Definitions.
  20.  
  21.          <ALT-U>
  22.          This turns on or off the RTTY translation process.  When  the
  23.          program  starts  RTTY is off.  <ALT-U> will display "RTTY ON"
  24.          and  will  begin  translating  the  incoming   and   outgoing
  25.          characters between ASCII and RTTY 5 bit "BOUDOT" code.
  26.  
  27.          <ALT-J>
  28.          This  is  hard  coded  to spit out my call sign, the date and
  29.          time.  To be done properly this should be part of the default
  30.          file but I got lazy.  You could certainly alter the call sign
  31.          to your own.  Matter of fact I would prefer it!
  32.  
  33.          <ALT-H>
  34.          This  switches  between  COM1:   and  COM2:.   A  message  is
  35.          displayed to indicate the  current  status  and  the  program
  36.          initializes to the default file.
  37.  
  38.          <ALT-B>
  39.          This  will  allow  you  to  enter a different data rate.  The
  40.          program will ask you for a new speed.  If you respond with  a
  41.          <?>  the  program  will return with the current setting.  For
  42.          example, entering 45.45 will result in the proper  "bits  per
  43.          seconds" setting for standard "60 WPM" RTTY.
  44.  
  45.          <ALT-N>
  46.          This will switch between the two  versions  of  FIGS  that  I
  47.          found in the previously mentioned artical.
  48.  
  49.          <ALT-A>
  50.          This will turn the transmitter on and off.   What  it  really
  51.          does  is  set  or reset the "Request to Send" line out of the
  52.          serial port.  Nothing will be displayed.
  53.  
  54.          <ALT-O>
  55.          This  will  force  a  switch  between LTRS and FIGS.  This is
  56.          sometimes  handy  if  you  happen  to  loose  one  of   those
  57.          characters and end up receiving garbage because you're in the
  58.          wrong case.
  59.  
  60.  
  61.          Operation
  62.  
  63.          In general, the standard way of getting RTTY "up" is to first
  64.          start the the RTTY program.  When it is ready it will display
  65.          the  message  "Ready".   Then  you can set the communications
  66.          port address using <ALT-H> to the port  where  the  interface
  67.          is.   (I have two serial ports and simply switch between them
  68.          using <ALT-H>).  Then you use one of  the  dialing  directory
  69.          entries  to  set the number of data and stop bits.  The entry
  70.          name is not important other than to remind you  what  it  is.
  71.          Hit  <ALT-D>  and  select  the entry you have set up with the
  72.          proper communications parameters and hit  enter.   The  phone
  73.          number  should be left blank ( although I haven't ever  tried
  74.          it with a number there.  It won't do anything other than send
  75.          the  number out the port!  ) The speed can be set to anything
  76.          because you will set that later  with  the  <ALT-B>  command.
  77.          Data  and  stop  bits are important here and this is the only
  78.          way to alter them.  Since Basic and the original PC-TALK  III
  79.          logic  opens  the  serial  port  when  executing  the <ALT-D>
  80.          command, the speed will be set at whatever  you  had  in  the
  81.          dialing  directory.   Problem  is  that  Basic  only  accepts
  82.          certain values ( see the manual ) and causes  error  messages
  83.          on  anything  it  doesn't  like.   Therefore  one of the next
  84.          commands ought to be the <ALT-B> command to  set  the  speed.
  85.          Again,  due  to Basic and previous program logic, the program
  86.          will turn on the transmitter as soon as the  <ALT-D>  command
  87.          is  executed.  You may or may not want to turn it off at this
  88.          point.  The last thing that is necessary is to  turn  on  the
  89.          RTTY  tranlation  process with <ALT-U>.  There you are, ready
  90.          to send and receive Radio TeleTYpe.
  91.  
  92.          One  word  of advise.  Compile this thing!  Basic has a nasty
  93.          habit of wondering off into never-never land  when  it  comes
  94.          time  to  clean  up  the  string  character  space.  For this
  95.          program this process can take as long  as  5  minutes!   Once
  96.          compiled  the  clean-up  time  is less than 1 second.  (Don't
  97.          ask.  If you must then ask IBM!) Also, heed the  warnings  in
  98.          the PC-TALK III documentation concerning communication buffer
  99.          sizes.
  100.  
  101.          If you have any questions I will be glad to answer any that I
  102.          can.  I make no claims about quality of the code  or  whether
  103.          it conforms to any known standards.  Enjoy.
  104.  
  105.          Steve Darling KA9DCA
  106.          3408 33rd Street
  107.          Moline, Illinois 61265
  108.          (309) 762-5342
  109.