home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / yappprot / tty.doc < prev    next >
Encoding:
Text File  |  1983-09-29  |  6.2 KB  |  120 lines
  1. Description of TTY Program
  2. TTY requires advanced basic 1.1, communications adapter,
  3. and 80 character wide screen.
  4. Comm adapter pins used are (2) xmit data, (3) rcv data, and (4) RTS.
  5. RTS is active (plus) when the program is in transmit mode, and may
  6. be used to control t/r switching in the TU or transceiver.
  7. TTY transmits and receives 5 bit teleprinter code (murray/baudot)
  8. at 45.45 baud (60 wpm) in half duplex mode and is intended for use
  9. in the amateur radio service.
  10. This documentation assumes the reader is familiar with amateur radio
  11. teleprinter conventions and practices.
  12. CAUTION: The IBM PC comm adapter uses rs 232 input and output voltage
  13. levels of +12v/-12v. Most commercial TUs use TTL levels 0v/+5v.
  14. Conversion circuitry may be required.
  15.  
  16. The TTY menu provides for selection of receive or transmit mode.
  17. Switching between transmit and receive modes is done by calling the
  18. menu, using the F10 key.
  19. In receive mode, the normal mode of operation is to ignore incoming
  20. cr and lf characters, and print full lines of 80 characters to the
  21. display and printer. However, the F1 key may be used to select a mode
  22. of operation in which cr/lf characters are recognized, and normal
  23. teleprinter operation is simulated. F1 toggles this function on/off.
  24. F2 toggles the PC line printer on/off.The printer is used in receive
  25. mode only.
  26. In receive mode, the program is arranged for "unshift" on space,
  27. cr and lf, as well as "ltrs".
  28.  
  29. In transmit mode, ltrs and figs shift characters are inserted
  30. where needed by the program.Ltrs and figs cannot be sent directly
  31. from the keyboard. The ascii cr (enter) key sends a cr/lf/ltrs
  32. sequence.The program assumes that the receiving terminal is
  33. equipped with unshift on space, and inserts figs accordingly.
  34. F3,F4,F6,and F7 are used to send preprogrammed messages. These
  35. messages reside at lines 17000,18000, 20000,and 21000, and may
  36. readily be changed to meet the needs of your station.
  37. F5 sends the required Morse code station identifier. This subroutine
  38. starts at line 19060. Morse code is sent by calling dit, dah, and
  39. intercharacter space subroutines at 19500,19600,and 19700 in sequence.
  40. Change lines 19060 thru 19080 to send your callsign.
  41. The program will accept either upper case or lower case keyboard entry.
  42. Other ascii characters which have no equivalent in murray code are
  43. ignored.
  44.  
  45. Hints and Kinks:
  46.  
  47. The `ignore cr/lf' mode is very useful when receiving conditions are
  48. less than perfect, and produces much more reliable copy. However,if the
  49. chap on the other end wants to send you some teleprinter art, use the
  50. cr/lf `on' mode.
  51. If the other station is using a conventional teleprinter, his line
  52. length is probably 70 or 72 characters. TTY lets you send 80 character
  53. lines which will overprint at the other station. Be careful!
  54. In transmit mode, characters appear on the screen when they are sent
  55. to the output buffer. The screen may be up to 128 characters ahead of
  56. the comm adapter output! F5 or F10 (cwid or return to menu) are stored
  57. and do not take effect until the buffer is empty. Hence the program
  58. may appear to `hang' while the buffer is emptying. Be patient! If it
  59. didn't work this way, some of your deathless prose would be lost down
  60. the bit bucket!
  61. 73 es GL de Bob Johnson AA4L, 11305 Rums Hill, Raleigh NC 27614
  62.  phone 919 847 5606
  63.  
  64. tty /murray Version 2.0  1/29/83
  65. The program has been entirely rewritten to improve readability
  66. and modularity. There are some significant functional changes:
  67. `75 speed' and `100 speed' capability have been added. It is no longer
  68. necessary to return to the menu to switch from receive to transmit and
  69. vice-versa. The `CQ', `de', and `test' messages are still embedded in
  70. the program code. However, in transmit mode, F1, F2, or F3 now cause
  71. the program to read files named msg1, msg2, or msg3 from disk. These
  72. files are then transmitted  as text. This provides greater flexibility.
  73. Version 1.0 outputted the cw id characters on the rs-232 transmit data
  74. line. Due to some changes in station hardware at AA4L, cw id is now
  75. keyed by means of the cassette tape motor control relay. Also, PC 
  76. generated sidetone is now audible through the system unit speaker.
  77.  
  78. It developed that Version 1.0 had a bug which could cause a system 
  79. crash. BASIC does not have provision to set the baud rate to 45.45.
  80. Hence the speed change is accomplished by OUT commands to &h3f8 and
  81. &h3f9. If a comm adapter interrupt occurs simultaneously with these
  82. OUT instructions, a system crash can occur. This has been corrected in
  83. Version 2.0 by the use of additional OUT instructions to disable the 
  84. comm adapter interrupts.
  85.  
  86. The embedded messages which you may wish to change to fit your station
  87. are now at lines 16300, 16400, and 16500. The `dit' subroutine is at
  88. 18500, the `dah' at 18600, and the intercharacter space at 18700.
  89. Change the gosubs following 18000 to call the dits, dahs and spaces 
  90. in the proper order to send your call. The msg1, msg2, and msg3 text
  91. files are prepared using edlin or your text editor.
  92.  
  93. NOTE: In transmit mode, use the <\> (backslash) to send the tty
  94. <BELL> character.
  95.  
  96.  
  97. Version 2.1   -  02/05/83
  98. A type-in message buffer has been added. 
  99. THERE ARE NO PROMPTS TO EXPLAIN THIS FEATURE DURING PROGRAM RUN!!
  100. When the program is in "receive" mode, you may type into the
  101. fifty line buffer. Be sure to end each line with a <cr>.
  102. You may enter text into the buffer at the same time that characters
  103. are being received from the comm adapter.
  104. You cannot correct or edit what you have typed.
  105. What you type will appear, line by line, on screen line 25,
  106. replacing the receive mode prompts. After entering "transmit"
  107. mode, you may transmit this buffer at any time by pressing key 
  108. <F9>.The buffer is effectively erased after transmission.
  109.  
  110. version 2.2 - 02/14/83
  111. 110 baud ascii capability has been added. 
  112. At the function menu, choice <4> will chain the program "asctty".
  113. The protocols are 7 data bits, space parity, two stop bits.
  114.  
  115. GL de AA4L
  116. 9/29/83 -- Note that changes in the FCC regs have eliminated the
  117. requirement for cw identification. You may wish to delete the CWID
  118. routine, as it is no longer needed. This is easiest done by changing
  119. line 16600 to GOTO 15080. Do this in both tty22.bas and asctty.bas.
  120.