INFORMATION RELEASE AB 165
Installing PCI RIO Adapters into a Vision 3269 System
The Vision Series 3269 is a Pentium Pro based system which supports upto 256MB RAM. This means that it will support around 60 users. Far too many to support by using Specialix I/O 8+ adapters.
Therefore systems are being sold with PCI RIO configured.
These configurations will be limited to a maximum of 2 RIO host adapters per system.
Note
Follow ANTI STATIC procedures when handling Printed Circuit Boards.
Install the RIO host adapter(s) into free PCI slots.
As the Vision Series 3269 does not support SCU there is no further hardware configuration required.
Boot the system and log into root.
At the # prompt enter custom (CR)
Insert the SCO driver diskette into the floppy drive, and follow the screen prompts to load it.
As the drive is loaded you will be asked various questions.
Ensure that you specify the right type of system bus - PCI, the current operating system - SCO Open Server, 1 or 2 Adapters as applicable and set them to be "Polled".
Once the load has completed and the operating system rebuilt then reboot the system to load the New Kernel.
Connect any RTAs to the host adapter and then use config.rio to configure them.
At login, on the system console log into root.
At the # prompt enter Config.rio (CR).
The first time Config.rio is used, the screen will display.
Operating system is SCO. Is this correct?
>YES<
NO
Select `YES'
A map of the RIO network will then be displayed, for example:
? : HELP, M: MAIN MENU, ESC : EXIT HOST : HOST O
*The map has a number of important features:
*The map illustrates your host card, RTAs and link cables.
*The first time you access Rioadm, all the RTAs on the map will be flashing. This indicates that they are unconfigured. If your terminal doesn't support flashing characters, an asterisk will be displayed inside the RTA.
*A map is drawn for each host card. Rioadm displays the map for the first host card by default. To change maps, use the `Change Hosts' utility on the Main Menu (see below).
*If an RTA has an `X' in the place of one if its links, this means that the link is connected to an RTA which cannot be configured. You can only configure 16 RTAs per card.
*Single oblong = 8 port RTA
*Double oblong = 16 port RTA
*The map is redrawn automatically to illustrate changes to the network, e.g. new RTAs, link failures or disconnections. This makes Rioadm a powerful fault monitoring tool (see chapter 8: Housekeeping). If the screen gets messed up for some reason, either because it hasn't redrawn correctly or because an error message has been displayed across it, pressing the
key will redraw the screen. *A context-sensitive help line at the foot of the screen. This contains the name of the host card or RTA tht the cursor is positioned on and the commands available to you.
*The help screen, displayed by pressing , describes the features of the map and the commands available to you.
*You can move between the host card and the RTA levels using the up and down arrow keys. You can move between RTAs using the left and right arrow keys.
Config.rio is operated through three menus:
*Main Menu - this controls system - wide configuration. To access the main menu, press
from the map. *Host Configuration Menu - this contains utilities specific to host cards. To access this menu, position the cursor on the host card and press
. These utilities affect only the host card from which the menu is called. *RTA Configuration Menu - this contains the utilities which enable you to configure RTAs. To access this menu, position the cursor on an RTA and press
. These utilities affect only the RTA from which the menu is called.
To exit Rioadm, press
3 RTA CONFIGURATION
New RTAs must be assigned an ID name and a block of eight tty numbers. Devices will be created for the RTA using selected tty numbers.
Note:
RIO devices automatically adopt the default terminal type and xprint settings. You can change the defaults to suit your requirements before you configure your RTAs. This way you will have to spend less time reconfiguring individuals ports. See Section 7.5.2.
Position the cursor on an unconfigured RTA and press
RTA Configuration
>View RTA settings<
Configure RTA
Select `Configuration RTA'. The following prompt will appear:
New Name:
?
Enter a name for the RTA (31 characters maximum) and press
TTY Configuration
Use default TTY block (r001-r008)<
Select TTY block
This prompt is asking you to select a block of eight tty numbers for the RTA. You can select the default block for tty numbers or any other unused block of eight for the 512 tty numbers available.
If you want to use the default block, select the first option. If you want to select a different block, select the `Select TTY block' option. A list of the unused blocks will be displayed:
Available ttys
r001 - r008<
r009 - r016
r017 - r024
r025 - r032
r033 - r040
r041 - r048
r049 - r056
r057 - r064
r065 - r072
This list may run to several `pages' depending on the number of unallocated ttys. Use
the left and right arrow keys to move through the list page by page; use the up and down
arrow keys to move entry by entry. Press
When you have selected a block of ttys, you will be returned to the RTA Configuration menu:
RTA Configuration
View RTA settings<
View/ edit TTY
Edit ID name
Notice that the menu has changed. This is the menu for a configured RTA.
6.3 Changing the Default TTY Configuration
RIO devices adopt the following default configuration:
Getty entry:m
TTY type:unknown
Chars/sec:100
The default getty entry is the first in /etc/gettydefs (usually `m'). The getty entry `m' corresponds to the following line settings: 9600 baud, 8 data bits, 1 stop bit, no parity and xon/xoff handshaking. The `TTY type' is the terminal type and the `Chars/sec' is the transparent print (xprint) speed.
Before you configure the RTA, you can change the default settings to match your requirements using config.rio. This will save you having to configure each tty individually later on.
Changing the defaults does not affect RTAs that have already been configured, so you can change the defaults as many times as you like.
If you want to change the tty configuration of all your ports, use the `Change all TTYs to default values' option (see Section 6.3.1).
Select `View/ edit default values' from the config.rio main menu. The default tty configuration will be displayed:
View/ edit default values
>getty entrym<
TTY typeunknown
chars/sec100
Getty Entry
To change the getty entry setting select `getty entry' and press
. A menu of available values will be displayed: labelbaudparitydatahandshake
>3840038400none8in: none out: soft<
1920019200even7in: none out: soft
96009600none7in: none out: soft
48004800none7in: none out: soft
24002400none7in: none out: soft
12001200none7in: none out: soft
300300none7in: none out: soft
console9600even8in: none out: soft
The getty entry values are listed in the `label' column. The other columns describe the configuration that each getty entry represents. The list may continue for several pages. Move through the list line by line with the up and down arrow keys; page by page with the left and right arrow keys.
Note:
RIO supports several useful, non-standard, speeds. Some of these are mapped to infrequently used UNIX/XENIX speeds. Refer to Table 1 for full details.
Highlight the required getty entry and press
. You will be returned to the menu.
Table 1: RIO
Supported Speeds and Speed Mapping
UNIX/XENIXSPECIALIXINTENDED USE
00Drop handshake lines
5057600High-speed communications
7575
110115200High-speed communications
134134
150150
200200
300300
600600
12001200
18002000
24002400
48004800
96009600
19200(EXTA)19200High-speed terminals
38400(EXTB)38400High-speed terminals
Terminal Type
The `TTY Type' option enables you to define the model of terminal connected to your ports. Select `TTY type' and a list of terminal types will be displayed:
TTY types
>1200<
1620
1640
2392
2392an
2392ne
2621
2621k45
This list may extend over several pages. Type the initial letter/number of the terminal type you are looking for, and you will move to the relevant region of the list. Select the required terminal type and press
. If the xprint on/off strings for this terminal are not defined, the following prompt will be displayed: Make new printcap.rio entry?
>Yes<
No
Terminal xprint strings are defined in the file printcap.rio. Press
to create an entry. The following prompt will then be displayed: Enter xprint enable string:
?
You should be able to find the xprint enable string, and the disable string, in the manual supplied with the terminal. These strings may include special characters in the following formats:
^
Control \e or \EEscape
\nNew line
\rCarriage return
\
Octal code \\Backslash
\^Carat
Type in the string and press
. Enter xprint disable string:
?
When you have entered this, you will be returned to the menu.
Transparent Print Speed
The `chars/sec' value is the number of characters sent per second whilst transparent print is enabled. The default value is 100. You can change this to any value in the range 1 to 2000. Select `Chars/sec'; you will be prompted to enter a value.
Chars/sec
?
Type in the required value and press
. You will be returned to the menu. The transparent print system used by RIO is described in detail in Section 6.6.
6.3.1 Change All TTYs to Default Values
If you select this option from the Main Menu, all RIO ttys on your system will be configured to the current default configuration. You can use this utility in conjunction with the `View/ edit default values' utility if you ever need to reconfigure your whole system. This might be the case, for example, if you were installing a new type of terminal across your system.
6.4 RTA Configuration
New RTAs must be assigned an ID name and a block of eight tty numbers. Devices will be created for the RTA using the selected numbers. Position the cursor on an unconfigured RTA, and call the RTA Configuration menu.
RTA Configuration
>View RTA settings<
Configure RTA
Select `Configure RTA'. A box will appear with the prompt:
New Name:
?
Type in an ID name for the RTA (31 chars max). Press
to continue:
TTY Configuration
>Use default TTY block (ttyr001 - ttyr008)<
Select TTY block
This prompt is asking you to select a block of eight tty numbers for the RTA. If you want to select the next free block (the default block), select the first option. If you want to select a different block, select the second option. A list of the available blocks will be displayed:
Available ttys
>ttyr001 - ttyr008<
ttyr009 - ttyr016
ttyr017 - ttyr024
ttyr025 - ttyr032
ttyr033 - ttyr040
ttyr041 - ttyr048
ttyr049 - ttyr056
ttyr057 - ttyr064
ttyr065 - ttyr072
This list may run to several `pages' depending on the number of unallocated ttys (there are 512 tty numbers). Move through the list line by line with the up and down arrow keys; page by page with the left and right arrow keys. Press
to select the block that you want. When you have selected a block of tty numbers, you will be returned to the RTA Configuration menu:
RTA Configuration
>View RTA settings<
View/ edit TTY
Edit ID name
Notice that the menu has changed. This is the menu for a configured RTA. The `View RTA Settings' and `Edit ID name' options are described in Chapter 8 (Housekeeping).
TTY Naming Conventions
Using the tty numbers you select, a local, modem and xprint device is created for each port. These devices are created in /dev and use the following naming conventions:
/dev/ttyr001 - /dev/ttyr512Local devices
/dev/ttyR001 - /dev/ttyR512Modem devices
/dev/ttyr001p - /dev/ttyr512pXprint devices
The modem device only opens the port when DCD is active. When DCD is lost, all processes on the line are killed. The xprint device is enabled automatically when the associated local or modem device is used.
6.5 Setting Up a Login
This section describes how to set up a login connection for a terminal and transparent printer. Run config.rio and position the cursor on a configured RTA. Press
to display the RTA Configuration menu: RTA Configuration
>View RTA settings<
View/ edit TTY
Edit ID name
To configure a port, select the `View/ edit TTY' option. A list of the tty pairs created for the RTA will be displayed:
View/edit TTY
>ttyr001 / ttyR001<
ttyr002 / ttyR002
ttyr003 / ttyR003
ttyr004 / ttyR004
ttyr005 / ttyR005
ttyr006 / ttyR006
ttyr007 / ttyR007
ttyr008 / ttyR008
These tty pairs correspond to ports 1-8 on the RTA. The first tty pair will be highlighted; press
to select it. The configuration of the port will be displayed: ttyr001 / ttyR001
>Enabled ?Both disabled<
Getty entry9600
TTY typewyse60
Chars/sec100
In this example, port 1 (ttyr001/ttyR001) has been selected. This form enables you to select the local or modem device for the port and, if required, change the tty configuration. The `Enabled ?' option will be highlighted; press
.
TTY en/disable
>TTY enabled<
Modem enabled
Both disabled
If you are going to connect a terminal directly to this port, select `TTY enabled'. If you are going to connect a modem to this port, select `Modem enabled'. Whichever tty you select, the associated transparent print device will be enabled as well. If you are going to set up another type of serial connection on the port, leave the setting as `Both disabled'.
Note:
If you want to use hardware handshaking under ISC UNIX, you must select the modem device, even if you are not connecting to a modem. You must also force DCD (see Appendix A: Cable Specifications).
If required, you can change the tty settings while you are here. These fields operate as described in Section 6.3 (Changing the Default TTY Configuration).
An entry for each port is added to the file /etc/print.rio. Each entry includes device name, terminal type, xprint speed and a fourth, optional, field for enabling/disabling IXANY. By default, IXANY is disabled. Each entry is written in the following format:
100 wyse60 ttyr001
To enable IXANY on a port, edit the entry to read:
100 wyse60 ttyr001 IXANY
Any time you edit this file directly, you will have to use the command config.rio -r to effect the changes.
6.6 Transparent Print
RS232 and RS422 serial ports provide full transparent print (xprint) support. The xprint system used by RIO is a terminal priority system. This means that screen output has absolute priority over printer output. No data will be sent to the printer while the terminal is busy. If the terminal becomes idle for more than a tenth of a second, the xprint driver becomes active and starts sending data to the printer port.
Graphics printers may misinterpret some characters output through transparent print. This problem is more likely if the terminal is in 7-bit mode because 8-bit characters will not be printed.
Some terminals suppress the output of certain characters to their printer or AUX ports. Such terminals can prevent essential control characters from reaching the printer, thus generating incorrect printer output. This occurrence is extremely unpredictable because of the large number of potential hardware configurations.
The SCO implementation of the RIO driver has one known problem in that ports do not always configure properly after a reboot.
To overcome this problem edit the file /etc/rc2.d/P20rio and add -0 to the line, /etc/config.rio -b. For example:
/etc/config.rio -b -0
Cable Specs
Use existing RIO cable specifications.