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:
- 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.
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.
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 board's 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.
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.
- Example 1
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 2
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 3
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 4
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 5
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 6
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 7
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 8
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
(Note that for MC C/X and MC/Xem, the addresses 104 and 108 should not be used to avoid possible conflicts)