home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HAMRADIO / MCODE.ZIP / CWTUTOR.DOC < prev    next >
Encoding:
Text File  |  1986-10-28  |  5.5 KB  |  97 lines

  1.                                    CW  TUTOR
  2.  
  3.  
  4. CW Tutor is a generic type program to aid in learning Morse code by supplying
  5. a very patient partner with an above average 'fist' to send you 'words'
  6. of code at whatever speed you feel comfortable. Mastering the code is not a
  7. function of your intelligence, but rather a function of your persistence.
  8. Pressures on ones time can make getting into the hobby of amateur radio
  9. more than a little difficult, but 15 minutes of UNINTERRUPTED CONCENTRATION
  10. every day will yield the desired speed increases in very short order. Have
  11. fun and enjoy....after all, its only a hobby.....don't force it.
  12.  
  13. First lets look at how the program is arranged.
  14.  
  15. CW Tutor was originally written about 10 years ago on a Heathkit H-8
  16. 8080A computer. It has since been translated to a KIM-1, a homebrew
  17. 6809 machine, Ohio Scientific. This latest translation was done on an IBM
  18. PC. While it may seem a little plain and even boring, that is purely
  19. intentional. Hopefully it will not be to difficult to make the conversion
  20. to whatever computer system you may have. There is only one MUST. Your
  21. system must have some means to make sound. Almost all the current crop
  22. of micros fall into this catagory. It will be left up to you to make those
  23. changes needed to match your system.
  24.  
  25. The code generator was arranged so that you could select a difficulty level
  26. of from 5 to 42. What this means is that the alphabet, numbers, punctuation,
  27. and special characters are arranged in assending order of difficulty. (Since
  28. I wrote it, I used my own experiences to determine which were harder than
  29. others...arbitary in some cases but basically sound.). If you select level
  30. 5, then you will get a random sampling of the first 5 characters. If you
  31. select 10, you will get the first 5 PLUS the next 5 characters in random
  32. groupings. Always building on the characters presented earlier. For this
  33. reason you should select 5 or 6 characters at a time. Practice them until
  34. you are comfortable with them then 5 or 6 more and work your way all the
  35. way to 42. Then you can go back and begin the process of increasing your
  36. speed.
  37.  
  38. Modifying this program
  39.  
  40. CW Tutor was written using the B-Simple development program. ( I cannot
  41. praise it enough for those that write software in BASIC.) The program is
  42. written as a collection of subroutines called from a short control
  43. program. Each sub-routine begins on an even bounry of 100. For example,
  44. the INTRO routine starts at 100 and returns at 199. The next subroutine,
  45. LEVEL SELECT, starts at 200 and returns at 299. All the routines are arranged
  46. this way. At the end of the program is a listing of all the routines and
  47. their starting locations.
  48.  
  49. Lets get to the major bones of contention first. The routine to make sound
  50. starts at line 700 and returns at line 799. It is just a for/next loop that
  51. times out the sound that was started with the - sound 800,1000 - command.
  52. The IBM BASICA uses this command to generate a sound of 800 hertz for a
  53. duration of 1000/18.2 seconds. Simply, this routine turns on a tone and
  54. times it with the for next loop. The next routine at 800 turns this sound
  55. off. not very difficult huh??? Your system is probably different, but
  56. not by much I suspect.
  57.  
  58. Sub-routine SET ARRAYS at line 400 may cause some problems. While they look
  59. like numbers, they are treated like strings and as such may cause some
  60. problems. Some systems REQUIRE that all strings in the DATA statements be
  61. enclosed in double quotes. The IBM only requires the commas, colons, and
  62. blanks be enclosed. So if you will look carefully on line 470 the comma
  63. is indeed quoted. Check your manual as to these requirements. Problably
  64. won't be different.
  65.  
  66. The only other know rough spot will be the RANDOMIZE routine at line
  67. 600. IBM and MICROSOFT were constipated the day this part of BASICA was written
  68. and it really shows here. You must generate a seed number and enter it into
  69. the program for the random number generator to generate random numbers. This
  70. is the first computer I've used that required this. If yours doesn't then
  71. go to line 21040 and put in a REM statement.
  72.  
  73. That is, as far as I can tell, the extent of modifying this thing to run on
  74. other systems. I didn't do a lot of nice things the make the program more
  75. usable. That I leave up to you. Don't just take this and accept it for what
  76. it is. It was written to be a kernel for you to build on. Some features that
  77. would be really nice would be to test the keyboard on the fly to speed up
  78. or slow down the code or even to add more letters. That tends to get machine
  79. specific so I'll leave it up to you.
  80.  
  81. Ranblings and other valuable stuff...
  82.  
  83. Morse code uses some double letter codes for SK,AR,AS. In order for the 5
  84. character blocks to look neat on the print out these were assigned single
  85. character symbols for printout. AS = #, AR = $, and SK = %. Again, its a
  86. matter of preference. Make whatever changes you deem necessary. By the
  87. way, if you give out before the computer's fist locks up you can bail out
  88. with your CNTRL-C or what ever your machine uses an an abort command.
  89. Drop me some EMAIL on one of the Columbia.S.C. BBS's if you have any problems.
  90. I'll try to help.
  91.  
  92.                                    Good luck on the ticket
  93.  
  94.                                    Gene Brigman, KC4SA
  95.  
  96. ..../.-/--/  /.-./.-/-../../- - -/  /..-./---/.-././...-/./.-./
  97.