home *** CD-ROM | disk | FTP | other *** search
/ Troubleshooting Netware Systems / CSTRIAL0196.BIN / attach / pcc / v08n03 / netwrk.exe / WDPOST.ZIP / WDPOST.TAR / wdpost.dir / super / diag / install.doc < prev    next >
Text File  |  1988-06-21  |  11KB  |  289 lines
  1.                          WESTERN DIGITAL 
  2.                      DIAGNOSTIC PROGRAM FOR
  3.                 "PLUS"-FAMILY LAN ADAPTER BOARDS
  4.  
  5.                      OPERATING INSTRUCTIONS
  6.  
  7. This document contains the procedures for testing the following
  8. "PLUS"-family LAN adapter boards:
  9.  
  10.     StarLAN:  
  11.             StarCard PLUS                     (WD8003S)
  12.             StarLink PLUS                     (WD8003SH)
  13.     Ethernet:
  14.             EtherCard PLUS                    (WD8003E)
  15.             EtherCard PLUS With 32K RAM And   (WD8003EBT)
  16.               Boot ROM Socket
  17.  
  18.  
  19. << DISK FILES >>
  20.  
  21.   DIAG8003.EXE   Diagnostic Program 
  22.   INSTALL.DOC    This document
  23.   RELEASE.DOC    Program version number and known problems
  24.  
  25.  
  26. << OVERVIEW >>
  27.  
  28. The Diagnostic Program can be used to verify correct configuration
  29. and operation of a LAN Adapter board before installing the network
  30. software.  
  31.  
  32. Before you use the Diagnostic Program, please note that:
  33.  
  34.    o It should be run directly from DOS.  Running the 
  35.      Diagnostic Program from any network operating system
  36.      may give unpredictable results.
  37.  
  38.    o An Ethernet adapter board will not pass any of the 
  39.      tests unless it is connected to a network that is 
  40.      properly terminated at each end.
  41.  
  42.    o Use of the External Loopback Test may interfere with
  43.      other network software that is running on a network.
  44.  
  45.  
  46. << STARTING THE PROGRAM >>
  47.  
  48. Type 
  49.             DIAG8003
  50.               
  51. and press RETURN.
  52.  
  53. The list of test options will appear as follows:
  54.  
  55.             1. Configuration
  56.             2. Interrupt Test
  57.             3. Read 8390 Registers
  58.             4. Write 8390 Registers
  59.             5. Internal Loopback Test
  60.             6. External Loopback Test
  61.  
  62. Use the ARROW keys to select a test option (1. - 6.) and press 
  63. RETURN to bring up the menu for that test.  To return to DOS from 
  64. this list of test options, press ESC.
  65.  
  66. For the purposes of verifying board configuration and operation,
  67. test options 1, 2, 5 and 6 are appropriate.  Test options 3 and 4
  68. are intended for use by the Western Digital factory and service 
  69. center and are not discussed here.
  70.  
  71. The Diagnostic Program is operated by menus that use the following 
  72. keys for selection:
  73.  
  74.   ARROWS/TAB  Move the cursor between fields in a menu.
  75.  
  76.   SPACE BAR   Sequences through the list of possible values
  77.               for a field.
  78.  
  79.   ESC         Exits the current menu and returns to the 
  80.               previous menu.
  81.  
  82. The following sections describe test options 1, 2, 5, and 6.
  83.  
  84.  
  85. << TEST 1. CONFIGURATION >>
  86.  
  87. Perform this test first.  The screen will display the following 
  88. configuration parameters:
  89.  
  90.        Base I/O Address
  91.        RAM Base Address
  92.        Receive FIFO Depth
  93.        IRQ Channel
  94.        Node Address Selection
  95.  
  96. You must first select values in the Base I/O Address and IRQ Channel 
  97. fields that match the jumper settings on your LAN adapter board.  
  98. Use the SPACE BAR to sequence through the possible values, and the 
  99. UP/DOWN ARROW keys to move between fields in the menu.  
  100.  
  101.         NOTE:  If the Base I/O Address or IRQ Channel values 
  102.                are wrong, none of the tests will pass.
  103.  
  104. The RAM Base Address is determined by the Diagnostic Program, not by
  105. jumpers.  You must select a value that does not conflict with other 
  106. adapters (such as EGA, VGA) that may be installed.  D0000 is usually
  107. a good choice, although D4000 or higher may be required if a VGA
  108. adapter is installed.
  109.  
  110. The Receive FIFO Depth and Node Address Selection fields should not 
  111. be changed.
  112.  
  113. When the correct values are displayed in the fields:
  114.    
  115.    o first reset the LAN controller device by pressing ALT-C;
  116.      press RETURN when prompted;
  117.    o then install the new parameters and start the configuration
  118.      test by pressing ALT-P.
  119.  
  120.         NOTE:  If an Ethernet adapter board is not connected
  121.                to a network that has proper 50-Ohm cable
  122.                terminators at both ends, none of the tests 
  123.                will pass.
  124.  
  125. Possible resulting messages are:
  126.  
  127.    RAM Test Passed     The configuration test is completed
  128.                        successfully.
  129.  
  130.    Checksum Error      The board is not installed at all or is
  131.                        not working, or the configuration 
  132.                        parameters (above) do not match the board 
  133.                        jumper settings.
  134.                       
  135.    No Response From    The board is not working, or an Ethernet 
  136.    8390                network is not properly terminated at 
  137.                        both ends.
  138.  
  139.    RAM Error           The RAM buffer memory test failed.
  140.  
  141. Press ESC when prompted at the completion of the test.  Return to 
  142. the main menu by pressing ESC again.
  143.  
  144.  
  145. << TEST 2. INTERRUPT TEST >>
  146.  
  147. Run this test next to ensure that the interrupt request generated
  148. by the adapter board properly interrupts the PC.
  149.  
  150. Possible resulting messages are:
  151.  
  152.    Interrupt Test Passed      The interrupt test is completed
  153.                               successfully.
  154.  
  155.    Interrupt Test Failed      The interrupt test failed.  Confirm
  156.              or               the correct jumper setting and
  157.    No Response From 8390      Ethernet network termination (if
  158.                               applicable).
  159.  
  160.    WD8003 Not Initialized     The Configuration Test (Test 1.) 
  161.                               was not completed successfully.
  162.   
  163.  
  164. << TEST 5. INTERNAL LOOPBACK TEST >>
  165.  
  166. This test verifies that groups of data (called "frames") can be
  167. transmitted and received correctly by the 8390 LAN controller 
  168. device on the LAN adapter board.  The frames are transmitted 
  169. internally to the same adapter board without using the network.  
  170. An Ethernet adapter board must be connected to a properly
  171. terminated network, however, when this test is run.  The RAM 
  172. buffer memory is not used.
  173.  
  174. Use the SPACE BAR to select a value of 1000 in the ITERATIONS 
  175. field.  This is the number of times the test will run before
  176. reporting the results.  (ITERATIONS=0 means run continuously 
  177. until ALT-P is pressed to stop the test.)
  178.  
  179. Don't change the values in the PATTERN or FRAME LEN fields.
  180.  
  181. When the desired values are displayed in the fields:
  182.  
  183.    o first press ALT-C to clear the statistics;
  184.    o then press ALT-P to start the test.
  185.  
  186. The messages "Internal Loopback In Progress/Internal Loopback 
  187. Test Completed" indicate a successful test.  The Frames Sent
  188. and Frames Received statistics should be equal.  Press ESC
  189. when prompted at the completion of the test.
  190.  
  191. You can start the test over by pressing ALT-C and ALT-P again.
  192. ALT-U is only used to cause a snapshot update of the statistics
  193. while the test is running.
  194.  
  195.      
  196. << TEST 6. EXTERNAL LOOPBACK TEST >>
  197.  
  198. This test allows the adapter board to transmit and receive data
  199. on the network.  
  200.  
  201.      NOTE:  this test may interfere with other network 
  202.             software that is running on the network.
  203.  
  204. For a simple test, you need two systems on the same network
  205. running the External Loopback Test portion of the Diagnostic 
  206. Program.  Select the following values in each system:
  207.  
  208.      System 1   MODE = ECHO
  209.                 ITERATIONS = 0
  210.                 FRAME LEN = 1518
  211.                 CHECK METHOD = NONE
  212.                 DEST.ADDR = (this value doesn't matter)
  213.  
  214.      System 2   MODE = TX/RX
  215.                 ITERATIONS = 1000
  216.                 FRAME LEN = 1024
  217.                 CHECK METHOD = COMPARE
  218.                 DEST.ADDR = the value shown in the SOURCE ADDR
  219.                             field of System 1
  220.  
  221. Once started, System 1 will operate in echo mode indefinitely, 
  222. returning every frame that it receives to the system that sent 
  223. it.  System 2 will send 1000 frames to System 1, checking to
  224. see that it receives each one after it is echoed.
  225.  
  226. Test 6 is operated just like Test 5.  Press ALT-C and then ALT-P 
  227. on each system to start the test.  Be sure to start System 1 
  228. first; then start System 2.  System 2 will stop by itself after
  229. 1000 frames are sent and received.
  230.  
  231. If you have other systems that you want to test, leave System 1
  232. running in ECHO mode while you add the other systems to the
  233. network running the External Loopback Test configured like
  234. System 2.  When you want to stop System 1, press ALT-P.
  235.  
  236. The following information is for more advanced testing.  The 
  237. MODE field selects one of four operating modes:
  238.  
  239.   TX Only Transmits frames (data) to another adapter board 
  240.           without receiving anything.  Set your DEST.ADDR 
  241.           (Destination Address) field value to the address of 
  242.           the other adapter board, which is displayed in its 
  243.           SOURCE ADDR field.  CHECK METHOD is ignored.
  244.           ITERATIONS is the number of frames to transmit.
  245.  
  246.   TX/RX   Transmits frames and waits for echo.  Set the
  247.           DEST.ADDR field of your system to the value shown in 
  248.           the SOURCE ADDR field of the system you want to send
  249.           the frames to.  Use CHECK METHOD = COMPARE.  
  250.           ITERATIONS is the number of frames to transmit.
  251.  
  252.   RX Only Receives frames from other adapter boards.  The 
  253.           address of your adapter board is shown in your 
  254.           SOURCE ADDR field.  DEST.ADDR is ignored.  
  255.           Use CHECK METHOD = CHECKSUM and ITERATIONS = 0.
  256.  
  257.   Echo    Receives frames from other adapter boards and sends 
  258.           each frame back to the adapter that transmitted it.  
  259.           The DEST.ADDR field is ignored.  Set the FRAME LEN 
  260.           field to the maximum value (1518) to ensure that
  261.           it is at least as large as the frame length of any 
  262.           of the frames being received.  Use ITERATIONS = 0
  263.           and CHECK METHOD = NONE.
  264.  
  265. The SOURCE ADDR field is for reference only.  It displays the
  266. LAN address of your adapter board.
  267.  
  268. The DEST.ADDR field is used in the TX/RX and TX Only modes to
  269. specify the LAN address of the adapter board where frames are to
  270. be sent.  The special Destination Address "FF FF FF FF FF FF" 
  271. is the broadcast address:  frames sent to this address should be 
  272. received by all adapter boards on the network except the board 
  273. that sent them.  Use the LEFT/RIGHT ARROW keys to edit this
  274. field.
  275.  
  276. The FRAME LEN field determines the number of bytes of data in 
  277. each frame that is sent.  
  278.  
  279. The PATTERN field shows the data (in hexadecimal) that is sent
  280. in each frame.
  281.  
  282. In some cases, such as the ECHO and RX ONLY modes, it is 
  283. convenient to select ITERATIONS = 0 to let the test run 
  284. continuously.  When doing this, press ALT-P to alternately start 
  285. and stop the test.  Press ALT-U while the test is running to get 
  286. a snapshot update of the statistics, which are normally not 
  287. updated until the test is stopped.  Press ALT-C if you want to 
  288. clear the statistics.
  289.