User Diagnostics Manual (USERCISC.TXT) 12/9/97 Digi International, Inc. Table Of Contents 1.0 Scope 2.0 Applicable Documents 3.0 Memory Map Utility (DIGIMMAP.EXE) 3.1 General Description 3.1.1 Display Conventions 3.1.2 Keyboard Conventions 3.2 Functional Description 3.2.1 BIOS Scan 3.2.2 RAM Scan 3.2.3 User Interface 3.3 Product Limitations 4.0 User Diagnostic Utility (UD-CISC.EXE) 4.1 General Description 4.1.1 Display Conventions 4.1.2 Keyboard Conventions 4.1.3 Supported Product Families for the User Diagnostics 4.2 Functional Description 4.2.1 General Information Screen 4.2.2 Main Menu Screen 4.2.3 Main Help Screen 4.2.4 System Error Messages 4.3 PC/Xe & PC/Xi Adapter Product Family 4.3.1 General Information 4.3.2 Help Screens 4.3.3 Basic Test Descriptions 4.3.4 Error Messages 4.4 MC/Xi Adapter Product Family 4.4.1 General Information 4.4.2 Help Screens 4.4.3 Basic Test Descriptions 4.4.4 Error Messages 4.5 C/X Adapter Product Family 4.5.1 General Information 4.5.2 Help Screens 4.5.3 Basic Test Descriptions 4.5.4 Error Messages 4.6 MC/Xe Adapter Product Family 4.6.1 General Information 4.6.2 Help Screens 4.6.3 Basic Test Descriptions 4.6.4 Error Messages 4.7 COM/XI Adapter Product Family 4.7.1 General Information 4.7.2 Help Screens 4.7.3 Basic Test Descriptions 4.7.4 Error Messages 1.0 Scope This document contains information related to the User Diagnostics package. All files for this package are contained on the floppy disk, and include this document, two executable programs, and release notes. This document explains the memory map utility (DIGIMMAP.EXE) and the user diagnostics (UD-CISC.EXE). 2.0 Applicable Documents C/X Adapter Installation Guide DBI 90027700 COM/Xi Adapter Installation Guide DBI 90022100 Combo Hardware Manual DBI 90029100 PC/Xe (old) & PC/Xi Adapter Installation Guide DBI 90026700 PC/Xe (new) Adapter Installation Guide DBI 90028600 MC/Xi Adapter Installation Guide DBI 90026600 PC/Xe & MC/Xe (8K) Adapter Installation Guide DBI 90028800 3.0 Memory Map Utility (DIGIMMAP.EXE) 3.1 General Description The memory map utility is an MS-DOS based executable program that is designed to aid in the installation of Digi hardware by detailing locations in memory that are available for the Digi product. 3.1.1 Display Conventions When the memory map utility is run, a main screen will appear. From the main screen, the operator may select a "Help" screen, run the utility, or return to the operating system. The upper portion of the screen displays the current version of the utility and copyright information. The middle of the screen displays data for operator's current selection. The lower portion of the screen is used for the operator interface. 3.1.2 Keyboard Conventions Three keyboard entries are used by the memory map utility. is used to run the utility, displays the "Help" screen, and is used to return to the operating system. The utility uses the bottom of the screen to prompt the operator for keyboard inputs. 3.2 Functional Description DIGIMMAP attempts to locate hardware in the upper 384K of the first megabyte of memory of an IBM PC or compatible. The memory range checked is from A0000H to FFFFFH. Typical devices in this area may include video ROMs, system ROMs, hard disk adapters, and network adapters. DIGIMMAP performs a ROM scan and a RAM scan to locate hardware residing in upper memory. 3.2.1 BIOS Scan This portion of the utility searches from C0000H to EFFFFH in 2K increments by checking the first two bytes of the region for a BIOS signature of 55AAH. If a ROM signature is found, the third byte indicates the number of 512 byte sections and the appropriate area is marked as unavailable. 3.2.2 RAM Scan This is a scan of the memory regions which were unused accoding to the previous test. The RAM scan also breaks memory down into 2K sections. If the section is writable the section is marked as RAM as is unavailable for the Digi product. If it is not writable, another type of ROM check is done, followed by either marking the area as ROM, or available for Digi product installation. ROMs found in the F0000H to FFFFFH area are considered System ROMs. 3.2.3 User Interface The following steps are suggested to run this utility. 1. Boot the system normally. This brings up the system in its normal configuration. This should cause the RAM on any adapters to be ON. If the memory is switched OFF, DIGIMMAP may not locate it. 2. Place a clean (NO TSR's and NO memory managers) boot floppy in drive A. Press Ctrl-Alt-Del to reboot the system. DO NOT use use a hardware reset to reboot as this will typically reset any adapters in the system. 3. Place the utility disk in drive A, and enter A:DIGIMMAP at the system prompt. 4. The main menu will be displayed. The following warning messages are displayed. Memory managers, used to load drivers and TSRs into the DOS high memory area, may cause DIGIMMAP to display incorrect results. DO NOT run DIGIMMAP under Windows, WFW, Windows 95, Windows NT etc. They use the high memory region, which may cause DIGIMMAP to display incorrect results. DIGIMMAP does writes to high memory. This may cause the system to lock up. Do not be alarmed, just reboot the system. 5. Pressing from the main menu display will begin the high memory search. This is a four part process. First it scans from C0000H to C7FFFH for video ROMs, then scans C8000H to DFFFFH for general ROMs, then scans E0000H to EFFFFH for expansion ROMs. The last part scans memory from A0000H to FFFFFH for RAM and other ROMs. For this check, a memory write is done to memory locations. Messages will appear at the bottom of the screen as the utility goes through the four checks. When these are complete, three sections will be displayed. The lists are 8K, 32K, and 64K available windows. Select an address from the size that corresponds to the adapter under test. These results are an educated guess of the areas in high memory that could be used to install the Digi product. 3.3 Product Limitations If an adapter has RAM mapped to the high memory area but it only gets activated (mapped) upon instruction from the driver (like some Digi products) and if this instruction has not been given, the adapter may go undetected. Any extended memory manager will cause DIGIMMAP to deliver false data. Since the memory manager is utilizing the upper memory area itself, DIGIMMAP will confuse this usage with hardware RAM areas. In some cases a memory manager will install itself like a BIOS. That is to say, it will contain a 55AAH signature in the first two bytes of its driver. If a driver loads itself high, DIGIMMAP will have the same difficulties with the driver as it has with the extended memory managers. The general rule is to keep the software out of high memory when DIGIMMAP is executing. DIGIMMAP will try to write to the first byte of each 2K block of memory that is found not to contain ROM. This could have adverse effects on the system if the adapter interprets it as an instruction. This is unlikely, but possible. 4.0 User Diagnostic Utility (UD-CISC.EXE) 4.1 General Description The user diagnostic utility is an MS-DOS based executable program that is designed to aid in the installation and troubleshooting of Digi hardware by performing a series of tests on the adapter. 4.1.1 Display Conventions When the user diagnostic utility is run, a general information screen is displayed, followed by the main screen. From the main screen, the operator may select a "Help" screen, run the utility, or return to the operating system. There are four sections to the display. The upper section of the screen displays the current version of the utility and copyright information. The next section is the parameter selection section. The next section displays test results when the diagnostic is executing. The lower portion of the screen is used for the operator interface. 4.1.2 Keyboard Conventions There are multiple keyboard entries for the user diagnostic utility. Adapter parameters have unique keyboard entries. When all parameters have been entered, press to run the utility. Pressing displays various help screens. is used to return to the operating system. The utility uses the bottom of the screen to prompt the operator for keyboard inputs. 4.1.3 Supported Product Families For The User Diagnostics The current release of the user diagnostic supports the AccelPort Xe adapters, AccelePort C/X adapters, PC/Xe adapters, PC/Xi adapters, MC/Xi adapters, MC/Xe adapters, C/X adapter adapters, and the COM/Xi adapters. 4.2 Functional Description The user diagnostic is a program that will test a Digi product for system compatability and adapter reliability. After all parameters have been entered, the operator may run the diagnostic. A configuration file (UD-CISC.CFG) is written to disk when program execution begins. When the program is run again, the configuration information is read and displayed for the operator. The operator can immediately run the diagnostics by pressing , or reenter any parameters prior to running the diagnostics. 4.2.1 General Information Screen This screen gives the operator an overview of how to correctly run the user diagnostics. Appropriate warning messages are also displayed. 4.2.2 Main Menu Screen Following the general information, the main screen appears. This program is designed to support multiple Digi products. The operator must select a product family displayed at the bottom of the screen. 4.2.3 Main Help Screen Prior to selecting a product family, pressing will display a product family information screen. 4.2.4 System Error Messages This program requires that the machine be at least a 386, that it is not running in virtual mode(a DOS window), and that there are no memory managers present. If any of these conditions exist, one of the following three messages will be displayed and the program will exit to DOS. Program requires 386 or better CPU to run ... aborting to DOS O/S. CPU is in Virtual Mode ... clean-boot DOS O/S to run this program. Installed memory driver(s) found ... clean-boot DOS O/S. If the program has previously been run, a file, UD-CISC.CFG, was created. If this file is present, the program will attempt to read it again to use the previously selected paramters. If there there is an error, the following message is displayed: ERROR! The diagnostics have detected a .CFG file error. ERROR! Erase the configuration file, UD-CISC.CFG; then rerun the diagnostics. One of the configuration items that is stored is the system bus type. This is either ISA/EISA or Micro Channel. If the stored data does not match the bus the program found, the following error message is displayed. ERROR! The diagnostics have detected a bus conflict. ERROR! The diagnostic reported an ISA/EISA bus. The disk file reported a Micro Channel bus. (or) The diagnostic reported a Micro Channel bus. The disk file reported an ISA/EISA bus. Erase file 'UD-CISC.CFG, then rerun the diagnostics. When UD-CISC.CFG is erased the operator must enter new parameters and the new UD-CISC.CFG will be written upon execution. Executing the diagnostic again on the same machine should result in no further bus conflicts. 4.3 PC/Xe & PC/Xi Adapter Product Family Adapters in this product family are intelligent adapters with an 80186 CPU embedded on the adapter. They communicate with the host via dual ported memory and interrupts. They support asynchronous communication with 2, 4, 8, or 16 ports. 4.3.1 General Information The adapter's dual ported memory must either be 8K, 32K, 64K, or 128K. The diagnostic is run in upper memory below the 1 megabyte boundary. Selecting a memory address range for the adapter may be assisted by the DIGIMMAP.EXE program, which is supplied with this package. 4.3.2 Help Screens There are two help screens associated with this product family. The first explains each of the parameter entries, and the second is a visual duplication of the switch settings for the adapters. 4.3.3 Basic Test Descriptions There are three basic test areas for this product family. There are a number of subtests within each basic test, depending on the adapter type. The first basic test is the host's memory test. The diagnostic writes/reads/compares data written to the adapter's dual ported memory. Various patterns of bytes/words are checked in the entire dual ported memory window. Any failure is considered critical and the tests are terminated with error information displayed. Failure could indicate that a memory conflict exists. The memory utility (DIGIMMAP.EXE) can be used to find a possible alternative memory window. The second basic test begins communicating with the adapter via the selected host base address. The BIOS is downloaded to the adapter and a response is necessary to post the information. Other tests include an IRQ test, window enable test (new PC/Xe adapter), and window select test (new PC/Xe adapter). Any failure is considered critical and the tests are terminated with error information displayed. The third basic test is the port test. There are two options for the port test, either a single selected port or 'All' ports. There are three parameters that are used in conjunction with the port test; "L)oopback", "C)ontinuous", and "S)top on first error". The signals that are looped back on the EIA-232 loopback cable are TxD to RxD, DTR to DSR & DCD, and RTS to CTS & RING. Some adapters have an EIA-422 option and a loopback cable must be assembled to perform the external test; the necessary loopback signals are TxD(+-) to RxD(+-) and RTS(+-) to CTS(+-). The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The loopback cable must be installed for valid test results in the external mode. When external testing is done, both data and control signals are tested. In internal mode only data is tested. Following the data tests an interrupt test is performed on the selected port. The "C)ontinuous" parameter allows the operator to select single or multiple passes for the port test. If "C)ontinuous" is "Y)es", the port test will run until either the operator stops the test or if an error occurs with the "S)top On First Error" parameter set to "Y)es". The "S)top On First Error" parameter causes the port test to stop when the first error is detected, or continue without regard to test failures. The EIA-232 loopback plug for the RJ-45 version, part number 60000401, consists of a 10-pin RJ-45 plug wired as follows: Pin 3 connected to pins 1 & 8 (RTS to RI and CTS); Pin 5 connected to pin 6 (TxD to RxD); Pin 9 connected to pins 2 & 10 (DTR to DSR and DCD). The EIA-232 loopback plug for the DB-25 version, part number 60000442, consists of a female DB-25 connector wired as follows: Pin 4 connected to pins 22 & 5 (RTS to RI and CTS); Pin 2 connected to pin 3 (TxD to RxD); Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD). The EIA-232 loopback plug for the DB-9 version consists of a single female DB-9 connector that can be made using the following pinout information: Pin 7 connected to pins 9 & 8 (RTS to RI and CTS); Pin 3 connected to pin 2 (TxD to RxD); Pin 4 connected to pins 6 & 1 (DTR to DSR and DCD). The EIA-422 loopback plug for the DB-9 version consists of a single female DB-9 connector that can be made using the following pinout information: Pin 2 connected to pin 4 (RTS+ to CTS+); Pin 3 connected to pin 5 (RTS- to CTS-); Pin 8 connected to pin 6 (TxD+ to RxD+); Pin 9 connected to pin 7 (TxD- to RxD-); The EIA-422 loopback plug for the DB-25 version consists of a single female DB-25 connector wired as follows: Pin 4 connected to pin 5 (RTS+ to CTS+); Pin 19 connected to pin 13 (RTS- to CTS-); Pin 2 connected to pin 3 (TxD+ to RxD+); Pin 14 connected to pin 16 (TxD- to RxD-); 4.3.4 Error Messages There are two places where error messages may appear. The first is at the bottom of the screen in the operator interface section. Error messages here relate to parameter entry. These messages typically prompt the operator for another entry or request another parameter first. All parameters must be entered before execution can begin. The second place error messages appear is in the test information section. These will be displayed in red with "Test FAILED" followed by a error message to identify the error. Memory Error. If an error occurs during the host's dual ported memory tests, a message will appear that displays the address, expected/written value, and the read value. The host displays the message as: Address = ?????. Expected = ????. Read = ????. Adapter Reset Error. If the memory tests were successful, the host attempts to reset the adapter. If the adapter does not reset, the host displays: Hardware reset error. Possible I/O port conflict. Adapter Load Error. If the adapter resets, the host attempts to communicate with the adapter by downloading a program (BIOS) and waiting for a response. If the adapter does not respond, the host displays: BIOS load error. Possible memory conflict. If the BIOS load is successful, the host displays adapter information including adapter type, memory available, and ports available. If there were any initialization errors, they will be displayed as: Memory errors. Port(s) missing. Port(s) error. IRQ Error. If an IRQ was selected and an error occurred, a message will indicate that the diagnostic did not receive an IRQ from the adapter. The new PC/Xe adapter has two additional errors: interrupt acknowledge error, and interrupt pending error. The host will display the following error message(s): The diagnostic did not receive an IRQ. Interrupt acknowledge error. Interrupt pending error. Window Enable Error. This test is only performed on the 8K adapters. One or both of the memory enable bits was found to be in error. The host displays the following message: One or both of the memory enable bits are faulty. Window Select Error. This test is only performed on the 8K adapters with the 8K window size selected. An error message with the window (1-8) that failed will be displayed. A base window select error is also possible. The displays host the following message(s): Window ? select error. Base window select error. 8K windowing feature is faulty. Port Errors. The first error that could appear is that the port number selected is outside the range of ports supported by this adapter. The maximum port number supported by the adapter is determined when BIOS code is downloaded and executed on the adapter. The test will terminate at this point and display: The selected port number is invalid for this adapter. The host sends a command to the adapter to intitiate the port test. If no response to the command is received, the following message is displayed: Adapter communication error during test setup. If the command is successful, the adapter begins testing the port. The host has a timeout that requires the adapter to finish the test in a certain amount of time. If the host's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. For either the internal or external data test the received data is compared to the transmitted data. If the they do not compare, the following message is displayed: Port ?? failed. RX data did not compare with TX data. There is a timeout on the adapter for the transmission and reception of data. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Port timeout occurred during TX/RX of data. The control signals are only tested when the loopback connector is installed. Depending on the control signal failure, one of the following messages is displayed: Port ?? failed. DCD input signal failed. Port ?? failed. DSR input signal failed. Port ?? failed. CTS input signal failed. Port ?? failed. RING input signal failed. Port ?? failed. DCD & DSR failed. Possible DTR failure. Port ?? failed. CTS & RING failed. Possible RTS failure. Port ?? failed. DCD/DSR/CTS/RING failed. Port failure. Port ?? failed. General port failure. There is a timeout on the adapter for the completion of the test. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. The port interrupt test checks the ability of the selected port to generate an interrupt to the CPU on the adapter. This is done by transmitting 1 byte of data in internal loopback mode. If an error occurs, one of the following message is displayed: Port ?? failed. Port interrupt did not occur. Port ?? failed. RX data did not compare with TX data. Port ?? failed. Port timeout occurred during TX/RX of data. 4.4 MC/Xi Adapter Product Family These are intelligent adapters with an 80186 CPU embedded on the adapter. They communicate with the host via dual ported memory and interrupts. They support asynchronous communication with 4, 8, or 16 ports. 4.4.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in upper memory below the 1 megabyte boundary. Selecting a memory address range for the adapter may be assisted by the DIGIMMAP.EXE program, which is supplied with this package. When the adapter is installed with the setup program (on the IBM reference diskette), these values will be used for the user diagnostics. 4.4.2 Help Screens There is a help screen associated with this product family. It explains each of the parameter entries. 4.4.3 Basic Test Descriptions There are three basic test areas for this product family. There are a number of subtests within each basic test. The first basic test is the host's memory test. The diagnostic writes/reads/compares data written to the adapter's dual ported memory. Various patterns of bytes/words are checked throughout the entire dual ported memory window. Any failure is considered critical and the tests are terminated with error information displayed. Failure could indicate that a memory conflict exists. The memory utility (DIGIMMAP.EXE) can be used to find a possible alternative memory window. The second basic test begins communicating with the adapter via the selected host base address. The adapter is released from reset and the code in the EPROMs is executed and a response is necessary to post the information. Other tests include an IRQ test and window select test. Any failure is considered critical and the tests are terminated with error information displayed. The third basic test is the port test. There are two options for the port test, either a single selected port or 'All' ports. There are three parameters that are used in conjunction with the port test; "L)oopback", "C)ontinuous", and "S)top on first error". The signals that are looped back on the EIA-232 loopback cable are TxD to RxD, DTR to DSR & DCD, and RTS to CTS & RING. The MC/Xi adapter has an EIA-422 option and a loopback cable must be assembled to perform the external test; the necessary loopback signals are TxD(+-) to RxD(+-) and RTS(+-) to CTS(+-). The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The loopback cable must be installed for valid test results in the external mode. When external testing is done, both data and control signals are tested. In internal mode only data is tested. Following the data tests an interrupt test is performed on the selected port. The "C)ontinuous" parameter allows the operator to select single or multiple passes for the port test. If "C)ontinuous" is "Y)es", the port test will run until either the operator stops the test or if an error occurs with the "S)top On First Error" parameter set to "Y)es". The "S)top On First Error" parameter causes the port test to stop when the first error is detected, or continue without regard to test failures. The EIA-232 loopback plug for the RJ-45 version, part number 60000401, consists of a 10-pin RJ-45 plug wired as follows: Pin 3 connected to pins 1 & 8 (RTS to RI and CTS); Pin 5 connected to pin 6 (TxD to RxD); Pin 9 connected to pins 2 & 10 (DTR to DSR and DCD). The EIA-232 loopback plug for the DB-25 version, part number 60000442, consists of a female DB-25 connector wired as follows: Pin 4 connected to pins 22 & 5 (RTS to RI and CTS); Pin 2 connected to pin 3 (TxD to RxD); Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD). The EIA-422 loopback plug for the DB-9 version consists of a single female DB-9 connector that can be made using the following pinout information: Pin 2 connected to pin 4 (RTS+ to CTS+); Pin 3 connected to pin 5 (RTS- to CTS-); Pin 8 connected to pin 6 (TxD+ to RxD+); Pin 9 connected to pin 7 (TxD- to RxD-); The EIA-422 loopback plug for the DB-25 version consists of a single female DB-25 connector that can be made using the following pinout information: Pin 4 connected to pin 5 (RTS+ to CTS+); Pin 19 connected to pin 13 (RTS- to CTS-); Pin 2 connected to pin 3 (TxD+ to RxD+); Pin 14 connected to pin 16 (TxD- to RxD-); 4.4.4 Error Messages There are two places where error messages may appear. The first is at the bottom of the screen in the operator interface section. Error messages here relate to parameter entry. These messages typically prompt the operator for another entry or request another parameter first. All parameters must be entered before execution can begin. The second place error messages appear is is the test information section. These will be displayed in red with "Test FAILED" followed by a message to identify the error. Memory Error. If an error occurs during the host's dual ported memory tests, a message will appear that displays the address, expected/written value, and the read value. The host displays the message as: Address = ?????. Expected = ????. Read = ????. Adapter Reset Error. If the memory tests were successful, the host attempts to reset the adapter. If the adapter does not reset, the host displays: Hardware reset error. Possible adapter I/O address conflict. Adapter Load Error. If the adapter resets, the host attempts to communicate with the adapter by executing an EPROM program (BIOS) and waiting for a response. If the adapter does not respond, the host displays: BIOS start error. Possible memory conflict. If the BIOS load is successful, the host displays adapter information including adapter type, memory available, and ports available. If there were any initialization errors they will be displayed as: Memory errors. IRQ Error. If an IRQ was selected and an error occurred, a message will indicate that the diagnostic did not receive an IRQ from the adapter. The host will display the following error message: The diagnostic did not receive an IRQ. Window Select Error. An error message with the window (1-8) that failed will be displayed. A base window select error is also possible. The host displays the following message(s): Window ? select error. Base window select error. 32K windowing feature is faulty. Port Errors. The first error that could appear is that the port number selected is outside the range of ports supported by this adapter. The maximum port number supported by the adapter is determined when BIOS code is executed on the adapter. The test will terminate at this point and display: The selected port number is invalid for this adapter. The host sends a command to the adapter to intitiate the port test. If no response to the command is received, the following message is displayed: Adapter communication error during test setup. If the command is successful, the adapter begins testing the port. The host has a timeout that requires the adapter to finish the test in a certain amount of time. If the host's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. For either the internal or external data test, the received data is compared to the transmitted data. If the they do not compare, the following message is displayed: Port ?? failed. RX data did not compare with TX data. There is a timeout on the adapter for the transmission and reception of data. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Port timeout occurred during TX/RX of data. The control signals are only tested when the loopback connector is installed. Depending on the control signal failure, one of the following messages is displayed: Port ?? failed. DCD input signal failed. Port ?? failed. DSR input signal failed. Port ?? failed. CTS input signal failed. Port ?? failed. RING input signal failed. Port ?? failed. DCD & DSR failed. Possible DTR failure. Port ?? failed. CTS & RING failed. Possible RTS failure. Port ?? failed. DCD/DSR/CTS/RING failed. Port failure. Port ?? failed. General port failure. There is a timeout on the adapter for the completion of the test. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. The port interrupt test checks the ability of the selected port to generate an interrupt to the CPU on the adapter. This is done by transmitting 1 byte of data in internal loopback mode. If an error occurs, one of the following messages is displayed: Port ?? failed. Port interrupt did not occur. Port ?? failed. RX data did not compare with TX data. Port ?? failed. Port timeout occurred during TX/RX of data. 4.5 C/X Adpater Product Family These are intelligent adapters with an 80186 CPU embedded on the adapter. They communicate with the host via dual ported memory and interrupts. They support synchronous or asynchronous communication with 2 ports. There are six adapters testable with the user diagnostics. The three earlier version adapters (ISA/EISA/MCA) are EIA-422 only. The more recent adapters can select EIA-232. Fault isolation relays are also present in the newer adapters. 4.5.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in upper memory below the 1 megabyte boundary. Selecting a memory address range for the adapter may be assisted by the DIGIMMAP.EXE program, which is supplied with this package. When a Micro Channel adapter is installed with the setup program (on the IBM reference diskette), these values will be used for the user diagnostics. 4.5.2 Help Screens There are two help screens associated with this product family. The first explains each of the parameter entries, and the second is a visual duplication of the switch settings for the ISA adapters. 4.5.3 Basic Test Descriptions There are three basic test areas for this product family. There are a number of subtests within each basic test. The first basic test is the host's memory test. The diagnostic writes/reads/compares data written to the adapter's dual ported memory. Various patterns of bytes/words are checked in the entire dual ported memory window. Any failure is considered critical and the tests are terminated with error information displayed. Failure could indicate that a memory conflict exists. The memory utility (DIGIMMAP.EXE) can be used to find a possible alternative memory window. The second basic test begins communicating with the adapter via the selected host base address. Code is downloaded to the adapter and a response is necessary to post the information. Other tests include an IRQ test, and window select test. Any failure is considered critical and the tests are terminated with error information displayed. The third basic test is the port test. There are two options for the port test, either a single selected port or 'All' ports. There are three parameters that are used in conjunction with the port test; "L)oopback", "C)ontinuous", and "S)top on first error". The loopback plug (part number 60000388) supplied with the adapter can be used for external loopback testing. The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The loopback plug must be installed for valid test results in the external mode. The earlier adapters use only EIA-422 and the newer adapters have EIA-232 selectability. The newer adapters also have fault isolation relays. When external loopback is selected on the newer adapters, clicking can be heard due to the testing of the relays. Data is transmitted at 1.2 MB for EIA-422 and 57.6 KB for EIA-232. The "C)ontinuous" parameter allows the operator to select single or multiple passes for the port test. If "C)ontinuous" is "Y)es", the port test will run until either the operator stops the test or if an error occurs with the "S)top On First Error" parameter set to "Y)es". The "S)top On First Error" parameter causes the port test to stop when the first error is detected, or continue without regard to test failures. The loopback plug (PN 60000388) consists of a single male HD-15 connector wired as follows: Pin 1 (RXD-) to pin 6 (TXD-) Pin 2 (RXD+) to pin 7 (TXD+) Pin 3 (CTS+) to pin 15 (RTS+) Pin 4 (RXCLK-) to pin 9 (TXCLK-) Pin 5 (RXCLK+) to pin 10 (TXCLK+) Pin 8 (CTS-) to pin 14 (RTS-) 4.5.4 Error Messages There are two places where error messages may appear. The first is at the bottom of the screen in the operator interface section. Error messages here relate to parameter entry. These messages typically prompt the operator for another entry or request another parameter first. All parameters must be entered before execution can begin. The second place error messages appear is in the test information section. These will be displayed in red with "Test FAILED" followed by a error message to identify the error. Memory Error. If an error occurs during the host's dual ported memory tests, a message will appear that displays the address, expected/written value, and the read value. The host displays the message as: Address = ?????. Expected = ????. Read = ????. Adapter Reset Error. If the memory tests were successful, the host attempts to reset the adapter. If the adapter does not reset, the host displays: Hardware reset error. Possible adapter I/O address conflict. Adapter Load Error. If the adapter resets, the host attempts to communicate with the adapter by downloading a program (BIOS) and waiting for a response. If the adapter does not respond, the host displays: BIOS load error. Possible memory conflict. If the BIOS load is successful, the host displays adapter information including adapter type, memory available, and ports available. If there were any initialization errors they will be displayed as: Memory errors. Port(s) missing. DMA errors. Window Select Error. The number of windows is either 4 or 16 depending on the amount of memory on the adapter (128K or 512K). An error message with the window that failed will be displayed. A base window select error is also possible. The host displays the following message(s): Window ? select error. Base window select error. 32K windowing feature is faulty. Fuse Test Error. The new adapters have an auxillary 5 volt supply that is fused. The condition of these fuses can be tested. If one or both of the fuses are open the following messsage is displayed: One or both of the Auxillary 5 volt fuses are open. IRQ Error. If an IRQ was selected and an error occurred, a message will indicate that the diagnostic did not receive an IRQ from the adapter. The host will display the following error message: The diagnostic did not receive an IRQ. The host sends a command to the adapter to intitiate the port test. If no response to the command is received, the following message is displayed: Adapter communication error during test setup. If the command is successful, the adapter begins testing the port. The host has a timeout that requires the adapter to finish the test in a certain amount of time. If the host's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. For either the internal or external data test the received data is compared to the transmitted data. If the they do not compare, the following message is displayed: Port ?? failed. RX data did not compare with TX data. There is a timeout on the adapter for the transmission and reception of data. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Port timeout occurred during TX/RX of data. 4.6 MC/Xe Adapter Product Family This product family is an intelligent adapter with an 80186 CPU embedded on the adapter. It communicates with the host via dual ported memory and interrupts. It supports asynchronous communication with 2, 4, or 8 ports. 4.6.1 General Information The adapter's dual ported memory must be 8K. The diagnostic is run in upper memory below the 1 megabyte boundary. Selecting a memory address range for the adapter may be assisted by the DIGIMMAP.EXE program, which is supplied with this package. 4.6.2 Help Screens There are two help screens associated with this product family. The first explains each of the parameter entries, and the second is a visual duplication of the switches for the adapters. 4.6.3 Basic Test Descriptions There are three basic test areas for this product family. There are a number of subtests within each basic test, depending on the adapter type. The first basic test is the host's memory test. The diagnostic writes/reads/compares data written to the adapter's dual ported memory. Various patterns of bytes/words are checked in the entire dual ported memory window. Any failure is considered critical and the tests are terminated with error information displayed. Failure could indicate that a memory conflict exists. The memory utility (DIGIMMAP.EXE) can be used to find a possible alternative memory window. The second basic test begins communicating with the adapter via the selected host base address. Code is downloaded to the adapter and a response is necessary to post the information. Other tests include an IRQ test, window enable test, and window select test. Any failure is considered critical and the tests are terminated with error information displayed. The third basic test is the port test. There are two options for the port test, either a single selected port or 'All' ports. There are three parameters that are used in conjunction with the port test; "L)oopback", "C)ontinuous", and "S)top on first error". The signals that are looped back on the loopback cable are TxD to RxD, DTR to DSR & DCD, and RTS to CTS & RING. The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The loopback cable must be installed for valid test results in the external mode. When external testing is done, both data and control signals are tested. In internal mode only data is tested. Following the data tests an interrupt test is performed on the selected port. The "C)ontinuous" parameter allows the operator to select single or multiple passes for the port test. If "C)ontinuous" is "Y)es", the port test will run until either the operator stops the test or if an error occurs with the "S)top On First Error" parameter set to "Y)es". The "S)top On First Error" parameter causes the port test to stop when the first error is detected, or continue without regard to test failures. The EIA-232 loopback plug for the RJ-45 version, part number 60000401, consists of a 10-pin RJ-45 plug wired as follows: Pin 3 connected to pins 1 & 8 (RTS to RI and CTS); Pin 5 connected to pin 6 (TxD to RxD); Pin 9 connected to pins 2 & 10 (DTR to DSR and DCD). The EIA-232 loopback plug for the DB-25 version, part number 60000442, consists of a female DB-25 connector wired as follows: Pin 4 connected to pins 22 & 5 (RTS to RI and CTS); Pin 2 connected to pin 3 (TxD to RxD); Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD). The EIA-232 loopback plug for the DB-9 version consists of a single female DB-9 connector that can be made using the following pinout information: Pin 7 connected to pins 9 & 8 (RTS to RI and CTS); Pin 3 connected to pin 2 (TxD to RxD); Pin 4 connected to pins 6 & 1 (DTR to DSR and DCD). 4.6.4 Error Messages There are two places where error messages may appear. The first is at the bottom of the screen in the operator interface section. Error messages here relate to parameter entry. These messages typically prompt the operator for another entry or request another parameter first. All parameters must be entered before execution can begin. The second place error messages appear is in the test information section. These will be displayed in red with "Test FAILED" followed by a error message to identify the error. Memory Error. If an error occurs during the host's dual ported memory tests, a message will appear that displays the address, expected/written value, and the read value. The host displays the message as: Address = ?????. Expected = ????. Read = ????. Adapter Reset Error. If the memory tests were successful, the host attempts to reset the adapter. If the adapter does not reset, the host displays: Hardware reset error. Possible I/O address conflict. Adapter Load Error. If the adapter resets, the host attempts to communicate with the adapter by downloading a program (BIOS) and waiting for a response. If the adapter does not respond, the host displays: BIOS load error. Possible memory conflict. If the BIOS load is successful, the host displays adapter information including adapter type, memory available, and ports available. If there were any initialization errors, they will be displayed as: Memory errors. Port(s) missing. Port(s) error. IRQ Error. If an IRQ was selected and an error occurred, the host will display the following error message(s): The diagnostic did not receive an IRQ. Interrupt acknowledge error. Interrupt pending error. Window Enable Error. If one or both of the memory enable bits was found to be in error. The host displays the following message: One or both of the memory enable bits are faulty. Window Select Error. This test is only performed on the MC/Xe adapter with the 8K window size selected. An error message with the window (1-8) that failed will be displayed. A base window select error is also possible. The host displays the following message(s): Window ? select error. Base window select error. 8K windowing feature is faulty. Port Errors. The first error that could appear is that the port number selected is outside the range of ports supported by this adapter. The maximum port number supported by the adapter is determined when BIOS code is downloaded and executed on the adapter. The test will terminate at this point and display: The selected port number is invalid for this adapter. The host sends a command to the adapter to intitiate the port test. If no response to the command is received, the following message is displayed: Adapter communication error during test setup. If the command is successful, the adapter begins testing the port. The host has a timeout that requires the adapter to finish the test in a certain amount of time. If the host's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. For either the internal or external data test the received data is compared to the transmitted data. If the they do not compare, the following message is displayed: Port ?? failed. RX data did not compare with TX data. There is a timeout on the adapter for the transmission and reception of data. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Port timeout occurred during TX/RX of data. The control signals are only tested when the loopback connector is installed. Depending on the control signal failure, one of the following messages is displayed: Port ?? failed. DCD input signal failed. Port ?? failed. DSR input signal failed. Port ?? failed. CTS input signal failed. Port ?? failed. RING input signal failed. Port ?? failed. DCD & DSR failed. Possible DTR failure. Port ?? failed. CTS & RING failed. Possible RTS failure. Port ?? failed. DCD/DSR/CTS/RING failed. Port failure. Port ?? failed. General port failure. There is a timeout on the adapter for the completion of the test. If the adapter's timeout expires, the following message is displayed: Port ?? failed. Test timeout occurred. The port interrupt test checks the ability of the selected port to generate an interrupt to the CPU on the adapter. This is done by transmitting 1 byte of data in internal loopback mode. If an error occurs, one of the following messages is displayed: Port ?? failed. Port interrupt did not occur. Port ?? failed. RX data did not compare with TX data. Port ?? failed. Port timeout occurred during TX/RX of data. 4.7 COM/Xi Adapter Product Family These are intelligent adapters with an 80188 CPU embedded on the adapter. They communicate with the host via dual ported memory and interrupts. They support asynchronous communication with 4 or 8 ports. 4.7.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in upper memory below the 1 megabyte boundary. Selecting a memory address range for the adapter may be assisted by the DIGIMMAP.EXE program, which is supplied with this package. 4.7.2 Help Screens There are two help screens associated with this product family. The first explains each of the parameter entries, and the second is a visual represenation of the jumper settings for the adapters. 4.7.3 Basic Test Descriptions There are three basic test areas for this product family. There are a number of subtests within each basic test. The first basic test is the host's memory test. Since the adapter's dual ported memory is controlled with the reset bit, the adapter is released from reset. The BIOS in EPROM is executed and the results are posted. If there are no critical errors, the diagnostic writes/reads/compares data written to the adapter's dual ported memory. Various patterns of bytes/words are checked throughout the entire dual ported memory window. Any failure is considered critical and the tests are terminated with error information displayed. Failure could indicate that a memory conflict exists. The memory utility (DIGIMMAP.EXE) can be used to find a possible alternative memory window. The second basic test continues communicating with the adapter via the selected host base address. The tests include an IRQ test and window select test. Any failure is considered critical and the tests are terminated with error information displayed. The third basic test is the port test. There are two options for the port test, either a single selected port or 'All' ports. There are three parameters that are used in conjunction with the port test; "L)oopback", "C)ontinuous", and "S)top on first error". The EIA-232 signals that are looped back on the loopback cable are TxD to RxD, DTR to DSR & DCD, and RTS to CTS & RING. The COM/Xi adapter has an EIA-422 option and a loopback cable must be assembled to perform the external test; the necessary loopback signals are TxD to RxD and RTS to CTS. The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The loopback cable must be installed for valid test results in the external mode. Both data and control signals are tested in either mode. The "C)ontinuous" parameter allows the operator to select single or multiple passes for the port test. If "C)ontinuous" is "Y)es", the port test will run until either the operator stops the test or if an error occurs with the "S)top On First Error" parameter set to "Y)es". The "S)top On First Error" parameter causes the port test to stop when the first error is detected, or continue without regard to test failures. The EIA-232 loopback plug for the RJ-45 version, part number 60000401, consists of a 10-pin RJ-45 plug wired as follows: Pin 3 connected to pins 1 & 8 (RTS to RI and CTS); Pin 5 connected to pin 6 (TxD to RxD); Pin 9 connected to pins 2 & 10 (DTR to DSR and DCD). The EIA-232 loopback plug for the DB-25 version, part number 60000401, consists of a female DB-25 connector wired as follows: Pin 4 connected to pins 22 & 5 (RTS to RI and CTS); Pin 2 connected to pin 3 (TxD to RxD); Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD). The EIA-422 loopback plug for the DB-9 version consists of a single female DB-9 connector that can be made using the following pinout information: Pin 2 connected to pin 4 (RTS+ to CTS+); Pin 3 connected to pin 5 (RTS- to CTS-); Pin 8 connected to pin 6 (TxD+ to RxD+); Pin 9 connected to pin 7 (TxD- to RxD-); 4.7.4 Error Messages There are two places where error messages may appear. The first is at the bottom of the screen in the operator interface section. Error messages here relate to parameter entry. These messages typically prompt the operator for another entry or request another parameter first. All parameters must be entered before execution can begin. The second place error messages appear is the test information section. These will be displayed in red with "Test FAILED" followed by a message to identify the error. Adapter Reset Error. If the memory tests were successful, the host attempts to reset the adapter. If the adapter does not reset, the host displays: Hardware reset error. Possible adapter I/O address conflict. Adapter Execute Error. If the adapter resets, the host attempts to communicate with the adapter by executing a program (BIOS) in EPROM and waiting for a response. If the adapter does not respond, the host displays: BIOS execute error. Possible memory conflict. Initialization Errors. If either a memory or port error is reported by the BIOS, the information is displayed. A mask of the bad ports is displayed. Bit 0 refers to port 1 and bit 7 refers to port 8. Initialization errors are not fatal and the diagnostics will continue. Memory Error. If an error occurs during the host's dual ported memory tests, a message will appear that displays the address, expected/written value, and the read value. The host displays the message as: Address = ?????. Expected = ????. Read = ????. If the BIOS load is successful, the host displays adapter information including adapter type, memory available, and ports available. If there were any initialization errors they will be displayed as: Memory errors. IRQ Error. If an IRQ was selected and an error occurred, a message will indicate that the diagnostic did not receive an IRQ from the adapter. The host will display the following error message: The diagnostic did not receive an IRQ. Window Select Error. An error message with the window (1-16) that failed will be displayed. The host displays the following message(s): Window select error for window ?. Data error reported from window ?. 16K windowing feature is faulty. FEP/OS Start Error. There is a Front End Processor/Operating System available in the EPROM. If the transfer of control from the BIOS is not successful, the host displays the following message: EPROM based operating system is not executing. Port Errors. The first error that could appear is that the port number selected is outside the range of ports supported by this adapter. The maximum port number supported by the adapter is determined when BIOS code is executed on the adapter. The test will terminate at this point and display: The selected port number is invalid for this adapter. The host sends a command to the adapter to intitiate the port test. If no response to the command is received, the following message is displayed: Adapter communication error during test setup. For either the internal or external data test, the received data is compared to the transmitted data. If the they do not compare, the following message is displayed: Port ?? failed. TX data = ??. RX data = ??. The host has a timeout that requires the adapter to finish the test in a certain amount of time. If the host's timeout expires, the following message is displayed: Port ?? failed. RX data missing. Test timeout. The control signals are tested in both internal and external mode. Depending on the control signal failure, one of the following messages is displayed with 1 to 4 control signal failures: Modem control signal did not clear: DCD RI DSR CTS. Modem control signal did not set: DCD RI DSR CTS.