home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / cw / cw_06 / amsoft.iii next >
Text File  |  1997-02-01  |  20KB  |  670 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                               THE CODE MACHINE
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                              TABLE OF CONTENTS
  25.  
  26.  
  27.        I.  Introduction .......................................  2
  28.       II.  Getting Started ....................................  3
  29.      III.  Menus ..............................................  4
  30.       IV.  Transmit ...........................................  4
  31.        V.  Words Per Minute (WPM) .............................  5
  32.       VI.  Call Sign ..........................................  7
  33.      VII.  Messages ...........................................  7
  34.     VIII.  Practice ...........................................  8
  35.       IX.  Help ...............................................  9
  36.        X.  Quit ...............................................  9
  37.       XI.  Special Characters .................................  9
  38.      XII.  Connection to Your Transmitter ..................... 10
  39.     XIII.  Date and Time ...................................... 10
  40.      XIV.  System Speed ....................................... 10
  41.       XV.  Disk Files ......................................... 10
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.     ╔══════════════════════════╗
  72.     ║ SECTION I - INTRODUCTION ║
  73.     ╚══════════════════════════╝
  74.  
  75.     This program is distributed as a Shareware product.  The Copyright
  76.     is retained by the author.  The program may be freely copied,
  77.     placed on any bulletin board system, or otherwise freely
  78.     distributed.  Shareware distributors may charge their standard
  79.     rates.
  80.  
  81.  
  82.     If you find The Code Machine to be practical and intend to use it,
  83.     you are asked to become a registered owner by sending a suggested
  84.     $20 contribution to:
  85.  
  86.  
  87.                            Lloyd J. Wilson
  88.                            The Code Machine
  89.                            25701 Park Vista Lane
  90.                            Hemet, CA  92344
  91.  
  92.  
  93.     Registered owners will immediately be sent The Code Machine,
  94.     Version 2.0 (or latest version) and The Code Machine User's Manual.  
  95.     Version 2.0 and above provides an output signal and instructions
  96.     for easily connecting your computer to key your transmitter (see
  97.     Section XII, "Connection to Your Transmitter").
  98.  
  99.  
  100.     Registered owners will also receive update notices when significant
  101.     enhancements to The Code Machine are made available for
  102.     distribution.  Planned future enhancements include: a copy buffer,
  103.     printer support, user selectable colors, user selectable practice
  104.     frequencies, programmable keys, speed adjustments while
  105.     transmitting, sample code tests, and OS support.  User's are 
  106.     encouraged to send additional suggestions for improvements to the
  107.     above address.
  108.  
  109.  
  110.     Those individuals who are using The Code Machine to prepare for
  111.     their first Amateur Radio license are not asked for a contribution.
  112.     Use this program freely as an encouragement and welcome to Ham
  113.     Radio.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                       -2-
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     ╔══════════════════════════════╗
  137.     ║ SECTION II - GETTING STARTED ║
  138.     ╚══════════════════════════════╝
  139.  
  140.     The Code Machine requires and IBM PC, XT, AT, or compatible, at
  141.     least 256K of RAM, and PC-DOS or MS-DOS 2.0 or higher.
  142.  
  143.  
  144.  
  145.     Floppy Disk Systems
  146.  
  147.     To run The Code Machine on a floppy-based system, copy all files on
  148.     The Code Machine distribution disk to a boot disk (a disk formatted
  149.     with the /s option).  After booting up with this disk, enter `TCM`
  150.     (for The Code Machine) to start the program.
  151.  
  152.  
  153.  
  154.     Hard Disk Systems
  155.  
  156.     Create a new directory called "CODE". Copy all files on the
  157.     distribution disk into \CODE.  Log into this directory and enter
  158.     `TCM` to start the program.  This sequence would be as follows:
  159.  
  160.  
  161.               C>MD \CODE
  162.               C>COPY A:*.* \CODE
  163.               C>CD \CODE
  164.               C\CODE>TCM
  165.  
  166.  
  167.  
  168.     Batch Files
  169.  
  170.     A batch file will allow you to enter the program without changing
  171.     directories.  The following example of a batch file named TCM.BAT
  172.     (located in the root directory or a directory for which a path has
  173.     been established) will let you start The Code Machine by entering
  174.     `TCM`:
  175.  
  176.  
  177.              CD\CODE
  178.              TCM
  179.              \CD
  180.  
  181.  
  182.  
  183.     Manual
  184.  
  185.     To print this manual, align your paper to the top of a page, then
  186.     at the DOS prompt type in the following command:
  187.  
  188.                                PRINT TCM.DOC
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                       -3-
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     ╔═════════════════════╗
  203.     ║ SECTION III - MENUS ║
  204.     ╚═════════════════════╝
  205.  
  206.     The Code Machine's menus work like most standard program menus 
  207.     today.  You may either use the arrow keys to identify the selection
  208.     you want and then press the [ENTER] key, or you may simply press
  209.     the first character of your selection.  The second method is
  210.     generally preferred as it requires only one keystroke to obtain the
  211.     desired menu selection.
  212.  
  213.  
  214.  
  215.  
  216.     ╔═══════════════════════╗
  217.     ║ SECTION IV - TRANSMIT ║
  218.     ╚═══════════════════════╝
  219.  
  220.     Once you enter the transmit mode, you will see the cursor located
  221.     at the beginning of the transmit buffer.  Code will be transmitted
  222.     as soon as you begin typing characters into the buffer.  The
  223.     characters will be transmitted at the WPM previously selected (see
  224.     Section V, "Words Per Minute").  If you select a character for
  225.     which a message exists in your message library, that message will
  226.     be placed into the transmit buffer (see Section VII, "Messages").
  227.  
  228.  
  229.     As the code is transmitted, the character that is currently being
  230.     sent will blink.  The transmit buffer is 13 lines long which allows
  231.     you to enter over 1000 characters (13 X 80 = 1040) ahead of what is
  232.     being transmitted.  If more space is needed, the buffer will scroll
  233.     to make room for the additional characters.  The buffer will not
  234.     scroll until all the characters in the top line have been
  235.     transmitted.  For messages, four lines must be available before a
  236.     scroll will occur.
  237.  
  238.     The [ESC] escape key will (1) suspend transmission, (2) clear the
  239.     transmit buffer, and (3) return control to the main menu.  It is
  240.     not necessary to leave the transmit buffer between copying and
  241.     sending sessions, as the program waits when it reaches the cursor.
  242.     Transmission will start again when additional characters are
  243.     entered.
  244.  
  245.  
  246.     The [CTRL]-[S] keys pause transmission until another key is
  247.     touched.  If you select to pause the transmission in the middle of
  248.     a character, the program will resume transmission with the next
  249.     full character, thus preventing transmission of a partial
  250.     character.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                       -4-
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     ╔════════════════════════════════════╗
  269.     ║ SECTION V - WORDS PER MINUTE (WPM) ║
  270.     ╚════════════════════════════════════╝
  271.  
  272.     The Code Machine offers an extremely versatile selection of code
  273.     speeds and modified code speeds.  The speeds and modifications
  274.     selected under menu choice WPM control both the code transmission
  275.     speed and the speed of the practice programs.  Selection of code
  276.     speeds falls into three categories: (1) true speeds, (2) modified
  277.     speeds, and (3) space-elongated speeds.
  278.  
  279.  
  280.     True Speeds
  281.  
  282.     True code speed is just what the name implies. True speed complies
  283.     strictly with the guidelines outlined in the ARRL Handbook:
  284.  
  285.               dit = 1 unit
  286.               dah = 3 units
  287.               space between character elements = 1 unit
  288.               space between characters = 3 units
  289.               space between words = 7 units
  290.               average units per word = 50 units
  291.  
  292.  
  293.     To enter the desired true code speed simply select the WPM option
  294.     off the Main Menu, enter any speed between 1 and 100, and press the
  295.     [ENTER] key.  The speed you selected will be displayed at the top
  296.     right-hand corner of your monitor, followed by a comma and "True".
  297.  
  298.  
  299.     Modified Speeds
  300.  
  301.     Working at slower speeds can be somewhat distracting because the
  302.     lengths of the characters increase excessively.  For example, at 1
  303.     WPM the true length of a dah is 3.6 seconds.  Even at 5 WPM the dah
  304.     is almost 3/4 of a second long (.72 seconds).  With the modified
  305.     speed option, all characters are transmitted at 12 WPM, however,
  306.     the spaces between the characters and words are increased to obtain
  307.     the overall speed selected.
  308.  
  309.     To select the modified code, enter a comma then a `M`  (for
  310.     modified) following the overall speed you select.  For example, if
  311.     you want 8 WPM modified code you will select WPM off the Main Menu
  312.     and enter the following:
  313.  
  314.                       8,M   (then press the [ENTER] key)
  315.  
  316.     The speed you selected will be displayed at the top right-hand
  317.     corner of your monitor followed by a comma and "Mod".  Of course,
  318.     this option only works at speeds under 12 WPM.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                       -5-
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     Space-Elongated Speeds
  335.  
  336.     If you listen closely to a station working CW, you will notice that
  337.     amateurs often leave more space between characters than the three
  338.     units (dah length) of true code, especially when working at the
  339.     slower speeds.  The Code Machine will let you recreate this type of
  340.     code transmission by increasing the space between characters.  You
  341.     can increase the space from 1.1 to 9.9 times what the true length
  342.     would be.  The way to select this option is choose WPM from the
  343.     Main Menu, select your WPM then enter a comma followed by the
  344.     increase desired (elongation factor).  For example, if you want to
  345.     double the space between characters and send characters at a rate
  346.     of 10 WPM, enter the following at the WPM prompt:
  347.  
  348.                 10,2
  349.  
  350.     If you only wished to increase the length by 1 1/2 times (a 50%
  351.     increase) you would enter:
  352.  
  353.                 10,1.5
  354.  
  355.  
  356.     1 3/4 would be:
  357.  
  358.                 10,1.75
  359.  
  360.  
  361.     2 1/2 would be:
  362.  
  363.                 10,2.5
  364.  
  365.     and so on.
  366.  
  367.  
  368.     With the space-elongated selection, the characters will be sent at
  369.     the true rate, however, the increased length between characters
  370.     will decrease your overall transmission rate.  Your actual rate can
  371.     be calculated with the following formula:
  372.  
  373.                        WPM = WPM - ((WPM X .38)(X-1))
  374.  
  375.                          where X = elongated factor
  376.  
  377.     So, for example, if you selected 13 WPM and doubled your space
  378.     between characters (13,2) your actual code speed would be:
  379.  
  380.                          WPM = 13-((13 X .38)(2-1))
  381.                          WPM = 13-(4.94 X 1)
  382.                          WPM = 13-4.94
  383.                          WPM = 8.06
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                       -6-
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.     ╔════════════════════════╗
  401.     ║ SECTION VI - CALL SIGN ║
  402.     ╚════════════════════════╝
  403.  
  404.     The call sign option is a very power and useful capability of The
  405.     Code Machine.  To use the option, simply select `Call Sign` from
  406.     the Main Menu and at the prompt enter the call sign of the station
  407.     you are working.  The call sign will be displayed in the upper left
  408.     corner of your monitor.  Once you have entered the call sign press
  409.     [ENTER] to return to the Main Menu.
  410.  
  411.     Now when you are entering data in the transmit buffer, you can
  412.     simply select the colon [:] key and the station's call sign will be 
  413.     entered into the transmit buffer.
  414.  
  415.     Additionally, this command can be embedded into your messages--more
  416.     on this in the Messages Section.
  417.  
  418.  
  419.  
  420.     ╔════════════════════════╗
  421.     ║ SECTION VII - MESSAGES ║
  422.     ╚════════════════════════╝
  423.  
  424.     You may store 22 messages of up to 255 characters each to use
  425.     during transmission.  Then by selecting only one key, that message
  426.     will be displayed in your buffer and transmitted.  There are no
  427.     special requirements and the messages can be inserted while you are
  428.     typing just as if you were entering another character.
  429.  
  430.  
  431.     Messages are automatically saved to your disk as you originally
  432.     enter them or change them.  All previously entered messages are
  433.     loaded when you start The Code Machine.  The messages are stored on
  434.     your disk in a file named TCM.MES.  If your program does not find
  435.     the TCM.MES file when it starts up, it creates a new one.  Ensure
  436.     that the disk containing The Code Machine has at least 6K of
  437.     available space in order to store your messages.  If you do not
  438.     have available space on your disk your TCM.MES file will be lost.
  439.  
  440.  
  441.     To enter new messages or view previously stored messages, select
  442.     `Messages` from the Main Menu.  You will be prompted to select the
  443.     key that corresponds to the message you want.  After selecting the
  444.     key you will be shown the current message stored for that key and
  445.     asked if you want to change it.  Select `Y` to enter a new message
  446.     and `N` to return to the Main Menu.  After selecting `Y`, you are
  447.     prompted to enter a message.  Each message can contain between 1
  448.     and 255 characters.
  449.  
  450.  
  451.     The Code Machine provides a very powerful method for entering
  452.     messages containing the call sign of the station being worked.
  453.     Enter the colon [:] in any message and the call sign of the station
  454.     your are working will replace the colon when that message is
  455.     called.
  456.  
  457.  
  458.                                       -7-
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.     Remember to select one key to represent your own call sign.  For
  467.     convenience, select a key that does not require you to use the
  468.     [SHIFT] key.
  469.  
  470.  
  471.  
  472.     ╔═════════════════════════╗
  473.     ║ SECTION VIII - PRACTICE ║
  474.     ╚═════════════════════════╝
  475.  
  476.     The Code Machine's practice programs use your computer's speaker to
  477.     output code at the rate previously selected with the WPM option.
  478.     Selecting `Practice` from the Main Menu drops down the Practice
  479.     Menu and allows you to select from seven different practice
  480.     programs.
  481.  
  482.  
  483.     Choose Characters
  484.  
  485.     This option allows you to select individual characters you need to
  486.     practice.  You will be prompted to enter the characters you want to
  487.     practice.  You may select as many characters as you wish (up to
  488.     255). The characters will be randomly selected and placed in the
  489.     transmit buffer in groups of five.  You may select characters more
  490.     than once-their random selection will be proportional to the number
  491.     of times you select them.
  492.  
  493.  
  494.     Alpha Characters
  495.  
  496.     All twenty-six letters will be randomly selected and placed in the
  497.     transmit buffer in groups of five.
  498.  
  499.  
  500.     Numeric Characters
  501.  
  502.     Numbers 0 thru 9 will be randomly selected and placed in the
  503.     transmit buffer in groups of five.
  504.  
  505.  
  506.     Special Characters
  507.  
  508.     The special characters (see Section XI, "Special Characters") will
  509.     be randomly selected and placed in the transmit buffer in groups of
  510.     five.
  511.  
  512.  
  513.     Letters and Numbers
  514.  
  515.     All letters and numbers will be randomly selected and placed in the
  516.     transmit buffer in groups of five.
  517.  
  518.  
  519.     Total Character Set
  520.  
  521.     All letters, numbers, and special characters will be randomly
  522.     selected and placed in the transmit buffer in groups of five.
  523.  
  524.                                       -8-
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.     Use Transmit Buffer
  533.  
  534.     This selection works identical to the Transmit Mode except that an
  535.     audible frequency is sent to the computer's speaker.  Text can be 
  536.     entered directly or sample tests and sample QSO's can be stored as 
  537.     messages and then called up in this practice mode.   Note: Users of
  538.     Versions below 2.0 will find no difference between this selection
  539.     and `Transmit` on the Main Menu.
  540.  
  541.  
  542.  
  543.     ╔═══════════════════╗
  544.     ║ SECTION IX - HELP ║
  545.     ╚═══════════════════╝
  546.  
  547.     Selecting help from the Main Menu will drop down an ON/OFF menu
  548.     that will let you toggle the help screen on and off.  If ON is
  549.     selected, the help screen will be displayed when you are in the
  550.     Transmit Mode.  This provides a quick reference to the special
  551.     characters while transmitting.
  552.  
  553.  
  554.  
  555.     ╔══════════════════╗
  556.     ║ SECTION X - QUIT ║
  557.     ╚══════════════════╝
  558.  
  559.     Selecting `Quit` from the Main Menu returns control of your machine
  560.     to DOS.
  561.  
  562.  
  563.  
  564.     ╔═════════════════════════════════╗
  565.     ║ SECTION XI - SPECIAL CHARACTERS ║
  566.     ╚═════════════════════════════════╝
  567.  
  568.     The following special characters and functions are supported by the
  569.     keys indicated:
  570.  
  571.  
  572.            [CONTROL] - [S] = Pauses transmission of characters
  573.            [-] dash = error
  574.            [\] backslash = KN
  575.            [/] slash = WAIT
  576.            [+] plus = AR
  577.            [=] equals = BT (double dash)
  578.            [;] semicolon = SK
  579.            [.] period = period
  580.            [,] comma = comma
  581.            [?] question mark = question mark
  582.            [SPACE BAR] = space between words
  583.            [ESC] esacape = stops transmission, clears buffer, Main Menu
  584.            [BACKSPACE] = moves cursor one space left and clears the
  585.                          character in that space from the buffer
  586.  
  587.  
  588.  
  589.  
  590.                                       -9-
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.     ╔══════════════════════════════════════════════╗
  599.     ║ SECTION XII - CONNECTION TO YOUR TRANSMITTER ║
  600.     ╚══════════════════════════════════════════════╝
  601.  
  602.     Keying your transmitter with The Code Machine Version 2.0 and above
  603.     is a simple matter of connecting two components (an optocoupler and
  604.     a resister) between the computer and the transmitter.  The
  605.     optocoupler is  available at Radio Shack for less than two dollars.
  606.     Full connection details are included in the Version 2.0 Manual.
  607.     Versions below 2.0 can also be connected but require additional
  608.     circuitry.
  609.  
  610.  
  611.     ╔══════════════════════════════╗
  612.     ║ SECTION XIII - DATE AND TIME ║
  613.     ╚══════════════════════════════╝
  614.  
  615.     The current date and time are shown at the top of your monitor.
  616.     The clock is suspended during code transmission.  Once you return
  617.     to the Main Menu the clock will update itself and resume.  You may
  618.     use the suspended time to mark the beginning of a QSO.
  619.  
  620.  
  621.  
  622.     ╔════════════════════════════╗
  623.     ║ SECTION XIV - SYSTEM SPEED ║
  624.     ╚════════════════════════════╝
  625.  
  626.     The Code Machine relies on system timing to accurately calculate
  627.     code speeds.  Because of the many different system clock
  628.     frequencies used by various compatible computers, the program does
  629.     a test when started to determine the speed of your computer.  This
  630.     results of this test are then used as the basis for the timing of
  631.     your code.  For this reason, users with selectable clock
  632.     frequencies (often called turbo) should not change their turbo
  633.     setting during operation of the program.  If you change your turbo
  634.     option while running the program, it will be necessary to restart
  635.     The Code Machine so the program's timing can be adjusted to the 
  636.     computer's new clock frequency.
  637.  
  638.  
  639.  
  640.     ╔══════════════════════════╗
  641.     ║  SECTION XV - DISK FILES ║
  642.     ╚══════════════════════════╝
  643.  
  644.     The following files should be on your The Code Machine disk:
  645.  
  646.              TCM.EXE  (The Code Machine Program)
  647.              TCM.SYS  (The Code Machine Program)
  648.              TCM.DOC  (The Code Machine Manual)
  649.              TCM.MES  (Message file - Created by the program if not on
  650.                        the disk)
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                      -10-
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.