XALL.SYS

Driver for DigiCHANNEL Intelligent Communications Boards. device=x:\digi\xall.sys [/n:names] [/b:baud] [/d:dtype] [/f:digipath] [/v:messagepath] /t:card /p:port /m:mem [, /t:card /p:port /m:mem] [, ...]

Parameters
/n:names

Defines the naming convention to be use for the DigiCHANNEL ports. names consists of an optional stem followed by the starting device number. The new stem must be enclosed in double-quotes (""). If the stem is omitted, COM will be used. If the number is omitted, 3 will be assumed. If the /n parameter is not specified, the default name COM3 will be assigned to the first port. /n:"digi"0 	DIGI0, DIGI1, DIGI2, ... DIGIn /n:4		COM4, COM5, COM6, ... COMn /n:"qdev"	QDEV3, QDEV4, QDEV5, ... QDEVn

/b:baud

Sets the default baud rate to be used for all ports. If this parameter is not specified, all ports will be set to the OS/2 default of 1200 baud. Baud rates of up to 38,400 are supported. Use the DMODE.EXE command to set baud rates of individual ports. /b:9600	Initializes all ports to 9600 baud.

/d:dtype

Sets the initial data type (parity, character length and number of stop bits). If this parameter is omitted, the OS/2 default data type of even parity, 7 data bits and 1 stop bit is used. The syntax is [pds], where p is E, O or N; d is 8, 7, 6 or 5; and s is 1 or 2. All three values must be supplied, in the correct order. /d:N81		No parity, 8 data bits, 1 stop bit.

/f:digipath

Defines an alternative directory path for the driver and data files. If this option is present, all files from the distribution diskette must be present in this directory. /f:d:\drvr\digi	All data files are in D:\DRVR\DIGI.

/v:messagefile

Forces the driver to direct all verbose messages to the file named. If /v: is given without a filename, messages will be placed in \XALL.MSG. This flag prevents any information from being displayed on the console; useful in some situations as when the machine is a headless server, where calls to Standard Output will cause problems. Without this flag, all messages will appear on the system console. The message file is overwritten each time the system is started.

/v:errmsg

Writes banner and other info to file \ERRMSG. /v:	Writes banner and other info to file \XALL.MSG.

/a:a

