home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / 594p.zip / INSTALL.DOC < prev    next >
Text File  |  1994-11-21  |  43KB  |  1,024 lines
  1.                                 9/29/94
  2.         -- INSTALL.DOC--xall.sys V1.4.7 a3 (Beta)
  3.  
  4. DigiBoard,- 6400 Flying Cloud Drive Eden Prairie, MN 55344 (612) 943-9020
  5.  
  6. DigiBoard, GmbH Schmittgasse 64 5000 Cologne 90 Germany 49-2203-81083
  7.  
  8.  
  9. Installation Guide Reference Manual for Universal OS/2 Device Driver for
  10. DigiBoard Intelligent Communications Boards
  11.  
  12. 92000100C
  13.  
  14. DigiBoard, DigiBoard, PC/Xi, PC/16i, PC/8i, PC/Xe, PC/16e, PC/8e,
  15. PC/4e, PC/2e, Xem, PC/Xem, MC/Xem, EISA/Xem, COM/Xi, COM/8i, COM/4i,
  16. MC/Xi, MC/16i, MC/8i, MC/4i, EPC/X, C/X and AccelePort are trademarks of
  17. DigiBoard. All other brand and product names are the trademarks of their
  18. respective holders.
  19.  
  20.  
  21. Digi International, Inc.  All Rights Reserved
  22.  
  23.  
  24. Information in this document is subject to change without notice and
  25. does not represent a commitment on the part of DigiBoard.  DigiBoard
  26. provides this document as is, without warranty of any kind, either
  27. expressed or implied, including, but not limited to, the particular
  28. purpose.  DigiBoard may make improvements and/or changes in this manual
  29. or in the product(s) and/or the program(s) described in this manual at
  30. any time.  This product could include technical inaccuracies or
  31. typographical errors.  Changes are periodically made to the information
  32. herein; these changes may be incorporated in new editions of the
  33. publication.
  34.  
  35. RESTRICTED RIGHTS:
  36.  
  37. For non-U.S. Government use: These programs are supplied under a
  38. license.  They may be used, disclosed, and/or copied only as permitted
  39. under such license agreement.  Any copy must contain the above copyright
  40. notice and this restricted rights notice.  Use, copying, and/or
  41. disclosure of the programs is strictly prohibited unless otherwise
  42. provided in the license agreement.
  43.  
  44. For U.S.  Government use: Use, duplication, or disclosure by the
  45. Government is subject to restrictions as set forth in sub-paragraph
  46. (c)(1)(ii) of the Rights in Technical Data and Computer Software clause
  47. of DFARS 52.227-7013.
  48.  
  49. Table of Contents                               1
  50. Introduction                                    2
  51. The Distribution Diskette                       2
  52. Installing the Device Driver                    3
  53. Global Parameters                               3
  54. Per-Card Parameters                             4
  55. Examples                                        6
  56. Testing the Ports                               8
  57. Troubleshooting                                 8
  58. Error Messages                                  18
  59. DMODE I/O Port Configuration Utility            10
  60. DMODE Examples                                  11
  61. Appendixes                                      12
  62.  
  63. Introduction
  64.  
  65. This release of the DigiWARE device driver for OS/2 supports the
  66. entire line of DigiBoard intelligent asynchronous serial communications
  67. controllers:
  68.  
  69. Micro Channel (MCA) bus:
  70.     DigiBoard MC/Xi 2, 4, 8 and 16 port boards
  71.     DigiBoard MC C/X cluster controller system
  72.     DigiBoard MC/Xem PC/AT
  73.         DigiBoard MC EPC/X
  74.  
  75. ISA bus:
  76.     DigiBoard PC/Xe 2, 4, 8 and 16 port boards
  77.     DigiBoard PC/Xi 8 and 16 port boards
  78.     DigiBoard COM/Xi 4 and 8 port boards
  79.     DigiBoard ISA C/X cluster controller system
  80.     DigiBoard PC/Xem
  81.     DigiBoard AccelePort
  82.         DigiBoard ISA EPC/X
  83.  
  84. EISA bus:
  85.     DigiBoard EISA C/X cluster controller system
  86.     DigiBoard EISA/Xem
  87.         DigiBoard EISA EPC/X
  88.  
  89. The device driver software supports multiple boards and multiple board
  90. types in a single machine, and can handle up to 256 ports from any
  91. combination of the boards listed above.  As new products are introduced,
  92. the driver will be upgraded to include those devices as well.  The
  93. driver takes all its configuration information from the device= command
  94. line in CONFIG.SYS, and all DigiBoard intelligent boards in a system
  95. are configured from a single command line.
  96.  
  97. In addition to the device driver, the configuration utility DMODE.EXE is
  98. provided to change communication parameters for individual ports without
  99. rebooting.  DMODE.EXE is similar to the OS/2 MODE command, but has some
  100. added features, and supports communications devices beyond OS/2's range
  101. of COM1 to COM8.
  102.  
  103.  
  104. Before installing this device driver software, complete the installation
  105. of the DigiBoard intelligent communications board(s) in your system,
  106. according to the hardware installation manual provided with the
  107. board(s), and write down your configuration!  The driver supports all
  108. legal I/O and memory address settings, but must be informed of these
  109. settings in the device driver command line.
  110.  
  111. The Distribution Diskette accompanying this manual contains all of the files
  112. and documentation needed to install the DigiWARE OS/2 Universal Intelligent
  113. Device Driver in your system.  A list of these files follows:
  114.  
  115. XALL.SYS        The installable device driver.
  116. DMODE.EXE       A MODE work-alike program for configuring I/O ports beyond COM8
  117. INSTALL.DOC     Installation instructions for the current release of the driver.
  118. RELNOTES.DOC    Release notes.
  119. DMODE.DOC       Instructions for the DMODE program.
  120. XALL.DOC        Programmers information about the driver and applicable
  121.         system calls.
  122. *.bin           Miscellaneous binary files used by the driver.
  123.  
  124.  
  125.  
  126. Installing the Device Driver.  Copy all of the files from the distribution
  127. diskette to a single directory on your hard drive.  By default, driver
  128. and data files are expected to be in \DIGI.  The device driver is
  129. invoked by placing its name and configuration arguments into the
  130. systems CONFIG.SYS file.  All DigiBoard intelligent asynchronous
  131. serial communications boards must be installed from a single command
  132. line, which contains complete set-up information for each board.  The
  133. format of the command line is:
  134.  
  135. device=\digi\xall.sys [/n:names] [/b:baud] [/d:dtype] [/f:digipath]
  136. [/v:messagepath] [/l:lptnames] [/s:sigs_off] /t:card /p:port /m:mem
  137. [, /t:card /p:port /m:mem] [, ...]
  138.  
  139. Note that the path for XALL.SYS is \DIGI.  This is the default path.  If an
  140. alternative path is specified with the /f:digipath option, substitute that
  141. path for \DIGI.
  142.  
  143. The above command line must appear on a single command line in the
  144. CONFIG.SYS file.  This line may be up to 255 characters long.
  145.  
  146. Global Parameters. The first six parameters in the command line above are
  147. global parameters, and affect all boards installed.  These parameters
  148. are optional, and may be omitted.  If omitted, default values will be
  149. used.
  150.  
  151.     /n:names        Defines the naming convention to be use for the
  152.             DigiBoard ports.  Names consists of an optional
  153.             stem followed by the starting device number.  The new
  154.             stem must be enclosed in double-quotes ("").  If
  155.             the stem is omitted, COM will be used.  If the
  156.             number is omitted, 3 will be assumed.  If the /n
  157.             parameter is not specified, the default name COM3 will
  158.             be assigned to the first port.
  159.  
  160.         /n:"digi"0      DIGI0, DIGI1, DIGI2, ...  DIGIn
  161.         /n:4            COM4, COM5, COM6, ...  COMn
  162.         /n:"qdev"       QDEV3, QDEV4, QDEV5, ...  QDEVn
  163.  
  164.     /b:baud         Sets the default baud rate to be used for all ports.
  165.             If this parameter is not specified, all ports will be
  166.             set to the OS/2 default of 1200 baud.  Baud rates of
  167.             up to 230,000 are supported.  Use the DMODE.EXE
  168.             command to set baud rates of individual ports.
  169.  
  170.         /b:9600         Initializes all ports to 9600 baud.
  171.  
  172.     /d:dtype        Sets the initial data type (parity, character
  173.             length and number of stop bits).  If this parameter
  174.             is omitted, the OS/2 default data type of even
  175.             parity, 7 data bits and 1 stop bit is used.  The
  176.             syntax is [pds], where p is E, O or N; d is 8, 7, 6
  177.             or 5; and s is 1 or 2.  All three values must be
  178.             supplied, in the correct order.
  179.  
  180.         /d:N81          No parity, 8 data bits, 1 stop bit.
  181.  
  182.     /f:digipath     Defines an alternative directory path for the driver
  183.             and data files.  If this option is present, all files
  184.             from the distribution diskette must be present in this
  185.             directory.
  186.  
  187.         /f:d:\drvr\digi         All data files are in D:\DRVR\DIGI.
  188.  
  189.  
  190.     /v:messagefile  Forces the driver to direct all verbose messages
  191.             to the file named.  If /v: is given without a
  192.             filename, messages will be placed in \XALL.MSG.
  193.             This flag prevents any information from being
  194.             displayed on the console; useful in some situations
  195.             as when the machine is a headless server, where
  196.             calls to Standard Output will cause problems.  Without
  197.             this flag, all messages will appear on the
  198.             system console.  The message file is overwritten
  199.             each time the system is started.
  200.  
  201.         /v:errmsg       Writes banner and other info to file \ERRMSG.
  202.         /v:             Writes banner and other info to file \XALL.MSG.
  203.  
  204.     /a:a            Enable the alternate pin assignment of Data Carrier
  205.             Detect (DCD) for all ports (see discussion of Alt-Pin
  206.             processing.
  207.  
  208.  
  209.         /a:q            Disables the performance enhancing quick-write mode.
  210.                         The driver defaults to quick-write mode enabled. When
  211.                         enabled, DosWrite calls return as soon as the transmit
  212.                         data is copied to the DigiBoard hardware transmit
  213.                         buffer. When this mode is disabled, DosWrite calls
  214.                         will return only after the transmit data has actually
  215.                         left the DigiBoard hardware, mimicing the OS/2 COM.SYS
  216.                         driver. A side effect of using quick-writes is that
  217.                         when DosClose is called, the driver must wait for any
  218.                         transmit data on the DigiBoard hardware to drain
  219.                         before finishing the close processing.
  220.  
  221.  
  222.  
  223.     /s:sigs_off     Forces modem control output signals off on port open.
  224.  
  225.         /s:d            DTR remains low or off on port open.
  226.         /s:r            RTS remains low or off on port open.
  227.         /s:dr           DTR & RTS remain low or off on port open.
  228.  
  229.  
  230.     /l:lptnames   This permits the user to define names for the 8emp
  231.             printer ports so that they are accessable to the OS/2
  232.             print manager. The convention is similar to the
  233.             /n:names option mentioned above.
  234.  
  235.             Names consists of an MANDITORY stem followed by the
  236.             starting device number.  The new stem must be
  237.             enclosed in double-quotes ("").  If the stem is
  238.             omitted, the parameter is invalid.  If the number is
  239.             omitted, 3 will be assumed.  If the /l: parameter is
  240.             omitted, the 8emp printer port will be named sequent-
  241.             ially with the other 8emp ports. If more than one
  242.             8emp module is used, the printer ports will be num-
  243.             bered sequentially starting with the stem and number
  244.             supplied with this option. If any DigiBoard supported
  245.             port has the same name as the selected 8emp printer
  246.             name, the 8emp printer port will be assigned the
  247.             specified name and the other port will be given the
  248.             name the printer port would have had, had this option
  249.             not been used.
  250.  
  251.  
  252.             The algorithm used to assign the names is as follows:
  253.  
  254.             1) Assign names to all ports (which will includ the
  255.                printer ports) using the driver's normal naming
  256.                convention, "/n:".
  257.  
  258.             2) Assign new names to the printer ports using the
  259.                names supplied by the "/l:" parameter.
  260.  
  261.             3) If step 2 would result in a printer port's name
  262.                being changed to a name assigned to another port,
  263.                the printer port gets the "/l:" name and the comm
  264.                port gets the printer ports original name.
  265.  
  266.  
  267.  
  268.  
  269.         /l:"com"2 /n:digi0
  270.                     8emp Ports
  271.  
  272.             1     2     3     4     5     6     7     8    9(prtr)
  273.             |     |     |     |     |     |     |     |    |
  274.               digi0 digi1 digi2 digi3 digi4 digi5 digi6 digi7 com2
  275.  
  276.  
  277.  
  278.         /l:"com"2
  279.                     8emp Ports
  280.  
  281.             1    2    3    4    5    6    7    8     9(prtr)
  282.             |    |    |    |    |    |    |    |     |
  283.               com3 com4 com5 com6 com7 com8 com9 com10 com2
  284.  
  285.             The 8emp ports start with "com3" since the "/n:"
  286.             parameter is ommited and com2 is assigned to the
  287.             printer port.
  288.  
  289.  
  290.  
  291.         /l:"com"
  292.                     8emp Ports
  293.  
  294.             1    2     3    4    5    6    7    8     9(prtr)
  295.             |    |     |    |    |    |    |    |     |
  296.               com11 com20 com5 com6 com7 com8 com9 com10 com3
  297.  
  298.               10    11    12    13    14    15    16    17   18(prtr)
  299.                |     |     |     |     |     |     |     |    |
  300.               com12 com13 com14 com15 com16 com17 com18 com19 com4
  301.  
  302.  
  303.               The printer ports are named sequentially starting with
  304.               the name "com3", so ports 9 and 18 are named "com3" and
  305.               "com4" respectively. Since the "/n:" option was not
  306.               used, the com ports would have started their names with
  307.               "com3". Since port 9 and 18 are already assigned "com3"
  308.               and "com4", port 1 (normally com3) is given the name
  309.               "com11" and port 2 (normally com4),is given the name
  310.               "com20", since these are the names that would have been
  311.               assigned to ports 9 and 18 had the "/l:" option not
  312.               been used.
  313.  
  314.  
  315.  
  316.         /l:"com"2 /n:"com"4
  317.  
  318.                     8emp Ports
  319.  
  320.             1    2    3    4    5    6    7     8     9(prtr)
  321.             |    |    |    |    |    |    |     |     |
  322.               com4 com5 com6 com7 com8 com9 com10 com11 com2
  323.  
  324.               10    11    12    13    14    15    16    17   18(prtr)
  325.                |     |     |     |     |     |     |     |    |
  326.               com13 com14 com15 com16 com17 com18 com19 com20 com3
  327.  
  328.  
  329.               Here, the standard com port names are not modified
  330.               because they have been specified to start with "com4"
  331.               using the "/n:" option, which don't conflict with the
  332.               specified printer port names.
  333.  
  334.  
  335.  
  336. Per-Card Parameters. The remaining three parameters are per-card
  337. parameters, and are used to inform the driver of the type of board and
  338. where it is to be addressed in the hosts I/O and memory buses.  These
  339. parameters are mandatory, and must be given for each board!  The
  340. per-card parameters must be given in complete sets, and the sets must be
  341. separated by commas.
  342.  
  343.     /t:card         Defines the card type to the driver.  Legal values
  344.             for card are:   a for AccelePort
  345.                     i for the ISA C/X,
  346.                     e for the EISA C/X,
  347.                     m for the MC C/X,
  348.                     p for Xem (PC/Xem, MC/Xem or EISA/Xem)
  349.                     x for COM/Xi boards.
  350.                                         c for all EPC/X cards (ISA, EISA, MCA)
  351.  
  352.             This parameter must be omitted for PC/Xe, PC/Xi and
  353.             MC/Xi boards.  The designators i, e, and m must be
  354.             followed by an additional two digits defining the
  355.             number and arrangement of DigiBoard C/CON-16 or
  356.             C/CON-16e concentrators on each host adapter channel.
  357.             If the concentrator(s) are connected to the host
  358.             adapter via a dial-up or leased line (remote
  359.             concentrators), each of the two digits must be
  360.             followed by a parameter, enclosed in parentheses,
  361.             specifying the synchronous communications mode to
  362.             be used for that line.  See the Appendix A for a
  363.             list of available synchronous communications modes.
  364.  
  365.         /t:x            COM/Xi (4 or 8 channels)
  366.  
  367.         /t:a            AccelePort
  368.  
  369.         /t:p            PC/Xem, MC/Xem or EISA Xem
  370.  
  371.  
  372.         /t:i10          ISA C/X, one local concentrator on line 1
  373.                                 only.
  374.  
  375.         /t:e11          EISA C/X, one local concentrator on each of
  376.                 lines 1 and 2.
  377.         /t:m21          MC C/X, two local concentrators on line 1 and
  378.                 1 on line 2.
  379.         /t:e12          EISA C/X, one local concentrator on line 1,
  380.                 and two on line 2.
  381.         /t:i22          ISA C/X, two local concentrators on each of
  382.                 lines 1 and 2.
  383.         /t:i2(21)3(27)  ISA C/X, two remote concentrators on line 1,
  384.                 and two remote concentrators on line 2.
  385.                 The concentrators on line 1 will use mode
  386.                 #21 (76,800 baud, 8-wire, external clock) to
  387.                 communicate with the host adapter, and the
  388.                 concentrators on line 2 will use mode #27
  389.                 (614,400 baud, 8-wire, internal clock).  See
  390.                 the Appendix for a list of synchronous
  391.                 communications modes.
  392.                 /t:c22          An ISA, EISA, or MCA EPC/X with 2 concentrators
  393.                                 on each line. Please see Appendix B for a more
  394.                                 detailed explanation of EPC/X configuration
  395.                                 specifications.
  396.  
  397.  
  398.  
  399.     /p:port         Defines the I/O port address for the card.
  400.  
  401.         /p:300          Board is addressed at I/O port 300h.
  402.         /p:2005         EISA board (EISA C/X or EISA/Xem host adapter)
  403.                 is in slot 2 (EISA I/O addresses are 4
  404.                 digits : the slot number, followed by 005).
  405.                 When plugging an ISA board (PC/Xe, ISA
  406.                 C/X host adapter, etc.) into an EISA
  407.                 machine, the /p parameter must contain the
  408.                 3-digit I/O address as set by the DIP switches
  409.                 on the board, and not the 4-digit address
  410.                 based on the EISA slot number.
  411.  
  412.     /m:mem          Dual-ported memory starting address.  This is the full
  413.             32-bit hexadecimal address of the beginning of the
  414.             boards dual-ported memory.
  415.  
  416.         /m:d0000        Sets dual-ported memory start address to
  417.                 0D0000h (in the BIOS expansion area between
  418.                 640K and 1 megabyte).
  419.         /m:e80000       Sets start address of E80000h (in the
  420.                 fifteenth megabyte).  EISA and ISA boards
  421.                 (except the COM/Xi), may all share the same
  422.                 memory starting address.  COM/Xi and all
  423.                 Micro Channel boards must each have
  424.                 unique memory addresses.
  425.  
  426.  
  427. Examples The following examples start out with just the minimum to
  428. install a DigiBoard board.  After locating an example for your type of
  429. board, read the rest of the examples for optional situations that may be
  430. appropriate to your application.  Default options will be altered by
  431. your application program(s) when you configure the application.
  432.  
  433. --------
  434.  
  435. Example 1:      COM/Xi One COM/Xi at I/O port 300h, memory start address
  436. D8000h; devices to be named COM5 COM6, etc.  All data files are in the
  437. directory \DIGI:
  438.  
  439. device=c:\digi\xall.sys /n:5 /p:300 /m:d8000 /t:x
  440.  
  441. (Note that the above must all appear on one line in CONFIG.SYS)
  442.  
  443. --------
  444.  
  445. Example 2:      PC/Xe, PC/Xi One PC/Xe (or PC/Xi) at I/O port 220h,
  446. memory address D0000h   Ports will be named COM3, COM4, etc.
  447. (default names).  All data files are in the directory \MISC\DIGI:
  448.  
  449. device=c:\misc\digi\xall.sys /f:\misc\digi /p:220 /m:d0000
  450.  
  451. (Note that the above must all appear on one line in CONFIG.SYS)
  452.  
  453. --------
  454.  
  455. Example 3:      MC/Xi One MC/Xi at I/O port F1F0h, memory address
  456. FC0000h.  Devices will be named DIGI1, DIGI2, etc.  and will have an
  457. initial baud rate of 38,400.  All data files are in the default
  458. directory \DIGI: 
  459.  
  460. device=c:\digi\xall.sys /n:"digi"1 /b:38400 /p:F1F0 /m:FC0000 
  461.  
  462. (Note that the above must all appear on one line in CONFIG.SYS)
  463.  
  464. --------
  465.  
  466. Example 4:      Two board installation with optional global parameters.
  467. Two PC/Xi (or PC/Xe) boards at I/O ports 320h and 300h, with dual-ported
  468. memory of both starting at D0000h.  Ports will be named COM0, COM1,
  469. etc., and will be initialized to 38,400 baud, no parity, 8 data bits and
  470. 1 stop bit; messages will be contained in the file MESSAGES.MSG located
  471. in the \DIGI directory.  All data files are in the default directory
  472. \DIGI: 
  473.  
  474. device=c:\digi\xall.sys /n:0 /b:38400 /v:\digi\messages.msg /d:N81
  475. /p:320 /m:D0000, /p:300 /m:D0000 
  476.  
  477. (Note that the above must all appear on one line in CONFIG.SYS)
  478.  
  479. ---------
  480.  
  481. Example 5:      PC/Xem One PC/Xem at I/O port 224h, memory start address
  482. C8000h; devices to be named COM3 COM4, etc.  All data files are in the
  483. default directory \DIGI: 
  484.  
  485. device=c:\digi\xall.sys /p:224 /m:C8000 /t:p
  486.  
  487. (Note that the above must all appear on one line in CONFIG.SYS)
  488.  
  489. ---------
  490.  
  491.  
  492. Example 6:      ISA C/X One ISA C/X host adapter at I/O port 228h,
  493. memory address D0000h, with one concentrator on line 1 and two on line
  494. 2.  Devices to be named DCX1, DCX2, etc.  and will have an initial baud
  495. rate of 38,400.  All data files are in the default directory \DIGI:
  496.  
  497. device=c:\digi\xall.sys /n:"dcx"1 /b:38400 /p:228 /m:d0000 /t:i12
  498.  
  499. (Note that the above must all appear on one line in CONFIG.SYS)
  500.  
  501. -----------
  502.  
  503. Example 7:      EISA C/X with a remote concentrator via an RS-232
  504. synchronous modem.  One EISA C/X host adapter in slot 3, memory address
  505. D8000h, with two local concentrators on line 1 and one remote
  506. concentrator at 9600 baud and external clocking on line 2.  Devices to
  507. be named COM5, COM6, etc.  and will have an initial baud rate of 19,200.
  508. All data files are in the directory \OS2\DIGI:
  509.  
  510. device=c:\os2\digi\xall.sys /n:5 /b:19200 /f:c:\os2\digi /p:3005 /m:d8000
  511. /t:e21(17)
  512.  
  513. (Note that the above must all appear on one line in CONFIG.SYS)
  514.  
  515. ----------
  516.  
  517. Example 8:      MC C/X and MC/Xem One MC C/X host adapter at I/O port
  518. 228h, memory address D8000h, with one concentrator on line 1 and one
  519. concentrator  on line 2; one MC/Xem at I/O Port 304h, memory address
  520. D0000h.  Devices will be named DIGI1, DIGI2, etc.  and will have an
  521. initial baud rate of 38,400, Alt-Pin enabled, no parity, 8 data bits,
  522. and 1 stop bit.  All data files are in the default directory \DIGI:
  523.  
  524. device=c:\digi\xall.sys /n:"digi"1 /b:38400 /a:a /d:N81 /p:228
  525. /m:d8000 /t:m11, /p:304 /m:d0000 /t:p
  526.  
  527. (Note that the above must all appear on one line in CONFIG.SYS) 
  528. (Note that for MC C/X and MC/Xem, the addresses 104 and 108 should not be 
  529.  used to avoid possible conflicts)
  530.  
  531. ----------
  532. ----------
  533.  
  534. Testing the Ports The simplest (and probably the best) way to check the
  535. driver and I/O connections is to connect an ASCII terminal to one of the
  536. ports and redirect some output to that port.  If the terminal is
  537. connected to COM3, try something like the following: 
  538.  
  539. dmode com3
  540.  
  541. (this will verify that the driver can find the portthe ports parameters will 
  542. be displayed.) 
  543.  
  544. dmode com3 octs=off odsr=off
  545.  
  546. (this insures that the hardware handshaking signals CTS and DSR will 
  547. not prevent outputwe are not concerned with flow control at this time.) 
  548.  
  549. dir > com3          
  550.  
  551. (this redirects the current directory to COM3.) The console should simply 
  552. respond by repeating the C:\> prompt, and the current directory 
  553. (in this case, C:\) will appear on the terminal.
  554.  
  555.  
  556.  
  557. Troubleshooting If the C:\> prompt doesn't reappear, and the system
  558. seems to be hung, you probably used a memory start address that is
  559. being used by some other device, or the board is not set for the address
  560. specified in CONFIG.SYS.  Try a different address.  If it still hangs,
  561. try a different I/O port.  If your computer has a memory cache and the
  562. boards memory start address is above 1 megabyte, try either disabling
  563. the cache or moving the board to a low-memory address (D0000 is usually
  564. a good choice).  It is also possible that a conflict exists with another
  565. device driver which has been loaded via CONFIG.SYS.  The XALL.SYS line
  566. should be placed near the end of the CONFIG.SYS, and must not be placed
  567. before the DEVICE=TESTCFG.SYS line.  Due to potential device naming
  568. conflicts, the pair of lines
  569.  
  570. DEVICE=\OS2\COM.SYS and 
  571. DEVICE=\OS2\VCOM.SYS 
  572.  
  573. may cause problems.  Be sure that the XALL.SYS line is placed before 
  574. these lines in CONFIG.SYS.  If the XALL.SYS driver generates an error 
  575. message, try temporarily putting REM in front of the above two lines. 
  576. If this works, there is probably a naming conflict.  You may need to 
  577. add a /n: command line flag to the XALL.SYS line to force the driver to use 
  578. a different base name or start numbering the COM devices at 5 or above.  
  579. If the C:\> prompt does reappear, but there is no output on the terminal
  580. screen, there is probably a cabling problem.  Make sure that all cable plugs
  581. are securely seated in receptacles, and that they are configured correctly 
  582. (see the appropriate section of the hardware installation guide for your 
  583. board).  If the terminal displays output, but the data on the screen is 
  584. garbled, the terminal is probably not set with the same baud rate and data 
  585. type as specified in CONFIG.SYS (or the defaults, if not specified).  
  586. Verify these settings.  If everything checks out and you still have 
  587. problems, there could be a problem with your board.  Contact your distributor 
  588. or DigiBoard Technical Support for further assistance.
  589.  
  590. Error Messages If, when the driver is loaded, it cannot find the
  591. board(s), or if they fail to respond properly to commands, certain error
  592. messages may be sent to the console.  These error messages are defined
  593. in the following table:
  594.  
  595. Could not find BIOS file 
  596. Could not find FEP file 
  597. Could not find data file        One or more files were missing from the 
  598.                 digipath directory.  The default digipath 
  599.                 directory is /digi.  If you have loaded the 
  600.                 driver and data files into a different 
  601.                 directory, that directory must be 
  602.                 specified in the xall command line with 
  603.                 the /f:digipath parameter.  
  604.                 
  605. IO Port Not Responding          I/O port address set incorrectly, or
  606.                 conflicting with some other device.  Verify 
  607.                 setting, or try a different address.  
  608.  
  609. DigiBoard BIOS Will Not Boot    
  610. DigiBoard BIOS Will Not Respond 
  611. DigiBoard FEPOS Will Not        DigiBoard board will not respond to 
  612.                 commands from the driver.  Typically due to a
  613.                 memory conflict, or a memory cache conflict.  
  614.  
  615. Driver Failed to Hook Timer
  616. System Cannot Allocate Memory    A system call to OS/2 has failed.  
  617.  
  618. Invalid Command Line Arguments  Syntax error in the command line in 
  619.                 CONFIG.SYS.  Double-check your entries.
  620.  
  621.  
  622. ========
  623.  
  624. DMODE I/O Port Configuration Utility DMODE is DigiBoards I/O channel
  625. configuration utility.  DMODE functions like the OS/2 MODE command, but
  626. is more flexible, and provides some added features.
  627.  
  628.     -Supports communications device names other than COM1-COM8.
  629.     -Any single parameter may be changed without causing all others
  630.      to be reset to default values.
  631.     -Can be used to enable or disable the Alt-Pin feature on
  632.      individual ports.
  633.     -Maintains the familiar MODE syntax.
  634.  
  635. DMODE arguments may be entered in any order, and in many cases may be
  636. abbreviated.  For example, a baud rate of 19,200 may be entered simply
  637. as 19, since within the context of the DMODE command, 19 cannot be
  638. interpreted as anything else.  Arguments may be separated by spaces or
  639. commas, and unspecified parameters are left unchanged.  DMODE returns
  640. the settings of all parameters after any requested changes have been
  641. made.  If no parameters are given, DMODE simply returns the current
  642. settings.  The syntax of DMODE is: dmode port_name [parameters]
  643.  
  644. Port names and parameters are not case sensitive, so upper and lower
  645. case letters may be freely mixed without effect on the operation of the
  646. DMODE command.  The following parameters are accepted:
  647.  
  648. Baud Rate       Baud rates can be specified with 2 to 5 digit designations,
  649.         according to the following table:
  650. Accepted Values         Baud Rate
  651.  
  652. 11 110                     110
  653. 15 150                     150
  654. 30 300                     300
  655. 60 600                     600
  656. 12 120 1200                1200
  657. 24 240 2400                2400
  658. 48 480 4800                4800
  659. 96 960 9600                9600
  660. 19 192 1920 19200          19200
  661. 38 384 3840 38400          38400
  662. 56 567 5670 56700          56700
  663.    115 1152 11520 115200   115200
  664.    230 2300 23000 230000   230000
  665.  
  666.  
  667. Character Length Characters may be 5, 6, 7 or 8 bits long.  Enter
  668. the appropriate number in the DMODE arguments.
  669.  
  670. Parity:  Enter the desired parity checking method with a single
  671. letter E, O, N, M or S for Even, Odd, None, Mark or Space, respectively.
  672.  
  673. Stop Bits: Enter the desired number of stop bits.  Recognized
  674. values are 1, 2 and 1.5.
  675.  
  676. Flags : DMODE supports the following flags in the same way as
  677. the OS/2 MODE command.  Refer to your OS/2 documentation for
  678. explanations of the flags.  To set a flag, enter the mnemonic for the
  679. flag, followed by an equals sign (=), and the desired value (ON, OFF,
  680. etc.).
  681.  
  682. TO=ON           Write timeout in effect.
  683. TO=OFF          No timeout (infinite write timeout)
  684.  
  685. XON=ON          XON/XOFF Transmit handshaking enabled.
  686. XON=OFF         XON/XOFF Transmit handshaking disabled.
  687. XON=BOTH        XON/XOFF Transmit and receive handshaking enabled.
  688.  
  689. IDSR=ON         Enables Input DSR Sensitivity.
  690. IDSR=OFF        Disables Input DSR Sensitivity.
  691.  
  692. ODSR=ON         Enables Output DSR Sensitivity.
  693. ODSR=OFF        Disables Output DSR Sensitivity.
  694.  
  695. OCTS=ON         Enables CTS output flow control.
  696. OCTS=OFF        Disables CTS output flow control.
  697.  
  698. DTR=ON          Sets DTR to ON or HIGH.
  699. DTR=OFF         Sets DTR to OFF or LOW.
  700. DTR=HS          DTR used for input flow control.  RTS Signal Control
  701.  
  702. RTS=ON          Sets RTS to ON or HIGH.
  703. RTS=OFF         Sets RTS to OFF or LOW.
  704. RTS=HS          RTS used for input flow control.
  705. RTS=TOG         Toggles RTS on every transmit request. (Not supported)
  706.  
  707. ALT=ON          Internally swaps DSR and DCD signals (see explanation below).
  708. ALT=OFF         DSR and DCD are not swapped.
  709.  
  710. QW=ON           Enables quick-write mode on the specified port.
  711. QW=OFF          Disables quick-write mode on the specified port.
  712.  
  713. DigiCHANNEL products use 10-pin RJ-45 connectors in order to support all
  714. of the signals normally available on a 9-wire RS-232 connection.
  715. However, many commercially available RJ-45 connectors have only 8 pins.
  716. 8-pin RJ-45 plugs will fit in a 10-pin jack, but the first and last pins
  717. (numbers 1 and 10) are not connected.  DigiBoard uses these pins for the
  718. modem control signals RI (Ring Indicator, pin 1) and DCD (Data Carrier
  719. Detect, pin 10).  While Ring Indicator is rarely a concern (since most
  720. modems have auto-answer capability), Data Carrier Detect is often
  721. monitored to insure that the modem has established, and is maintaining,
  722. a valid connection with a remote modem.  To facilitate the use of 8-pin
  723. RJ-45 connectors in modem applications, a special DMODE flag, ALT, has
  724. been provided.  ALT instructs the device driver to monitor pin 1 of an
  725. 8-pin RJ-45 for DCD.  See the Hardware Installation guide for your board
  726. for cabling diagrams and pin assignment charts for DB-25 and RJ-45
  727. connectors.
  728.  
  729. Examples
  730.  
  731. dmode digi12
  732.  
  733. (Returns the current settings of device digi12.  No changes are made.)
  734.  
  735. dmode com5 2
  736.  
  737. (Configures COM5 for 2 stop bits.  All other parameters remain unaffected.)
  738.  
  739. dmode com5:38 rts=on 
  740.  
  741. (Configures COM5 for a baud rate of 38,400 and sets RTS to ON or HIGH.)
  742.  
  743. dmode com5 8 
  744.  
  745. (Configures COM5 for 8 data bits.  No other parameters are affected. )
  746.  
  747. dmode comdv83 idsr=off, to=off e 7 12 
  748.  
  749. (Sets COMDV83 to disable Input DSR Sensitivity, disable output timeout, 
  750.  select even parity, 7 data bits and a baud rate of 1200. )
  751.  
  752. dmode com5 38 alt=on 
  753.  
  754. (Sets up COM5 for a baud rate of 38,400, and enables Alt-Pin Processing.)
  755.  
  756. dmode com5 e alt=off 
  757.  
  758. (Sets COM5 for even parity checking and disables Alt-Pin processing.)
  759.  
  760. dmode com3 odsr=off octs=off 
  761.  
  762. (Disables sensing of output flow control signals Clear To Send (CTS)
  763.  and Data Set Ready (DSR). )
  764.  
  765.  
  766. ===========
  767.  
  768. Appendix A
  769.  
  770. Synchronous Communications Modes
  771.  
  772. The DigiCHANNEL C/X host adapter communicates with attached C/CON-16
  773. concentrators via two RS-422 synchronous channels (newer concentrators and
  774. host adapters also support RS-232 synchronous communication.  See your
  775. hardware Installation Guide).  The default operating mode for these
  776. channels is 1.2 megabaud, 8-wire, internally clocked.  This provides the
  777. fastest possible communication between the host adapter and locally
  778. connected concentrators (in this context, local indicates that concentrators
  779. are connected directly, via a 4 or 8 wire cable, to the host adapter;
  780. remote refers to concentrators that are connected to the host adapter via
  781. data communications devices such as modems or DSUs).  Local concentrators
  782. always communicate with the host adapter in either an eight wire internally
  783. clocked mode or a four wire self-clocked mode (in the four wire modes the
  784. clock is encoded with the data instead of being carried on separate lines as
  785. in the eight wire modes).  Remote concentrators always use an eight wire 
  786. externally clocked mode (the clock signal is provided by the synchronous
  787. modem). The table on the following page shows the modes that are supported by
  788. the XALL.SYS device driver. 
  789.  
  790. =====================
  791.  
  792. The currently available communications modes are as follows:
  793.  
  794.     Mode    Bit Rate        Clocking Mode
  795. _____________________________________________________________________________
  796.  
  797.     00      115K            8-wire internal clock
  798.     
  799.     01      230K            4-wire self-clocked
  800.     02      460K            4-wire self-clocked
  801.  
  802.     03      2400            8-wire internal clock
  803.     04      4800            8-wire internal clock
  804.     05      9600            8-wire internal clock
  805.     06      19.2K           8-wire internal clock
  806.     07      38.4K           8-wire internal clock
  807.     08      57.6K           8-wire internal clock
  808.     09      76.8K           8-wire internal clock
  809.     10      115K            8-wire internal clock
  810.     11      230K            8-wire internal clock
  811.     12      460K            8-wire internal clock
  812.     13      920K            8-wire internal clock
  813.     14      1.2M            8-wire internal clock
  814.  
  815.     15      2400            8-wire external clock 
  816.     16      4800            8-wire external clock 
  817.     17      9600            8-wire external clock 
  818.     18      19.2K           8-wire external clock 
  819.     19      38.4K           8-wire external clock 
  820.     20      57.6K           8-wire external clock 
  821.     21      76.8K           8-wire external clock 
  822.     22      115K            8-wire external clock 
  823.     23      230K            8-wire external clock 
  824.     24      460K            8-wire external clock 
  825.     25      920K            8-wire external clock 
  826.     26      1.2M            8-wire external clock
  827.     
  828.     33      14000           8-wire external clock 
  829.  
  830.     35      2400            8-wire external clock RS-232
  831.     36      4800            8-wire external clock RS-232
  832.     37      9600            8-wire external clock RS-232
  833.     38      14000           8-wire external clock RS-232
  834.     39      19.2K           8-wire external clock RS-232
  835.     40      38.4K           8-wire external clock RS-232
  836.     41      57.6K           8-wire external clock RS-232
  837.     42      64000           8-wire external clock RS-232
  838.     43      76.8K           8-wire external clock RS-232
  839.  
  840.     44-59   Reserved in future EPC Concentrator modes
  841.  
  842.     60      115K            4-wire self-clocked
  843.     61      115K            4-wire self-clocked
  844.     62      230K            4-wire self-clocked
  845.     63      230K            4-wire self-clocked
  846.     64      460K            4-wire self-clocked
  847.     65      460K            4-wire self-clocked
  848.     66      921K            4-wire self-clocked
  849.     67      921K            4-wire self-clocked
  850.     68      1.843M          4-wire self-clocked
  851.     69      1.843M          4-wire self-clocked
  852.  
  853.     70      1.843M          8-wire internal clock
  854.     71      2.458M          8-wire internal clock
  855.     72      3.686M          8-wire internal clock
  856.     73      7.373M          8-wire internal clock
  857.     74      10M             8-wire internal clock
  858.     
  859. In 8-wire internal clock mode, each device provides it's own transmit clock
  860. from an internal baud-rate generator at the rated speed.  In 8-wire external
  861. clock mode, the transmit clock must be supplied from a modem or similar
  862. source.  External clock rates are approximates used to set up timeouts
  863. tuning parameters only.  Values need not be exact; the user should select
  864. the speed closest to the actual speed of the modem.     
  865.  
  866. On one line, if any device uses 4-wire mode, all devices on that line must
  867. use the same 4-wire mode.  8-wire modes have no such restrictions, and may
  868. be mixed in any desired combination.
  869.  
  870. Modes 60-74 are only supported by the EPC/X product.
  871.  
  872.  
  873.  
  874.  
  875. Appendix B - EPC/X command line configuration.
  876.  
  877. Specifying an EPC/X command line is similar to specifying a C/X command
  878. line but with more options. These options are a result of the EPC/X's
  879. ability to have up to 3 EBI modules attached to each EPC concentrator. The
  880. driver supports up to a limit of 256 ports total across all EPC/X cards.
  881.  
  882. The default line speed is 1.2M since both C/CON-16 and EPC/CON-16 concentra-
  883. tors may be attached to an EPC/X host adapter card. Only one line speed may
  884. be specified for each EPC/X line and all concentrators on the line will
  885. communicate at that speed. For example, If you are using remote concentrators
  886. via a synchronous modem at 9600 baud, then all concentrators will communicate
  887. at this speed.
  888.  
  889.  
  890. A series of progressively more difficult configuration examples are presented
  891. below to describe the EPC/X configuration command line.
  892.  
  893.  
  894. The card type specifier (/t:_) 'C' indicates an EPC on any bus (ISA, EISA,
  895. MCA). The type specification is followed by information about the number of
  896. concentrators on each line. These examples are the same as examples for C/X
  897. configurations. Note too, that these can be C/X or EPC/X concentrators.
  898.  
  899.  
  900. Example : device=xall.sys /p:328 /m:d0000 /t:c11
  901.           One concentrator on each line at the default speed of 1.2M.
  902.  
  903. Example : device=xall.sys /p:328 /m:d0000 /t:c32
  904.           3 concentrators on line 1 and 2 concentrators on line 2 at the
  905.           default speed of 1.2M.
  906.  
  907. Example : device=xall.sys /p:328 /m:d0000 /t:c02
  908.           No concentrators on line 1 and 2 concentrators on line 2 at the
  909.           default speed of 1.2M.
  910.  
  911.  
  912.  
  913. The next level of complexity is to specifiy a non-default communications
  914. line speed. This is specified by a speed number in parenthesis immediately
  915. following the number of concentrators as specified for each line. Parenthesis,
  916. in general, mark the beginning of a more complex configuration for a given
  917. line. These examples also apply to C/X configurations with the exception of
  918. line speed 74, which is exclusive to the EPC/X.
  919.  
  920.  
  921. Example : device=xall.sys /p:328 /m:d0000 /t:c1(74)0
  922.           1 concentrator on line 1 communicating at 10M (mode 74, Appendix A)
  923.           and no concentrator on line 2.
  924.  
  925. Example : device=xall.sys /p:328 /m:d0000 /t:c2(14)3(19)
  926.           2 concentrators on line 1 communicating at 1.2M (mode 14) and 3
  927.           concentrators on line 2 communicating at 38.4k (mode 19).
  928.           In this case it's redundant to specify mode 14 as this is the
  929.           default mode.
  930.  
  931. Example : device=xall.sys /p:328 /m:d0000 /t:c23(9)
  932.           2 concentrators communicating at 1.2M (default) on line 1 and 3
  933.           concentrators on line 2 communicating at 76.8k (mode 9).
  934.  
  935.  
  936.  
  937.  
  938. The last level of complexity is to specify EBI modules connected to EPC/X
  939. concentrators. To do this, each concentrator (EPC/CON or C/CON) must be
  940. specified with the square bracket characters,'[' and ']' and each EBI module
  941. attached to the concentrator is specified within the bracket pair using their
  942. number of ports. Multiple EBI modules are seperated by a semi-colon. Both
  943. concentrator and EBI modules must be specified in the order they are attached
  944. to the EPC/CON. Place holders ( empty brackets, "[]") must be used to specify
  945. concentrators with no EBI modules if concentrators further downline have EBI
  946. modules attached to them.
  947.  
  948.  
  949. Example : device=xall.sys /p:328 /m:d0000 /t:c1([16])0
  950.  
  951.           /t:c1([16])0
  952.               ||||   \- No concentrators on line 2.
  953.               |||\----- Denotes one 16 port EBI on the concetrator.
  954.               ||\------ Denotes 1st and only concentrator.
  955.               |\------- Denotes start of expanded configuration on line 1.
  956.               \-------- Denotes one concentrator on line 1.
  957.  
  958. Example : device=xall.sys /p:328 /m:d0000 /t:c2([16])0
  959.  
  960.           /t:c2([16])0
  961.               ||||   \- No concentrators on line 2.
  962.               |||\----- Denotes one 16 port EBI on concetrator #1.
  963.               ||\------ Denotes 1st concentrator.
  964.               |\------- Denotes start of expanded configuration on line 1.
  965.               \-------- Denotes two concentrators on line 1.
  966.  
  967.  
  968.           Note that the 2nd concentrator was not specified since no EBI
  969.           modules are attached to it and it's the last concentrator on the
  970.           line.
  971.  
  972.  
  973. Example : device=xall.sys /p:328 /m:d0000 /t:c2([][16])0
  974.  
  975.           /t:c2([][16])0
  976.               ||| ||   \- No concentrators on line 2.
  977.               ||| |\----- Denotes one 16 port EBI on the 2nd concetrator.
  978.               ||| \------ Denotes 2nd concentrator.
  979.               ||\-------- Denotes 1st concentrator with no EBI modules.
  980.               |\--------- Denotes start of expanded configuration on line 1.
  981.               \---------- Denotes two concentrators on line 1.
  982.  
  983.  
  984.           Note that the first concentrator was specified with a place holder,
  985.           "[]", since a concentrator followed it with an attached EBI module.
  986.  
  987.  
  988. Example : device=xall.sys /p:328 /m:d0000 /t:c2([8][9;16])0
  989.  
  990.           /t:c2([8][9;16])0
  991.               |||| ||||   \- No concentrators on line 2.
  992.               |||| |||\----- Denotes 2nd EBI module, a 16em.
  993.               |||| ||\------ Semi-colon seperates EBI modules.
  994.               |||| |\------- Denotes 1st EBI module, an 8emp (8 + parallel)
  995.               |||| \-------- Denotes 2nd concetrator.
  996.               |||\---------- Denotes 8em on 1st concentrator.
  997.               ||\----------- Denotes 1st concentrator.
  998.               |\------------ Denotes start of expanded configuration on line 1.
  999.               \------------- Denotes two concentrators on line 1.
  1000.  
  1001.  
  1002. Example : device=xall.sys /p:328 /m:d0000 /t:c2(74[8][9;16])3(12([][][16;16;8])
  1003.  
  1004.           /t:c2(74[8][9;16])3(12[][][16;16;8])
  1005.               ||| || ||||   ||| | | ||  |  \- 3rd 8em EBI module on conc #3.
  1006.               ||| || ||||   ||| | | ||  \---- 2nd 16em EBI module on conc #3.
  1007.               ||| || ||||   ||| | | |\------- 1st 16em EBI module on conc #3.
  1008.               ||| || ||||   ||| | | \-------- 3rd concentrator.
  1009.               ||| || ||||   ||| | \---------- 2nd concentrator, No EBI's.
  1010.               ||| || ||||   ||| \------------ 1st concentrator, No EBI's.
  1011.               ||| || ||||   ||\-------------- 460K speed on line #2.
  1012.               ||| || ||||   |\--------------- Line #2 expanded configuration.
  1013.               ||| || ||||   \---------------- 3 concentrators on line 2.
  1014.               ||| || |||\-------------------- 2nd 16em EBI module on conc #2.
  1015.               ||| || ||\--------------------- Semi-colon seperates EBI modules.
  1016.               ||| || |\---------------------- 1st 8emp EBI module on conc #2.
  1017.               ||| || \----------------------- 2nd concentrator.
  1018.               ||| |\------------------------- 8em EBI module on conc #1.
  1019.               ||| \-------------------------- 1st concentrator.
  1020.               ||\---------------------------- 10M speed on line #1
  1021.               |\----------------------------- Line #1 expanded configuration.
  1022.               \------------------------------ 2 concentrators on line #1.
  1023.  
  1024.