Comtrol QNX 4.xx User Manual

RocketPort® Series
QNX® 4.xx Device Driver
Installation Reference Card
Scope
Use this three Comtrol RocketPort series multiport serial cards
and QNX
Reference Card
device driver.
to configure and install up to
Where:
•B is optional and signifies a beta driver.
####
is the Comtrol device driver part number, 6523.
PAX
means multiple files have been combined into
one file.
.F
means the file has been compressed.
Prerequisites
The following are required to use this device driver:
• QNX level 4.XX operating system
• An ISA- or PCI-based machine
Note: This Reference Card assumes that you are
familiar with the QNX 4.XX operating system.
How to Use the On-Line Help
This device driver provides on-line help that shows how to initialize the device driver. To start the help system, enter the following:
use /Dev##.rckt
Installing RocketPort Systems
Use the following procedure to install and configure RocketPort series systems with the driver.
If necessary, set the I/O address DIP switch on any ISA cards.
Install the cards in the system.
Install the device driver.
Initialize the card.
Note: Refer to the Hardware Reference Card for
hardware installation information or use the Readme file that came with the driver.
If you are installing a RocketPort ISA in an EISA-bus computer, you may need the EISA configuration files. The EISA configuration files are available on the Comtrol ftp site or the diskette that contains the Diagnostics for the RocketPort series.
QNX 4.XX
device
Downloading and Installing Driver Files
The file names are released on the ftp/web site with the following file name format:
B####pax.F
Extracting Files
Use the following steps to extract the QNX driver files:
1. Download the file on to your system.
Note: If you downloaded the driver to a DOS file
2. Copy the
3. Rename the driver, type:
Use one of the following procedures to install the driver directly onto your hard drive or create an installation diskette.
Note: Before you install the driver, you may need to
system, you may need to use the command to read the DOS formatted file.
6523pax.f
mv 6523pax.f 6523.pax.F
increase the size of the Device Manager -n option in the
DEV
controllers you are adding.
file to your root directory (/).
statement in your
Dosfsys
sysinit
file for the
Installing the Driver On the Hard Drive
Use the following procedure to install the driver on your hard drive.
1. Follow Steps 1-3 in the
2. Enter one of the following commands to install and create a
OR
3. Load the driver by following the discussion.
/Comtrol
install -u 6523.pax.F
cat 6523.pax.F | melt | pax -rv
Extracting Files
directory the driver:
Loading the Driver
discussion.
Creating an Installation Diskette
Use the following procedure to create a Comtrol QNX driver diskette:
1. Follow Steps 1-3 in the
2. Place diskette into floppy drive (
3. Enter the following commands:
dinit /dev/fd0 cat 6523.pax.F | vol -ws2 /dev/fd0
4. To install the driver from the floppy drive, type:
install
Extracting Files
/dev/fd0
discussion.
).
Note: By default, the install command looks in the
diskette drive for the driver files.
5. Load the driver using the discussion.
Loading the Driver
Loading the Driver
Before loading the driver, make sure that you have installed the RocketPort ISA or PCI cards. If you are installing an ISA card, it may be necessary to change the I/O address (default is 180) setting. Use the
Reference Card
installation procedures. To load the driver, issue the following command line
from either the command prompt or from the
config/sysinit
sample command lines. If you are installing RocketPort PCI cards, they are
detected before any of the RocketPort ISA cards and you do not need to specify I/O addresses or IRQs for RocketPort PCI cards. The system determines the order of the PCI cards.
Note: If you type '
Where:
command line help.
[path]Dev##.rckt [options] addr[,irq] [addr[,irq]] [addr[,irq]] &
Command Description
[
path
] The path to the Comtrol driver files. Optionally,
Dev##.rckt
[
options
[
addr
(ISA only) [
irq
(ISA only)
] Represents any combination of the parameters
]
]
or the
file. See the
you may either add the directory to your binary path or copy the Comtrol driver files ( to your
Where ## is the specific driver; that is:
* *
listed in Table 2. Represents the I/O base address (hex) of each
RocketPort ISA board you are installing. This is not required for RocketPort PCI boards.
Represents the software interrupt you want to use with the RocketPort ISA board (default is 15).
RocketPort ISA cards cannot share interrupts (IRQs). If you are running in poll mode, you do not need to specify any IRQs.
Once loaded, the driver creates devices for each board in the unless otherwise specified by the where # is 1 through the number of ports on the card.
readme
use Dev##.rckt
Table 1. Commands
/bin
directory.
Dev32.rckt
(QNX 4.23 and higher)
Dev16.rckt
(QNX 4.22 and below)
/dev
file for hardware
Quickstart
is the 32-bit version of the driver
is the 16-bit version of the driver
directory by the name of
' you will get
Hardware
discussion for
/etc/
Dev##.rckt
-N
name option;
rckt#
Load Options
The following is a table of load option parameters.
Table 2. Driver Load Options
Options Description
-p Poll mode (Interrupt default) - 137 Tx polls/sec and 100 Rx polls/sec. If IRQs are specified along with this option, the IRQs are ignored.
-b number Defines initial baud rate (default 9600).
-C number Size of canonical input buffer (default 256).
-d Sets DSR on initially (default).
-D Sets DSR off initially.
-e Sets options to “edit” mode.
-E Sets options to “raw” mode (default).
-f Enables and locks hardware flow control (default).
-F Disables hardware flow control.
-h number Defines high-water mark for system input buffer
-I number Size of raw system input buffer (default 2,048).
-l number Defines low-water mark for system input buffer
-m Disables modem carrier processing (HUP).
-M Enables modem processing (HUP) (default).
-N name Prefix to register (default “rckt”).
-O number Size of system output buffer (default 2,048).
-r Sets RTS on initially (default).
)
-R Sets RTS off initially.
-s Enables output flow control (ohflow) split, CTS
-S Disables output flow control (ohflow). CTS and
-x Enables and locks software flow control.
-X Disables software flow control (default).
flow control (default 3/4 point of input buffer).
flow control (default 1/4 point of input buffer).
only required (default).
DSR required.
Quickstart
The following illustrates some sample installations.
Note: You may receive
message if the QNX Device Manager ( statement does not have a large enough value for the -n option in the number of ports.
• Starts Dev32.rckt with PCI cards only.
,
• Starts Dev32.rckt for one RocketPort ISA card with
• Starts Dev32.rckt for 2 RocketPort ISA cards with
Dev32.rckt &
the base I/O address of 180h using IRQ11. If any PCI boards are installed, they are detected and installed first.
Dev32.rckt 180,11 &
the first using a base I/O address at 180h with IRQ 11, the second with a base I/O address at 100h using IRQ 15, both 1200 baud. If any PCI boards are installed, they are detected and installed.
Dev32.rckt -b 1200 180,11 100,15 &
Error 23 File Table Overflow
Dev)
sysinit
file to accommodate the
• Starts Dev32.rckt for any number of RocketPort PCI cards at 115200 baud.
Dev32.rckt -b 115200 &
Resolving Installation Problems
If installation fails or you are trying to resolve a problem, you should try the following before calling the Comtrol technical support line:
• Check the signals between your peripherals and the interface box to verify that they match (if applicable). See the appropriate information.
• Check to make sure the cables are connected properly.
• Reseat the card in the slot.
• Make sure that the expansion slot screw was replaced after inserting the card.
• Check for possible I/O address conflicts using the following table.
If you have not been able to get the card operating:
1. Turn off your PC and insert the diagnostic diskette.
2. Boot the PC and following the instructions provided by the diagnostic diskette.
Hardware Reference Card
for
Software Sample Code
The QNX system calls: and closing ports, and for the port.
System calls: same calls that you would use for standard ports. There are no special calls needed for the RocketPort, it is treated and manipulated similar to standard ports.
Please refer to your QNX manuals for information about QNX function calls or locate the QNX web page where they have free sample software:
http://www.qnx.com.
read
open, close
tcsetattr
and
write
, works for opening
sets the
also work. These are the
stty
settings
Software & Hardware Buffers
The RocketPort card has a 1,024 byte hardware queue for input data, and a 256 byte hardware queue for output data. This is on a per port basis.
The 1K byte input queue buffer is adequate and works well in most cases. The hardware performs RTS/CTS flow control. The output buffer is smaller and might be a problem for some programs.
An additional software buffer on the output helps ease this problem. (The QNX driver employs a 2K intermediate buffer). Software buffers do have a cost, you pay a penalty of an increase in RAM required by the driver as well as additional overhead required to shuffle data in and out of it. Also, the addition of a software buffer requires polling in order to move data from the software buffer to the hardware buffer. This requires either a dedicated IRQ or a hook into the system timer. (The QNX driver responds to a Transmit Buffer Empty (TBE) interrupt so no polling is required for continuous transmission).
Technical Support
Before you place a technical support call to Comtrol, please make sure that you have the following information.
• Card type
• Connector type
• I/O address selections
• OS type and release
• Driver release number (to verify, enter
• PC make, model, & speed
• List of other devices in the After you have gathered this information, contact
Comtrol using one of the following methods.
Comtrol Headquarters
Phone: (612) 631-7654 FAX: (612) 631-8117 Email: support@comtrol.com Web site: http://www.comtrol.com FTP site: ftp.comtrol.com telnet: www.comtrol.com (or telnet 204.73.219.7)
Comtrol Europe
Phone: +44 (0)1869 323220 FAX: +44 (0)1869 323211 Email: support@comtrol.co.uk Web site: http://www.comtrol.co.uk
PC
with addresses
sin ver
)
Copyrights and Trademarks
First Edition, March 26, 1998 Copyright © 1998 Comtrol Corporation All Rights Reserved
Comtrol Corporation makes no representations or warranties with regard to the contents of this reference card or to the suitability of Comtrol products for any particular purpose.
Comtrol and RocketPort are trademarks of Comtrol Corporation. QNX is a registered trademark of QNX Software Systems, LTD.
Other product and company names mentioned herein may be the trademarks of their respective owners.
6523D
Loading...