, and the system
will display:
Extracting files...
5. You will see the following screen:
Copyright (c) 1988-93 DigiBoard Inc. All Rights Reserved
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the Government
is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the
Rights in Technical Data and Computer Software clause at DFARS 252.227-
7013. Digi International Inc. d/b/a DigiBoard, 6400 Flying Cloud Dr., Eden
Prairie, MN 55344.
This script installs the DigiBoard EPC/X, CX, and Xem driver for:
SCO XENIX System V Release 2.3
By default, the ports are installed with the basename "tty".
DigiPrint ports are installed with the basename "pr".
Is this acceptable (y or n)?
If you answer "no" to the question, you will be prompted for new base names.
6. The system displays:
The port names (in the /dev directory) will look like: /dev/ttya01
where `tty' is the basename you picked above, `a' is an ID letter
that can be different for each port box, and `01' is the port number.
You can have the install script pick ID letters for you, assigning
letters consecutively (a,b,c,d,...) and starting over from the
beginning when it runs out of letters; or you can choose them manually.
Manual ID selection is recommended for larger systems, where it can be
used to help keep port names more organized.
Do you want ID letters picked for you (y/n)?
If you answer "y", ID letters will be automatically picked. If you answer "n",
you will be asked (later in the procedure) to specify an ID letter for each
PORTS module.
7. Now the system will ask: How many boards do you wish to install (1-4)?
Enter the number of boards you have installed in your computer.
Steps 8-12 will be repeated for each EPC/X, C/X, or Xem host adapter installed
8. You will see the display:
Configuring board 1.
Boards supported:
ISA Boards (PC/AT Compatible Bus)
1) PC/Xem (or PC/Xm)
2) ISA C/X Host Adapter
3) ISA EPC/X Host Adapter
EISA Boards
4) EISA/Xem (or EISA/Xm)
5) EISA C/X Host Adapter
6) EISA EPC/X Host Adapter
MC Boards (IBM PS/2 Micro Channel Bus)
7) MC/Xem (or MC/Xm)
8) MC C/X Host Adapter
9) MC EPC/X Host Adapter
What type is board 1?
Choose the applicable board type.
9. (ISA boards only_EISA boards go Step 10; Micro Channel boards go Step 11)
You will be asked to specify the I/O port for the board being configured.
Configuring board 1.
Board type is ISA EPC/X Host Adapter.
Selecting the I/O port:
The I/O port choice must match the setting of the dip switches on the
board, and must not conflict with other devices in the system.
The I/O port address choices, in hexadecimal, are:
108 208 308
118 228 328
128
Please enter selection (108-328):
Select the address that corresponds to the setting of the boards DIP switches.
10. (EISA and ISA boards only; Micro Channel boards skip to Step 11.)
Next, you need to specify a starting address for the dual-ported memory on
your board. If you are installing multiple boards, the same address may be
used for all boards that are supported by this driver.
You will see the screen:
Configuring board 1.
Board type is PC/Xem.
I/O port is 104.
Selecting the memory address:
The memory address choice must not conflict with other devices in the
system. Problems with the memory address selection should be checked
for if your system fails to find "board memory" or your system locks up.
The memory address choices, in hexadecimal, are:
*80) 0x00080000 *A0) 0x000A0000 C0) 0x000C0000 E0) 0x000E0000
*88) 0x00088000 *A8) 0x000A8000 C8) 0x000C8000 E8) 0x000E8000
*90) 0x00090000 *B0) 0x000B0000 D0) 0x000D0000 F0) 0x000F0000
*98) 0x00098000 *B8) 0x000B8000 D8) 0x000D8000 F8) 0x000F8000
*NOTE: selections 80-98 usually conflict with system memory.
selections A0-B8 usually conflict with video boards.
Please enter selection code (80-F8):
Enter the two-digit code to the left of the address you wish to use.
EISA Boards (see previous page for ISA Boards):
Next, you need to specify a starting address for the dual-ported memory on
your board. If you are installing multiple boards, the same address may be
used for all boards that are supported by this driver.
You will see the screen:
Configuring board 1.
Board type is EISA EPC/X Host Adapter.
Selecting the memory address:
The memory address choice must not conflict with other devices in the system.
The memory address choices, in hexadecimal, are:
*80) 0x00080000 *A0) 0x000A0000 C0) 0x000C0000 E0) 0x000E0000
*88) 0x00088000 *A8) 0x000A8000 C8) 0x000C8000 E8) 0x000E8000
*90) 0x00090000 *B0) 0x000B0000 D0) 0x000D0000 F0) 0x000F0000
*98) 0x00098000 *B8) 0x000B8000 D8) 0x000D8000 F8) 0x000F8000
*NOTE: selections 80-98 usually conflict with system memory.
selections A0-B8 usually conflict with video boards.
F000) 0xF0000000 F400) 0xF4000000 F800) 0xF8000000 FC00) 0xFC000000
F100) 0xF1000000 F500) 0xF5000000 F900) 0xF9000000 FD00) 0xFD000000
F200) 0xF2000000 F600) 0xF6000000 FA00) 0xFA000000 FE00) 0xFE000000
F300) 0xF3000000 F700) 0xF7000000 FB00) 0xFB000000 FF00) 0xFF000000
Please enter selection code (80-F8 or F000-FF00):
Enter the two or four digit code to the left of the address you wish to use
(the four digit codes yield addresses in the fourth gigabyte). The address
must be the one you specified when you ran the EISA configuration program.
11. This step is different depending upon whether you are installing Xem or
(EP)C/X boards. Follow the appropriate procedure for your board.
Xem_for C/X and EPC/X, see below.
If you are installing an Xem host adapter, you will now be asked for the
number of PORTS modules to be connected to the board:
Configuring board 2.
Board type is PC/Xem.
I/O port is 104.
Memory Addr. is 0x000D0000.
PORTS/16em or PORTS/8em(p) modules: Xem brd can have 1 to 4 modules connected.
How many modules are connected to this board (1 - 4)?
Select the appropriate number for your installation.
If you answered "n" to the question "Do you want ID letters
picked for you?" back in Step 6, you will also be prompted at this time
for the ID letters to be assigned to each of the PORTS modules.
You will also be asked for the number of ports (8, 9 or 16) on each PORTS
module. Answer "8" for PORTS/8em modules, "9" for PORTS/8emp
modules or "16" for PORTS/16em modules. Now proceed to Step 12
C/X, EPC/X host adapters_for Xem host adapters, follow the procedure
on the previous page.
If you are installing a C/X or EPC/X host adapter, you will be asked for
configuration information for the two synchronous lines. You will see:
Configuring board 1.
Board type is ISA EPC/X Host Adapter.
I/O port is 108.
Memory Addr. is 0x000D0000.
Line Configuration:
The sync lines may be configured two ways. The basic method has all
connections wired "8 wire direct" at a speed of either 1228K bps or
10M bps, and can be used for quick set-up for most situations. The
custom method allows you to choose speeds and wiring methods individually.
Do you want to use the basic installation method (y/n)?
Basic Configuration (for Custom Configuration, see 11a. If you are
installing an EPC/X host adapter, you will see the following screen
(if you are installing a C/X host adapter, skip to Step 11b):
Configuring board 1.
Board type is ISA EPC Host Adapter.
I/O port is 108.
Memory Addr. is 0x000D0000.
Basic Configuration:
One of two line speeds must be chosen for the basic configuration
method. The choices are 1228K bps and 10M bps. Running the sync
lines at 1228K bps maintains compatibility with C/CON-16 concentrators.
1) 1228K bps
2) 10M bps
Which speed do you wish to run the sync lines at?
Select 10M bps only if:
*all attached concentrators are EPC/CON-16 concentrators, and
*the cumulative length of all daisy chain cables on either
sync line is 30 feet or less.
See the EPC/CON-16 Installation Guide for more detailed
information about data rates versus cable lengths.
11b.Now you will be asked how many concentrators are attached to each
sync line. For EPC/X host adapters, you will also be asked how many EBI
modules are attached to each concentrator (this refers to PORTS/16em,
PORTS/8em or PORTS/8emp modules connected to the "EBI Out" port of
EPC/CON-16 concentrators), and how many ports (8, 9 or 16) are on each
EBI module (answer "8" for PORTS/8em modules, "9" for PORTS 8emp
modules and "16" for PORTS/16em modules).
EPC/CON-16 and newer C/CON-16 concentrators (which have a plastic case)
must have their node numbers set manually at installation (see the concentrator
Installation Guide for instructions). When asked for the number of
concentrators, enter the node number of the last concentrator in each sync line
(which may be different from the actual number of concentrators). Normally
concentrator node numbers are assigned sequentially, beginning with 1;
Older C/CON-16 concentrators (which have a metal case) are always assigned
node numbers sequentially, beginning with 1. If all of the concentrators on a
sync line are older models, enter the actual number of concentrators (which
will correspond to the node number of the last concentrator in the chain).
Mixed Older and Newer Concentrators
When mixing older and newer concentrators on a sync line, the older con-
centrators must be attached closest to the host adapter, and newer concentra-
tors must be at the end of the chain. In this case, use the node number that
has been set in the last concentrator in the chain (which may be different
from the actual number of concentrators). Now proceed to Step 12.
Custom Configuration
The custom configuration requires you to specify the wiring method and the data
rate for each host adapter synchronous line. The wiring options are:
1) 4-wire direct
2) 8-wire direct
3) 8-wire synchronous modem
4) RS-232 synchronous modem
The supported data rates are:
4-wire direct
1) 230K 2) 460K 3) 921K* 4) 1843K*
8-wire direct
1) 2400 5) 38.4K 9) 230K 13) 1843K* 17)10M*
2) 4800 6) 57.6K 10) 460K 14) 2458K*
3) 9600 7) 76.8K 11) 921K 15) 3686K*
4) 19.2K 8) 115K 12) 1228K 16) 7373K*
8-wire synchronous modem
1) 2400 6) 38.4K 10) 460K
2) 4800 7) 57.6K 11) 921K
3) 9600 8) 76.8K 12) 1228K
4) 14.4K 9) 115K
5) 19.2K 10) 230K
8-wire RS-232 synchronous modem
1) 2400 4) 14.4K 7) 57.6K
2) 4800 5) 19.2K 8) 64.1K
3) 9600 6) 38.4K 9) 76.8K
*Rates with an asterisk are incompatible with C/CON-16 concentrators. These
data rates can only be used if all concentrators on a given sync line are EPC/CON-16 concentrators.
12. You will now be asked to confirm the configuration for the board:
You have selected the following configuration for board 2:
Board Type: PC/Xem. I/O address: 104.
Memory address: 0x000D0000.
Module Port Names
---------------------------
1 ttym01 - ttym16
2 ttyn01 - ttyn09
3 ttyo01 - ttyo08
4 ttyq01 - ttyq16
Is this configuration acceptable (y or n)?
If you installed an EPC/X host adapter, you might see something like this:
You have selected the following configuration for board 1:
ISA EPC Host Adapter. I/O address: 108. Memory Address: 0x000D0000.
Connections Speed Cabling Port Names
---------------------------------------------------------
Line 1
Concentrator 1 10M 8 wire direct ttya01 - ttya16
EBI Module 1 ttyb01 - ttyb08
EBI Module 2 ttyc01 - ttyc09
EBI Module 3 ttyd01 - ttyd16
Is this configuration acceptable (y or n)?
If you accept the configuration, Steps 8-12 will be repeated for each
additional board specified in Step 7. Otherwise, you will be returned
to Step 8 to re-enter the configuration for the current board.
13. Next, you need to select the altpin setting. This allows alternate
wiring of the RJ-45 modular connectors. The default for altpin is OFF,
giving you the standard DigiBoard RJ-45 pinouts.
The software asks:
The default setting for altpin is off. Is this acceptable (y or n)?
Answer y or n as appropriate.
Note that answering "n" here activates the altpin configuration for all ports.
Individual ports can be set with ditty.
14. Installing DigiScreen
DigiScreen is DigiBoard's multiple screen utility that allows a single physical
terminal to be connected to several virtual terminal sessions (screens) at one
time. The software installation script gives you the option of installing it.
The software asks: Do you wish to install DigiScreen (y or n)?
If you answer "n", proceed to Creating New Devices.
15. The software continues:
Each session under DigiScreen requires a DigiScreen device.
How many DigiScreen devices do you wish to have installed?
(max. is 256, default is 32)
16. Finally, the software asks: Do you wish to update /etc/ttytype (y or n)?
For a new installation, answer "y" (yes). For updates, answer "n" to preserve
the current setup. If you are not sure, answer "y".
/etc/ttys will also be updated if you answer "y" above.
Part Two: Creating New Devices
This portion of the install procedure creates devices in /dev, giving XENIX
the information to use the additional ports.
The devices are named according to the following conventions:
Format used for port names:
tty Default base name. You may have defined a different one in Step 5
pr Default base name for DigiPrint transparent printing.
a-z Concentrator or PORTS module letter I.D. Legal letters are a-z; ports
(tty or printer) with modem control identified by a capital letter A- Z.
01-96 Port number on the individual concentrator or PORTS module.
For example, if "tty" is the base name, Port 4 on concentrator or PORTS
module "b" will be ttyb04. The same port with modem control enabled would
be named ttyB04.
Part Three: Installing the New Kernel
The device driver software install is now complete, and the new kernel must
be installed.
1. You will see:
Kernel with driver modifications is in /usr/sys/conf/xenix.
Do you want this kernel to boot by default (y or n)?
If you enter "y", you will see:
The old kernel is installed in /xenix.old
The new kernel is installed in /xenix
Enter the following command to reboot your system and
activate the new kernel: shutdown 0
If you enter "n", you will see:
Changes will not be reflected unless
/usr/sys/conf/xenix is copied to /xenix.
2. The system displays:
1. Install one or more packages
2. Remove one or more packages
3. List the available packages
4. List the files in a package
5. Install a single file
6. Select a new set to customize
7. Display current disk usage
8. Help
Select an option or press q to quit: Enter "q".
3.If you chose to have the new kernel boot by default, enter the following
command to boot the new kernel: shutdown 0
4.When the computer reboots, you should see messages which indicate the board
is functioning. Your screen will look something like this:
device address vector dma comment
------------------------------------------------------------
%epca 0x0204-0x0204 - - mem=0x000D0000
Ports=64
ISA PC/Xem V x.x.x
After multi-user mode has been entered, you will see this message (it may
scroll by too quickly to notice):
DigiBoard software download started.
Part Four: Enabling the New Ports
1. Connect terminals to the ports (using a null modem, if necessary) and
test the connections to each terminal by entering the following command for
each port added: date > /dev/ttya01
(Assuming the terminal is connected to ttya01.)
(Please note that in the above, the "date" command is used as a simple test,
to provide text output that can be redirected; there is no other significance
to "date" in this test.)
*If date appears on the terminal's screen, the device is properly connected.
*If the date does not appear on the terminal's screen, then that terminal is
not receiving data; check the power, cables, connections, etc...
*If nonsense characters are printed on the terminal's screen, check the baud
rates, data bits, stop bits, and parity setting on your terminal (XENIX
default parameters are 9600 baud, 8 data bits, 1 stop bit, and no parity).
2.To activate a port for use with a terminal, enter the following command:
enable ttya01
The above command will cause a login prompt to be sent to the terminal
connected to ttya01. To activate the other ports, repeat the enable command
with the appropriate port name.
Serial Printers
To prepare a port for connection to a printer, enter the following command:
ditty printer [baud rate and flow control options] ttya01
This command forces the specified port to stay open, thus preserving any "non-
sticky" options (see Setting Terminal Options with ditty, beginning on page 28,
for complete descriptions of all ditty parameters) for that port.
This command is recommended for any port that has a printer connected to it.
The command may be placed in /etc/rc.d/8/userdef so that it is
automatically executed whenever the system is booted.
EXAMPLE:
The command shown below results in 9600,8,1,N, with software flow control.
ditty printer ixon opost onlcr ttya01
Un-Installing the SCO XENIX Device Driver
Removing the driver from the kernel is a two-part process. First, the driver
references are removed from the system configuration files. Secondly, a new
kernel is linked, and copied to the root directory.
Enter the following commands to un-install the device driver software:
1. Log onto the console as super-user (root), and enter the command: custom
2. When the operating system menu asks, choose REMOVE.
3. Select epca.
4. Select the DigiBoard driver. The software will respond with:
Removing DigiBoard EPC, CX and Xem intelligent async serial driver.
5. Next, the software asks:
Removing DigiScreen devices will affect ALL DigiBoard Drivers.
Do you wish to remove DigiScreen devices (y or n)?
Answer "y" or "n".
6. The software asks:
Do you wish to remove DigiBoard EPC, CX and Xem entries from /etc/ttytype
(y or n)?
Answer "y" if these entries are no longer needed (or if you are in doubt), or
answer "n" if you wish to preserve the old entries.
7. You will see: Do you want this kernel to boot by default (y or n)?
Answer "y". The system displays:
Do you want the kernel environment rebuilt (y or n)?
Answer "y". You will see:
The kernel has been successfully linked and installed. To activate it, reboot
8. Remove the perms file: rm /etc/perms/epca
9. Enter the following command to boot the new kernel: shutdown 0