www.digi.com
  Advanced Search
Product Selector
     
  Technical Support
Drivers

Firmware Upgrades

FAQs

Product Documentation

Cabling

Support Tools

Legacy Products

About Digi Support

Knowledge Base

Online Support Request

FTP Site



Related Links
Inside Out Networks


 
Solutions Partners Support and Training Corporate Info Where to Buy Order Where to Buy Site Map Contact Us
Home > Support >kbase >
Installing AccelePort Xem, EPC/X, C/X adapters in Xenix (legacy)
Installing AccelePort Xem, EPC/X, C/X adapters in Xenix (legacy) Installing AccelePort Xem, EPC/X, C/X adapters in Xenix (legacy)

Installation Guide for DigiBoard EPC/X, C/X, and Xem Systems
SCO XENIX System V Rel. 2.3
DBI 92000157A

Software Installation
Part One: Linking a New Kernel
1. Log onto the console as super user (root).
2. Insert the DigiWARE diskette and enter: custom
3. The system will now display the Custom menu. If the device driver has been previously installed, the Custom menu lists DigiWARE. Select this. If not, select Option 4 to add a supported product.

The system will display:

Installing custom data files...
Insert distribution volume 1 and press or enter q to quit: 4. Press and the system will display:
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:

Select Option 1 to install the DigiWARE software. The system will display:

Name  Inst  Size  DigiWARE for EPC, CX and Xem System packages 
----------------------------------------------------------------- 
EPCA  NO    992   DigiBoard ISA EPC, CX and Xem async driver V5.x.x 
 
Enter the package(s) to install or enter q to return to the menu: epca
The system will then display:

Insert DigiWARE package volume 1 and press or q to return to the menu:

Volume 1 should still be in the diskette drive.

Press , 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

 

solutions | partner programs | corporate info | support and training | where to buy
site map | contact us | press releases |
events | promotions | advertising

Copyright © 1996-2001 Digi International. All rights reserved.