Enable the alternate pin assignment of Data Carrier Detect (DCD) for all ports (see discussion of Alt-Pin processing.

Per-Card Parameters The remaining three parameters are per-card parameters, and are used to inform the driver of the type of board and where it is to be addressed in the hosts I/O and memory buses. These parameters are mandatory, and must be given for each board! The per-card parameters must be given in complete sets, and the sets must be separated by commas.

/t:card

Defines the card type to the driver. Legal values for card are: This parameter must be omitted for PC/Xe, PC/Xi and MC/Xi boards. The designators i, e, and m must be followed by an additional two digits defining the number and arrangement of DigiCHANNEL C/CON-16 or C/CON-16e concentrators on each host adapter channel.
 * i for the ISA C/X,
 * e for the EISA C/X,
 * m for the MC C/X,
 * p for Xem (PC/Xem, MC/Xem or EISA/Xem)
 * x for COM/Xi boards.

If the concentrator(s) are connected to the host adapter via a dial-up or leased line (remote concentrators), each of the two digits must be followed by a parameter, enclosed in parentheses, specifying the synchronous communications mode to be used for that line. See the Appendix for a list of available synchronous communications modes.
 * /t:i10	ISA C/X, one local concentrator on line 1 only.
 * /t:e11	EISA C/X, one local concentrator on each of lines 1 and 2.
 * /t:m21	MC C/X, two local concentrators on line 1 and 1 on line 2.
 * /t:e12	EISA C/X, one local concentrator on line 1, and two on line 2.
 * /t:i22	 ISA C/X, two local concentrators on each of  lines 1 and 2.
 * /t:i2(21)3(27) ISA C/X, two remote concentrators on line 1, and two remote concentrators on line 2. The concentrators on line 1 will use mode #21 (76,800 baud, 8-wire, external clock) to communicate with the host adapter, and the concentrators on line 2 will use mode #27 (614,400 baud, 8-wire, internal clock).
 * /t:x		COM/Xi (4 or 8 channels)
 * /t:p        PC/Xem, MC/Xem or EISA Xem

/p:port

Defines the I/O port address for the card.
 * /p:300 	Board is addressed at I/O port 300h.
 * /p:2005	EISA board (EISA C/X or EISA/Xem host adapter) is in slot 2 (EISA I/O addresses are 4 digits : the slot number, followed by 005). When plugging an ISA board (PC/Xe, ISA C/X host adapter, etc.) into an EISA machine, the /p parameter must contain the 3-digit I/O address as set by the DIP switches on the board, and not the 4-digit address based on the EISA slot number.

/m:mem

Dual-ported memory starting address. This is the full 32-bit hexadecimal address of the beginning of the boards dual-ported memory.
 * /m:d0000	Sets dual-ported memory start address to 0D0000h (in the BIOS expansion area between 640K and 1 megabyte).
 * /m:e80000	Sets start address of E80000h (in the fifteenth megabyte). EISA and ISA boards (except the COM/Xi), may all share the same memory starting address.  COM/Xi and all Micro Channel boards must each have unique memory addresses.

Example
Examples The following examples start out with just the minimum to install a DigiCHANNEL board. After locating an example for your type of board, read the rest of the examples for optional situations that may be appropriate to your application. Default options will be altered by your application program(s) when you configure the application.

COM/Xi One COM/Xi at I/O port 300h, memory start address D8000h; devices to be named COM5 COM6, etc. All data files are in the directory \DIGI: device=c:\digi\xall.sys /n:5 /p:300 /m:d8000 /t:x
 * Example 1

PC/Xe, PC/Xi One PC/Xe (or PC/Xi) at I/O port 220h, memory address D0000h  Ports will be named COM3, COM4, etc. (default names). All data files are in the directory \MISC\DIGI: device=c:\misc\digi\xall.sys /f:\misc\digi /p:220 /m:d0000
 * Example 2

MC/Xi One MC/Xi at I/O port F1F0h, memory address FC0000h. Devices will be named DIGI1, DIGI2, etc. and will have an initial baud rate of 38,400. All data files are in the default directory \DIGI: device=c:\digi\xall.sys /n:"digi"1 /b:38400 /p:F1F0 /m:FC0000
 * Example 3

Two board installation with optional global parameters. Two PC/Xi (or PC/Xe) boards at I/O ports 320h and 300h, with dual-ported memory of both starting at D0000h. Ports will be named COM0, COM1, etc., and will be initialized to 38,400 baud, no parity, 8 data bits and 1 stop bit; messages will be contained in the file MESSAGES.MSG located in the \DIGI directory. All data files are in the default directory \DIGI: device=c:\digi\xall.sys /n:0 /b:38400 /v:\digi\messages.msg /d:N81 /p:320 /m:D0000, /p:300 /m:D0000
 * Example 4

PC/Xem One PC/Xem at I/O port 224h, memory start address C8000h; devices to be named COM3 COM4, etc. All data files are in the default directory \DIGI: device=c:\digi\xall.sys /p:224 /m:C8000 /t:p
 * Example 5

ISA C/X One ISA C/X host adapter at I/O port 228h, memory address D0000h, with one concentrator on line 1 and two on line 2. Devices to be named DCX1, DCX2, etc. and will have an initial baud rate of 38,400. All data files are in the default directory \DIGI: device=c:\digi\xall.sys /n:"dcx"1 /b:38400 /p:228 /m:d0000 /t:i12
 * Example 6

EISA C/X with a remote concentrator via an RS-232 synchronous modem. One EISA C/X host adapter in slot 3, memory address D8000h, with two local concentrators on line 1 and one remote concentrator at 9600 baud and external clocking on line 2. Devices to be named COM5, COM6, etc. and will have an initial baud rate of 19,200. All data files are in the directory \OS2\DIGI: device=c:\os2\digi\xall.sys /n:5 /b:19200 /f:c:\os2\digi /p:3005 /m:d8000 /t:e21(17)
 * Example 7

MC C/X and MC/Xem One MC C/X host adapter at I/O port 228h, memory address D8000h, with one concentrator on line 1 and one concentrator on line 2; one MC/Xem at I/O Port 304h, memory address D0000h. Devices will be named DIGI1, DIGI2, etc. and will have an initial baud rate of 38,400, Alt-Pin enabled, no parity, 8 data bits, and 1 stop bit. All data files are in the default directory \DIGI: device=c:\digi\xall.sys /n:"digi"1 /b:38400 /a:a /d:N81 /p:228 /m:d8000 /t:m11, /p:304 /m:d0000 /t:p
 * Example 8

(Note that for MC C/X and MC/Xem, the addresses 104 and 108 should not be used to avoid possible conflicts)