home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DIGIPROG.ZIP / USERDIAG.TXT < prev    next >
Text File  |  1993-07-29  |  35KB  |  809 lines

  1.  
  2.  
  3.           User Diagnostics Manual (USERDIAG.TXT)
  4.  
  5.            V 1.1.0            7/28/93
  6.  
  7.              Digiboard, Inc.
  8.  
  9.  
  10.             Table Of Contents
  11.  
  12. 1.0  Scope
  13.  
  14. 2.0  Applicable Documents
  15.  
  16. 3.0  Memory Map Utility (DIGIMMAP.EXE)
  17.  
  18.     3.1  General Description
  19.  
  20.         3.1.1  Display Conventions
  21.         3.1.2  Keyboard Conventions
  22.  
  23.     3.2  Functional Description
  24.  
  25.         3.2.1  BIOS Scan
  26.         3.2.2  RAM Scan
  27.         3.2.3  User Interface
  28.  
  29.     3.3  Product Limitations
  30.  
  31.  
  32. 4.0  User Diagnostic Utility (DIGIDIAG.EXE)
  33.  
  34.     4.1  General Description
  35.  
  36.         4.1.1  Display Conventions
  37.         4.1.2  Keyboard Conventions
  38.         4.1.3  Supported Product Families For The User Diagnostic's 
  39.  
  40.     4.2  Functional Description
  41.  
  42.         4.2.1  General Information Screen
  43.         4.2.2  Main Menu Screen
  44.         4.2.3  Main Help Screen
  45.         4.2.4  System Error Messages
  46.  
  47.     4.3  PC/Xe Board, PC/Xi Board, and 2Port Board Product Family
  48.  
  49.         4.3.1  General Information
  50.         4.3.2  Help Screens
  51.         4.3.3  Basic Test Descriptions
  52.         4.3.4  Error Messages
  53.  
  54.     4.4  MC/Xi Board Product Family
  55.  
  56.         4.4.1  General Information
  57.         4.4.2  Help Screens
  58.         4.4.3  Basic Test Descriptions
  59.         4.4.4  Error Messages
  60.  
  61.     4.5  C/X Host Adapter Product Family
  62.  
  63.         4.5.1  General Information
  64.         4.5.2  Help Screens
  65.         4.5.3  Basic Test Descriptions
  66.         4.5.4  Error Messages
  67.  
  68.  
  69.  
  70. 1.0    Scope
  71.  
  72.     This document contains information related to the User Diagnostics
  73.     package.  All files for this package are contained on the floppy disk,
  74.     and include this document, two executable programs, and release notes.
  75.     This document explains the memory map utility (DIGIMMAP.EXE) and the 
  76.     user diagnostics (DIGIDIAG.EXE).
  77.  
  78.  
  79. 2.0    Applicable Documents
  80.  
  81.     PC/Xe (old) Board Installation Guide            DBI  90028600
  82.     PC/Xe (new) Board, PC/Xi board Installation Guide    DBI  90026700
  83.     2Port Board Installation Guide                DBI  90028300
  84.     MC/Xi Board Installation Guide                DBI  90026600
  85.     C/X Host Adapter Installation Guide            DBI  90027700
  86.  
  87.  
  88. 3.0    Memory Map Utility (DIGIMMAP.EXE)
  89.  
  90. 3.1      General Description
  91.  
  92.     The memory map utility is an MS-DOS based executable program that is
  93.      designed to aid in the installation of DigiBoard hardware by detailing
  94.     locations in memory that are available for the DigiBoard product.
  95.  
  96. 3.1.1      Display Conventions
  97.  
  98.     When the memory map utility is executed, a main screen will appear.
  99.     From the main screen, the operator may select a 'help' screen,
  100.     execute the utility, or return to the operating system.
  101.  
  102.     The upper portion of the screen displays the current version of the
  103.     utility and copyright information.  The middle of the screen displays
  104.     data for operator's current selection.  The lower portion of the
  105.     screen is used for the operator interface.
  106.  
  107. 3.1.2      Keyboard Conventions
  108.  
  109.     Three keyboard entries are used by the memory map utility.  <E> is
  110.     used to execute the utility, <F1> displays the 'help' screen, and
  111.     <Esc> is used to return to the operating system.  The utility uses
  112.     the bottom of the screen to prompt the operator for keyboard inputs.
  113.  
  114. 3.2    Functional Description
  115.  
  116.     DIGIMMAP attempts to locate hardware in the upper 384K of the first
  117.     megabyte of memory of an IBM PC or compatible.  The memory range 
  118.     checked is from A0000H to FFFFFH.  Typical devices in this area may 
  119.     include video ROMs, system ROMs, hard disk adapters, and network
  120.     adapters.  DIGIMMAP performs a ROM scan and a RAM scan to locate 
  121.     hardware residing in upper memory.    
  122.  
  123. 3.2.1    BIOS Scan
  124.  
  125.     This portion of the utility searches from C0000H to EFFFFH in 2K
  126.     increments by checking the first two bytes of the region for a BIOS
  127.     signature of 55AAH.  If a ROM signature is found, the third byte
  128.     indicates the number of 512 byte sections and the appropriate area
  129.     is marked as unavailable.
  130.  
  131. 3.2.2    RAM Scan
  132.  
  133.     This is a scan of the memory regions which were unused accoding to
  134.     the previous test.  The RAM scan also breaks memory down into 2K
  135.     sections.  If the section is writable the section is marked as RAM
  136.     as is unavailable for the DigiBoard product.  If it is not writable, 
  137.     another type of ROM check is done, followed by either marking the 
  138.     area as ROM, or available for DigiBoard product installation.  ROMs 
  139.     found in the F0000H to FFFFFH area are considered System ROMs.
  140.  
  141. 3.2.3    User Interface
  142.  
  143.     The following steps are suggested to run this utility.  
  144.  
  145.     1.  Boot the system normally.  This brings up the system in its
  146.         normal configuration.  This should cause the RAM on any adapters
  147.         to be ON.  If the memory is switched OFF,  DIGIMMAP may not 
  148.         locate it.
  149.  
  150.     2.  Place a clean (NO TSR's and NO memory managers) boot floppy in
  151.         drive A.  Press Ctrl-Alt-Del to reboot the system.  DO NOT use
  152.         use a hardware reset to reboot as this will typically reset any 
  153.         adapters in the system.
  154.  
  155.     3.  Place the utility disk in drive A, and enter DIGIMMAP
  156.         at the system prompt.
  157.  
  158.     4.  The main menu will be displayed.
  159.  
  160.         The following warning messages are displayed.
  161.  
  162.         Memory managers, used to load drivers and TSRs into the
  163.         DOS high memory area, may cause DIGIMMAP to display incorrect
  164.         results.
  165.  
  166.         DO NOT run DIGIMMAP under Windows.  Windows uses the high
  167.         memory region, which may cause DIGIMMAP to display incorrect
  168.         results.
  169.  
  170.         DIGIMMAP does writes to high memory.  This may cause the
  171.         system to lock up.  Do not be alarmed, just reboot the system.
  172.  
  173.     5.  Pressing <E> from the main menu display will begin the high memory
  174.         search.  This is a four part process.  First it scans from C0000H
  175.          to C7FFFH for video ROMs, then scans C8000H to DFFFFH for general 
  176.         ROMs, then scans E0000H to EFFFFH for expansion ROMs.  The last 
  177.         part scans memory from A0000H to FFFFFH for RAM and other ROMs.
  178.         For this check, a memory write is done to memory locations.
  179.  
  180.     Messages will appear at the bottom of the screen as the utility goes
  181.     through the four checks.  When these are complete, two maps will be
  182.     displayed.  The list on the left will sequentially display the results
  183.     and the map on the right will display a grid map of the same results.
  184.  
  185.     These results are an educated guess of the areas in high memory that 
  186.     could be used to install the DigiBoard product.  Make note of the 
  187.     area(s) that are large enough to accomodate the product's memory 
  188.     requirements.
  189.  
  190. 3.3    Product Limitations
  191.  
  192.     If an adapter has RAM mapped to the high memory area but it only gets
  193.     activated (mapped) upon instruction from the driver (like some
  194.     DigiBoard products) and if this instruction has not been given,
  195.     the adapter may go undetected.
  196.  
  197.     Any extended memory manager will cause DIGIMMAP to deliver false data.
  198.     Since the memory manager is utilizing the upper memory area itself,
  199.     DIGIMMAP will confuse this usage with hardware RAM areas.  In some
  200.     cases a memory manager will install itself like a BIOS.  That is to
  201.     say, it will contain a 55AAH signature in the first two bytes of its
  202.     driver.
  203.  
  204.     If a driver loads itself high, DIGIMMAP will have the same difficulties
  205.     with the driver as it has with the extended memory managers.  The
  206.     general rule is to keep the software out of high memory when DIGIMMAP
  207.     is executing.
  208.  
  209.     DIGIMMAP will try to write to the first byte of each 2K block of 
  210.     memory that is found not to contain ROM.  This could have adverse
  211.     effects on the system if the adapter interprets it as an instruction.
  212.     This is unlikely, but possible.
  213.  
  214.  
  215. 4.0  User Diagnostic Utility (DIGIDIAG.EXE)
  216.  
  217. 4.1  General Description
  218.  
  219.     The user diagnostic utility is an MS-DOS based executable program that
  220.      is designed to aid in the installation and troubleshooting of 
  221.     DigiBoard hardware by performing a series of tests on the board.
  222.  
  223. 4.1.1  Display Conventions
  224.  
  225.     When the user diagnostic utility is executed, a general information 
  226.     screen is displayed followed by the main screen.  From the main 
  227.     screen, the operator may select a 'help' screen, execute the utility, 
  228.     or return to the operating system.
  229.  
  230.     There are four sections to the display.  The upper section of the 
  231.     screen displays the current version of the utility and copyright 
  232.     information.  The next section is the parameter selection section.
  233.     The next section displays test results when the diagnostic is 
  234.     executing.  The lower portion of the screen is used for the operator 
  235.     interface.
  236.  
  237. 4.1.2  Keyboard Conventions
  238.  
  239.     There are multiple keyboard entries for the user diagnostic utility.
  240.     Board parameters have unique keyboard entries.  When all parameters 
  241.     have been entered, press <E> to execute the utility.  Pressing <F1> 
  242.     displays various help screens.  <Esc> is used to return to the 
  243.     operating system.  The utility uses the bottom of the screen to 
  244.     prompt the operator for keyboard inputs.
  245.  
  246. 4.1.3  Supported Product Families For The User Diagnostic's 
  247.  
  248.     The current release of the user diagnostic supports the PC/Xe boards,
  249.      PC/Xi boards, ISA 2Port boards, MC/Xi boards,and the C/X host adapter 
  250.     boards.
  251.  
  252. 4.2  Functional Description
  253.  
  254.     The user diagnostic is a program that will test a DigiBoard for system
  255.     compatability and board reliability.  After all parameters have been
  256.      entered, the operator may execute the diagnostic.  A configuration
  257.     file (DIGIDIAG.CFG) is written to disk when program execution begins.
  258.     When the program is run again, the configuration information is read
  259.     and displayed for the operator.  The operator can immediately run the
  260.     diagnostics by pressing <E>, or reenter any parameters prior to running
  261.     the diagnostics.
  262.  
  263. 4.2.1  General Information Screen
  264.  
  265.     This screen gives the operator an overview of how to correctly 
  266.     execute the user diagnostics.  Appropriate warning messages are 
  267.     also displayed.    
  268.  
  269. 4.2.2  Main Menu Screen
  270.  
  271.     Following the general information, the main screen appears.  This 
  272.     program is designed to support multiple DigiBoard products.  The 
  273.     operator must select a product family displayed at the bottom of the
  274.     screen.
  275.  
  276. 4.2.3  Main Help Screen
  277.  
  278.     Prior to selecting a product family, pressing <F1> will display a 
  279.     product family information screen.    
  280.  
  281. 4.2.4  System Error Messages
  282.  
  283.     One of the configuration items that is stored is the system bus type.
  284.     This is either ISA/EISA or Micro Channel(MCA).  If the stored data does
  285.     not match the bus the program has found, the following error message
  286.     is displayed.
  287.  
  288.     ERROR!  Disk file & diagnostics have found a bus conflict.  ERROR!
  289.  
  290.      Disk file reported MCA bus.  Diagnostic reported ISA bus.
  291.                 (or)
  292.      Disk file reported ISA bus.  Diagnostic reported MCA bus.
  293.  
  294.      Suggest that the DIGIDIAG.CFG file be erased, then rerun diagnostics.
  295.  
  296.     When DIGIDIAG.CFG is erased the operator must enter new parameters
  297.     and the new DIGIDIAG.CFG will be written upon execution.  Executing
  298.     the diagnostic again on the same machine should result in no further
  299.     bus conflicts.
  300.  
  301. 4.3  PC/Xe Board, PC/Xi Board, 2Port Board Product Family
  302.  
  303.     This product family is an intelligent board with an 80186 CPU
  304.     embedded on the board.  It communicates with the host via dual ported
  305.     memory and interrupts.  It supports asynchronous communication with
  306.     2, 4, 8, or 16 ports.
  307.  
  308. 4.3.1  General Information
  309.  
  310.     The board's dual ported memory must either be 8K, 64K, or 128K.  The 
  311.     diagnostic is run in upper memory below the 1 megabyte boundary.  
  312.     Selecting a memory address range for the board may be assisted by
  313.     the DIGIMMAP.EXE program, which is supplied with this package.
  314.  
  315. 4.3.2  Help Screens
  316.  
  317.     There are two help screens associated with this product family.
  318.     The first explains each of the parameter entries, and the second is
  319.     a visual duplication of the switch settings for the boards.
  320.  
  321. 4.3.3  Basic Test Descriptions
  322.  
  323.     There are three basic test areas for this product family.  There are 
  324.     a number of subtests within each basic test, depending on the board 
  325.     type.
  326.  
  327.     The first basic test is the host's memory test.  The diagnostic 
  328.     writes/reads/compares data written to the board's dual ported memory.
  329.     Various patterns of bytes/words are checked for the entire dual ported
  330.     memory window.  Any failure is considered critical and the tests are
  331.     terminated with error information displayed.  Failure could indicate 
  332.     that a memory conflict exists.  The memory utility (DIGIMMAP.EXE) can 
  333.     be used to find a possible alternative memory window.
  334.  
  335.     The second basic test begins communicating with the board via the
  336.     selected host base address.  Code is downloaded to the board and a
  337.     response is necessary to post the information.  Other tests include an
  338.     IRQ test, window enable test (2Port), and window select test (2Port).
  339.     Any failure is considered critical and the tests are terminated with 
  340.     error information displayed.  
  341.  
  342.     The third basic test is the port test.  The parameters allow for a
  343.     single port to be tested.  There are other parameters that are used
  344.     in conjunction with the port test.  The diagnostic package includes an
  345.     RS-232 loopback cable for testing.  The signals that are looped back
  346.     on the supplied cable are TxD to RxD, DTR to DSR & DCD, and RTS to CTS
  347.     & RING.  The PC/Xi has a RS-422 option and a loopback cable must be 
  348.     assembled to perform the external test; the necessary loopback signals
  349.      are TxD to RxD and RTS to CTS.  The loopback parameter enables the 
  350.     operator to test the port in the internal or external mode.  The 
  351.     loopback cable must be installed for valid test results in the 
  352.     external mode.  When external testing is done, both data and control 
  353.     signals are tested.  In internal mode only data is tested.  Following
  354.     the data tests an interrupt test is performed on the selected port.
  355.  
  356.     The Continuous parameter allows the option of continually running the 
  357.     port test(s).  The Stop On First Error parameter allows the test to 
  358.     stop when an error is detected.
  359.  
  360.     The loopback plug for the RJ-45 version consists of a 10-pin RJ-45
  361.     plug wired as follows:
  362.         Pin 3 connected to pins 1 & 8 (RTS to RI and CTS);
  363.         Pin 5 connected to pin 6 (TxD to RxD);
  364.         Pin 9 connected to pins 2 & 10 (DTR to DSR and DCD).
  365.  
  366.     The loopback plug for the DB-25 version consists of a female DB-25
  367.     connector wired as follows:
  368.         Pin 4 connected to pins 22 & 5 (RTS to RI and CTS);
  369.         Pin 2 connected to pin 3 (TxD to RxD);
  370.         Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD).
  371.  
  372.     The loopback plug for the DB-9 version consists of a female DB-9
  373.     connector wired as follows:
  374.         Pin 7 connected to pins 9 & 8 (RTS to RI and CTS);
  375.         Pin 3 connected to pin 2 (TxD to RxD);
  376.         Pin 4 connected to pins 6 & 1 (DTR to DSR and DCD).
  377.  
  378. 4.3.4  Error Messages
  379.  
  380.     There are two places where error messages may appear.  The first
  381.     is at the bottom of the screen in the operator interface section.
  382.     Error messages here relate to parameter entry.  These messages
  383.     typically prompt the operator for another entry or request another
  384.     parameter first.  All parameters must be entered before execution
  385.     can begin.
  386.  
  387.     The second place error messages appear is is the test information 
  388.     section.  These will be displayed in red with 'Test FAILED' followed 
  389.     by a error message to identify the error.
  390.  
  391.     Memory Error.  If an error occurs during the host's dual ported 
  392.     memory tests, a message will appear that displays the address 
  393.     (segment:offset), expected/written value, and the read value.  The
  394.     host displays the message as:
  395.         Segment:offset = ????:????. Expected = ????. Read = ????.
  396.  
  397.     Board Reset Error.  If the memory tests were successful, the host
  398.     attempts to reset the board.  If the board does not reset, the host
  399.     displays:
  400.         Hardware reset error.  Possible I/O port conflict.
  401.  
  402.     Board Load Error.  If the board resets, the host attempts to 
  403.     communicate with the board by downloading a program (BIOS) and 
  404.     waiting for a response.  If the board does not respond, the host 
  405.     displays:
  406.         BIOS load error.  Possible memory conflict.
  407.  
  408.     If the BIOS load is successfully, the host displays board information
  409.     including board type, memory available, and ports available.  If
  410.     there were any initialization errors, they will be displayed as:
  411.         Memory errors.
  412.         Port(s) missing.
  413.         Port(s) error.
  414.  
  415.     IRQ Error.  If an IRQ was selected and an error occurred, a message
  416.     will indicate that the diagnostic did not receive an IRQ from the
  417.     board.  The 2Port board has two additional errors: interrupt 
  418.     acknowledge error, and interrupt pending error.  The host will 
  419.     display the following error message(s):
  420.         The diagnostic did not receive an IRQ.
  421.         Interrupt acknowledge error.
  422.         Interrupt pending error.
  423.  
  424.     Window Enable Error.  This test is only performed on the 2Port board.
  425.     One or both of the memory enable bits was found to be in error.  The
  426.      host displays the following message:
  427.         One or both of the memory enable bits are faulty.
  428.  
  429.     Window Select Error.  This test is only performed on the 2Port board
  430.      with the 8K window size selected.  An error message with the window 
  431.     (1-8) that failed will be displayed.  A base window select error is 
  432.     also possible.  The displays host the following message(s):
  433.         Window ? select error.
  434.         Base window select error.
  435.         8K windowing feature is faulty.
  436.  
  437.     Port Errors.  The first error that could appear is that the port
  438.     number selected is outside the range of ports supported by this
  439.     board.  The maximum port number supported by the board is determined
  440.     when BIOS code is downloaded and executed on the board.  The test will
  441.     terminate at this point and display:
  442.         The selected port number is invalid for this board.
  443.  
  444.     The host sends a command to the board to intitiate the port test.  If
  445.     no response to the command is received, the following message is
  446.     displayed:
  447.         Board communication error during test setup.
  448.         
  449.     If the command is successful, the board begins testing the port.  The
  450.     host has a timeout that requires the board to finish the test in a 
  451.     certain amount of time.  If the host's timeout expires, the following
  452.     message is displayed:
  453.         Port ?? failed.  Test timeout occurred.
  454.  
  455.     For either the internal or external data test the received data is
  456.     compared to the transmitted data.  If the they do not compare, the
  457.     following message is displayed:
  458.         Port ?? failed.  RX data did not compare with TX data.
  459.  
  460.     There is a timeout on the board for the transmission and reception of
  461.     data.  If the board's timeout expires, the following message is
  462.     displayed:
  463.         Port ?? failed.  Port timeout occurred during TX/RX of data.
  464.  
  465.     The control signals are only tested when the loopback connector is
  466.     installed.  Depending on the control signal failure, one of the
  467.     following messages is displayed:
  468.         Port ?? failed.  DCD input signal failed.        
  469.         Port ?? failed.  DSR input signal failed.
  470.         Port ?? failed.  CTS input signal failed.
  471.         Port ?? failed.  RING input signal failed.
  472.         Port ?? failed.  DCD & DSR failed.  Possible DTR failure.
  473.         Port ?? failed.  CTS & RING failed.  Possible RTS failure.
  474.         Port ?? failed.  DCD/DSR/CTS/RING failed.  Port failure.
  475.         Port ?? failed.  General port failure.
  476.  
  477.     There is a timeout on the board for the completion of the test.
  478.      If the board's timeout expires, the following message is displayed:
  479.         Port ?? failed.  Test timeout occurred.
  480.  
  481.     The port interrupt test checks the ability of the selected port to
  482.     generate an interrupt to the CPU on the board.  This is done by
  483.     traansmitting 1 byte of data in internal loopback mode.  If an error 
  484.     occurs, one of the following message is displayed:
  485.         Port ?? failed.  Port interrupt did not occur.
  486.         Port ?? failed.  RX data did not compare with TX data.
  487.         Port ?? failed.  Port timeout occurred during TX/RX of data.
  488.  
  489. 4.4  MC/Xi Board Product Family
  490.  
  491.     These are intelligent boards with an 80186 CPU embedded on the board.
  492.       They communicate with the host via dual ported memory and interrupts.
  493.       They support asynchronous communication with 4, 8, or 16 ports.
  494.  
  495. 4.4.1  General Information
  496.  
  497.     The board's dual ported memory is 32K.  The diagnostic is run in 
  498.     upper memory below the 1 megabyte boundary.  Selecting a memory 
  499.     address range for the board may be assisted by the DIGIMMAP.EXE 
  500.     program, which is supplied with this package.  When the board is
  501.     installed with the POS program, these values will be used for the
  502.     user diagnostics.
  503.  
  504. 4.4.2  Help Screens
  505.  
  506.     There is a help screen associated with this product family. It 
  507.     explains each of the parameter entries.
  508.  
  509. 4.4.3  Basic Test Descriptions
  510.  
  511.     There are three basic test areas for this product family.  There are 
  512.     a number of subtests within each basic test.
  513.  
  514.     The first basic test is the host's memory test.  The diagnostic 
  515.     writes/reads/compares data written to the board's dual ported memory.
  516.     Various patterns of bytes/words are checked throughout the entire 
  517.     dual ported memory window.  Any failure is considered critical and 
  518.     the tests are terminated with error information displayed.  Failure 
  519.     could indicate that a memory conflict exists.  The memory utility
  520.      (DIGIMMAP.EXE) can be used to find a possible alternative memory 
  521.     window.
  522.  
  523.     The second basic test begins communicating with the board via the
  524.     selected host base address.  The board is released from reset and the
  525.     code in the EPROMs is executed and a response is necessary to post 
  526.     the information.  Other tests include an IRQ test and window select 
  527.     test.  Any failure is considered critical and the tests are terminated
  528.      with error information displayed.  
  529.  
  530.     The third basic test is the port test.  The parameters allow for a
  531.     single port to be tested.  There are other parameters that are used
  532.     in conjunction with the port test.  The diagnostic package includes an
  533.     RS-232 loopback cable for testing.  The signals that are looped back
  534.     on the supplied cable are TxD to RxD, DTR to DSR & DCD, and RTS to CTS
  535.     & RING.  The PC/Xi board has an RS-422 option and a loopback cable 
  536.     must be assembled to perform the external test; the necessary loopback
  537.      signals are TxD to RxD and RTS to CTS.  The loopback parameter enables
  538.      the operator to test the port in the internal or external mode.  The
  539.     loopback cable must be installed for valid test results in the 
  540.     external mode.  When external testing is done, both data and control 
  541.     signals are tested.  In internal mode only data is tested.  Following
  542.     the data tests an interrupt test is performed on the selected port.
  543.  
  544.     The Continuous parameter allows the option of continually running the 
  545.     port test(s).  The Stop On First Error parameter causes the test to 
  546.     stop when an error is detected.
  547.  
  548.     The loopback plug for the RJ-45 version consists of a 10-pin RJ-45
  549.     plug wired as follows:
  550.         Pin 3 connected to pins 1 & 8 (RTS to RI and CTS);
  551.         Pin 5 connected to pin 6 (TxD to RxD);
  552.         Pin 9 connected to pins 2 & 10 (DTR to DSR and DCD).
  553.  
  554.     The loopback plug for the DB-25 version consists of a female DB-25
  555.     connector wired as follows:
  556.         Pin 4 connected to pins 22 & 5 (RTS to RI and CTS);
  557.         Pin 2 connected to pin 3 (TxD to RxD);
  558.         Pin 20 connected to pins 6 & 8 (DTR to DSR and DCD).
  559.  
  560. 4.4.4  Error Messages
  561.  
  562.     There are two places where error messages may appear.  The first
  563.     is at the bottom of the screen in the operator interface section.
  564.     Error messages here relate to parameter entry.  These messages
  565.     typically prompt the operator for another entry or request another
  566.     parameter first.  All parameters must be entered before execution
  567.     can begin.
  568.  
  569.     The second place error messages appear is is the test information 
  570.     section.  These will be displayed in red with 'Test FAILED' followed 
  571.     by a message to identify the error.
  572.  
  573.     Memory Error.  If an error occurs during the host's dual ported 
  574.     memory tests, a message will appear that displays the address 
  575.     (segment:offset), expected/written value, and the read value.  The
  576.     host displays the message as:
  577.         Segment:offset = ????:????. Expected = ????. Read = ????.
  578.  
  579.     Board Reset Error.  If the memory tests were successful, the host
  580.     attempts to reset the board.  If the board does not reset, the host
  581.     displays:
  582.         Hardware reset error. Possible board I/O port address conflict.
  583.  
  584.     Board Load Error.  If the board resets, the host attempts to 
  585.     communicate with the board by downloading a program (BIOS) and 
  586.     waiting for a response.  If the board does not respond, the host 
  587.     displays:
  588.         BIOS start error.  Possible memory conflict.
  589.  
  590.     If the BIOS load is successful, the host displays board information
  591.     including board type, memory available, and ports available.  If
  592.     there were any initialization errors they will be displayed as:
  593.         Memory errors.
  594.  
  595.     IRQ Error.  If an IRQ was selected and an error occurred, a message
  596.     will indicate that the diagnostic did not receive an IRQ from the
  597.     board.  The host will display the following error message:
  598.         The diagnostic did not receive an IRQ.
  599.  
  600.     Window Select Error.  An error message with the window (1-8) that 
  601.     failed will be displayed.  A base window select error is also 
  602.     possible.  The host displays the following message(s):
  603.         Window ? select error.
  604.         Base window select error.
  605.         32K windowing feature is faulty.
  606.  
  607.     Port Errors.  The first error that could appear is that the port
  608.     number selected is outside the range of ports supported by this
  609.     board.  The maximum port number supported by the board is determined
  610.     when BIOS code is downloaded and executed on the board.  The test will
  611.     terminate at this point and display:
  612.         The selected port number is invalid for this board.
  613.  
  614.     The host sends a command to the board to intitiate the port test.  If
  615.     no response to the command is received, the following message is
  616.     displayed:
  617.         Board communication error during test setup.
  618.         
  619.     If the command is successful, the board begins testing the port.  The
  620.     host has a timeout that requires the board to finish the test in a 
  621.     certain amount of time.  If the host's timeout, expires the following
  622.     message is displayed:
  623.         Port ?? failed.  Test timeout occurred.
  624.  
  625.     For either the internal or external data test the received data is
  626.     compared to the transmitted data.  If the they do not compare, the
  627.     following message is displayed:
  628.         Port ?? failed.  RX data did not compare with TX data.
  629.  
  630.     There is a timeout on the board for the transmission and reception of
  631.     data.  If the board's timeout expires, the following message is
  632.     displayed:
  633.         Port ?? failed.  Port timeout occurred during TX/RX of data.
  634.  
  635.     The control signals are only tested when the loopback connector is
  636.     installed.  Depending on the control signal failure, one of the
  637.     following messages is displayed:
  638.         Port ?? failed.  DCD input signal failed.        
  639.         Port ?? failed.  DSR input signal failed.
  640.         Port ?? failed.  CTS input signal failed.
  641.         Port ?? failed.  RING input signal failed.
  642.         Port ?? failed.  DCD & DSR failed.  Possible DTR failure.
  643.         Port ?? failed.  CTS & RING failed.  Possible RTS failure.
  644.         Port ?? failed.  DCD/DSR/CTS/RING failed.  Port failure.
  645.         Port ?? failed.  General port failure.
  646.  
  647.     There is a timeout on the board for the completion of the test.
  648.      If the board's timeout expires, the following message is displayed:
  649.         Port ?? failed.  Test timeout occurred.
  650.  
  651.     The port interrupt test checks the ability of the selected port to
  652.     generate an interrupt to the CPU on the board.  This is done by
  653.     transmitting 1 byte of data in internal loopback mode.  If an error 
  654.     occurs, one of the following messages is displayed:
  655.         Port ?? failed.  Port interrupt did not occur.
  656.         Port ?? failed.  RX data did not compare with TX data.
  657.         Port ?? failed.  Port timeout occurred during TX/RX of data.
  658.  
  659.  
  660. 4.5  C/X Host Adpater Product Family
  661.  
  662.     These are intelligent adapters with an 80186 CPU embedded on the board.
  663.       They communicate with the host via dual ported memory and interrupts.
  664.       They support synchronous or asynchronous communication with 2 ports.
  665.     There are six adapters testable with the user diagnostics.  The 
  666.     three earlier version adapters (ISA/EISA/MCA) are RS-422 only.  The
  667.     more recent adapters can select RS-232.  Fault isolation relays are 
  668.     also present in the newer adapters.
  669.  
  670. 4.5.1  General Information
  671.  
  672.     The adapter's dual ported memory is 32K.  The diagnostic is run in 
  673.     upper memory below the 1 megabyte boundary.  Selecting a memory 
  674.     address range for the adapter may be assisted by the DIGIMMAP.EXE 
  675.     program, which is supplied with this package.  When the adapter is
  676.     installed with the POS program, these values will be used for the
  677.     user diagnostics.
  678.  
  679. 4.5.2  Help Screens
  680.  
  681.     There are two help screens associated with this product family.
  682.     The first explains each of the parameter entries, and the second is
  683.     a visual duplication of the switch settings for the ISA host adapters.
  684.  
  685. 4.5.3  Basic Test Descriptions
  686.  
  687.     There are three basic test areas for this product family.  There are 
  688.     a number of subtests within each basic test.
  689.  
  690.     The first basic test is the host's memory test.  The diagnostic 
  691.     writes/reads/compares data written to the adapter's dual ported memory.
  692.     Various patterns of bytes/words are checked for the entire dual ported
  693.     memory window.  Any failure is considered critical and the tests are
  694.     terminated with error information displayed.  Failure could indicate 
  695.     that a memory conflict exists.  The memory utility (DIGIMMAP.EXE) can 
  696.     be used to find a possible alternative memory window.
  697.  
  698.     The second basic test begins communicating with the adapter via the
  699.     selected host base address.  Code is downloaded to the adapter and a
  700.     response is necessary to post the information.  Other tests include an
  701.     IRQ test, and window select test.  Any failure is considered critical 
  702.     and the tests are terminated with error information displayed.  
  703.  
  704.     The third basic test is the port test.  The parameters allow for a
  705.     single port to be tested.  There are other parameters that are used
  706.     in conjunction with the port test.  The terminator plug (part number
  707.     60000388) supplied with the adapter can be used for external loopback
  708.      testing.  The loopback parameter enables the operator to test the 
  709.     port in the internal or external mode.  The terminator cable must be
  710.      installed for valid test results in the external mode.
  711.  
  712.      The earlier adapters use only RS-422 and the newer adapters have 
  713.     RS-232 selectability.  The newer adapters also have fault isolation 
  714.     relays.  When external loopback is selected on the newer adapters, 
  715.     clicking can be heard due to the testing of the relays.  Data is
  716.     transmitted at 1.2 MB for RS-422 and 57.6 KB for RS-232.
  717.  
  718.     The Continuous parameter allows the option of continually running the 
  719.     port test(s).  The Stop On First Error parameter allows the test to 
  720.     stop when an error is detected.
  721.  
  722.     The terminator plug consists of a male HD-15 connector wired as 
  723.     follows:
  724.         Pin 1 to pin 6;
  725.         Pin 2 to pin 7;
  726.         Pin 3 to pin 15;
  727.         Pin 4 to pin 9;
  728.         Pin 5 to pin 10;
  729.         Pin 8 to pin 14;
  730.  
  731. 4.5.4  Error Messages
  732.  
  733.     There are two places where error messages may appear.  The first
  734.     is at the bottom of the screen in the operator interface section.
  735.     Error messages here relate to parameter entry.  These messages
  736.     typically prompt the operator for another entry or request another
  737.     parameter first.  All parameters must be entered before execution
  738.     can begin.
  739.  
  740.     The second place error messages appear is is the test information 
  741.     section.  These will be displayed in red with 'Test FAILED' followed 
  742.     by a error message to identify the error.
  743.  
  744.     Memory Error.  If an error occurs during the host's dual ported 
  745.     memory tests, a message will appear that displays the address 
  746.     (segment:offset), expected/written value, and the read value.  The
  747.     host displays the message as:
  748.         Segment:offset = ????:????. Expected = ????. Read = ????.
  749.  
  750.     Adapter Reset Error.  If the memory tests were successful, the host
  751.     attempts to reset the adapter.  If the adapter does not reset, the host
  752.     displays:
  753.         Hardware reset error. Possible board I/O port address conflict.
  754.  
  755.     Adapter Load Error.  If the adapter resets, the host attempts to 
  756.     communicate with the adapter by downloading a program (BIOS) and 
  757.     waiting for a response.  If the adapter does not respond, the host 
  758.     displays:
  759.         BIOS load error.  Possible memory conflict.
  760.  
  761.     If the BIOS load is successful, the host displays adapter information
  762.     including adapter type, memory available, and ports available.  If
  763.     there were any initialization errors they will be displayed as:
  764.         Memory errors.
  765.         Port(s) missing.
  766.         DMA errors.
  767.  
  768.     Window Select Error.  The number of windows is either 4 or 16 
  769.     depending on the amount of memory on the adapter (128K or 512K).
  770.     An error message with the window that failed will be displayed.  
  771.     A base window select error is also possible.  The host displays the
  772.     following message(s):
  773.         Window ? select error.
  774.         Base window select error.
  775.         32K windowing feature is faulty.
  776.  
  777.     Fuse Test Error.  The new host adapters have an auxillary 5 volt 
  778.     supply that is fused.  The condition of these fuses can be tested.  
  779.     If one or both of the fuses are open the following messsage is 
  780.     displayed:
  781.         One or both of the Auxillary 5 volt fuses are open.
  782.  
  783.     IRQ Error.  If an IRQ was selected and an error occurred, a message
  784.     will indicate that the diagnostic did not receive an IRQ from the
  785.     adapter.  The host will display the following error message:
  786.         The diagnostic did not receive an IRQ.
  787.  
  788.     The host sends a command to the adapter to intitiate the port test.  If
  789.     no response to the command is received, the following message is
  790.     displayed:
  791.         Board communication error during test setup.
  792.         
  793.     If the command is successful, the adapter begins testing the port.  The
  794.     host has a timeout that requires the adapter to finish the test in a 
  795.     certain amount of time.  If the host's timeout expires, the following
  796.     message is displayed:
  797.         Port ?? failed.  Test timeout occurred.
  798.  
  799.     For either the internal or external data test the received data is
  800.     compared to the transmitted data.  If the they do not compare, the
  801.     following message is displayed:
  802.         Port ?? failed.  RX data did not compare with TX data.
  803.  
  804.     There is a timeout on the adapter for the transmission and reception of
  805.     data.  If the adapter's timeout expires, the following message is
  806.     displayed:
  807.         Port ?? failed.  Port timeout occurred during TX/RX of data.
  808.  
  809.