home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / hamcom20 / hc.doc < prev    next >
Text File  |  1991-10-15  |  7KB  |  182 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 HamComm
  7.                               Version 2.0
  8.                            October 10th 1991
  9.  
  10.  
  11.                             W. F. Schroeder
  12.  
  13.                                  DL5YEC
  14.  
  15.  
  16.  
  17. HamComm is a program for ham radio communications.  It supports
  18. reception and transmission of amateur radio teletype and Morse code
  19. signals.  A converter or modem chip is not required.  The audio output
  20. of the receiver is connected to the serial port of any PC/XT/AT
  21. compatible computer thru a very simple and low-cost circuit.  Only one
  22. IC is needed (Op-Amp LM741 or similar) and a few diodes, capacitors and
  23. resistors.  The supply current is drawn from the serial port.  For
  24. transmission the speaker output is connected to the microphone input of
  25. the transmitter thru a passive r/c filter.  Audio frequency decoding,
  26. serial/parallel conversion and all other signal processing is done by
  27. the program. 
  28.  
  29.  
  30. License
  31.  
  32. HamComm Version 2.0 is not in the public domain. 
  33. The author keeps the copyright and all other rights. 
  34.  
  35. You are NOT allowed to:
  36.  - make any modifications to the program
  37.  - distribute the program without this file
  38.  - take more than $10 for distribution including all costs
  39.  
  40. You ARE allowed to:
  41.  - use this program freely for any non-commercial purpose
  42.  - make as many copies as you like and give them away
  43.  
  44. There is no registeration and nothing to pay.
  45.  
  46.  
  47. NO WARRANTY !
  48.  
  49. Because this program is licensed free of charge, the author provides
  50. absolutely no warranty, to the extent permitted by applicable state law. 
  51. Except when otherwise stated in writing, the author and/or other parties
  52. provide this program "AS IS" without warranty of any kind, either
  53. expressed or implied, including, but not limited to, the implied
  54. warranties of merchantability and fitness for a particular purpose.  The
  55. entire risk as to the quality and performance of the program is with
  56. you.  Should the program prove defective, you assume the cost of all
  57. necessary servicing, repair or correction. 
  58.  
  59. In no event unless required by applicable law will the author and/or any
  60. other party who may modify and/or redistribute this program be liable to
  61. you for damages, including any lost profits, lost monies, or other
  62. special, incidental or consequential damages arising out of the use or
  63. inability to use (including but not limited to loss of data or data
  64. being rendered inaccurate or losses sustained by third parties or a
  65. failure of the program to operate with any other programs) this program,
  66. even if you have been advised of the possibility of such damages, or for
  67. any claim by any other party. 
  68.  
  69.  
  70. Computer system requirements
  71.  
  72. HamComm will run under MS-DOS 3.x or higher on any PC/XT/AT-compatible
  73. computer with at least 310KB of free memory.  A harddisk is not
  74. required.  Because of the size of the program file there may be not
  75. enough space to copy all required files onto a 360KB diskette.  On very
  76. slow systems, e.g. 8088 CPU running at 4.77MHz, some functions may not
  77. work as expected or may not work at all. 
  78.  
  79. HamComm will automatically detect the type of video adapter in use. 
  80. MDA, CGA, EGA, VGA and Hercules are supported.  The graphics display
  81. functions are not available on MDAs since the MDA has no graphics mode. 
  82. No attempt has been made to avoid screen flicker (snow) on cheap CGAs. 
  83.  
  84. HamComm will probably NOT run under any kind of multitasking software
  85. like Desqview or Windows since it needs direct control of the interrupt
  86. controller, timer chip and serial I/O hardware. 
  87.  
  88.  
  89. Installation
  90.  
  91. For installation on a harddisk you should create a subdirectory HAMCOMM
  92. and CD to that directory.  HamComm is distributed as a .ZIP or .EXE file. 
  93. To unpack a .ZIP file you need a program like UNZIP or PKUNZIP.  The
  94. .EXE version is a 'self-extracting archive' that contains all the files
  95. and a build-in unpack program.  In both cases the files will be created
  96. in the current directory. 
  97.  
  98. Please read the files README, HC.CFG and CHANGES !
  99.  
  100.  
  101. Program startup
  102.  
  103. To start HamComm type HC at the DOS prompt and hit ENTER.  The interface
  104. circuit is not needed if you just want to play with the program.
  105.  
  106. HamComm normally uses the currently selected video mode.  If you have an
  107. EGA or VGA card with an EGA/VGA monitor you can also switch to 43 or 50
  108. lines.  Try option -L43 to switch to 43 lines on EGA cards or -L50 for
  109. 50 lines on VGA cards. 
  110.  
  111. Many SuperVGA cards have special text modes e.g.  80x60 or 132x44. 
  112. Activate the desired mode before starting HamComm.  Most cards come with
  113. a utility program to do this.  Only the modes where the video display
  114. buffer starts at segment B800 are supported. 
  115.  
  116.  
  117. Screen layout
  118.  
  119. HamComm has SAA-like user interface with pull-down menues, dialog boxes
  120. and online helptexts.  The menue bar at the top of the screen is always
  121. visible if the program is in text mode.  The bottom line has information
  122. about the currently selected menue item. 
  123.  
  124. Every name on the menue bar has a highlighted character.  Press and hold
  125. the ALT key and type that character to select the corresponding menue. 
  126. The cursor-left and cursor-right keys can now be used to switch to the
  127. previous/next menue.  Use the cursor-up and cursor-down keys to move to
  128. the desired function and hit the ENTER key. 
  129.  
  130. Every menue line also has a highlighted character.  Typing that
  131. character (without the ALT key) will get you directly to the
  132. corresponding function. 
  133.  
  134. Some frequently used menue entries have been assigned to function keys. 
  135. The F8 key for example activates the SCOPE function. 
  136.  
  137. The ESC key can be used any time to abort menue selection. 
  138.  
  139.  
  140. Help texts
  141.  
  142. The ALT-H and F1 keys both start the help system.  The ALT-H key
  143. displays general information about the program, the F1 key displays a
  144. help text specific to the current situation. 
  145.  
  146.  
  147. Interface circuit
  148.  
  149. The interface schematics are included in the online help texts.
  150.  
  151.   1. Start the program,
  152.   2. Hit ALT-H to start the help subsystem,
  153.   3. Hit the letter 'O' to select topic 'Overview',
  154.   4. Hit the TAB key to select topic 'Converter' and hit return,
  155.   5. Scroll the help text using the cursor-up/cursor-down keys
  156.      and read the text.
  157.  
  158. Hit ESC to leave the help system.
  159.  
  160.  
  161. The operational amplifier (OpAmp) is used to bring the audio signal from
  162. the receiver up to RS232 level.  The supply current is drawn from the
  163. DTR and RTS pins of the serial port.  The four diodes (1N4148 or
  164. similar) of the receive circuit form a standard bridge rectifier. 
  165.  
  166. The input signal amplitude should be at least 100mVpp.  The 100nF
  167. capacitor removes any DC bias.  Since the OpAmp runs with maximum gain
  168. there will be a (more or less) rectangular waveform at its output.
  169.  
  170.  
  171. Signal processing
  172.  
  173. The amplified audio signal is connected to the DSR modem status input of
  174. the serial port where every zero crossing generates an interrupt. 
  175. HamComm determines the time between successive interrupts and calculates
  176. the corresponding tone frequency.  Comparing the tone to the currently
  177. selected center frequency the program decides wether this is a 'mark' or
  178. 'space' signal.  The mark/space signal is sampled at the proper time
  179. collecting all bits of a character.  When the character is complete it
  180. is converted to ASCII code and displayed in the RX window. 
  181.  
  182.