Installation Guide
Reference Manual for
Universal QNX4 Device Driver
for DigiCHANNEL Intellegent Communications Boards

92000127A

Introduction
Dq.ser is a device driver that runs under the QNX4 "Dev" process, 
providing the hardware-dependent component for DigiBoard intelligent 
serial boards (DigiCHANNEL PC/Xi, PC/Xe, PC/Xem, PC/Xr, 
COM/Xi and MC/Xi boards) and cluster controller systems 
(DigiCHANNEL C/X System).

Once the Dq.ser driver has initialized the hardware and registered 
itself with Dev, new serial device nodes will appear in the /dev 
directory.  Dq.ser thereafter takes care of having these devices 
emulate standard serial communications hardware.  When the nature of 
the I/O requests permits it, Dq.ser will take full advantage of the on-
board buffering and intelligence of the DigiCHANNEL hardware.  
Advantages include efficient, flow-controlled transmission of large 
blocks of data; buffered inputs rendering data loss extremely unlikely; 
and almost no interrupt-time processing that could interfere with other 
Real Time Critical processes.

Installation

Dq.ser is a command line invoked device driver, so installation 
consists of little more than copying the files into a directory on the hard 
disk drive.

To copy the files, perform the following steps:

Step 1. Log in as super user (root).

Step 2.	Place the DigiBoard device driver diskette in Drive A 
	(/dev/fd0) or Drive B (/dev/fd1).

Step 3.	Type install (and press ).

The install program will extract all of the files from the DigiBoard 
diskette and place them in the default DigiBoard directory 
/etc/digi.  

The files in /etc/digi are loaded when Dq.ser is invoked from the 
command line.  Only those files that are appropriate to the specified 
command line options are loaded, thus minimizing the amount of system 
memory required to support the device driver.


The minimum requirements to run Dq.ser are:

*	All distribution files must be in the default DigiBoard directory.
*	Since devices will be mounted in /dev, Dev must have enough 
	space reserved for all the expected devices (see the section on Dev 
	in the QNX4 Administrator's guide).  For example, if 32 serial 
	ports are expected, the line in the sysinit file might be:
		Dev -n 50 &
	to have Dev reserve space for up to 50 nodes in /dev.
*	Settings for I/O port addresses, shared memory address and 
	concentrator daisy chaining configuration must be specified for each 
	card.


Invoking the Device Driver

Dq.ser is invoked from the command line (or from sysinit); all 
DigiCHANNEL boards to be supported by the driver must be 
described in the command line arguments.  After initialization, which will 
take a few seconds, the device names will appear in /dev and are 
ready for use.  See the QNX4 Administrator's Guide for information on 
enabling ports for logins.

Command Line Arguments

The standard QNX4 usage utility use will give a brief overview of the 
command line options.  The syntax of the command line is:

	Dq.ser port, mem [,cfg] [port, mem [,cfg] ...] [options] 

port and mem are mandatory fields which identify the I/O port address 
and shared memory addresses of the boards.  cfg is required to identify 
a board as a COM/Xi, PC/Xem, PC/Xm or C/X system).  If cfg is 
absent, the board is assumed to be a PC/Xe or PC/Xi (ISA and EISA 
systems) or an MC/Xi (Micro Channel systems).  The format for port, 
mem and cfg is as follows:


port	Hexadecimal I/O port address of DigiCHANNEL intelligent 
	board.  All boards must have a unique I/O port address, and 
	that address must not be used by any other device in the 
	system.
mem	Hexadecimal starting address for shared memory.  All boards 
	except COM/Xi and Micro Channel boards may share the 
	same memory addresses.  The designated shared memory must 
	not be used by any other device in the system.
cfg		Identifies DigiCHANNEL board type or number of 
	concentrators on a C/X system.  If this parameter is absent, 
	board is assumed to be a PC/Xe or PC/Xi (on ISA or EISA 
	platforms) or an MC/Xi (on Micro Channel platforms).  Values 
	for cfg are:
		p		Specifies PC/Xem or PC/Xm system.
		c		Specifies COM/Xi board.
		0 .. 8	Specifies C/X system and indicates the number of 
	concentrators attached to each RS-422 port on the 
	host adapter (e.g. 31 means 3 concentrators on line 1 
	and 1 concentrator on line 2; 40 means 4 concentrators 
	on line 1 and no concentrators on line 2).

The options field allows you to change some of the default configuration 
settings:

-b baud rate	Set initial baud rate for all ports.  Default: 9600 bps.
-n name		Prefix for port names.  Default: dty
-d data path	Location of driver data files.  Default: /etc/digi
-v		Verbose.  Full banner including copyright, board names 
		and settings will be output upon initialization of the 
		driver.  Default: non-verbose (silent).


-a		Select ALTPIN configuration for all channels.  
		ALTPIN switches the Data Set Ready (DSR) and Data 
		Carrier Detect (DCD) signals so that DCD is available 
		on pin 1 of 8-pin RJ-45 connectors (normally a 10-pin 
		RJ-45 connector is required to support DCD).  Default: 
		ALTPIN not selected.
 
Multiple options must be separated by a space, and 
each option must begin with a dash (-);  thus, to 
select ALTPIN and Verbose, use -a -v, not -av.


Command Line Examples

Dq.ser 300,d0000
Board at I/O port 0x300, shared memory starting at 0x000D0000.  
If installed in an ISA system, a PC/Xe or PC/Xi board is expected.  
If installed in a Micro Channel system, an MC/Xi board is 
expected.  All other settings are left at default values.  Devices will 
be named /dev/dty1, /dev/dty2, etc.

Dq.ser 324,d0000,p -b 1200
PC/Xem (or PC/Xm) board at I/O port 0x324, shared memory 
starting at 0x000D0000.  Set initial baud rate for all ports to 1200 
baud.

Dq.ser 328,d8000,21 -n digi
C/X host adapter at I/O port 0x328, shared memory starting at 
0x000D8000.  Two concentrators on line 1 and one concentrator 
on line 2.  Devices will be named /dev/digi1, /dev/digi2, 
etc.


Error Messages

Failed to RESET the I/O PORT
I/O port address may be set incorrectly or conflict with another board.  
Verify setting, or try another address.

Failed to load data from disk
Failed to STAT BIOS file
Failed to allocate local space for BIOS file
Failed to read from BIOS file
Failed to find DIGIPATH directory

Improper installation.  Driver and/or data files not found in expected 
directory.  Default DIGIPATH directory is /etc/digi.  All files must 
be loaded from the distribution diskette to this directory.  If a different 
directory is used, it must be specified with the -d option in the Dq.ser 
command line.

Failed to allocate CardBase Memory Selector

System call to map physical memory has failed.  Too many processes in 
the system may be competing for memory handles.  The QNX kernel 
may need to be reconfigured to permit more memory selectors.

Failed to BOOT the BIOS

BIOS on DigiBoard will not respond to commands from the driver.  
Usually means that the driver cannot reliably read/write to the dual 
ported RAM.  This could be due to a cache conflict (if the board is 
addressed above 1 meg) or a conflict with another device's memory.  It 
could also mean that the wrong address was given in the Dq.ser 
command line.

Failed to BOOT the uploaded FEPOS

Card type specification may be incorrect.  Could also indicate an 
incorrect memory address specification or a dual ported memory 
conflict.

Failed to read Initialization Information

Shared memory conflict.  Try a different address.

Failed to set up Event Queue

System resource exausted.