WESTERN DIGITAL DIAGNOSTIC PROGRAM FOR "PLUS"-FAMILY LAN ADAPTER BOARDS OPERATING INSTRUCTIONS This document contains the procedures for testing the following "PLUS" - Family LAN adapter boards: XT/AT Bus Adapters: StarLAN StarCard PLUS (WD8003S) StarLink PLUS (WD8003SH) Ethernet EtherCard PLUS (WD8003E) EtherCard PLUS With 32K RAM (WD8003EBT) And Boot ROM Socket EtherCard PLUS - software (WD8003EB) configured EtherCard PLUS TP (WD8003WT) Twisted Pair Micro Channel Bus Adapters: StarLAN StarCard PLUS/A (WD8003ST/A) Ethernet EtherCard PLUS/A (WD8003E/A) << DISK FILES >> DIAGNOSE.EXE Diagnostic Program $RUN.OVL -- SYS$MSG.DAT | SYS$HELP.DAT |-- Support FIles SYS$ERR.DAT | DIAGHLP.HLP -- USER.DOC User Documentation (this file) All Diagnostic Program files must be in the same directory for proper operation. << OVERVIEW >> The Diagnostic Program is used to verify the correct configuration and operation of a Western Digital LAN Adapter board before installing the network software. << BEFORE STARTING THE PROGRAM >> 1. Be sure you know the configuration of any adapters that use jumpers to set the configuration. 2. After turning off the PC's power, insert the adapter in the PC. ** Ethernet boards must be on a properly terminated cable (use a BNC "T" connector with two 50 Ohm terminators or an AUI loopback connector). 3. Boot the PC to a DOS prompt. ** Memory resident (TSR) programs and device drivers should not be loaded while the Diagnostic Program is active, so you may need to temporarily rename your CONFIG.SYS and AUTOEXEC.BAT files. The Diagnostic Program is always run without loading any network software. << STARTING THE PROGRAM >> 1. To run the Diagnostic Program change to directory with the Diagnostic Program (\DIAGNOSE on the floppy disk, \WDPLUS\DIAGNOSE on a hard disk) type DIAGNOSE and press Enter. 2. Read the opening screen and press Enter. ** Press F1 any time in this program to get help 3. Press Enter to select a board to test. More than one board may be displayed depending on the number installed in the system. 4. If an error message is displayed then a board is not present. ** The board type and the Base I/O should appear. If two boards are in the machine both boards should be listed. Every network board in a PC must have a unique IRQ and Base I/O. ** If only one board is displayed, and more than one are in the PC, then the Base I/O on the boards is the same. Turn off the PC and check the Base I/O on all boards. Change the Base I/O's so that each board has a unique value. Restart the PC and rerun the Diagnostic Program. 5. Select the adapter to test and press Enter. The board configuration is displayed. Board Type - Displays the board type Base I/O - found by searching all base I/O's IRQ - defaults to three (3) regardless of what IRQ the board is actually set to (see note 1) RAM size - defaults to most appropriate setting (see note 1) RAM address - always defaults to D0000 ROM size - defaults to most appropriate setting (see note 1) ROM status - defaults to most appropriate setting (see note 1) NOTE 1: The EtherCard PLUS EB and Micro Channel boards can correctly read the configuration information off the card. ** Read the file SYSMAP.DOC on SuperDisk Drivers disk for a thorough understanding of the various settings available on Western Digital network adapters. 6. Press any key to continue. << SET CONFIGURATION >> 1. Go to SET CONFIGURATION by pressing S or using the Up/Down arrows if the IRQ, RAM address, RAM Size, or ROM Size and Address need to be changed from the displayed value. 2. The board's network address is displayed. 3. Use the Up/Down arrows to move to the setting that needs to be changed. 4. Press Enter and a menu of options is displayed. Again use the Up/Down arrows to position the highlight bar on the proper option and press Enter to select a new choice. ** The Base I/O and IRQ must match the board settings ** The RAM address selected here is only for the purpose of this program and has no effect on any other network software used afterward. 5. If an invalid selection is made the program will not stop the user from making that selection. 6. Press F10 to save the changes or ESC to exit without change. << BASIC ADAPTER TEST >> 1. The BASIC ADAPTER TEST must be run to verify correct operation. 2. Press B or move the highlight bar using the Up/Down arrows over the BASIC ADAPTER TEST option in the menu and press Enter. 3. This selection tests the basic board functions. The test takes less than a minute and displays "ALL BASIC ADAPTER TESTS COMPLETED SUCCESSFULLY" and "PRESS ANY KEY TO CONTINUE" upon successful completion. 4. The test has failed if any of these conditions occur: A) An error message displays at the bottom of the screen in a RED box; or B) The test hangs up at a certain blinking line and never completes. The blinking line is the test that failed. ** Read the error message or blinking line and write it down!! Then reboot the PC. ** Use the error message or blinking line to find the problem. Common problems include not terminating an Ethernet board and hardware or software conflicts with IRQ, Base I/O, or RAM address. ** A board may be considered defective if it does not pass this test and an identical board with the same jumper settings does pass. 5. If the board fails recheck the board settings, try a different BNC "T" connector and terminator, or remove other boards from the PC. << INITIATE TEST MESSAGE and RESPOND TO TEST MESSAGES >> 1. The best test environment is two PCs directly cabled, but this test can be run with any PCs on the network. 2. These two tests must be run together on two different machines, both of which must have passed the basic adapter test. 3. In this example we will refer to COMPUTER A and COMPUTER B. Start with COMPUTER A Press R or move the highlight bar using the Up/Down arrows to Respond To Test Messages, and press Enter. Press Enter again and a box opens in the middle of the screen with the message: Responding to test messages Press any key to stop COMPUTER A is now ready to respond to test messages and is called the Responder. Go to COMPUTER B Press I or move the highlight bar using the Up/Down arrows to Initiate Test Messages, and press Enter. There are two methods to perform the test. 1. Press Enter to begin the test. The test will perform 1000 iterations after finding the first available responder. 2. If you have more than one responder on the network press F2 and all active responders are displayed with their network addresses. Select the desired responder by using the Up/Down arrows and pressing Enter. Press Enter and the test will perform 1000 iterations. ** If an error message, No Responder Found, is displayed then the two computers cannot communicate across the network. The normal reason for this test to fail is cabling, "T" connectors, or terminators that are bad. When the test is complete press F4 on both computers to find the test results. ** A small number of collisions is normal on a live network or one with multiple test initiators, however Alignment or CRC errors might mean that the board that initiated the messages (COMPUTER B) is bad. Press F6 to clear the results for the next test, then press ESC. At this point the test of the adapters is complete. There are further options available on the initiating computer (COMPUTER B). The option menu is selected by pressing F6. F6 will allow you to set parameters such as the frame length. The Up/Down arrows are used to select the parameters and the spacebar to change parameter values. Set the Iterations to non-stop to run a continuous test. To stop the continuous test press any key. This concludes this additional options test. There are other choices available under the additional options test. << ADVANCED USE >> The Diagnostic Program is also designed to operate from the command line. This method of operation is especially appropriate if your adapter uses a non-factory configuration. Using the command line setup, you bypass having to constantly use the SET CONFIGURATION portion of the program. The following lists the command line parameters available: /base:aaa Specifies base I/O address. /irq:n Specifies interrupt level (IRQ). /ram:aaaaa Specifies base address of the on-board RAM. /rom:aaaaa Specifies base address of the boot ROM. /adapter:n Specifies adapter to test, see note 1. /slot:n Specifies Micro Channel slot adapter to test. /send:xxxxxx Initiates test messages to network address 'xxxxxx'. Each 'x' is a two digit hex value (e.g. C0). /send Initiates test messages to all responders. /respond Echoes received test messages. /test Runs Basic Adapter Test. /v Displays program version and copyright info. /? Displays this help screen. Note 1: Adapter is selected using Base I/O for systems with more than one network adapter. If /ADAPTER:2 was used then the board with the second Base I/O (in ascending order) is tested. These command line parameters can be used in combination in batch files. For example: diagnose /irq:7 /respond Initiates program using IRQ 7 and starts the computer in a responder mode. diagnose /base:320 /test Initiates program using a Base I/O of 320h and runs the Basic Test Program. << SUPPORT >> If you have any additional questions regarding your Diagnostic Program contact your dealer or distributor technical support department. << TRADEMARKS >> Micro Channel is a registered trademark of International Business Machines Corporation.