home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / cat / kenwood / ken_10 / amsoft.iii next >
Text File  |  1997-02-01  |  11KB  |  267 lines
  1.                             
  2.  
  3.  
  4.  
  5.                             AMAZING KENWOOD V.4.2
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                              -- INTRODUCTION --
  13.              
  14.                             
  15. Amazing Kenwood is a no frills Kenwood radio controller created for fast
  16. and easy radio operations.
  17. I have seen several radio controllers, but they all lacked a function or 
  18. two, were too complicated to use, or were specialized for one radio model.
  19. While programming Amazing Kenwood I tried to keep "simple" in mind, and I 
  20. think I've managed to do just that.
  21. The first version took about 20 programming hours to complete, and it took
  22. double that just to write this short document :-)
  23.  
  24.  
  25.                               -- COPYWRITE --
  26.                               
  27.                               
  28. Amazing Kenwood is fully copywrited by Demetre Koymanakos.
  29. Amazing Kenwood is released in the Public Domain area, and must be freely 
  30. distributed free of charge.
  31. Kenwood, TS-50, TS-140, TS-440, TS-680, TS-711, TS-811, TS-940, R-5000 
  32. and IF-232C are copywrited by Kenwood Corp.
  33.  
  34.  
  35.                               -- WARRANTY --
  36.                              
  37.  
  38. This program is only warranted to take up your disk space, and nothing else.
  39.  
  40.  
  41.                          -- VIRUS PROTECTION --
  42.  
  43.  
  44. Amazing Kenwood was originally free from all known virii and trojans,
  45. a built-in anti virii/trojan routine will stop execution of Amazing
  46. Kenwood if it detects any change in the structure of the original 
  47. AK.EXE file.
  48.  
  49.  
  50.                      -- HARDWARE REQUIREMENTS --
  51.  
  52.                          
  53. Amazing Kenwood requires at least a 10 Mhz PC-XT with a serial port COM1,
  54. COM2, COM3 or COM4, a Kenwood IF-232C or compatible interface, and a Kenwood
  55. transceiver or receiver to properly operate. 
  56. Amazing Kenwood was successfully tested on a 80486/50 and 80486/66 clone 
  57. with a Kenwood TS-140S, and TS-680S.
  58.  
  59.  
  60.                             -- FILES YOU NEED --
  61.  
  62.  
  63.     AK.EXE -> Main executable file.
  64.     AK.MEM -> Default external memory file.
  65.  
  66.  
  67.                      -- AMAZING KENWOOD ENVIRONMENT --
  68.  
  69.  
  70. In order for Amazing Kenwood to locate it's memory files, and be executed
  71. from any working directory, the proper DOS environmet must be set in your 
  72. AUTOEXEC.BAT.
  73. First you must add the AK full directory path (were all the needed files
  74. are found) in your PATH setting. 
  75. Second you must add the SET AMAZINGKENWOOD=<path> (were <path> is the full 
  76. path of the AK directory) command.
  77. If you don't wish to make the above changes in your AUTOEXEC.BAT, AK must 
  78. be executed from inside the AK working directory itself.
  79.  
  80.  
  81.                           -- INTERNAL COMMANDS --
  82.  
  83.  
  84. Once Amazing Kenwood runs, you may have a display such as the one that follows:
  85.  
  86.  
  87. ┌────────────────────────────────────────────────────────────────────────────┐
  88. │  AMAZING KENWOOD V.4.2 (c) DK 94-95   RUNNING ON A KENWOOD TS-940  - COM4  │
  89. └────────────────────────────────────────────────────────────────────────────┘
  90. ┌─────────────────────┬─────────────────────┬─────────────────────────┬──────┐
  91. │ VFO A : 145.125.00  │ VFO B :  29.655.00  │  LOCAL TIME : 12:12:12  │  RX  │
  92. ├─────────────────────┴─────────────────────┴────┬─────────┬──────────┼──────┤
  93. │ MODE:CWN         ┐  ┌─┐ ┌─┐ ┌─┐  ┐  ┌─┐   RIT  │ S C A N │  SPLIT   │ LOCK │
  94. │ ANT : 1          │  └─┤ │ │ │ │  │  │ │  +0100 │ MEM  12 │ TONE  10 │ HOLD │
  95. │ ST:00055         ┴ .└─┘ └─┘ └─┘. ┴  └─┘   XIT  │ M.BNK 1 │ OFFSET + │ DCS  │
  96. ├──────────────────┬───────────────────────┬─────┴────┬────┴──────────┴──────┤
  97. │ DX CALL : VE2VE  │ STATION CALL : SV1BCY │ VBT : 12 │ SLOPE HI: 01 LOW: 22 │
  98. └──────────────────┴───────────────────────┴──────────┴──────────────────────┘
  99. ┌────────────────────────────────────────────────────────────────────────────┐
  100. │ [A] VFO A FREQUENCY CHANGE  [P] STEP ON/OFF     1 - VFO A     2 - VFO B    │
  101. │ [B] VFO B FREQUENCY CHANGE  [R] RIT ON/OFF      3 - MEM       4 - COM      │
  102. │ [C] RIT CLEAR               [S] SCAN ON/OFF     5 - MEM CALL  6 - EXT MEM  │
  103. │ [D] SLOPE TUNE              [T] ANTENNA TUNER   7 - QSO DBASE 8 - POWER    │
  104. │ [H] SCAN HOLD               [U] PASSBAND SET    9 - ANT SET   0 - CLK SET  │
  105. │ [I] SPLIT                   [V] VOICE RECALL                               │
  106. │ [L] LOCK CONTROLS           [W] DCS ON/OFF       CRSR UP/DOWN - FRQ UP/DWN │
  107. │ [M] MODE SELECTION          [X] XIT ON/OFF       CRSR RGT/LFT - RIT UP/DWN │
  108. │ [N] TONE OPTIONS            [Y] RIG SWAP          SPACE BAR - TRANSMIT     │
  109. │ [O] OFFSET                  [Z] LOCAL ON/OFF      ALT+Q - QUIT PROGRAM     │
  110. └────────────────────────────────────────────────────────────────────────────┘
  111.  
  112.  
  113. The first physical part of the display identifies the program the version
  114. and the Kenwood radio model that is used.
  115. The second physical part will display all the operating information that is
  116. made available by the radio model used, such as VFO frequency, RIT, XIT ect.
  117. And last the third physical part displays the available commands, these are  
  118. separated into two types, the immediate commands and the parameter commands.
  119. The first (immediate) commands, such as the 1 - VFO A once used will take
  120. effect at once, the second (parameter) commands, such as the [O] OFFSET
  121. will prompt you at the 25th line of the display for input.
  122. All internal commands are fully described in the manual of the radio model
  123. used.
  124.  
  125.  
  126.                           -- EXTERNAL COMMANDS --
  127.  
  128.  
  129. Amazing Kenwood has the following external commands:
  130.  
  131.  
  132.     /C[CALL] : Set your call sign, this command will overide
  133.                the DCS setting of some models.
  134.     /D[NAME] : Defines the QSO dbase utility you wish to run,
  135.                this utility must be in a valid DOS's path, or in
  136.                the Amazing Kenwood working directory.
  137.     /F       : Defines the data base name for the dbase utility
  138.                to load (if supported by the utility).
  139.     /H       : Produces a short help command.
  140.     /N       : AK scans for an active serial port, when one is not 
  141.                defined, this command disables the port scan.
  142.     /P#      : Defines the Serial Port to be used, 1 to 4 are the four
  143.                options available, if an inactive port is selected AK
  144.                will scan for an active port.
  145.     /R       : AK is model sensitive, this command disables the radio 
  146.                model scan.
  147.     /S#      : Changes the Command scan time in seconds, 1 to 10 are 
  148.                the options available with 1 second as a default.
  149.     /V       : Disables internal virii/trojan scan.
  150.  
  151. The "/" may be replaced by a "-" for the command separator sign
  152.  
  153. External command syntax : AK [/command] [/command] [/command]......
  154.  
  155.  
  156.                        -- USING Amazing Kenwood --
  157.  
  158.  
  159. There is very little you should be told in order to successfully run Amazing 
  160. Kenwood, but some commands need explaining:
  161.  
  162. EXT MEM: 
  163.  
  164. The external memory option will call up a small data base of commonly used
  165. frequencies. Once selected the AK will load the default AK.MEM file, 
  166. you may have as many memory files as you like and load them at will.
  167. The memory files are pure text files, and can be edited with the help of 
  168. your favorite text editor.
  169. The memory file consists of four parameters, frequency, mode, vfo, comment,
  170. all separated by comas. Semicolons are ignored.
  171. The memory file must have a maximum of fourty entries, any extra entries are
  172. ignored. The memory files must be located in the working directory of AK.EXE
  173. or in the path directory set by the Amazing Kenwood environment setting.
  174.          
  175. RIG SWAP: 
  176.  
  177. The rig swap will swap serial ports, by this you can control four different 
  178. Kenwood rigs at the same time.
  179. If a non existing or non operating serial port is selected, AK will scan
  180. for an active port.
  181.  
  182. ERRORS:
  183.  
  184. Most possible errors have been trapped and you will be informed with a message
  185. at the 25th line of your display.
  186.  
  187.  
  188.                               -- HISTORY --
  189.  
  190.  
  191. Version 1.0 - The original first version.
  192. Version 2.0 - An external memory option was added.
  193.               A two rig operation option was added.
  194.               Major routines were rewritten for faster performance.
  195.               Minor display bug was corected.
  196.               Frequency entry routine changed to decimal point insensitive.
  197. Version 2.1 - Command display routines are now model sensitive.
  198.               Display routines have been optimized.
  199. Version 3.0 - Major serial communication routine changes.
  200.               A four rig operation option was added.
  201.               Major routines were rewritten for faster performance.
  202.               Minor command bug was corected.             
  203. Version 3.1 - Major Extended Memory display bug was corected.             
  204.               Minor routine rewritten for faster performance.
  205. Version 3.2 - Minor main display bug was corected.
  206.               Minor routine rewritten for faster performance.
  207. Version 3.3 - External QSO dbase logger command added.
  208. Version 4.0 - Support for the R-5000 Kenwood receiver added, after
  209.               the request of a user.
  210.               Support for the TS-50 and TS-440 models added.
  211.               Active port scan added.
  212.               Anti Virii/Trojan routine added for extra safety.
  213.               Environment detection routine added.
  214.               Minor routine rewritten for faster performance.
  215. Version 4.1 - Minor routine rewritten for faster performance.              
  216.               -.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.
  217.               More or less the last DOS version, unless bugs need to 
  218.               be corected.
  219. Version 4.2 - Minor communications routine change to help IF-232C
  220.               interface clones.
  221.  
  222.  
  223.                            -- FUTURE PLANS --
  224.  
  225.  
  226. I'm planning of adding the following in future releases:
  227.  
  228. Windows Amazing Kenwood Version 1.0 (WAK 1.0) 
  229.  
  230.                           
  231.                         -- BUGS AND COMMENTS --
  232.  
  233.  
  234. The program has not been tested with the Kenwood, TS-50, TS-440, TS-711, 
  235. TS-811, or TS-940, any feedback on the above mentioned HF rigs will be 
  236. appreciated.
  237.  
  238. Please report any bugs, comments or suggestions to:
  239.  
  240. Demetre Koymanakos
  241. P.O.BOX 23039
  242. Athens Greece
  243.  
  244. or by E-Mail to :
  245.  
  246. Internet   demetre@intranet.gr 
  247. FidoNet    2:410/101
  248.  
  249.  
  250.                           -- ACKNOWLEDGMENTS --
  251.  
  252.  
  253. Since I'm only a SW listener (not for long I hope), all tests were
  254. performed with borrowed rigs, so a thanks is due to my Amateur friends
  255. who lended me their rigs for my tests.
  256. Also a special thanks to all who wrote to me with their opinion of AK.
  257.  
  258.  
  259.                            -- QSL CARDS --
  260.  
  261.  
  262. If you like this program, or even if you totally hate it, send me your 
  263. QSL card, or a plain post card telling me how much you like Amazing Kenwood
  264. or how much you hate it !!
  265.  
  266. 73's
  267.