home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 365.MORSE.DOC < prev    next >
Text File  |  1987-06-24  |  15KB  |  660 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   Morse Tutor  
  12.                                 Operation Manual 
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 1
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.     Introduction 
  72.     ------------ 
  73.  
  74.      This document is intended is to assist you in the operation of Morse
  75.     Tutor.  This may not be the best manual you have ever used but it's
  76.     better than nothing. 
  77.  
  78.     Background 
  79.     ---------- 
  80.  
  81.      I began creating MT on Feb,12,1987 after listening to a code tape and
  82.     realizing that the tape contained insufficient random practice material
  83.     for me to learn code.  I had already located what I had thought were the
  84.     only MS-DOS code practice programs around, and they were not suitable
  85.     for learning the code ( i.e. individual practice etc, same format as
  86.     ARRL tape etc) so fire up the ole compiler ( necessity is the mother of
  87.     invention ) and write your own I said.  We'll I did as you can see and
  88.     it does work as I passed my code test on April 8th.  I have tried to
  89.     make MT as foolproof as possible while still easy to use.  I you don't
  90.     like something let me know.  
  91.  
  92.  
  93.     Program Information 
  94.     ------------------- 
  95.     Source code size is up to 118k and growing still. 
  96.  
  97.     Written in Lattice C 3.1 Small Model ( Good Stuff ) 
  98.  
  99.     Written using the BRIEF editor by Software Solutions. 
  100.       ( The best !!  PC editor ever) 
  101.  
  102.  
  103.     System Requirements 
  104.     ------------------- 
  105.  
  106.     128K Free ram.  ( If I added up the linker map up right ) 
  107.  
  108.     IBM PC or compatible. 
  109.  
  110.     Tested on: 
  111.  
  112.     IBM PC 
  113.     Compaq Portable II 
  114.     Compaq Portable III 
  115.     ATT 6300 
  116.  
  117.     CGA or MONOCHROME ( Mono not tested, let me know if it doesn't work ) 
  118.     Also PC jr not tested let me know of any problems. 
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 2
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.     Operation 
  139.     --------- 
  140.  
  141.     To execute 
  142.  
  143.     Type "morse <cmd>" leaving out the quotes and arrows. 
  144.  
  145.     Optional cmds are 
  146.  
  147.     /f Read configuration file Morse.cfg 
  148.  
  149.          1st line Char Speed 
  150.          2nd line Send Speed 
  151.          3rd line Tone Freq 
  152.  
  153.          Every other line is ignored and can be used for comments. 
  154.  
  155.          Valid Ranges are. 
  156.          Character and send speed 5 to 50 Wpm. 
  157.          Tone 500 to 2000 Hz 
  158.  
  159.      Morse Tutor will look in the current directory for morse.cfg unless
  160.     MTDIR=path is found in the environment.  For example if morse.exe and
  161.     its configuration files are in the util directory on your harddisk place
  162.     set MTDIR=c:\util\ in you autoexec.bat file. 
  163.  
  164.  
  165.     /c Switch to color screen 
  166.          White letters on a blue background 
  167.  
  168.     /a Use alternate learning sequence. 
  169.  
  170.          Introduces characters in the sequence described in the 1970 version
  171.     of "Learning The Radiotelegraph Code" by the ARRL ( See the learning
  172.     help in the program for more information). 
  173.  
  174.  
  175.      Hopefully a small welcome window will popup and stay up for
  176.     approximately ten seconds.  During this time the system is reading the
  177.     configuration file (if "/f" was present on the comand line) creating the
  178.     window buffers and calibrating the timer function.  After a little humor
  179.     the main program screen will be displayed.  
  180.  
  181.     The whole premise of the type of user interface I'm using is that it is
  182.     self explanatory.  Therefore I will not go into any discussion on the
  183.     operation except for some special keys. 
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 3
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.            Key                    Function
  204.     -----------------------------------------------------------------------
  205.           Escape           Abort out of any selection menu
  206.           Insert           Toggle insert and off during setting window
  207.           Backspace        Delete previous char during message input
  208.  
  209.     Special Characters, Valid during message input, read from file, and quiz.
  210.  
  211.         -  Procedural BT
  212.         +      ""     AR
  213.         *      ""     SK
  214.  
  215.     Normal Characters
  216.  
  217.        A Thru Z,  0 Thru 9 and  .,/?
  218.  
  219.         A note about message entry and file reading 
  220.         ------------------------------------------- 
  221.  
  222.          Morse Tutor will look in the current directory for the specified
  223.         file unless MTDIR is present in the enviroment. 
  224.  
  225.          Any char listed above can be used.  If the char is in lower case
  226.         the program will convert it to upper case and char's that are not
  227.         sendable are skipped. 
  228.  
  229.         Comments in text file 
  230.         --------------------- 
  231.          If the character ';' is at the beginning of a line it is not sent
  232.         but is displayed as a comment line.  The maximum length of a
  233.         comment line is 78 characters, if the line is longer than that the
  234.         remainder will be sent in code.  This I thought would be useful
  235.         for instructors. 
  236.  
  237.         Settings window 
  238.         --------------- 
  239.  
  240.         Valid char, send speeds are 5 to 50 wpm. 
  241.  
  242.         Tone frequency 500 to 2000 hz 
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 4
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.         How to learn code 
  271.         ----------------- 
  272.  
  273.         I suggest you obtain "Tune In The World With Ham Radio" by the
  274.         ARRL as a companion text to this program. 
  275.  
  276.         When using this program it is extremely important to listen to the
  277.         rhythm of the character and not the elements that make up the
  278.         character.  I think of code as music, it seems to help. 
  279.  
  280.      1. Select the first group in the learning function. 
  281.  
  282.      2. Listen the group once then enter the quiz function and select
  283.         groups, individual, group A, and see how well you do. 
  284.  
  285.      3. Continue this exercise for approx 10 minutes. 
  286.  
  287.      4. Enter the practice, groups, individual, and select the first
  288.         group. 
  289.  
  290.      5. Copy as much as you can for 5 minutes then stop. 
  291.  
  292.      6. Repeat the above sequence the next day until you can copy 100
  293.         percent and then continue to the next group. 
  294.  
  295.      7. After you have mastered the first group, reduce the individual
  296.         group practice to 5 minutes.  Then practice cumulatively for 5
  297.         minutes. 
  298.  
  299.         Practice for 20 minutes a day and no more.  Above all, listen to
  300.         the rhythm of the character.  Don't make the same mistake I did,
  301.         the first time I tried to learn code, by counting the elements. 
  302.  
  303.         If you practice every day for 20 minutes you should be able to
  304.         pass the novice code test in as little as four weeks. 
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 5
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.         Known problems 
  337.         -------------- 
  338.  
  339.         All problems, as far as I know, have been corrected.  If you find
  340.         any, let me know. 
  341.  
  342.         Problem or comment reporting 
  343.         ---------------------------- 
  344.  
  345.         If you have any comments or find any bugs ( Argh !!) or get an
  346.         error message contact me at the below addresses or systems so I
  347.         can fix them. 
  348.  
  349.         Please supply the following information if reporting a bug: 
  350.  
  351.         Type of system 
  352.  
  353.         Free memory at program startup (use CHKDSK to find this ) 
  354.  
  355.         Any memory resident programs that you are running 
  356.  
  357.         If the problem can be duplicated.  If so, please supply the key
  358.         sequence. 
  359.  
  360.         Error number if one was reported 
  361.  
  362.         GEnie Mail J.DUTHLER ( Checked once a week ) 
  363.  
  364.         Compuserve address 71655,1057 ( I Check Compuserve about once a
  365.         month ) 
  366.  
  367.         Heathkit Store #31 BBS at 913-362-9583 (Checked at least once a
  368.         week). 
  369.  
  370.         Or by mail: 
  371.  
  372.         Jay Duthler 
  373.         7575 W 106th Apt #57 
  374.         Overland Park, Ks 66212 
  375.  
  376.         Or you can call me at home at 913-341-4857 if you prefer ( Early
  377.         evening only, please ). 
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 6
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.         Thought this program is not a SHAREWARE program if you find it
  403.         useful and what to send me something send me a QSL card or some
  404.         mail.  It will bring me great joy to know that this program helped
  405.         you earn your license. 
  406.  
  407.         Program Enhancement 
  408.         ------------------- 
  409.  
  410.         If there is a function that would help you or make the program
  411.         easier to use, let me know.  Some enhancements that I have
  412.         considered are listed below. 
  413.  
  414.      1. Keying of remote keyer via RS-232 port.  ( good for classes ) 
  415.      2. System generated test at end of QSO practice. 
  416.      3. Response time recording/reporting after quiz function. 
  417.  
  418.         Program History 
  419.         --------------- 
  420.  
  421.         Revision  Date                Major fix or addition
  422.         -----------------------------------------------------------------------
  423.          Beta    3/01/87     First release ( Very Buggy )
  424.                  3/02/87     Corrected Quiz results formula
  425.                              Added char 'D' to quiz, learn and practice func
  426.                              Added sanity checks to settings function
  427.                              Corrected problem in group generation, was skipping
  428.                              letters
  429.                  3/03/87     Corrected problem with random number generator, was
  430.                              rounding down and not reaching specified stop
  431.                              parameter. Affected all code generating functions
  432.                              Re-released program as morse303.arc
  433.                  3/05/87     Changed to Large Memory Model compiler
  434.                  3/06/87     Added giggle pops. Cleaned up message window.
  435.                              Enlarged help window. And added ESC ability to all
  436.                              popup windows
  437.          1.0a    3/08/87     Added AR and SK procedural characters.
  438.                              Wrote first decent doc file
  439.                              Re-released as morse308.arc
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 7
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.          1.1a    3/16/87     Changed to new speed calculation formula
  469.                              Corrected misc spelling
  470.                              Incorporated 2 Wpm speed up during Quiz
  471.                              Removed serial number from welcome window
  472.                              Found a nasty bug and changed back to the
  473.                              Small Memory Model
  474.                              Added ctrl-c and ctrl-break trapping
  475.                              Added automatic ignore or DOS abort,retry,ignore
  476.                              during file i/o
  477.                              Save video state at beginning of program
  478.                              Added error trapping for not enough memory for
  479.                              windows system and others
  480.                              Added comment feature to text file
  481.                              Changed character display method
  482.         1.1h     3/25/87     Released as morse326.arc
  483.         1.2a     4/03/87     Changed to a new method of timing which is much
  484.                              more accurate than the previous function.
  485.                              Increased maximum code speed to 50 Wpm.
  486.                              Period was being sent as procedural AR
  487.                              Words practice is much more random and has more
  488.                              data.
  489.         1.2c     4/05/87     Released to the world as MORSE406.ARC
  490.                              Added help sub menu.
  491.                              Added /a command line option.
  492.                              Added calibrate timer message and reworked timer
  493.                              calibration. Only takes 5 seconds now.
  494.                              Added practice words sub menu.
  495.                              Made minor changes to code timing calculations
  496.                              should be as perfect as possible now.
  497.                              Added Environment search feature.
  498.                              Added main window clear, main window hide functions
  499.         2.1a     4/21/87     Released as morse421.arc.
  500.         2.1b     6/24/87     Made minor video attr changes and released as
  501.                              morse624.arc
  502.  
  503.         New releases are uploaded to GEnie, and local BBS's as I make them.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 8
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.     Speed Formula 
  535.     ------------- 
  536.  
  537.      The following assumptions are made. 
  538.  
  539.      The standard speed calibration word "Paris" contains 31 elements that
  540.     make up the dit's, dah's and the spaces between the dit's and dah's that
  541.     make up the characters.  The remaining 19 elements are used to make up
  542.     the spaces between the characters and the spaces between the words.
  543.     With this in mind when you generate code using the Farnsworth method the
  544.     time constant used to generate the 19 elements described above must be
  545.     adjusted to compensate for the compressed character generation. 
  546.  
  547.       Time for each element used in generating character elements. 
  548.  
  549.       e_time = element time in msec. 
  550.  
  551.       e_time = ( 60 / ( 50 * Character speed )) 
  552.  
  553.       Time used for the spacing between characters and words. 
  554.  
  555.       s_time = space element time in msec
  556.  
  557.       s_time = ( 60 - (( e_time * 31 ) * send speed ))/ ( 19 * send speed )
  558.  
  559.       DIT = e_time 
  560.       DAH = e_time * 3 
  561.  
  562.       Space between an element = e_time 
  563.  
  564.       Character space = 3 * s_time 
  565.       Word space = 7 * s_time 
  566.  
  567.  
  568.     If you would like to get started in amateur radio contact: 
  569.  
  570.      American Radio Relay League 
  571.      225 Main Street 
  572.      Newington, Ct 06111
  573.  
  574.      They can put you in touch with a club in your area. 
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 9
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.     Acknowledgements 
  601.     ---------------- 
  602.  
  603.     My wife Julie 
  604.     ------------- 
  605.  
  606.     For putting up with DIT DAHS for months and the two o'clock in the
  607.     morning and all weekend coding sessions ( obsessed, who me?  ). 
  608.  
  609.     Pat Burke. 
  610.     --------- 
  611.  
  612.     For his tutelage in 'C', for without his assistance this would not be. 
  613.  
  614.     Lee Murrah 
  615.     ---------- 
  616.  
  617.     For saving me the time it would take to type in the base for the words
  618.     used for words practice and the variables used in the practice QSO. 
  619.  
  620.     Mike Dodd 
  621.     --------- 
  622.  
  623.     For his paper on precision timing loops which steered me in the right
  624.     direction on software timing loops. 
  625.  
  626.     Kent Larson KL7SD 
  627.     ----------------- 
  628.  
  629.     For testing this release and making valuable comments. 
  630.  
  631.  
  632.                                    End of text 
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.                        MTDOC 24/Jun/87 Replaces 21/Apr/87 Page 10
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.