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, follow the procedure on the following page. 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 (see page 30). 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