XALL.SYS: Difference between revisions
Created page with "Driver for DigiCHANNEL Intelligent Communications Boards. device=\digi\xall.sys [/n:names] [/b:baud] [/d:dtype] [/f:digipath] [/v:messagepath] /t:card /p:port /m:mem [, /t:c..." |
No edit summary |
||
Line 6: | Line 6: | ||
;Parameters | ;Parameters | ||
/n:names | '''/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 | 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 | ||
Line 16: | Line 16: | ||
/b:baud | '''/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 | 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 | ||
Line 24: | Line 24: | ||
/d:dtype | '''/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. | 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. | ||
Line 31: | Line 31: | ||
/f:digipath | '''/f:digipath''' | ||
Defines an alternative directory path for the driver | Defines an alternative directory path for the driver | ||
Line 41: | Line 41: | ||
'''/v:messagefile''' | |||
Forces the driver to direct all verbose messages | 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. | 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. | ||
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 | '''/v:errmsg''' | ||
Writes banner and other info to file \ERRMSG. | Writes banner and other info to file \ERRMSG. | ||
Line 60: | Line 53: | ||
/a:a | '''/a:a''' | ||
Enable the alternate pin assignment of Data Carrier Detect (DCD) for all ports (see discussion of Alt-Pin processing. | Enable the alternate pin assignment of Data Carrier Detect (DCD) for all ports (see discussion of Alt-Pin processing. | ||
Line 71: | Line 64: | ||
separated by commas. | separated by commas. | ||
/t:card | '''/t:card ''' | ||
Defines the card type to the driver. Legal values for card are: | 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 | 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. | ||
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 | 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. | ||
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:i10 ISA C/X, one local concentrator on line 1 only. | ||
Line 99: | Line 82: | ||
:: /t:e12 EISA C/X, one local concentrator on line 1, and two 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: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, | :: /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:x COM/Xi (4 or 8 channels) | ||
Line 113: | Line 88: | ||
:: /t:p PC/Xem, MC/Xem or EISA Xem | :: /t:p PC/Xem, MC/Xem or EISA Xem | ||
/p:port | '''/p:port''' | ||
Defines the I/O port address for the card. | Defines the I/O port address for the card. | ||
Line 120: | Line 95: | ||
:: /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. | :: /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 | '''/m:mem''' | ||
Dual-ported memory starting address. This is the full 32-bit hexadecimal address of the beginning of the boards dual-ported memory. | Dual-ported memory starting address. This is the full 32-bit hexadecimal address of the beginning of the boards dual-ported memory. | ||
Line 145: | Line 120: | ||
; 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: | ; 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 | device=c:\digi\xall.sys /n:"digi"1 /b:38400 /p:F1F0 /m:FC0000 | ||
(Note that the above must all appear on one line in CONFIG.SYS) | (Note that the above must all appear on one line in CONFIG.SYS) |
Revision as of 16:30, 1 January 2019
Driver for DigiCHANNEL Intelligent Communications Boards.
device=\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 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.
- 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
(Note that the above must all appear on one line in CONFIG.SYS)
- 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
(Note that the above must all appear on one line in CONFIG.SYS)
- 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
(Note that the above must all appear on one line in CONFIG.SYS)
- 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
(Note that the above must all appear on one line in CONFIG.SYS)
- 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
(Note that the above must all appear on one line in CONFIG.SYS)
- 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
(Note that the above must all appear on one line in CONFIG.SYS)
- 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)
(Note that the above must all appear on one line in CONFIG.SYS)
- 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 the above must all appear on one line in CONFIG.SYS)
(Note that for MC C/X and MC/Xem, the addresses 104 and 108 should not be used to avoid possible conflicts)
OS/2 2.x | OS/2 3.0 | OS/2 4.0 | OS/2 4.5x |
---|---|---|---|
No | Yes | Yes | Yes |