Introduction
This software installation guide is designed to help users successfully install the Titan and Extreme/104 Express serial adapters under the QNX6 platform. Before beginning the software installation, please be sure to read the product manual for hardware installation/configuration instructions. To make the instructions easy to follow, all commands that have to be issued on the command line are written in bold text. These adapters are Plug and Play devices, but before inserting into your system please make sure that the desired jumper settings are correct.
NOTE: You must be logged in as root to perform this installation.
Installing the Driver
Go to the root directory by issuing the command:
# cd /
NOTE: Be sure to be in the / (root) directory
To extract the tar archive from the driver diskette, you need to mount the floppy driver in DOS format, and then untar the file:
# mkdir /floppy
# mount -t dos /dev/fd0 /floppy
# tar -xzvf /floppy/qnx6/BHTNXE-QNX6_XXXX.tar.gz
Where XXXX is the driver version (i.e. 207)
Once you untar the file:
devc-citw, devc-ctiser will be extracted to /sbin,
readme.txt will be extracted to /usr/cti/bh-tn-xe, and
neutctl and ctty are extracted to /usr/bin
Command Line Arguments
The driver can be controlled with the following command line arguments:
# devc-citw &
Start devc-ctiw starting with device /dev/ser1 by default
# devc-ctiw -u 3 &
Start devc-ctiw starting with device /dev/ser3
This is often the best setting as a lot of systems have two built in serial ports and it is best to reserve room for them.
For more command line options, issue the following commands:
# use devc-ctiser
Other command line options:
-b number Define initial baud rate (default 57600)
-c clk[/div] Set the input clock rate and divisor
-C number Size of canonical input buffer (default 256)
-e Set options to “edit” mode
-E Set options to “raw” mode (default)
-I number Size of raw input buffer (default 2048)
-f Enable hardware flow control (default)
-F Disable hardware flow control
-N name Prefix to register (default /dev/ser)
-O number Size of output buffer (default 2048)
-s Enable software flow control
-S Disable software flow control (default)
-t number Enable receive FIFO and set receive FIFO trigger level
-T number Enable transmit FIFO and set transmit FIFO size
-u unit Set serial unit number (default 1)
RS485 Mode Support
The Titan/cPCI and Xtreme/104 Express QNX6 driver supports all three modes of RS-485, full duplex, half duplex and multi-drop.
The multi-drop mode requires the ctty command to be used to enable the automatic RS-485 buffer which will tri-state the RS-485 transmitters during the time when the transmitter is idle. Be sure that the port you will use in multi-drop mode is jumpered correctly (i.e. configured for RS-485 , and duplex control, and not configured for RS-232). Note that hardware flow control needs to be disabled for this mode.
The half duplex mode requires the ctty command to be used to enable the automatic RS-485 buffer which will tri-state the RS-485 transmitters during the time when the transmitter is idle. Be sure that the port you will use in half duplex mode is jumpered correctly (i.e. configured for RS-485 , and duplex control, and not configured for RS-232). Note that hardware flow control needs to be disabled for this mode.
The full duplex mode (the default mode at power up) requires no special software or hardware configuration. Ensure that there the port you will use in full duplex mode has the RS-485 mode select jumpered, and that there is no jumper in the duplex control positions for the port.
To enable automatic RS-485 buffer, issue the following command:
# ctty +auto485 < /dev/serX
This is used for half duplex and multi-drop modes.
To disable automatic RS-485 buffer, issue the following command:
# ctty -auto485 < /dev/serX
This is used for full duplex mode.
NOTE: X in serX stands for the port number on the Titan or Xtreme/104 Express
NEUTCTL Utility
Currently Neutrino’s stty command (see “use stty”) is not capable of displaying the state of a serial ports modem signals. To display these, as well as change the state of any of the modem outputs, Connect Tech provides the NEUTCTL utility.
# neutctl < /dev/ser3
This will display the current state of modem signals available for the com port labelled ser3
# neutctl -RTS < /dev/ser3
This will lower the RTS signal on the com port labelled ser3 (provided it is raised.)
Testing the Newly Installed Ports
You can perform a simple loopback test with a terminal program (i.e. qtalk) and a loopback connector to ensure that the newly installed ports are functioning. Be sure to check the jumper settings on the Titan are appropriate to your setup. Default line mode for all ports is RS485 Full Duplex.
Connect the loopback connector to the port you want to test and run qtalk. When you type a character, you should see it on the screen, which means that the port is working. If you remove the loopback connector, the characters that you type should not appear on the screen.
Assuming that you want to test ser1 with qtalk, run:
qtalk -m /dev/ser1