home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / windows / win_21 / amsoft.iii next >
Text File  |  1997-02-01  |  8KB  |  278 lines
  1. Documentation for WLOGRIGS.DLL
  2. Copyright (c) 1992 by Wayne E. Wright, W5XD
  3.  
  4. Permission to copy one file, WLOGRIGS.DLL, is GRANTED provided that
  5. this file, testplan.txt, accompanies it and that neither is altered
  6. in any way.
  7.  
  8. Attached are the field test versions of the 
  9.     Yaesu
  10.     ICOM
  11.     TenTec
  12.  
  13. rig control libraries for WriteLog. You need version 5.15 of WriteLog (available on 
  14. Compuserve as Wlogdemo.zip) to run this test.
  15.  
  16. Please note that as of October 12, 1992:
  17.  
  18.     THESE LIBRARIES HAVE NOT BEEN TESTED WITH ACTUAL RIGS.
  19.  
  20. They are provided without warranty and you use them at your own risk.
  21.  
  22. They have been simulated as far as is possible WITHOUT the actual hardware, and
  23. are being distributed free of charge in hopes that users of the newly supported
  24. rigs will try them and report their results. A reporting form is attached and:
  25.  
  26.     YOU ARE REQUESTED TO FORWARD A REPORT OF YOUR USE OF THIS SOFTWARE TO
  27.     THE AUTHOR AT:
  28.  
  29.         Austin Code Works, 11000 Leafwood Lane, Austin, Tx 72750
  30.         or Compuserve account: 71034,33544
  31.         or Internet address: info@acw.com
  32.         or fax to 512-258-1342
  33.  
  34. ASSUMING EVERYTHING WORKS, IT TAKES ABOUT TEN MINUTES TO RUN THE TEST PLAN
  35. ATTACHED.
  36.  
  37. Yaesu:
  38. The rigs supported are those for which Yaesu provided documentation:
  39.     FT-1000, FT-990, FT-890, FT-767, and FT-747.
  40.  
  41. They also provided documentation for the FT-736 (VHF rig), and their receiver,
  42. but, according to the manufacturer's documentation, it is not possible to
  43. read the operating frequency from these machines. This limitation makes them
  44. not very useful to WriteLog.
  45.  
  46. The baud rate on the radio must be set to 4800 baud.
  47.  
  48. ICOM:
  49. The software was written using "Icom Communication Interface-V
  50. Reference Manual" provided by Icom.
  51.  
  52. Logging, storing and retrieving of split frequencies is
  53. not supported because there is no way to retrieve the transmit
  54. frequency without altering the rig's state. Also, there is no
  55. control of the rig's PTT over the RS-232 port when sending WAV files
  56. on a sound board.
  57.  
  58. The only difference between all the ICOM entries is the RS-232 address
  59. of rig. The addresses used are:
  60.     IC-725: 0x28
  61.     IC-735: 0x04
  62.     IC-751: 0x1C
  63.     IC-761: 0x1E
  64.     IC-765: 0x2C
  65.     IC-781: 0x26
  66.     IC-271:    0x20
  67.     IC-275: 0x10
  68.     IC-375:    0x12
  69.     IC-471:    0x22
  70.     IC-475:    0x14
  71.  
  72. For both TenTec and Icom, WriteLog originates message on address 0xE1,
  73. and the baud rate must be set to 1200.
  74.  
  75. TenTec:
  76. The rigs supported are the DELTA II, OMNI VI, ARGONAUT II (along with the
  77. OMNI V, which is already a tested and supported WriteLog rig).
  78.  
  79. The serial port is configured at 1200 baud, and WriteLog expects your
  80. rig to be at the "unique identifier" number (same as "address" in ICOM
  81. world):
  82.     Omni VI:    0x01
  83.     Delta II:   0x02
  84.  
  85. With these rigs, logging, storing and retrieving split frequencies is not
  86. supported because, according to the manufacturer's documentation, it is
  87. not possible to read the transmit frequency without switching VFOs--an
  88. intrusive operation that would disrupt operation as WriteLog did dupe
  89. checks.
  90.  
  91. HARDWARE CONNECTINS:
  92.  
  93. Consult your rig's hardware documentation. On the PC end, connections
  94. to pins 2, 3, and 7 are all that are necessary on the usual 25 pin
  95. connection (or 2, 3, and 5 on a 9 pin connection). The computer end
  96. requires RS-232 voltage levels--this may require your use of an
  97. optional level converter--consult your rig's manual.
  98.  
  99. TEST PROCEDURE:
  100. This is a step-by-step test procedure that you are asked to
  101. execute and report. The procedure is designed to minimize
  102. confusion and ambiguity in the reporting process so that any
  103. problems found can be quickly located and corrected. Record
  104. your results on the form attached at the bottom of this file.
  105.  
  106. If something goes wrong during the test, try to continue the 
  107. test if at all possible and record your results on all the steps.
  108.  
  109.  
  110. 1. If you already have a rig control program for your rig,
  111. try it first to confirm that your hardware is correctly
  112. connected. Make this file, testplan.txt, easily available by
  113. bringing it up under the Notepad editor or print a copy of
  114. it.
  115.  
  116. 2. First Exit any WriteLog session you might have open.
  117.  
  118. 3 (deleted)
  119. 4 (deleted)
  120.  
  121. 5. Use the Options Port Setup dialog to select:
  122.     Rig Control Port:       COM1, 2, 3, or 4.
  123.     (Record port number in your report)
  124.     Enable RS-232 Rig Control:  Selected (crossed)
  125.  
  126.     Select your rig
  127.     Select OK.
  128.  
  129. 6. Now Select Bands Set Freq:
  130.  
  131.     Button on "Dupe check and log using rig control port"
  132.  
  133. 7.      Leaving the set freq dialog up,
  134.     Command your rig using the following sequence:
  135.  
  136.     Type "3620" into the "Select Frequency" control.
  137.     Button on "LSB" in the "Select Mode" control.
  138.  
  139.     Button on "SET".
  140.         Does your rig tune to 3620 KHz LSB?
  141.         If not, please note what, if anything,
  142.         did happen.
  143.  
  144. 8. Now try each of the other five "Select Mode"
  145.     buttons, followed by "SET".
  146.     Does your rig switch to each of the modes?
  147.     NOTE: Rigs that don't support RTTY should switch
  148.     to LSB when you select FSK.
  149.  
  150. 9. Button on OK to close the dialog box.
  151.  
  152. 10. Under "Edit Display Format" turn off all except:
  153.     "transmit frequency" button
  154.     "frequency" button
  155.     "mode" button
  156.  
  157.     Button on OK.
  158.  
  159. 11. Tune your rig to 7026.1 Khz CW using its front panel.
  160.  
  161. 12. Type a letter into the CALL field in the "Dupe Band Auto"
  162.     window, and then type the "Enter" key.
  163.     You should get an entry in your log indicating
  164.     7026 XMIT, 7026, FREQ, and MOD CW.
  165.     Please record your result.
  166.  
  167. 13. One at a time, change your rig to all available modes
  168.     (CW, LSB, USB, RTTY, AM, FM, etc.), type
  169.     a letter into the CALL field, and make a log entry
  170.     with the "Enter" key.
  171.  
  172.     In each case, you should get a log entry indicating matching
  173.     the mode on your rig.
  174.     Please record your results.
  175.  
  176. 14. Now tune your rig to 14205.3 Khz, USB using its front panel.
  177.  
  178. 15. Button on the digit "1" in the "STO" column in the Dupe Band Auto
  179.     window. The FREQ column in the same window should change to
  180.     "14205". Please record your result, and estimate how long it
  181.     took between the button click and the change in the WriteLog
  182.     display.
  183.  
  184. 16. Now tune your rig to 14001.0 KHz CW using its front panel.
  185.     Button on the digit "2" in the "STO" column.
  186.     The FREQ column should update. Please record your result.
  187.  
  188. 17. Button on the digit "1" in the "RCL" column.
  189.     WriteLog should tune your rig to 14205.3 Khz USB.
  190.     Please record your result and how long it took.
  191.     You should be able to quickly switch your rig between
  192.     14001 CW and 14205 USB by alternately buttoning on
  193.     the "1" and "2" in the RCL column.
  194.  
  195.     FOR ICOM AND TENTEC RIGS, SPLIT OPERATION IS NOT SUPPORTED.
  196.     SKIP TO STEP 23
  197.  
  198. 18. Tune your rig for split operation:
  199.     Transmit on 7253 KHz LSB.
  200.     Receive on 7074 KHz LSB.
  201.  
  202. 19. Button on digit "1" in the "STO" column
  203.     You should see 7074 in the FREQ column.
  204.  
  205. 20. Type a letter into the CALL field and press Enter.
  206.     You should see 7074 in the FREQ column and
  207.     7253 in the XMIT column.
  208.  
  209. 21. Button on digit "2" in the RCL column
  210.     14001 KHZ CW should be restored.
  211.  
  212. 22. Button on digit "1" in the RCL column.
  213.     7074/7253 split operation should be restored.
  214.  
  215. 23. Mail in your report, please. 
  216.  
  217.     Thanks and 73,
  218.     Wayne E. Wright, W5XD
  219.  
  220. TEST REPORT FORM:
  221. Please fill in this form according to the test procedure above.
  222.  
  223. (personal information is optional)
  224.  
  225. Your name:_______________________
  226.  
  227. Your call:_______________________
  228.  
  229. Your address: _____________________________________________________
  230.  
  231. Your telephone number:_____________________________________________
  232.  
  233. STEP #          SUCCESS?                FAILURE EXPLANATION OR COMMENT.
  234.  
  235. 1.                      Did you try some other program first?
  236.             What program?
  237.  
  238. 2.
  239. 3.
  240. 4.              WriteLog version?
  241. 5.                      Comm port:
  242.             Rig Selected:
  243.             Rig Used:
  244.  
  245. 6.
  246.  
  247. 7.                      Rig set to 3620 LSB?
  248.  
  249. 8.                      Other modes?
  250.  
  251. 9.
  252. 10.
  253. 11.
  254.  
  255. 12.                     Logged at 7026KHz CW?
  256.  
  257. 13.                     Logged various modes OK?
  258.  
  259. 14.
  260.  
  261. 15.             STO button work?
  262.             How long?
  263.  
  264. 16.
  265.  
  266. 17.             Recall button work?
  267.         How long?
  268.  
  269. 18.
  270.  
  271. 19.     STO of split frequency?
  272.  
  273. 20.     Logging of split frequency?
  274.  
  275. 21.
  276.  
  277. 22.     RCL of split operation?
  278.