home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / HAM / R8TUNER2.ZIP / R8_TUNER.DOC < prev    next >
Text File  |  1992-02-28  |  20KB  |  470 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                 ╔══════════════════════════════════════╗
  8.                 ║                                      ║
  9.                 ║               R8 Tuner               ║
  10.                 ║           Drake R8 to IBM            ║
  11.                 ║       Tuner Interface Program        ║
  12.                 ║                                      ║
  13.                 ║                                      ║
  14.                 ║                                      ║
  15.                 ║                                      ║
  16.                 ║             Version 2.0              ║
  17.                 ║ Copyright (c) 1992 by Mike Musielski ║
  18.                 ╚══════════════════════════════════════╝
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. Requirements:
  26.  
  27.  
  28.         -IBM 286 compatible computer or higher running DOS
  29.          3.3 or higher.
  30.  
  31.         -COM1, 2, 3 or 4 available. This version makes
  32.          provision for adjusting the port to be used. Cable length is to
  33.          your preference and should be dependant on the amount of RF
  34.          coming off you computer.
  35.  
  36.         -DRAKE R8 Receiver obviously.
  37.  
  38.  
  39.  
  40.  
  41.  
  42. Files Included in this package:
  43.  
  44.                    * R8_TUNER.EXE
  45.                    * R8INIT.IN1
  46.                      MEMLOADR.EXE
  47.                    * QSL.LOG
  48.                      R8_BBC.DAT
  49.                      R8_SPAIN.DAT
  50.                      R8_SRI.DAT
  51.                      R8_RFI.DAT
  52.                      R8_NEDR.DAT
  53.                      R8_SWED.DAT
  54.  
  55. *Both the above files must be in the same directory. The others needn't but it is
  56. recommended.
  57.  
  58.  
  59.  
  60. Disclaimer:
  61.         R8_Tuner is provided AS IS. The author specifically disclaims
  62.         any and all warrantees, expressed or implied, including fitness
  63.         for a particular purpose. Use this product at you own risk.
  64.         This software is copyrighted by the author and all rights are
  65.         reserved. The Drake R8 is manufactured by the R.L. Drake Company
  66.         of Miamisburg. Ohio. The author of this software is not affiliated
  67.         with the R.L. Drake Company and does not claim to be representing
  68.         the interests of that company.
  69.  
  70. Registration:
  71.         This product is intended as shareware (user supported
  72.         software). This concept means you can evaluate the
  73.         program on your own machine and determine if you want
  74.         to purchase it. It is not free software and it is not
  75.         in the public domain.  You may distribute
  76.         it freely. But we ask that you also distribute this readme
  77.         file with it when you do. If you find that it meets your
  78.         needs and would like to purchase this software and be placed
  79.         on our mailing list a donation to the project of $35.00 sent
  80.         to the author whose address is discretely provided below is
  81.         requested.
  82.  
  83.         It is our intention to upgrade this product in the future
  84.         with a mouse driven interface, complete simple to use
  85.         Database manipulation, Multi-event timer and automated file
  86.         inport-export capabilities. This will be available only to registered users.
  87.  
  88.         If you have any questions regarding this product or suggestions
  89.         about the future product, please contact the author at:
  90.  
  91.                        Compuserve -71600,614
  92.                        U.S. Mail  -Mike Musielski
  93.                        16 Academy Rd.
  94.                        Madison, N.J.
  95.                              07940
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.                             R8_TUNER  Ver2.0
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112. File Descriptions:
  113. R8_TUNER.EXE  -This is the main program. This is a standalone,
  114.                full screen, menu driven, front-end driver for the
  115.                Drake R8 communications receiver. Once initiated
  116.                the program is designed to take-over as the radio's
  117.                front panel for all operations except analog inputs
  118.                such as volume control, notch adjustment and passband
  119.                offset tuning. The program can be suspended revoking
  120.                front panel control back to the radio for such
  121.                operations as timer (to be implimented in a future
  122.                version), scan operation (also to be implemented
  123.                later) and minor adjustments to tweek in a DX signal.
  124.  
  125. R8INIT.IN1    -must be present in the same directory as R8_TUNER.EXE,
  126.                if it is not, the program will automatically select COM1.
  127.                Use ALT-C to change to the desired COM port.
  128.                If it is necessary to scroll past COM4 and return to
  129.                COM1, COM2 or COM3 the correct procedure is to scroll
  130.                to the desired COM port then press ALT-S to suspend
  131.                the program and then reset the COM port by pressing
  132.                the SPACEBAR to resume the program.
  133.  
  134. QSL.LOG       -This file is a straight ascii text file created
  135.                by the R8_TUNER.EXE program. The file is created
  136.                (if not already present in the same directory) or
  137.                appended whenever ALT-D is selected in the
  138.                R8_TUNER.EXE program. The formating of the text
  139.                appears below.
  140. ╔═══════════════════════════════════════════════════════════════════════════╗
  141. ║                     R8 listing format for QSL.LOG                         ║
  142. ╟─────────┬────────┬──┬──────────┬─┬─┬─┬─┬───┬─┬─┬─┬─┬──────────────────────║
  143. ║         │        │M │          │ │ │ │ │   │ │ │ │ │                      ║
  144. ║         │        │E │          │ │ │ │ │   │ │ │N│ │                      ║
  145. ║         │        │M │   F      │ │ │ │ │   │M│ │O│S│                      ║
  146. ║         │        │  │   R      │V│A│ │A│   │O│ │T│Y│                      ║
  147. ║         │        │C │   E      │F│N│R│G│   │D│N│C│N│                      ║
  148. ║  DATE   │  TIME  │H │   Q      │O│T│F│C│BW │E│B│H│C│ PRGM NOTES           ║
  149. ╚═════════╪════════╪══╪══════════╪═╪═╪═╪═╪═══╪═╪═╪═╪═╪══════════════════════╝
  150. 12-23-1991│16:44:48│14│ 15.26000*│B│2│P│O│6.0│A│O│O│F│bbcnews program
  151. 12-23-1991│17:12:41│28│ 11.62000*│A│1│A│S│4.0│C│F│F│O│SRI to n. euro-dateline
  152. 12-23-1991│18:33:30│99│ 17.08000*│B│2│O│F│2.3│L│O│O│F│
  153. ──────────┴────────┴──┴──────────┴─┴─┴─┴─┴───┴─┴─┴─┴─┴────────────────────────
  154.   Whenever Alt-D is pressed you will be prompted for a note to add to the
  155.   end of the current radios settings in the output log. After adding your
  156.   note, pressing ENTER will add, or create and add, the complete radio setup
  157.   and your note to the file QSL.LOG. TIP: Rename this file with a unique
  158.   name after each days sessions and build a database. More on this later.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166. MEMLOADR.EXE  -Is a stand alone program. When initiated, you are prompted
  167.                for a filename to load. This file is a straight ASCII text
  168.                file formatted exactly like the output file from R8_TUNER.
  169.                It will be search for a + sign immediately following the
  170.                second memory channel number. Any listings with this
  171.                charecter in this exact position will be loaded into the
  172.                radio's memory. The program first scans the input file
  173.                for this designator. Loads all such marked listings into
  174.                a buffer and counts them. If it finds exactly 100 it will
  175.                load the radio's memory channels sequentially. If there are
  176.                less than 100 listings marked, the program will provide you
  177.                with the number marked, prompting for which radio channel
  178.                to start the sequentially load from. If you inadvertantly
  179.                give it a number which when added to the marked listing
  180.                count totals more than 100 the program will abort.
  181.                (The radio's first memory channel is 00 not 1.)
  182.  
  183.  
  184.                The listings marked R8_XXX.DAT are files which can
  185.                be used with MEMLOADR.EXE. They contain a basic radio
  186.                setup and all of the frequencies listed in the World
  187.                Radio and TV Handbook for 1992 for the various
  188.                stations. SRI is Swiss Radio International,
  189.                NEDR is Radio Nederland, RFI is Radio France International,
  190.                the BBC is of course the BBC and the rest are self
  191.                explanitory. A simple text editor such as QEDIT,
  192.                MULTIEDIT or even EDLIN can be used to modify these
  193.                files directly. Be sure to overtype and not insert.
  194.                It is VERY import that the data's positioning on the
  195.                line remain as is.
  196.                There should be no space before the start of the
  197.                first date number. One space between date and time,
  198.                time and memory channel, vfo and ant, ant and rf,
  199.                rf and agc, agc and bw, bw and mode, mode and nb,
  200.                nb and notch, notch and sync, sync and notes as
  201.                illustrated in the above example. This sounds
  202.                more difficult than it is. Actually use the
  203.                overtype mode and Replace the choices with the
  204.                new ones or in the case of making a selection
  205.                place a + immediately following the second number
  206.                of the memory channel. Make sure nothing moves on
  207.                that line when you do and save the file as a pure
  208.                text file. Once saved, from the dos prompt type
  209.                MEMLOADR and press ENTER the program will ask
  210.                for a filename and enter it just as you would
  211.                from the dos prompt, path and all. Just make
  212.                sure you do not overrun the highlighted box.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228. THE FOLLOWING CHOICES ARE AVAILABLE FOR EACH FIELD
  229. ══════════════════════════════════════════════════
  230. MEM CH:   At this time and for the purposes of memory channel loading
  231.           this field has no meaning but must be a 2 place number.
  232.           (I.E. 01 and not just  1). A plus sign immediately following
  233.           the second memory channel number is used as a selector symbol
  234.           by the program memloadr.exe to stuff it to the radio.
  235.  
  236. FREQ.:    This can be changed but not its postion on the line. There
  237.           should always be two spaces between the last memory channel
  238.           number and the first number of the frequency. (One if a plus
  239.           sign is present and the frequency is above 10 MHz.)
  240.           If the frequency is less than 10 MHz a third space or a zero
  241.           can be used. It is important that the number be carried out
  242.           to five decimal places followed by either two spaces or an
  243.           asterisc and a space.
  244.  
  245. VFO:    A or B.
  246.  
  247. ANT:    1 or 2.
  248.  
  249. RF:     O(off), P(preamp) or A(attn).
  250.  
  251. AGC:    O(off), S(slow) or F(fast).
  252.  
  253. BW :    6.0, 4.0, 2.3, 1.8 or 0.5 (The decimal point is required)
  254.  
  255. MODE:   A(am), F(fm), C(cw), R(rtty), L(lsb) or U(usb).
  256.  
  257. NB:     O(off), N(narrow) or W(wide).
  258.  
  259. Notch:  F(off) or O(on) (sorry but with two positions... well it was late)
  260.  
  261. Synch:  F(off) or O(on).
  262.  
  263. Notes:  This field is just for your notes.
  264. (When finished press a return and start on a new line. There
  265. can be no blank lines in the file.)
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276. ╔═════════════════════════════════════════════════════════════════════════════╗
  277. ║                     R8TUNER.EXE OPERATION MANUAL                            ║
  278. ╚═════════════════════════════════════════════════════════════════════════════╝
  279.  
  280.          To START:  -the program type R8_TUNER and hit carriage return.
  281.          To END:    -exit program press ALT-X.
  282.  
  283.         When the program starts, it looks for the file R8INIT.IN1. Not
  284.         finding this file in the current directory will cause the screen
  285.         to loadup with garble. To correct this hold down the ALT key while
  286.         pressing the letter C (ALT-C). Then press ALT-X to exit the program.
  287.         Which will create the file. Then restart the program. Pressing ALT-C
  288.         will scroll through the four available COM ports. Stop when the
  289.         correct port for your installation is displayed in the lower left
  290.         portion of the base screen.
  291.  
  292.         Assuming you are now on the base screen with the correct COM port
  293.         displayed in the lower left portion, pressing any highlighted key
  294.         will open that menu. All the radio's functions can be controlled
  295.         in this manner except certain scan functions. The menus can
  296.         all be exited by pressing the escape key. The time and date displayed are    
  297.         whichever your computor is set for (Local or GMT).
  298.  
  299.  
  300. FUNCTIONS:
  301.         F   -Opens the frequency window and prompts for the frequency
  302.              desired. Enter only numbers in memgahertz. No period.
  303.              (I.E. 9.500 should be entered: 09500 or 0950000)
  304.              The number can be corrected by using the arrow keys or
  305.              the backspace key and reentering the number. Pressing
  306.              ENTER or RETURN stuffs the selected frequency to the radio.
  307.  
  308.         R   -Opens the power menu. Select either O for on or F for OFF.
  309.              In all two selection menus the above will hold true.
  310.  
  311.         M   -Opens the mode menu. Selections can be made by by pressing
  312.              just the highlighted letter (changing the radio immediately).
  313.              Or using the arrow keys (which waits for you to press RETURN
  314.              or ENTER before executing the command)
  315.             -Pressing ESC exits from this menu returning you to the base
  316.              screen with updated information.
  317.  
  318.         W   -Opens the Bandwidth menu. Selections can be made the same way
  319.              as in the mode menu. Press ESC to exit.
  320.  
  321.         G   -Opens the AGC menu. Selections can be made the same way as in
  322.              the mode menu. Press ESC to exit.
  323.  
  324.         P   -Opens the RF menu. Selections can be made the same way as in
  325.              the mode menu. Press ESC to exit.
  326.  
  327.         B   -Opens the Noise Blanker menu. Selections can be made the same
  328.              as in the mode menu.
  329.  
  330.                                 --cont--
  331.  
  332.  
  333.  
  334.         V   -Opens the VFO menu. Selections can be made the same
  335.              as in the mode menu.
  336.  
  337.         A   -Opens the Antenna menu. Selections can be made the same
  338.              as in the mode menu.
  339.  
  340.         S   -Whenever this is pressed the frequency step size will be
  341.              immediately changed.
  342.              (I.E. if the Frequency displayed on the radio is 15.07000
  343.                    pressing this will change the display to 15.0700
  344.                    pressing again will change the display to 15.070)
  345.  
  346.         N   -Opens the Notch menu. Selections can be made the same
  347.              as in the mode menu.
  348.  
  349.         Y   -Pressing this will immediately turn on the Synchro feature
  350.              on the radio.
  351.  
  352. ALT FUNCTIONS:
  353.         F1     -Help file.
  354.  
  355.         ALT-C  -Changes the com port selected. Displays the current
  356.                 choice in the lower left portion of the screen. Pressing
  357.                 ALT-S to suspend the program operation and then pressing
  358.                 the SPACEBAR to resume the program's control will usually
  359.                 re-establish the link using the newly selected COM port.
  360.                 If this doesn't work use ALT-X to exit the program and
  361.                 re-enter the program normally.
  362.  
  363.         ALT-M  -Puts you into memory mode allowing for scrolling
  364.                 through all the current memory channels. The use of
  365.                 U or the up arrow key increments the memory channel
  366.                 on the radio. The use of D or the down arrow will
  367.                 decrement the memory channel on the radio. Pressing
  368.                 the letter G while in this mode will prompt for which
  369.                 channel to GO to directly upon the pressing of the
  370.                 Enter or Return key.
  371.  
  372.         ALT-D  -Opens a prompt window asking for any notes
  373.                 pertaining to the current radio setup or program
  374.                 being listened to before saving the record to the
  375.                 file QSL.LOG. If QSL.LOG does not exist it will be
  376.                 created in the current directory.
  377.  
  378.         ALT-L  -Will open a prompt window asking for the channel you
  379.                 would like to load the current radio setup into.
  380.  
  381.         ALT-S  -Will suspend the program allowing you to manually
  382.                 tweek the radio. After you are finished pressing the
  383.                 spacebar will resume the program and refresh the
  384.                 screen with the current radio information.
  385.  
  386.         ALT-X  -Exits the program and closes all open files and ports.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396. ╔═════════════════════════════════════════════════════════════════════════════╗
  397. ║                     MEMLOADR.EXE Program Manual                             ║
  398. ╚═════════════════════════════════════════════════════════════════════════════╝
  399.  
  400. Discription:
  401.         This is a stand alone program designed to allow the radio's
  402.         memory channels to be automatically loaded from an input file
  403.         provided by the user. It will prompt for the path and filename.
  404.         Unpredictable results may occur if the maximum length is exceeded.
  405.         If the file requested is not present, the program will terminate
  406.         normally with the message:
  407.                        Cannot open the file
  408.                      PROGRAM ABORTED NORMALLY
  409.  
  410.         If the file is present but more than 500 lines the program will
  411.         terminate normally with the message:
  412.          PROGRAM TERMINATED DUE TO MEM_CH.DTA HAVING MORE THAN 500 LINES
  413.  
  414.         If the file has less than 500 lines the file will be loaded and
  415.         checked. If a + sign is present next to the memory channel number
  416.         the line will be prepared for loading into the radio. A counter
  417.         will keep track of the number of selections. If the number is the
  418.         maximum the receiver can handle, (100 selections), the program will
  419.         automatically load the radio beginning with channel number 00 and
  420.         continue until all 100 channels have been loaded. While the
  421.         loading is in progress you will be reminded by a flashing White
  422.         on Red window reading:
  423.                 THE MEMORY CHANNELS ARE BEING LOADED
  424.               Please wait until the radio stops updating
  425.                   then PRESS ANY KEY TO CONTINUE
  426.  
  427. Example of correct input format:
  428. 12-23-1991 17:12:41 28+ 11.62000* A 1 A S 4.0 C F F O
  429. (notes field is not read and is optional
  430.  
  431.         On the conclusion of reading the input file you will be prompted
  432.         for where to start loading the memory channels on the radio.
  433.         (Provided 100 channels were not selected). Enter the channel
  434.         number. This will be the first channel loaded and the program
  435.         will sequentially load the selected programs.
  436.  
  437.        If you inadvertantly provide a channel number which when added
  438.        with the number of programs waiting to be loaded exceeds the
  439.        100 channel maximum the program will abort normally with a
  440.        window reading:
  441.                               DATA OVERRUN
  442.                         UNABLE TO LOAD CHANNELS
  443.  
  444.  
  445.  
  446.  
  447.  
  448.        TIPS:
  449.         Use a ASCII text editor such as QEDIT or MULTIEDIT to edit
  450.         the QSL.LOG file to keep just those programs likely to be
  451.         loaded into memory and save the file under unique names.
  452.         Such as all the frequencys and radio setups you use for
  453.         the BBC could be save in a file named BBC.LOG then when you
  454.         wanted to load the memorys with BBC frequencys just edit
  455.         the file with an ASCII text editor of choice adding a + sign
  456.         next to the memory channel number. Go to the end of the
  457.         file and look at the line count for the file. Make sure this
  458.         isn't larger than 500 lines. A separate file of channels and
  459.         setups can be kept individually for all the frequencys and their
  460.         associated radio setups in uniquely named files.
  461.         When wanting these in memory just rename it to preserve the
  462.         original files add the + signs for the active channels and
  463.         load it. The program will prompt you for where to start the
  464.         sequential load.
  465.  
  466.         Also rename qsl.log at the end of a day's sessions so each is
  467.         a unique name. I.E.:
  468.                  r8122391.log for the qsl.log for dec. 23, 1991
  469.  
  470.