home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / windows / win_40 / prog / k_expla.tx_ / k_expla.tx
Text File  |  1997-02-01  |  18KB  |  409 lines
  1. ADDITIONAL NOTES ON RIGMASTER 5.03
  2. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  3.  
  4. 1. PROGRAM HISTORY
  5.    ===============
  6.  
  7. New features of v 1.1 with respect to v 1.0:
  8.  
  9. - DDE: a DDE menu has been added, allowing you to select Client or Server DDE
  10.   and the relevant options;
  11. - Freq. set option: the panel has been redesigned to allow for multiple
  12.   operations without having to re-make the freq. set selection every time;
  13. - some minor improvements in controls operation.
  14.  
  15. New features of v 2.0:
  16.  
  17. - the support of TS850S;
  18. - the capability to perform an automatic SWR measurements set within a
  19.   predifined frequency range, to visualize and print an SWR-versus-frequency
  20.   plot, to store measurement results on file and to retrieve them;
  21. - other operational improvements.
  22.  
  23. New features of v 2.12:
  24.  
  25. - the support of TS450S and TS690S;
  26. - the possibility of graphically comparing SWR plots;
  27. - improvement of SWR plots print;
  28. - modification of Server DDE strings;
  29. - further operational improvements.
  30.  
  31. New features of v 2.32:
  32.  
  33. - the support of TS950SDX;
  34. - possibility to operate the Client and Server DDE modes simultaneously;
  35. - improvement of message parsing procedures.
  36.  
  37. New features of v 2.42:
  38.  
  39. - files are now generated with Visual Basic version 2.0;
  40. - improvement in the SWR graphs presentation.
  41.  
  42. New features of v 3.0:
  43.  
  44. - files are now generated with Visual Basic version 3.0;
  45. - a data base of HF stations for automatic SWL operation. It features
  46.   automatic selection of strongest station, with graphic presentation;
  47. - automatic installation is now available;
  48. - some operational improvements;
  49. - new help structure.
  50.  
  51. New features of v 4.1:
  52.  
  53. - the capability to plot the antenna gain, to print the plot and to
  54.   store/retrieve data to/from file;
  55. - some operational improvements.
  56.  
  57. New features of v 5.03:
  58.  
  59. - total re-design of the DDE facility. The Client-Server distinction does no
  60.   longer exist;
  61. - some operational improvements.
  62.  
  63. 2. NOTES ON SERIAL PORTS UTILIZATION
  64.    =================================
  65.  
  66. Transceiver control requires a free serial port. The program supports COM1,
  67. COM2, COM3 and COM4. If the available serial ports are all utilized, you may
  68. consider purchasing a 2-way (or even 4-way) RS-232 switch (typically around
  69. 30 US$) allowing you to share the same port over many devices. This solution
  70. may be inadequate if you intend to operate RigMaster simultaneously with
  71. other applications (multitasking mode is allowed by Windows) which also make
  72. use of a serial port, such as a packet radio program.
  73.  
  74. To operate in multitasking mode, it is necessary to have serial ports confi-
  75. gured such as to able to operate simultaneously with each other. Although
  76. Windows allows you to install up to 4 serial ports (COM1 ... COM4), it is
  77. worth noting that COM1 and COM3 typically share the same IRQ (IRQ4), so do
  78. COM2 and COM4 (IRQ3). This means that only 2 ports can be simultaneously
  79. active. If you use one port for the mouse and one for your packet radio
  80. program you get stuck, as there are no more ports available to support
  81. RigMaster. You may buy special serial boards which allow circumventing this
  82. problem by selecting a different IRQ, which are becoming cheaper nowadays.
  83.  
  84. An alternative cost-effective solution (do it at your risk !) is that of
  85. making a simple hardware modification to the board supporting COM3 / COM4, so
  86. that at least one of the two ports can operate on an IRQ different from the
  87. standard one. Unfortunately there are not plenty of IRQs to play with. A
  88. viable solution is that of using an IRQ assigned to the parallel ports (IRQ5
  89. or IRQ7). This should not cause problems as long as you use the parallel port
  90. to actually print and not as an input device (this is quite an unfrequent
  91. usage; anyway you would still be able to receive data over the parallel port,
  92. if so required, but not while RigMaster is operational). I would suggest
  93. using IRQ5, because IRQ7 is the default for common sound boards, which are
  94. supported by Windows. It is conceivable to use also IRQ10 and IRQ11 (and
  95. perhaps IRQ9). Access to the first two can only be gained on the second comb
  96. connector, which normally does not exist on typical serial boards. Never use
  97. IRQ2 on 286/386/486 PCs !
  98.  
  99. How to change the IRQ ? Quite simple: cut the appropriate copper strip of the
  100. serial board (consult an hardware engineer if you need assistance) and make a
  101. connection to the IRQ5 connector contact (next to IRQ4 pin). Note that most
  102. serial boards do not even have a contact on the connector at the IRQ5 or IRQ7
  103. position, as it would be of no use for them. It is therefore suggested that
  104. you procure a board having, in addition to the serial port(s), also a paral-
  105. lel port (which you may disable if not needed), this supposedly having the
  106. IRQ5/IRQ7 contact you need.
  107.  
  108. To configure serial ports, run the "Control Panel", select "Port", then
  109. "Settings", lastly "Advanced" and then enter the appropriate IRQ number.
  110.  
  111. As to sound boards, certain model allow you to utilize IRQ10, thus yielding
  112. better flexibility in selecting IRQs for serial ports. Even higher flexi-
  113. bility is achieved by using a "bus mouse" (having a dedicated board typically
  114. configurable also on IRQ5), which frees a serial port.
  115.  
  116. As an example, the following table shows the configuration of my PC.
  117.  
  118. Device          IRQ
  119. ---------------------
  120. COM1            IRQ4
  121. COM2            IRQ3
  122. COM3            IRQ11
  123. COM4            IRQ7
  124. Sound Board     IRQ10
  125. Bus Mouse       IRQ5
  126.  
  127. 3. DIFFERENCES AMONG TRANSCEIVERS
  128.    ==============================
  129.  
  130. Please take note that, depending on the transceiver used, certain controls
  131. will result to be disabled, them not being implemented. These are:
  132.  
  133. - SUB VFO                                        (TS-850S, TS-690S, TS-450S);
  134. - Data ON-OFF control                            (TS-850S, TS-690S, TS-450S);
  135. - VBT control                                    (TS-850S, TS-690S, TS-450S);
  136. - Collector current (Ic) meter                   (TS-850S, TS-690S, TS-450S);
  137. - Compression meter                              (TS-690S, TS-450S);
  138. - dB (AF) meter                                  (TS-950SDX, TS-950S/SD,
  139.                                                   TS-850S);
  140. - Modes CW-R and FSK-R                           (TS-950S/SD);
  141. - Mode TUNE                                      (TS-950SDX, TS-950S/SD,
  142.                                                   TS-690S, TS-450S);
  143. - 270 Hz filter @ 8.83 MHz                       (TS-690S, TS-450S);
  144. - 1.8 KHz filter @ 8.83 MHz                      (TS-850S, TS-690S, TS-450S);
  145. - 250 Hz filter @ 455 KHz                        (TS-850S, TS-690S, TS-450S);
  146. - 12 KHz filter @ 455 KHz in SSB/CW/FSK/AM modes (TS-950SDX, TS-950S/SD).
  147.  
  148. With other Kenwood transceivers, all the TS-950S/SD controls are made
  149. enabled, so you should experiment which of them work in your case and which
  150. not. Again, no tests have been conducted with other equipment, so that
  151. results are unpredictable.
  152.  
  153. As far as filters are concerned, not all the filter positions shown on the
  154. transceiver front panel may actually be operational, unless you buy optional
  155. filters. To be able to manage all possible equipment configurations, the
  156. program shows all the filter positions, so be not surprised if you will not
  157. be able to set certain filters on, simply because you do not have them!
  158.  
  159. With the TS-950SDX, it will be possible to activate only those filters which
  160. can be switched in on the front panel, these varying with the operating mode.
  161.  
  162. 4. FILE STRUCTURES
  163.    ===============
  164.  
  165. All files are so called - comma and "" delimited files - (common spreadsheet
  166. import). They can be easily edited with a normal ASCII editor.
  167.  
  168. Where applicable, it is reminded that the signal strength is represented by
  169. the number of lit LED bars on the S-meter (0 to 30). S-9 correponds to 15 lit
  170. LED bars. One LED bar means a change of 4 dB.
  171.  
  172. 4.1 Antenna plot feature files
  173.     --------------------------
  174.     The generated file has the following format (187-point example):
  175.  
  176. "6-January-93","16:37:25"       ' plot date, time
  177. 187                             ' number of points
  178. 8                               ' plot step, in dB
  179. 1                               ' if 1, rotation was CW during measurement
  180.                                 ' if 0, rotation was CCW during measurement
  181. 8.947369                        ' first point value
  182. 10                              ' ...   ...   ...
  183. 8.947369                        ' ...   ...   ...
  184. 9.473684                        ' ...   ...   ...
  185. 9.473684                        ' ...   ...   ...
  186. 9.473684                        ' ...   ...   ...
  187. 6.842105                        ' ...   ...   ...
  188. 7.368421                        ' last point value
  189.  
  190. Please note that a change of 1 in the value (e.g. 10 to 9) means a change of
  191. 4 dB in signal level.
  192.  
  193. 4.2. SWL feature files
  194.      -----------------
  195. The SWL feature utilizes the following files:
  196.  
  197. - the GROUPS.DB file which contains the existing groups names and the names
  198. of the files (extension .GRO is to implicitly be added) containing data
  199. relevant to each group;
  200.  
  201. - as many .GRO files as the number of groups. Please note that numbers have
  202.   been used to designate file names (e.g. 1.GRO, 2.GRO etc.).
  203.  
  204. In the following, the content of a sample file set is given.
  205.  
  206. - File GROUPS.DB ----------------------------------------------------------
  207.  
  208. 2                      ' total number of .GRO files
  209. 1                      ' file name (1.GRO) associated to the first group
  210. "Broadcast"            ' name of the first group
  211. 4                      ' file name (4.GRO) associated to the second group
  212. "Bullettins"           ' name of the second group
  213.  
  214. Note: as shown in the above example, the .GRO file names are not necessarily
  215. constituted by consecutive numbers.
  216.  
  217. ---------------------------------------------------------------------------
  218.  
  219. - File 1.GRO --------------------------------------------------------------
  220.  
  221. 2                      ' total number of stations on file
  222. "BBC",5,"005","005",2  ' first station name, mode, 8.83 MHz filter,
  223.                          455 KHz filter, number of frequencies
  224. 12345.67,23            ' first frequency, signal strength of first station
  225. 23456.78,18            ' second frequency, signal strength of first station
  226. "VOA",5,"005","005",1  ' second station name, mode, 8.83 MHz filter,
  227.                          455 KHz filter, number of frequencies
  228. 21987.65,11            ' first frequency, signal strength of second station
  229.  
  230. ---------------------------------------------------------------------------
  231.  
  232. - File 4.GRO --------------------------------------------------------------
  233.  
  234. 1                      ' total number of stations on file
  235. "ANSA",6,"007","007",1 ' first station name, mode, 8.83 MHz filter,
  236.                          455 KHz filter, number of frequencies
  237. 3546.98,27             ' first frequency, signal strength of first station
  238.  
  239. ---------------------------------------------------------------------------
  240.  
  241. Please note the following data encodings:
  242.  
  243. - mode is encoded according to following table (where applicable):
  244.  
  245.     1 LSB
  246.     2 USB
  247.     3 CW
  248.     4 FM
  249.     5 AM
  250.     6 FSK
  251.     7 CW-R
  252.     8 TUNE
  253.     9 FSK-R
  254.  
  255. - the 8.83 MHz filter is encoded as shown below (where applicable):
  256.  
  257.    "002" through
  258.    "005" 6 KHz
  259.    "007" 2.7 Khz
  260.    "008" 1.8 KHz
  261.    "009" 500 Hz
  262.    "010" 270 Hz
  263.  
  264. - the 455 KHz filter is encoded as shown below (where applicable):
  265.  
  266.    "002" 12 KHz
  267.    "003" 6 KHz FM (only TS450/690S)
  268.    "005" 6 KHz and, for TS-850S/950S/SD/SDX, also 6 KHz FM
  269.    "007" 2.7 KHz
  270.    "009" 500 Hz
  271.    "010" 250 Hz
  272.  
  273. 4.3. SWR plot files
  274.      --------------
  275. The generated file has the following format (7-point example):
  276.  
  277. "6-January-93","16:37:25"       ' plot date, time
  278. 7,14000,80                      ' number of points, start frequency, step
  279. "Frequency","LED count","SWR"   ' labels
  280. 14000,5,1.5                     ' frequency, lit LED bars count, SWR
  281. 14080,2,1.3                     ' ...       ...       ...       ...
  282. 14160,1,1.15                    ' ...       ...       ...       ...
  283. 14240,1,1.15                    ' ...       ...       ...       ...
  284. 14320,3,1.4                     ' ...       ...       ...       ...
  285. 14400,5,1.5                     ' ...       ...       ...       ...
  286. 14480,8,1.8                     ' ...       ...       ...       ...
  287.  
  288. (the above is the response of my Hy-Gain 204BA 4-element monobander)
  289.  
  290. 5. PROGRAM FILES
  291.    =============
  292.  
  293. - KEN_I0JX.EXE   the main executable Windows 3.1 file
  294. - 850.ICO        a Windows icon for TS-850S owners
  295. - 690.ICO        a Windows icon for TS-690S owners
  296. - 450.ICO        a Windows icon for TS-450S owners
  297. - K_READ.ME      this file
  298. - K_LEGGI.MI     this file translated into Italian
  299. - K_EXPLA.TXT    more details on RigMaster
  300. - K_SPIEG.TXT    as above translated into Italian
  301. - GROUPS.DB      a support file for the SWL feature
  302. - 1.GRO files    a data base file for the SWL feature
  303. - 2.GRO files    a data base file for the SWL feature
  304. - 3.GRO files    a data base file for the SWL feature
  305. - 4.GRO files    a data base file for the SWL feature
  306. - 5.GRO files    a data base file for the SWL feature
  307. - PRO67_7.SWR    a sample .SWR file
  308. - PRO67_14.PLT   a sample .PLT file
  309.  
  310. 6. ADDITIONAL NOTES ON HARDWARE
  311.    ============================
  312.  
  313. Between the standard VGA mode (640x480) and SVGA modes some differences exist
  314. for what concerns fonts appearance. Due to the increasing usage of SVGA
  315. modes, the graphic presentation has been optimized for these modes (both
  316. 800x600 and 1024x768).
  317.  
  318. KEN_I0JX.EXE heavily relies upon colors. I cannot predict the program
  319. operability with a monochrome monitor or a VGA board with less than 256
  320. colors.
  321.  
  322. KEN_I0JX.EXE has been exclusively tested on 33/50/66 MHz machines; but there
  323. should be no reason why the program should not work on other machines. Never-
  324. theless certain features may not work if the computer is not fast enough
  325. (reports welcome).
  326.  
  327. 7. VISUAL BASIC SUPPORT FILES
  328.    ==========================
  329.  
  330. The following files are utilized:
  331.  
  332. - VBRUN300.DLL
  333. - GSWDLL.DLL
  334. - GSW.EXE
  335. - GAUGE.VBX
  336. - GRAPH.VBX
  337. - SPIN.VBX
  338. - THREED.VBX
  339.  
  340. Caution: the corresponding files of Visual Basic 1.0 or 2.0 may not properly
  341. work with KEN_I0JX.EXE.
  342.  
  343. 8. COMMAND LINE SYNTAX
  344.    ===================
  345.  
  346. The command line shall read \XXX\KEN_I0JX.EXE nX, where XXX is the RigMaster
  347. directory and nX is a field to be filled as explained below.
  348.  
  349. If the expression nX is left blank (i.e. the command line is just KEN_I0JX.
  350. EXE), the program will just start assuming COM1 as the default COM port and
  351. DDE disabled.
  352.  
  353. If you instead wish a different default COM port or you wish to directly
  354. activate a DDE feature, please use the following syntax:
  355.  
  356.   n is:
  357.  
  358.   1   to get COM1 as default
  359.   2   to get COM2 as default
  360.   3   to get COM3 as default
  361.   4   to get COM4 as default
  362.  
  363.  
  364.   X sets the program starting mode, according to following table:
  365.  
  366.       |--------|-----------|----------|-----------|-----------|-----------|           
  367.       | normal | minimized |   DDE    |    DDE    |    DDE    |    COM    |
  368.       | window |           | disabled | frequency | frequency | port open |
  369.       |        |           |          |    only   |  & mode   |  Auto ON  | 
  370. |-----|--------|-----------|----------|-----------|-----------|-----------| 
  371. | X=A |   X    |           |     X    |           |           |           | 
  372. | X=B |        |     X     |          |     X     |           |     X     |   
  373. | X=C |        |     X     |          |           |     X     |     X     |   
  374. | X=D |   X    |           |          |     X     |           |     X     |    
  375. | X=E |   X    |           |          |           |     X     |     X     |   
  376. |-----|--------|-----------|----------|-----------|-----------|-----------| 
  377.  
  378.  
  379. For instance, if the commmand line is KEN_I0JX.EXE 4C, the program will
  380. automatically start minimized, with COM4 already open, with "Auto" set to ON
  381. and with DDE set to "Frequency + mode".
  382.  
  383. 9. ANTENNA PLOT
  384.    ============
  385.  
  386. A wide range of signal levels can be used to perform the antenna plot,
  387. however best results should be expected with a signal of about S9+10 when
  388. the antenna is pointing the signal source. If the signal is lower, background
  389. noise or interference may impair the measurement accuracy, especially when
  390. the antenna is pointing 90 deg away from the source. Conversely, with a
  391. stronger signal, the plot step will result to be larger, thus reducing the
  392. plot resolution in Normal view (with the Expanded view however, the resolu-
  393. tion is always the same independently of signal level).
  394.  
  395. As far as the indication of gain is concerned, this is determined by
  396. calculating and processing the value of the gain curve area, and applying
  397. correction factors taking account of the transformation of this curve into a
  398. tri-dimensional surface. These factors were calculated on the basis of
  399. typical Yagi antenna responses.
  400.  
  401. The inaccuracy of provided gain figure mainly arises from:
  402.  
  403. - the imprecision of the above mentioned correction factors (moderate
  404.   impact);
  405. - the S-meter inaccuracy (larger impact);
  406. - the antenna ohmic losses (typically little impact).
  407.  
  408. On the contary, coaxial cable loss has no impact on provided gain figures
  409. (gain is defined at the antenna terminals).