User Diagnostics Manual (USERRISC.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-RISC.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 Xem Systems, Adapter and PORTS Modules 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 EPC/X 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 Xr 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 SyncPort Adapter Product Family 4.6.1 General Information 4.6.2 Help Screens 4.6.3 Basic Test Descriptions 4.6.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-RISC.EXE). 2.0 Applicable Documents Xem Adapter Installation Guide 90027500 EPC/X Adapter Installation Guide 90027800 Xr Adapter Installation Guide 90029900 SyncPort Hardware Installation Guide 90032600 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 and 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. Highlighted addresses indicate the preferred choice(s). 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-RISC.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 3rd section displays test results when the diagnostic is running. The 4th section in 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 Xem product family, the EPC/X adapter family, the Xr adapter family, and the SyncPort adapter family. The Xem family includes the Xem (ISA/EISA/MC) systems. Each Xem system includes an Xem adapter and up to 4 PORTS modules to support up to 64 total ports. The EPC/X family includes the ISA/EISA/MC adapters. The Xr adapter family includes the ISA adapter with either 4 or 8 ports. The new 4r 920 & 8r 920 is also supported. The SyncPort (ISA/MC) adapter family is supported. In MC systems with more than one MC bus, the MC Xem, MC EPC/X, & MC SyncPort are only supported in the primary bus slots 1-8. 4.2 Functional Description The user diagnostic is a program that will test a Digi product for system compatability and reliability. After all parameters have been entered, the operator may run the diagnostic. A configuration file (UD-RISC.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-RISC.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-RISC.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 has 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 the configuration file, UD-RISC.CFG; then rerun the diagnostics. When UD-RISC.CFG is erased the operator must enter new parameters and the new UD-RISC.CFG will be written upon execution. Running the diagnostic again on the same machine should result in no further bus conflicts. 4.3 Xem Adapter & PORTS Modules Product Family These are intelligent adapters with an 3051 RISC CPU embedded on the adapter. They communicate with the host via dual ported memory and interrupts. They support asynchronous communication with a maximum of 64 ports. There are three adapters (ISA/EISA/MC) testable with the user diagnostics. 4.3.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in memory below the 1 megabyte boundary for the ISA & EISA adapters. 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), the values logged in the POS registers will be used for the user diagnostics. The Micro Channel adapters can be tested above the 1 megabyte boundary. In MC systems with more than one MC bus, the MC Xem is only supported in the primary bus slots 1-8. 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 Xem (ISA) adapter. 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. 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 adapter's base address. Code is downloaded to the adapter and a response is necessary to post the information. Other tests include an IRQ test, a window select test, a hardware timer test, and an adapter memory test. Any failure for the IRQ and window select tests is considered critical and the tests are terminated with error information displayed. The hardware timer and adapter memory tests are not critical and will only stop if an error occurs with the "S)top On First Error" parameter set to "Y)es". The third basic test is the port test. The P)ort selection is either a single port or all ports. There are four parameters that are used in conjunction with the port test; "E)IA-232/422", "L)oopback", "C)ontinuous", and "S)top on first error". EIA-422 is not available in the Xem adapter family. The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The "C)ontinuous" parameter allows the operator to run 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 error set to "Y)es". The "S)top On First Error" parameter set to 'Yes' causes the port test to stop when the first error is detected; set to 'No' causes the port test to continue without regard to test failures. When internal mode is selected, the BIOS actually internally tests both data and control signals for all the ports in the PORTS module where the port resides. The 8em/8emp/16em EIA-232 signals that are looped back externally are TxD to RxD, DTR to DSR & DCD, and RTS to CTS & RING. If the PORTS module is an 8emp, the parallel port is not tested in the external mode. If the parallel port is selected for external testing the BIOS will do an internal test. The loopback plug must be installed for valid test results in the external mode. When external testing is done, both data and control signals are tested for the selected port. The external port test for the PORTS module Modem 4/8em requires that 2 ports are used to perform the external test. The P)ort number selected will be the transmit port and the associated receive port is as follows: 1/2, 2/1, 3/4, 4/3, 5/6, 6/5, 7/8, & 8/7. The RJ-11 cables provided must be placed according to this list. If 'All' ports are selected, each port will be tested in ascending order and two (4em) or four (8em) loopback cables must be used in the order listed above. The EIA-232 loopback plug, part number 60000401, for the RJ-45 version consists of a 10-pin RJ-45 connector wired as follows: Pin 3 to pins 1 & 8 (RTS to RI and CTS) Pin 5 to pin 6 (TxD to RxD) Pin 9 to pins 2 & 10 (DTR to DSR and DCD) The EIA-232 loopback plug, part number 60000442, for the DB-25 version consists of a female DB-25 connector wired as follows: Pin 4 to pins 22 & 5 (RTS to RI and CTS) Pin 2 to pin 3 (TxD to RxD) Pin 20 to pins 6 & 8 (DTR to DSR and DCD) 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 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 value read. 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: Adapter reset error. Possible I/O address conflict. Adapter Reset Release Error. If the reset was successful, the host attempts to communicate with the adapter by downloading a program (BIOS) and releasing reset on the adapter. If the adapter does not release reset, the host displays: Adapter did not release reset. Possible I/O address conflict. Adapter Load Error. If the adapter releases reset, the host waits for the BIOS 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 memory available and ports available. If there were any initialization errors, they will be displayed as: CPU. Checksum. Timer. RAM. EBI0. EBI1. EBI2. EBI3. Misc. If the BIOS found no PORTS modules, the host displays: The BIOS reports no ports found. Check the EBI cabling. After the BIOS has found between 1 to 4 the PORTS module(s), the host displays information about each PORTS module. There are five possible types. PORTS module ? is a 16em EIA-232 & reports a total of 16 ports. PORTS module ? is an 8em EIA-232 & reports a total of 8 ports. PORTS module ? is an 8emp EIA-232 (& parallel port) & reports a total of 9 ports. PORTS module ? is a Modem 4em & reports a total of 4 ports. PORTS module ? is a Modem 8em & reports a total of 8 ports. If the BIOS found any errors with any of the ports a message will be displayed. It will report the total number of bad ports; the mask is a hex representation of which ports are bad, bit 0 (LSB) is for port 1 and bit 15 (MSB) is for port 16. PORTS module ? reports errors with ?? port(s), mask = ????H. Window Select Error. This test is performed on either 256K, 512K, 768K, or 1024K of memory. An error message with the window (1-32) 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. 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. Adapter hardware timer error. The host sends a command to the adapter to intitiate the hardware timer 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 BIOS begins testing the timer. The host has a timeout that requires the BIOS to finish the test in five seconds. If the host's timeout expires, the following message is displayed: Adapter's hardware timer test failed. Host timeout. If the BIOS reports a timer failure the following message is displayed: Adapter's BIOS reported hardware timer failure. Adapter memory test error. The host sends a command to the adapter to intitiate the memory 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 BIOS begins testing the adapter's memory. The test takes aprroximately 20 seconds to complete. This test is only performed once during this session of the diagnostics. Further executions will display a message that the test is being skipped. The host has a timeout that requires the BIOS to finish the test in 90 seconds. If the host's timeout expires, the following message is displayed: Adapter's memory test failed. Host timeout. If the BIOS reports a memory failure the following message is displayed: Adapter's BIOS reported memory test failure. Internal Port Errors. The first error that could appear is that the port number selected is outside the range of ports supported by this adapter and PORTS module(s). 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 BIOS begins testing all the ports within the PORTS module of the selected port. The host has a timeout that requires the BIOS to finish the test in approxmately six seconds. If 'All' ports was selected, all PORTS modules will be tested. If the host's timeout expires, the following message is displayed: PORTS module ? failed. Host timeout. The internal port test places the ports in an internal loopback mode that wraps the transmitted data back to the received data; and wraps four output signals back to four input signals (RTS/CTS, DTR/DSR, OUT1/RI, and OUT2/DCD). If the internal port test is completed by the BIOS and has found errors, one the following messages will be displayed: PORTS module is not responding. EBI cable. Internal loopback failed for ?? port(s), mask = ????H. A PORTS module not responding means the BIOS has not found any ports and is unable to communicate with the PORTS module. The EBI cable is suspect. Individual internal port failures are displayed with a hexadecimal bit mask. Port 1 is assigned bit 0 (LSB) and port 16 is assigned bit 15 (MSB). External Port Errors. The first error that could appear is that the port number selected is outside the range of ports supported by this adapter and PORTS module(s). 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 initiate 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 BIOS begins testing the selected port via the associated PORTS module. The host has a timeout that requires the BIOS to finish the test in approxmately six seconds. If 'All' ports was selected, each port in all PORTS modules will be tested. If the host's timeout expires, the following message is displayed: Port ?? failed. Host timeout. The external port test for the PORTS module 16em/8emp/8em places the port in the normal operating mode. The BIOS checks that the received data is equal to the transmitted data. The BIOS also checks the RTS to CTS & RI, and DTR to DSR & DCD signals. If the external port test is completed by the BIOS and has found errors, one of the following messages will be displayed: Port ?? failed. PORTS module is not responding. EBI cable. Port ?? failed. Data failed. Port ?? failed. Control signals failed. Port ?? failed. Data failed. Control signals failed. A PORTS module not responding means the BIOS has not found the associated PORTS module and is unable to communicate with the PORTS module. The EBI cable is suspect. The other three messages report specific failures that have occurred on the selected port. If both data and control signals failed, check to make sure that the loopback connector is plugged into the selected port. If only the data failed, the port is not receiving the data it transmitted, but the control signals are being looped backed sucessfully. If only the control signals failed, the port is not receiving the loopback RTS and DTR signals it transmitted, but the data is being looped back sucessfully. When the Modem 4/8em external port test is completed by the BIOS and has found errors, one of the following messages will be displayed: BIOS initialization failure for the modem test. Port ?? failed. PORTS module is not responding. EBI cable. Port ?? failed. Modem error code = ????. Refer to the manual. A BIOS initialization error indicates that the BIOS load prior to the external test was unsuccessful. The host adapter is suspect. A PORTS module not responding means the BIOS has not found the associated PORTS module and is unable to communicate with the PORTS module. The EBI cable is suspect. If a Modem 4/8em reported a modem error, the following is a breakdown of the error types and the mask associated with the error. More than 1 error is possible. 0x0001 - parameters out of range. 0x0002 - failure if internal attempts to set the UART registers. 0x0004 - data sent across the connection is corrupted. 0x0008 - modem responds to a command unexpectedly. 0x0010 - modems do not negotiate. 0x0020 - modems do not connect at 28800 ot 33600 DCE rate. 0x4000 - receiving modem has the error. 0x8000 - transmitting modem has the error. 4.4 EPC/X Adapter Product Family These are intelligent adapters with a RISC 3051 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 three adapters (ISA/EISA/MC) currently testable with the user diagnostics. 4.4.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in memory below the 1 megabyte boundary or the ISA & EISA adapters. 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), the values logged in the POS registers will be used for the user diagnostics. The Micro Channel adapters can be tested above the 1 megabyte boundary. In MC systems with more than one MC bus, the MC EPC/X is only supported in the primary bus slots 1-8. 4.4.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.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 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 adapter's base address. Code is downloaded to the adapter and a response is necessary to post the information. Other tests include a window select test, a fuse test (EISA/MC only), an IRQ test, a hardware timer test, and an adapter memory test. Any failure for the window select or IRQ tests is considered critical and the tests are terminated with error information displayed. The hardware timer, adapter memory, and fuse tests are not critical and will only stop if an error occurs with the "S)top On First Error" parameter set to "Y)es". The third basic test is the port test. The P)ort selection is either a single port or all ports. There are three other parameters that are used in conjunction with the port test. The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The "C)ontinuous" parameter allows the operator to run 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 error set to "Y)es". The "S)top On First Error" parameter set to 'Yes' causes the port test to stop when the first error is detected; set to 'No' causes the port test to continue without regard to test failures. The terminator plug (part number 60000388) supplied with the adapter can be used for external loopback testing. The terminator plug must be installed for valid test results in the external mode. The EIA-422 communication mode is the only mode available for testing on the adapters. EIA-232 mode requires an external clock, typically supplied by modems. When external loopback is selected on the adapters, clicking can be heard due to the testing of the relays. Data is transmitted externally in EIA-422 mode at 1.2 MBaud & 10 MBaud, and internally in 4 wire mode at 230 KBaud & 460 KBaud. The terminator plug, part number 60000388, consists of a male HD-15 male connector wired as follows: Pin 7 to pin 2 (TxD+ to RxD+) Pin 6 to pin 1 (TxD- to RxD-) Pin 10 to pin 5 (TxC+ to RxC+) Pin 9 to pin 4 (TxC- to RxC-) Pin 15 to pin 3 (RTS+ to CTS+) Pin 14 to pin 8 (RTS- to CTS-) 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 in 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 value read. 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: Adapter reset error. Possible I/O address conflict. Adapter Reset Release Error. If the reset was successful, the host attempts to communicate with the adapter by downloading a program (BIOS) and releasing reset on the adapter. If the adapter does not release reset, the host displays: Adapter did not release reset. Possible I/O address conflict. Adapter Load Error. If the adapter releases reset, the host waits for the BIOS 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 memory available and ports available. If there were any initialization errors, they will be displayed as: CPU. Checksum. Timer. RAM. Sync. Misc. Window Select Error. This test is performed on either 256K, 512K, 768K, or 1024K of memory. An error message with the window (1-32) 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 EISA/MC 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, the host will display the following error message(s): The diagnostic did not receive an IRQ. Interrupt acknowledge error. Interrupt pending error. Adapter hardware timer error. The host sends a command to the adapter to intitiate the hardware timer 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 BIOS begins testing the timer. The host has a timeout that requires the BIOS to finish the test in five seconds. If the host's timeout expires, the following message is displayed: Adapter's hardware timer test failed. Host timeout. If the BIOS reports a timer failure the following message is displayed: Adapter's BIOS reported hardware timer failure. Adapter Memory Test Error. The host sends a command to the adapter to intitiate the memory 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 BIOS begins testing the adapter's memory. The test takes aprroximately 15 seconds to complete. This test is only performed once during this session of the diagnostics. Further executions will display a message that the test is being skipped. The host has a timeout that requires the BIOS to finish the test in 20 seconds. If the host's timeout expires, the following message is displayed: Adapter's memory test failed. Host timeout. If the BIOS reports a memory failure the following message is displayed: Adapter's BIOS reported memory test failure. Port Error. 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 about six seconds. If 'All' ports was selected, both ports will be tested. If the host's timeout expires, the following message is displayed: Port ? failed. Host timeout. If L)oopback was 'No' the internal port test cycles between 2 modes. The 2 modes are 4 wire @ 230 KBaud and 4 wire @ 460 KBaud. If one or both modes fail the following message(s) appear: Port ? failed 4 wire @ 230 KBaud. Port ? failed 4 wire @ 460 KBaud. If L)oopback was 'Yes' the external port test cycles between 2 modes. The 2 modes are EIA-422 @ 1.2 MBaud and @ 10 MBaud. If one or both modes fail the following message(s) appear: Port ? failed EIA-422 @ 1.2 MBaud. Port ? failed EIA-422 @ 10 MBaud. 4.5 Xr Adapter Product Family This is an intelligent adapter with a RISC CPU (3051 family) embedded on the adapter. It communicates with the host via dual ported memory and interrupts. It supports asynchronous communication with either 4 or 8 ports. The ISA adapter is testable with the user diagnostics. 4.5.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in 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.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 Xr adapter. 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 adapter's base address. Code is downloaded to the adapter and a response is necessary to post the information. Other tests include an IRQ test, a window select test, a hardware timer test, and an adapter memory test. Any failure for the IRQ and window select tests is considered critical and the tests are terminated with error information displayed. The hardware timer and adapter memory tests are not critical and will only stop if an error occurs with the "S)top On First Error" parameter set to "Y)es". The third basic test is the port test. The P)ort selection is either a single port or all ports. There are four parameters that are used in conjunction with the port test; "E)IA-232/422", "L)oopback", "C)ontinuous", and "S)top on first error". The EIA-232 signals that are looped back externally are TxD to RxD, DTR to DSR & DCD, and RTS to CTS & RING. The EIA-422 signals that are looped back externally are TxD+ to RxD+, TxD- to RxD-, RTS+ to CTS+, and RTS- to CTS-. Although the operator can select either EIA-232 or EIA-422, after the BIOS is loaded, it will detect and test the correct hardware configuration regardless of the parameter. The "L)oopback" parameter enables the operator to test the port in the internal or external mode. When internal mode is selected, the BIOS internally tests both data and control signals for all the ports. The loopback plug must be installed for valid test results in the external mode. When external testing is done, both data and control signals are tested 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 connector wired as follows: Pin 5 connected to pin 6 (TxD to RxD); Pin 3 connected to pins 1 & 8 (RTS to RI and CTS); 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 2 connected to pin 3 (TxD to RxD); Pin 4 connected to pins 22 & 5 (RTS to RI and CTS); Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD). An EIA-422 loopback plug for the RJ-45 version can be made using the following pinout information: Pin 7 connected to pin 6 (TxD+ to RxD+); Pin 4 connected to pin 5 (TxD- to RxD-); Pin 1 connected to pin 10 (RTS+ to CTS+); Pin 2 connected to pin 9 (RTS- to CTS-). An EIA-422 loopback plug for the DB-25 version can be made using the following pinout information: Pin 2 connected to pin 3 (TxD+ to RxD+); Pin 14 connected to pin 16 (TxD- to RxD-); Pin 4 connected to pin 5 (RTS+ to CTS+); Pin 19 connected to pin 13 (RTS- to CTS-). 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 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 value read. 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: Adapter reset error. Possible I/O address conflict. Adapter Reset Release Error. If the reset was successful, the host attempts to communicate with the adapter by downloading a program (BIOS) and releasing reset on the adapter. If the adapter does not release reset, the host displays: Adapter did not release reset. Possible I/O address conflict. Adapter Load Error. If the adapter releases reset, the host waits for the BIOS 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 memory available and ports available. If there were any initialization errors, they will be displayed as: CPU. Checksum. Timer. RAM. Ports. Misc. If the BIOS found any errors with any of the ports a message will be displayed. It will report the total number of bad ports; the mask is a hex representation of which ports are bad, bit 0 (LSB) is for port 1 and bit 7 (MSB) is for port 8. Xr adapter reports errors with ? port(s), mask = ??H. Window Select Error. This test is performed on either 256K, 512K, 768K, or 1024K of memory. An error message with the window (1-32) 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. 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. Adapter hardware timer error. The host sends a command to the adapter to intitiate the hardware timer 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 BIOS begins testing the timer. The host has a timeout that requires the BIOS to finish the test in five seconds. If the host's timeout expires, the following message is displayed: Adapter's hardware timer test failed. Host timeout. If the BIOS reports a timer failure the following message is displayed: Adapter's BIOS reported hardware timer failure. Adapter memory test error. The host sends a command to the adapter to intitiate the memory 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 BIOS begins testing the adapter's memory. The test takes a maximum of 20 seconds to complete. This test is only performed once during this session of the diagnostics. Further executions will display a message that the test is being skipped. The host has a timeout that requires the BIOS to finish the test in 90 seconds. If the host's timeout expires, the following message is displayed: Adapter's memory test failed. Host timeout. If the BIOS reports a memory failure the following message is displayed: Adapter's BIOS reported memory test failure. Internal 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 BIOS begins testing all the ports on the adapter. The host has a timeout that requires the BIOS to finish the test in approxmately six seconds. If 'All' ports was selected, all ports will also be tested. If the host's timeout expires, the following message is displayed: Port ? failed. Host timeout. The internal port test places the ports in an internal loopback mode that wraps the transmitted data back to the received data; and wraps four output signals back to four input signals (RTS/CTS, DTR/DSR, OUT1/RI, and OUT2/DCD). If the internal port test is completed by the BIOS and has found errors, the following messages will be displayed: Internal loopback failed for ? port(s), mask = ??H. Individual internal port failures are displayed with a hexadecimal bit mask. Port 1 is assigned bit 0 (LSB) and port 8 is assigned bit 7 (MSB). External 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 BIOS begins testing the selected port. The host has a timeout that requires the BIOS to finish the test in approxmately six seconds. If 'All' ports was selected, each port will be tested. If the host's timeout expires, the following message is displayed: Port ?? failed. Host timeout. The external port test places the port in the normal operating mode. The BIOS checks that the received data is equal to the transmitted data. The BIOS also checks the RTS/CTS and DTR/DSR signals. If the external port test is completed by the BIOS and errors have been found, one of the following messages will be displayed: Port ?? failed. Data failed. Port ?? failed. Control signals failed. Port ?? failed. Data failed. Control signals failed. The three messages report specific failures that have occurred on the selected port. If both data and control signals failed, check to make sure that the loopback connector is plugged into the selected port. If only the data failed, the port is not receiving the data it transmitted, but the control signals are being looped backed sucessfully. If only the control signals failed, the port is not receiving the loopback RTS and DTR signals it transmitted, but the data is being looped back sucessfully. 4.6 SyncPort Adapter Product Family These are intelligent adapters with a RISC 3051 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 currently ISA & MC adapters that are testable with the user diagnostics. 4.6.1 General Information The adapter's dual ported memory is 32K. The diagnostic is run in memory below the 1 megabyte boundary for the ISA adapter. 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), the values logged in the POS registers will be used for the user diagnostics. The Micro Channel adapters can be tested above the 1 megabyte boundary. In MC systems with more than one MC bus, the MC SyncPort is only supported in the primary bus slots 1-8. 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 switch settings for the ISA 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. 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 adapter's base address. Code is downloaded to the adapter and a response is necessary to post the information. Other tests include a window select test, a fuse test (MC only), an IRQ test, a hardware timer test, and an adapter memory test. Any failure for the window select or IRQ tests is considered critical and the tests are terminated with error information displayed. The hardware timer, adapter memory, and fuse tests are not critical and will only stop if an error occurs with the "S)top On First Error" parameter set to "Y)es". The third basic test is the port test. The P)ort selection is either a single port or all ports. There are three other parameters that are used in conjunction with the port test. The "L)oopback" parameter enables the operator to test the port in the internal or external modes. The "C)ontinuous" parameter allows the operator to run 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 error set to "Y)es". The "S)top On First Error" parameter set to 'Yes' causes the port test to stop when the first error is detected; set to 'No' causes the port test to continue without regard to test failures. Data is transmitted internally (Loopback = No) in 4 wire mode at 230 KBaud & 460 KBaud. The V.24 communication mode is the external program default. V.11, V.35, V.36, & Special are also selectable for external loopback testing. When external loopback is selected on the adapters, clicking can be heard due to the testing of relays. The Special mode allows for a loopback to be placed directly on the adapter's 15 pin connector. This special loopback loops 6 signals back to the adapter. The correct cable and loopback connector must be installed for valid test results in the external mode. The matching cables and loopbacks are listed below. Mode Cable PN Loopback PN ----------------------------------- V.11 62150008 63000010-01 (DB-15F) V.24 62240008 63000011-01 (DB-25F) V.35 62180008 63000012-01 (34 Pin F) V.36 62190008 63000014-01 (DB-37F) Special N/A 60000388 (HD-15M) Jumpers must be set on the adapter to select one of the 5 modes. The jumpers are port specific. Refer to the Hardware Installation Guide (PN 90032600) for the correct jumper settings for the selected communication mode. If the Special mode is selected, the jumpers on the adapter should be set to the V.11 settings for the port under test. The pinout information for each of the loopbacks listed above is as follows: V.11 loopback PN 63000010-01 (DB-15F) Pin 9 to pin 11 (TxD+ to RxD+) Pin 2 to pin 4 (TxD- to RxD-) Pin 10 to pin 12 & 13 (RTS+ to CTS+ & RxC+) Pin 3 to pin 5 & 6 (RTS- to CTS- & RxC-) V.24 loopback PN 63000011-01 (DB-25F) Pin 2 to pin 3 (TxD to RxD) Pin 15 to pin 17 (TxC to RxC) Pin 4 to pin 5 (RTS to CTS) Pin 20 to pins 6 & 8 (DTR to DSR & DCD) V.35 loopback PN 63000012-01 (34 Pin F) Pin S to pin T (TxD+ to RxD+) Pin P to pin R (TxD- to RxD-) Pin Y to pin V (TxC+ to RxC+) Pin AA to pin X (TxC- to RxC-) Pin C to pin D (RTS to CTS) Pin H to pins E & F (DTR to DSR & DCD) V.36 loopback PN 63000014-01 (DB-37F) Pin 22 to pin 24 (TxD+ to RxD+) Pin 4 to pin 6 (TxD- to RxD-) Pin 5 to pin 8 (TxC+ to RxC+) Pin 23 to pin 26 (TxC- to RxC-) Special loopback PN 60000388 (HD-15M) Pin 7 to pin 2 (TxD+ to RxD+) Pin 6 to pin 1 (TxD- to RxD-) Pin 10 to pin 5 (TxC+ to RxC+) Pin 9 to pin 4 (TxC- to RxC-) Pin 15 to pin 3 (RTS+ to CTS+) Pin 14 to pin 8 (RTS- to CTS-) 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 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 value read. 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: Adapter reset error. Possible I/O address conflict. Adapter Reset Release Error. If the reset was successful, the host attempts to communicate with the adapter by downloading a program (BIOS) and releasing reset on the adapter. If the adapter does not release reset, the host displays: Adapter did not release reset. Possible I/O address conflict. Adapter Load Error. If the adapter releases reset, the host waits for the BIOS 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 memory available and ports available. If there were any initialization errors, they will be displayed as: CPU. Checksum. Timer. RAM. Sync. Misc. Window Select Error. This test is performed on either 256K, 512K, 768K, or 1024K of memory. An error message with the window (1-32) 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 MC adapter has 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, the host will display the following error message(s): The diagnostic did not receive an IRQ. Interrupt acknowledge error. Interrupt pending error. Adapter hardware timer error. The host sends a command to the adapter to intitiate the hardware timer 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 BIOS begins testing the timer. The host has a timeout that requires the BIOS to finish the test in five seconds. If the host's timeout expires, the following message is displayed: Adapter's hardware timer test failed. Host timeout. If the BIOS reports a timer failure the following message is displayed: Adapter's BIOS reported hardware timer failure. Adapter Memory Test Error. The host sends a command to the adapter to intitiate the memory 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 BIOS begins testing the adapter's memory. The test takes aprroximately 15 seconds to complete. This test is only performed once during this session of the diagnostics. Further executions will display a message that the test is being skipped. The host has a timeout that requires the BIOS to finish the test in 20 seconds. If the host's timeout expires, the following message is displayed: Adapter's memory test failed. Host timeout. If the BIOS reports a memory failure the following message is displayed: Adapter's BIOS reported memory test failure. Port Error. 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(s). The host has a timeout that requires the adapter to finish the test in about six seconds. If 'All' ports was selected, both ports will be tested. If the host's timeout expires, the following message is displayed: Port ? failed. Host timeout. If L)oopback was 'No' the internal port test cycles between 2 modes. The 2 modes are 4 wire @ 230 KBaud and 4 wire @ 460 KBaud. If one or both modes fail the following message(s) appear: Port ? failed 4 wire @ 230 KBaud. Port ? failed 4 wire @ 460 KBaud. If L)oopback was 'Yes' the external port test repeats the mode on one or both ports. The 5 modes are: V.11 @ 2.458 MBaud, V.24 @ 57.6 KBaud, V.35 @ 2.458 MBaud, V.36 @ 2.458 MBaud, & Special @ 2.048 MBaud. If the mode fails, the corresponding message appears: Port ? failed V.11 @ 2.458 MBaud. Port ? failed V.24 @ 57.6 KBaud. Port ? failed V.35 @ 2.458 MBaud. Port ? failed V.36 @ 2.458 MBaud. Port ? failed Special @ 2.048 MBaud.