Ö· Ö· Ò Ö· ·Ö Ö· Ö· Ö· ÖÒ· Ö· Ö· Ƕ º º / Ƕ ºº Ƕ ºº Ó· º Ƕ ǽ ½Ó Ó½ ÓÄ ½Ó Ó/ ½Ó ½Ó Ó½ Ð ½Ó ½Ó ·Ö ÖÄ Ö· Ò ·Ö Ó· Ç ºº º Ó· ½Ó ÓÄ ½Ó Ð ½Ó ACL/Avanstar Device Driver Version 2.1X for SCO XENIX System V (Ver. 2.2 & 2.3) Software Installation Guide Part Number: 650018-07 CONTENTS INTRODUCTION 2 I. How to Install and Use the ACL/Avanstar Package 3 BEFORE YOU INSTALL THE SOFTWARE A. Choose values for ACL/Avanstar parameters 3 B. Check for the Link Kit and install it if necessary 9 C. Make a backup copy of the ACL/Avanstar diskette 10 HOW TO INSTALL THE SOFTWARE D. Load the package 11 E. Enter the parameters for the software driver 12 F. Reboot the system 17 HOW TO SET UP PORTS FOR G. Serial device names and ACL II/II+ port setup 19 H. Log-in terminals, modems, line printers 20 I. Transparent print function 23 II. How to Modify the ACL/Avanstar Configuration 25 III. How to Remove the ACL/Avanstar Package 33 IV. Troubleshooting 35 APPENDICES I. Replacing Pre-Custom Drivers 42 II. Replacing the ACX/32 Driver 43 III. Changing ACL II/II+ ports to DCE or DTE 45 IV. How to Use Extended Baud Rates. 46 V. How to Change the Input Buffer Trigger Rate 48 VI. Changing Configurable External Panel's Interface Type 50 CUSTOMER ASSISTANCE 52 LICENSE AGREEMENT 53 c 1993 by Star Gate Technologies, Inc. All rights reserved. All brand and product names are trademarks or registered trademarks of their respective companies. Introduction to the ACL/Avanstar Family XENIX Device Driver The ACL/Avanstar Family XENIX System V Device Driver Diskette includes the ACL/Avanstar Family XENIX System V Device Driver and the supporting software for its configuration and use. The driver provides the interface between a 286-, 386- or 486-based ISA-bus, EISA-bus or Micro Channel computer and up to four ACL/Avanstar family boards. The ACL/Avanstar family of serial communication boards from Star Gate Technologies includes the ACL, ACL II,ACL II+, ACL IIR, ACL IIR+, ACL 16, ACL 16+, ACL MC, ACL MC+, Avanstar 100e,Avanstar 100i, and Avanstar 100m. During installation, you link the ACL/Avanstar device driver into the SCO XENIX kernel. Afterward, at power-up, the host PC automatically sets up the interface to the ACL/Avanstar board(s). The driver supports serial ports for terminals, modems, line printers and the transparent print function. It provides either polling or interrupt-driven operation, plus shared interrupts among ACL/Avanstar family boards. It supports DTE/DCE selection through software for ACL II and ACL II+ EIA-232 ports . It also fully supports VP/ix, including 8250 emulation. I. HOW TO INSTALL AND USE THE ACL/AVANSTAR PACKAGE A. How to Choose Values for Hardware and Software Listed below are the ACL/Avanstar driver parameters and some guidelines for choosing values. Record your selections so you can: make sure that your selections do not conflict with that of any other devices installed set up the ISA board hardware to match. Note that EISA and Micro Channel boards do not have any hardware settings; these boards are set up entirely with software. 1. Choose one of the following modes: interrupt operation ____ polled operation ____ General Guidelines: If you have an IRQ that is not used by any other device in the host PC, set up the driver software and the board hardware for interrupt operation. Otherwise, set them up for polled operation. Check your application software for specific guidelines. Multiple Boards: You cannot mix modes. The boards must be either all interrupt driven or all polled. 2. Choose a unique I/O address for each ISA board. (This does not apply to EISA or Micro Channel boards): 200-207 for board ____ 300-307 for board ____ 600-607 for board ____ 700-707 for board ____ The following addresses are also available for the Avanstar 100i: 208-20F for board ____ 308-30F for board ____ 608-60F for board ____ 708-70F for board ____ Guidelines: Each ACL/Avanstar family board must have a unique range- a range not used by any other device in the host PC. The starting address is the address used for configuration. You might use 200 for the first board, 300 for the second board, 600 for the third and 700 for the fourth. Attention ACL Board Owners... If the I/O PAL chip in location U45 (just above the 8-position DIP switch) is numbered ACX/16, 800204-01 or 900204-01, the I/O address choices will be 250, 350, 650 and 750. These I/O addresses apply to ACLs originally sold with the ACX/32 or ACX/16 driver(the SCO XENIX drivers sold by Star Gate before June 1989). 3. Note the dual port size: 8K bytes (some ACL MC+, all ACL MC) ____ 16K bytes (some ACL, ACL II, ACL II+, ACL IIR, ACL IIR+, ACL MC+; all ACL 16, ACL 16+, Avanstar 100i, and Avanstar 100m ____ 32K bytes (all Avanstar 100e) ____ 64K bytes (some ACL, ACL II, ACL II+, ACL IIR, and ACL IIR+) ____ NOTE Each of the 8-port ISA boards (ACL, ACL II, ACL II+, ACL IIR, ACL IIR+) is available with either a 16K or a 64K dual port. You can not change the dual port size of any of these boards because it is set by the hardware. The dual port size of the ACL MC+ board can be changed to either 8K or 16K by the configuration software on the Reference diskette and the Option diskette. 4. Recommendations: We usually recommend a location of D0000 (hex), an area often-though not always-free of conflicts. For other locations, see the Dual Ports section (an Appendix) of your adapter board's User's Guide. Guidelines: The dual port for the ACL II, ACL II+, ACL IIR, ACL IIR+, ACL MC,or Avanstar 100e board may be placed anywhere in the PC's physical address space, but it must not conflict with memory for other adapters. The dual port for the ACL, ACL 16, ACL 16+, ACL MC+, Avanstar 100i, or Avanstar 100m board must be installed within the first megabyte of the host computer's address space. For all boards, the starting address is the address used for configuration, and this starting address must be on certain boundaries (see the chart on the next page). Caution: Cache memory may interfere with the operation of the ACL II(+), ACL IIR(+), ACL MC, or Avanstar 100e board if the dual port memory is mapped beyond the first megabyte of address space. Either disable the cache memory, or locate the dual port between A0000 and F0000 (hex) in the first megabyte, on which cache memory typically does not act. Multiple Boards: The dual ports of ISA and EISA bus boards may occupy different ranges, or they may partly or fully overlap. There is no advantage to assigning different ranges for these boards, and you save address space by mapping all the dual ports to the same space. Each Micro Channel board's dual port must have a different starting address, as Micro Channel boards cannot share address space. Dual port Boundary it Four least significant digits size (K bytes) must be on (hex) of starting address (hex) 8 2000 0000, 2000,4000, 6000, 8000 A000, C000 or E000 16 4000 0000, 4000, 8000 or C000 32 8000 0000, 8000 64 10000 0000 Choose a memory address for the dual port. Board 1______________ Board 2______________ Board 3______________ Board 4______________ 5. If the driver is to be interrupt driven, choose an IRQ for each board installed, or choose a shared IRQ: Board 1 IRQ ____ Board 2 IRQ ____ Board 3 IRQ ____ Board 4 IRQ ____ Guidelines: Generally, each ACL/Avanstar family board may be assigned a unique IRQ, or up to four ACL/Avanstar family boards may share the same IRQ. However, if both EISA boards and ISA boards are installed in the same system, each board must have a unique IRQ, or the driver must be set for polled operation. Also, the IRQs selected for ACL/Avanstar family boards must not be used by any other device in the host PC. The list on the next page shows the IRQs supported by each board. We generally recommend IRQ 5, a setting relatively free of conflicts. Board IRQ choices ACL 3 4 5 6 7 9* ACL II/ACL II+ 3 4 5 9 10 11 12 15 ACL IIR/ACL IIR+ 3 4 5 9 10 11 12 15 ACL 16/ACL 16+ 3 4 5 11 12 15 ACL MC/ACL MC+ 3 4 5 7 9 10 11 12 Avanstar 100e 3 4 5 9 10 11 12 15 Avanstar 100m 3 4 5 7 9 10 11 12 Avanstar 100i 3 4 5 9 10 11 12 15 *Note: Although the ACL board hardware offers IRQ 2, IRQ 2 is translated to IRQ 9 on ISA bus machines. Use the IRQ 2 switch setting on the ACL board hardware, but select IRQ 9 during software installation. 6. Now set up the board using the following guidelines. NOTE EISA and Micro Channel boards do not have any hardware settings. These boards are set up entirely with software. (a) Before installing an ISA board, set up the switches for the I/O address. For any ISA board except the Avanstar 100i, also set the switches for the IRQ (if used) you selected. (b) After installing a Micro Channel board, set it up with the ADF file on the Star Gate-supplied Option diskette and the configuration program on the Reference diskette included with the computer. Select the dual port address and IRQ (if used) for each ACL MC, ACL MC+ and Avanstar 100m in the system. Also, select the dual port sizes for any ACL MC+ boards in the system. (c) After installing an EISA board, set it up with the system configuration utility and the CFG file on the Configuration diskette supplied with the board. Select the dual port address and IRQ (if used) for each Avanstar 100e in the system. For more detailed instructions, see Chapter II of the applicable ACL/Avanstar family board user's guide. CAUTION Before you install the ACL/Avanstar family board(s) or the device driver software, make sure all other users are logged off your computer system. Summarized below are the two hardware (or options software) defaults that must be made consistent with your ACL/Avanstar software selections. Hardware Defaults: Board IRQ I/O address in hex ACL no IRQ 200-207 ACL II/ACL II+ 5 200-207 ACL IIR/ACL IIR+ 5 200-207 ACL 16/ACL 16+ 5 200-203 ACL MC 3 (not applicable) ACL MC+ 3 (not applicable) Avanstar 100e 5 (not applicable) Avanstar 100m 3 (not applicable) Avanstar 100i no IRQ 200-205 Note: In the polled mode, the software driver will ignore any IRQs selected by the hardware switches on ACL family ISA boards. Proceed to Section B of this manual to continue software installation. B. Check for the Link Kit and Install It If Necessary Attention: If you attempt to install this device driver without the Link Kit present in the operating system, you will be asked: Do you wish to install the Link Kit now? (Y or N) If you do not, the installation will abort and you will see: Drivers cannot be installed without the Link Kit The Link Kit must be installed in the XENIX system before the ACL/Avanstar driver can be installed. To check for the Link Kit, follow these steps. How to Check for the Link Kit Package 1. At the system console, boot your XENIX system and log in as root. 2. Type: custom 3. Select: The Operating System 4. Select: List the available packages 5. Check for the line beginning with Link If the second field is Yes, the Link Kit is installed. Go directly to Section C-Make a Copy of the ACL/Avanstar Device Driver Diskette. If the second field is No, the Link Kit is not installed. Use the instructions on the next page to install it. How to Install the Link Kit Package 1. Type: custom 2. From among the options, select: The Operating System 3. When the custom menu appears, select: Install one or more packages 4. Type: LINK 5. Follow the on-screen instructions to complete the installation and then quit custom. C. Make a Backup Copy of the ACL/Avanstar Device Driver Diskette To make a backup copy of the device driver software, follow these steps using the sysadmsh shell. 1. At the system console, boot your XENIX system and log in as root. 2. Type: sysadmsh 3. Select: media 4. Select: duplicate 5. Choose the appropriate low density device. 6. Choose the default blocking factor. 7. Insert the original diskette in the drive. 8. Follow the on-screen instructions to copy the diskette. 9. After making a copy, quit out of the sysadmsh shell. D. How to Load the Package Follow these steps to install the ACL/Avanstar Family XENIX device driver. Attention: Users Replacing Early Versions of the ACL Family Driver If you have an earlier ACL family driver installed, you'll need to start with some extra steps. If your system has an ACL Family XENIX driver Version 1.01 or 1.02, first turn to Chapter III for instructions to remove the package and its custom entry. If your system has a pre-custom version of the ACL family driver installed, see Appendix I for special instructions. If your system has an ACX/32 driver installed, see Appendix II. 1. At the system console, boot the system and log in as root. 2. Type at the root # prompt: custom 3. When the custom menu appears, select: Add a Supported Product 4. The screen prompts: Installing custom data files ... Insert distribution volume 1 and press or enter q to quit: 5. Place the ACL/Avanstar Family XENIX Device Driver disk into the primary drive, and press: 6. Custom displays another menu. Select: Install one or more packages 7. The screen prompts: Enter the package(s) to install or enter q to return to the menu: 8. Type: ACL 9. The screen prompts: Insert ACL/Avanstar for XENIX Driver volume 1 and press or enter q to return to the menu: 10. Make sure the ACL/Avanstar XENIX Device Driver disk is still in the primary drive, and press: E. Enter Parameters for the Software Driver Follow the prompts to enter the values selected in Section A. 11. The screen prompts: Should the driver poll or be interrupted? (i or p) 12. Enter either: i (for interrupt) or p (for poll) If you enter no selection or something other than i or p, you will be reminded of these two acceptable choices. 13. The screen prompts: How many boards will be installed? (1-4) Enter one of the following choices: 1 2 3 4 If you enter no selection or something other than 1, 2, 3 or 4, you will be reminded of these choices. Note: If you later wish to change any software parameters or wish to add or remove board(s), use the /usr/lib/acl/config program described on page 25. If you have a Micro Channel board, go to Step 14b. 14a. Appears for ISA or EISA bus boards only: Adding board X. What board type is this board? 1. ACL 2. ACL II/ACL II+ 3. ACL IIR/ACL IIR+ 4. ACL 16/ACL 16+ 5. Avanstar 100e 6. Avanstar 100i Select one (1 to 6, q to quit). Enter the appropriate choice. 14b. Appears for Micro Channel boards only: Adding board X. What board type is this board? 1. ACL MC 2. ACL MC+ 3. Avanstar 100m Select one (1 to 3, q to quit). Enter the appropriate choice. 15a. Appears for ACL family ISA bus boards only: What I/O address is board 1 to use? (200, 300, 600 or 700) Enter the appropriate choice, making sure your selection matches the hardware setup selected by the switches. Attention ACL Board Users... If the I/O PAL chip in location U45 (just above the 8-position DIP switch) is numbered ACX/16, 800204-01 or 900204-01, enter whichever of these values is selected by the hardware switches: 250 350 650 750 These values are not displayed on the screen. These values apply to ACL boards originally sold with the ACX/32 or ACX/16 driver (SCO XENIX drivers sold before June 1989). If you enter no selection or an unacceptable value, you'll be reminded of the acceptable choices. 15b. Appears for the Avanstar 100i board only: What I/O address is board 1 to use? (200, 208, 300, 308, 600,608, 700, or 708) Enter the appropriate choice, making sure your selection matches the hardware setup delected by the switches. If you enter no selection or an unacceptable value, you will be reminded of the acceptable choices. 16. (You will not be prompted to enter an ACL MC+ board's dual port size (8K or 16K) because it is automatically detected.) Appears for 8-port ACL family ISA bus boards only: What size is the dual port on board 1? (16 or 64) Enter 16 if you have a 16K byte dual port; enter 64 if you have a 64K byte dual port. If you enter no selection or something other than 16 or 64, you will be reminded of these two acceptable choices. 17. Appears for ISA bus boards only: What memory address is board 1 to use? Enter the boundary address chosen in Chapter A. This parameter is not selected by hardware, so you can place it where convenient. If the value is not on the correct boundary, you will be reminded to choose a value on the correct boundary. Example: An address that may be used for a 16K or 64K dual port is D0000. 18. Appears if you had selected interrupt-driven operation: What IRQ is board 1 to use? Enter one of the following choices. Make sure you match the hardware switch setting if the board is an ACL family ISA bus board. (There are no hardware switches for IRQ settings for the Avanstar 100i.) Make sure you match the software configured value if the board is an EISA or Micro Channel bus board. Follow the guidelines in Chapter A. If you enter no selection or something other than these choices, you will be reminded of these acceptable choices. Board IRQ choices ACL 3 4 5 6 7 9* ACL II/ACL II+ 3 4 5 9 10 11 12 15 ACL IIR/ACL IIR+ 3 4 5 9 10 11 12 15 ACL 16/ACL 16+ 3 4 5 11 12 15 ACL MC 3 4 5 7 9 10 11 12 ACL MC+ 3 4 5 7 9 10 11 12 Avanstar 100e 3 4 5 9 10 11 12 15 Avanstar 100m 3 4 5 7 9 10 11 12 Avanstar 100i 3 4 5 9 10 11 12 15 * Although the ACL board hardware offers IRQ 2, IRQ 2 is translated to IRQ 9 on ISA systems. Use the IRQ 2 switch setting on the ACL board hardware , but select IRQ 9 during software installation. 19. The screen will now list the parameters you have entered and prompt: OK to add board 1? (y or n) If you type y, the software will install the board and ask you to repeat Steps 14 through 19 for any additional boards you are adding. If you type n, the software will repeat the entire series of questions for board 1 (Steps 14 through 19). 20. When the screen asks if you want this kernel to boot by default, type: y 21. When the custom menu is displayed again, quit custom by typing: q F. How to Reboot the System 22. Remove the ACL/Avanstar Family XENIX diskette from the disk drive. 23. Reboot the system by typing: reboot 24. When the boot prompt : is displayed, press: Note: If you do not press , the system will autoboot and slightly different screen messages will be displayed than those shown in these steps. Note: You should see messages on the boot screen saying that the ACL/Avanstar Family XENIX driver is present. 25. At the screen prompt, type: d 26. Respond to the XENIX boot prompts, for the correct time and date. 27. Note the download messages, such as. Starting ACL/Avanstar download As the download program is executed for each board, the board and download file name and the result of the download will appear. NOTE The following shows the Control Programs for all the boards: Board Type Control Program Filename ACL ACL.CP ACL II(+) ACL2.CP ACL IIR(+) ACL2R.CP ACL 16(+) ACL16.CP ACL MC ACLMC.CP ACL MC+ ACLMCP.CP Avanstar 100e A100E.CP Avanstar 100m A100M.CP Avanstar 100i A100I.CP 28. A successful download will result in the message: load successful If you later wish to change the software parameters of the board(s) or wish to add or remove board(s), you can easily do so using the menu-driven program described in Section II. 29. Check to make sure a load successful message appears for each board. If all ACL/Avanstar family boards have been successfully loaded, the installation of the driver software is complete. Continue to the next section to set up ports for serial devices. An unsuccessful download will result in an error message, described in Chapter IV-Troubleshooting. G. Device Names for Setting Up Serial Device Ports To use ACL/Avanstar family serial ports for a log-in terminal, modem, line printer or the transparent print function, you must change the system setup. This change requires the use of device names (see the box below). With the ACL II and ACL II+, you can select a DCE or DTE setup for EIA-232 ports via software. You should make a selection before configuring or enabling the ports for use. See Appendix III. How ACL/Avanstar Family Device Names Work The driver installation procedure creates two device names for each port on an ACL/Avanstar family board. The names allow you to set up ports with modem or nonmodem (direct connection for terminals) handshaking. The ACL/Avanstar Family XENIX driver calls the ACL/Avanstar family boards COM5,COM6, COM7 and COM8. The ports are set up in the /dev directory and named: /dev/tty Where: for: board 1 (COM 5) = 5 board 3 (COM 7) = 7 board 2 (COM 6) = 6 board 4 (COM 8) = 8 for: direct connection modem connection port 1 = a port 9 = i port 1 = A port 9 = I port 2 = b port 10 = j port 2 = B port 10 = J port 3 = c port 11 = k port 3 = C port 11 = K port 4 = d port 12 = l port 4 = D port 12 = L port 5 = e port 13 = m port 5 = E port 13 = M port 6 = f port 14 = n port 6 = F port 14 = N port 7 = g port 15 = o port 7 = G port 15 = O port 8 = h port 16 = p port 8 = H port 16 = P Examples: /dev/tty5d board 1, port 4 is direct connection /dev/tty8Fboard 4, port 6 is modem connection /dev/tty6c board 2, port 3 is direct connection H. How to Set Up Serial Ports for a Log-In Terminal, Modem or Line Printer How to Enable (or Disable) a Port for a Log-In Terminal or Dial-In Modem To enable (or disable) a port for these applications, follow these steps: 1. At the system console, boot the system and log in as root. 2. Check the etc/gettydefs file to make sure that the parity, number of bits per character and baud rate for each port correspond to the settings of the device which will be connected. Background: At installation time, entries in /etc/ttys are created for each port. These entries specify the "m" entry in gettydefs. For more information on the gettydefs file, see in the System Administrator's Guide of the SCO XENIX System V Operating System manuals. 3. Invoke the editor and make any modifications necessary to the gettydefs file. 4a. Enable each port you plan to use by typing after the # prompt: enable tty where boards are numbered from 5 to 8, direct connection ports are numbered a through p, and modem connection ports are numbered A through P. Examples: To enable direct connection port 8 on board 1, type: enable tty5h To enable modem connection port 3 on board 2, type: enable tty6C 4b. Or, to disable a port you no longer need, type after the # prompt: disable tty Where boards are numbered from 5 to 8, direct connection ports are numbered a through p, and modem connection ports are numbered A through P. Example: To disable log-in terminal port 4 on board 1, type: disable tty5d 5. The screen will respond with the messages: /etc/ttys updated After a few seconds, the login prompt should appear on the terminal. For more information on Terminal Login Management, see the System Administrator's Guide of the SCO XENIX System V Operating System manuals. How to Use a Port for a Modem For detailed information on using a port for a modem, refer to the System Administrator's Guide of the SCO XENIX System V Operating System manuals. How to Use a Port for a Line Printer Follow these steps to install a printer on an ACL/Avanstar port. 1. Log in as root. 2. Type: mkdev lp 3. From the menu, select: 1 - Add a new printer 4. From the next menu, select: 2. Serial printer. 5. Specify the port device name: tty 6. From the menu, select the appropriate interface program for your printer. For detailed information on using a port for a printer, refer to the System Administrator's Guide of the SCO XENIX System V Operating System manuals. I. How to Configure a Port for Transparent Print Function The transparent print function allows a printer that is attached to a terminal to operate. The printer and terminal data streams are multiplexed in order to travel over the same serial cable. To configure a port for this function, follow these steps: 1. Boot the system and log in as root. 2. At the root # prompt, type: cd /usr/lib/acl 3. Invoke the editor for the file called: ttpinit 4. Locate the line for the board and port used by the terminal and transparent printer by using this key for the numbers after each ttp: First Number: 5 = board 1 6 = board 2 7 = board 3 8 = board 4 Second Number: a = port 1 i = port 9 b = port 2 j = port 10 c = port 3 k = port 11 d = port 4 l = port 12 e = port 5 m = port 13 f = port 6 n = port 14 g = port 7 o = port 15 h = port 8 p = port 16 Example: The line for port 2 on the board 1 is: #/usr/lib/acl/ttp /dev/ttp5b -s 0 -n 0 -f 0 5. Remove the # sign from the beginning of the line you located. 6. Consult the terminal manual for the ON and OFF strings that terminal uses for transparent printer data. Note: ON and OFF strings are one to four characters, with each character separated by a space. Characters are given by the decimal (not hex or octal) value of the ASCII code. 7. Consult the printer manual for the speed of the printer. 8. Replace the three zeros in the segment: -s 0 -n 0 -f 0 Replace the 0 after the: -s with the speed of the printer in characters per second -n with the decimal value of the ASCII code for the ON character (s) which your terminal recognizes as the start of transparent printer data -f with the decimal value of the ASCII code for the OFF character(s) which your terminal recognizes as the end of transparent printer data Example: You plan to plug a terminal which supports transparent print into port 5 of board 2. The printer's speed is 120 characters per second; the terminal's ON string is or X (24 in decimal), and its OFF character is or T (20 in decimal). Edit this line: #/usr/lib/acl/ttp /dev/ttp6e -s 0 -n 0 -f 0 To become: /usr/lib/acl/ttp /dev/ttp6e -s 120 -n 24 -f 20 9. Write in the changes and exit the editor. 10. To utilize the printer(s), type at the prompt: /usr/lib/acl/ttpinit Note: This file will also be executed each time the kernel is booted. II. HOW TO RECONFIGURE THE ACL/Avanstar FAMILY XENIX DEVICE DRIVER SOFTWARE Earlier, you set up software parameters for the boards you installed. If ever you wish to add or remove a board, or enter new values, we provide a menu- and message-driven configuration program to help you change software parameters very easily. The five options on the main menu are: Main Menu Options 1) Switch to interrupt driven operation. (polled mode message) or 1) Switch to polled operation. (interrupt mode message) 2) List parameters for all boards. This option displays the I/O address for ISA boards, the dual port address, dual port size and IRQ (0 if the polled mode is used) for all boards as configured by the software. 3) Add a board. This option allows you to configure the software parameters of one board. It will ask you for the I/O address (if an ISA bus board), the dual port address, dual port size (if an 8-port ACL family ISA bus board) and IRQ line (if interrupt driven) and advise you on choices on all but the dual port address. Note that the board does not have to be physically installed for this option. 4) Modify a board. This option allows you to modify the software parameters of any board you have previously added. It will ask you which parameter to modify-I/O address (if an ISA bus board), dual port address, dual port size (if an 8-port ACL family ISA bus board) or IRQ line (interrupt-driven operation only)-and advise you on choices. 5) Remove a board. This option allows you to remove the software parameters previously specified for one board. Entering Software Values When you enter a value to add or modify a board, the software checks if the value is among a group of acceptable entries. It does not check for conflicting or no longer available values. Nor does it check for the hardware value selected by an ISA board's switches or if the board is physically installed. Follow this procedure to load the configuration program and add boards. Note that the program lets you backtrack, modify or remove boards at any time. How to Run the ACL/Avanstar Configuration Program 1. Log in as root. 2. To run the menu-driven configuration program, type: /usr/lib/acl/config How to List Current Values 3. The main menu will appear, and you can select list parameters for all boards by typing: 2 4. The values for I/O address (for an ISA board), dual port address, dual port size and IRQ will be displayed for each board. Example: Board Type IRQ I/O DP addr DPsize 0 ACL2/2+ 5 200 d0000 64 1 ACL 3 300 d0000 64 How to Add a Board Note: When you add a board, the program will number the new board based on the order in which it was installed. For example, if there are 2 boards and you add a board, the new board will be board 3. 1. At the main menu, select add a board by typing: 3 If you are adding a Micro Channel board, go to Step 2b. 2a. Appears for ISA and EISA bus boards only: Adding board X. What board type is this board? 1. ACL 2. ACL II/ACL II+ 3. ACL IIR/ACL IIR+ 4. ACL 16/ACL 16+ 5. Avanstar 100e 6. Avanstar 100i Select one (1 to 6, q to quit). Enter 1, 2, 3, 4, 5, or 6 making sure your selection matches the type of adapter board you are adding. 2b. Appears for Micro Channel boards only: Adding board X. What board type is this board? 1. ACL MC 2. ACL MC+ 3. Avanstar 100m Select one (1 to 3, q to quit). Enter the appropriate choice. 3a. Appears for ACL family ISA bus boards only: What I/O address is board X to use? (200, 300, 600 or 700) Enter the appropriate choice, making sure your selection matches the hardware setup selected by the switches. Note: For ACL boards equipped with PAL chip numbered ACX/16, 800204-01 or 900204-01 (at U45, just above the 8-position DIP switch), you should enter the value selected by the hardware switches. (These ACL boards were originally sold with the ACX/32 or ACX/16 driver (XENIX drivers sold before June 1989).) The value is one of the following, though these values are not displayed on the screen: 250 350 650 750 If you enter no selection or an unacceptable value, you will be reminded of the acceptable choices. Note: The I/O address of each board installed in your computer must be unique. 3b. Appears for an Avanstar 100i board only: What I/O address is board X to use? (200, 208, 300, 308, 600, 608, 700, or 708) Enter the appropriate choice, making sure your selection matches the hardware setup selected by the switches. If you enter no selection or an unacceptable value, you will be reminded of the acceptable choices. Note: The I/O address of each board installed in your computer must be unique. 4. (You will not be prompted to enter an ACL MC+ board's dual port size (8K or 16K) because it will be automatically detected.) Appears for 8-port ACL family ISA bus boards only: What size is the dual port on board X? (16 or 64) Enter 16 if you have a 16K dual port; 64 if you have a 64K dual port. If you enter no selection or something other than 16 or 64, you will be reminded of these two acceptable choices. 5. Appears for ISA bus boards only: What memory address is board X to use? Enter the starting address of the dual port. This parameter is not selected by hardware, so you may locate it where convenient using the guidelines in Chapter A. 6. Appears if you had earlier selected interrupt-driven operation: What IRQ is board 1 to use? (3-7, 9-12 or 15) Enter one of the following choices, making sure you match the hardware switch setting if the board is an ACL family ISA board. (There are no hardware switches for IRQ settings for the Avanstar 100i.) Make sure you match the software configured value if the board is an EISA or Micro Channel bus board. Board IRQ choices ACL 3 4 5 6 7 9 ACL II/ACL II+ 3 4 5 9 10 11 12 15 ACL IIR/ACL IIR+ 3 4 5 9 10 11 12 15 ACL 16/ACL 16+ 3 4 5 11 12 15 ACL MC/ACL MC+ 3 4 5 7 9 10 11 12 Avanstar 100e 3 4 5 9 10 11 12 15 Avanstar 100m 3 4 5 7 9 10 11 12 Avanstar 100i 3 4 5 9 10 11 12 15 Generally, you may select a unique IRQ for each board, or all the boards may share one IRQ. However, if both EISA boards and ISA boards are installed in the same system, each board must have a unique IRQ, or the driver must be set for polled operation. If you enter no selection or something other than these choices, you will be reminded of these valid choices. 7. The screen will now list the I/O address, dual port memory size, dual port address and IRQ you have entered and prompt: OK to add board X? (y nor n) If you enter y you will be returned to the main menu and the board will be added. If you enter n you will be returned to the main menu without adding the board. 8. If you wish to add one, two or three more boards (up to a total of four), repeat Steps 1 through 7 for each board. Or, if you wish to reconfigure, go to the instructions for modifying a board (below) or removing a board (page 31). When you are satisfied with the software configuration, turn to page 31. Follow the steps to install the new configuration by performing a reboot. How to Modify a Board Note: If you are replacing one type of board with another-for example, replacing an ACL board with an ACL II-first remove the old board (page 31), then add the new board (page 27). 1. When you select 4) modify a board from the main menu, the screen will ask you which board you wish to modify. 2. Respond by giving the number of the board (the number corresponds to the order in which you added the board, starting from 1). 3. You will next be given this list of parameters to select from: 1) I/O address 2) memory address 3) dual port size 4) IRQ line Note: Line 1 appears only for ISA boards. Line 3 only apears for 8-port ACL family ISA boards. Line 4 will not appear if you had earlier selected polled operation. 4. Make your modifications. 5. To complete the modifications and return to the main menu, type: q 6. You will be asked if it is okay to update the board. If the modifications are correct, type: y If the modifications are incorrect, type: n When you are satisfied with the software configuration, follow the steps below to install the new configuration and perform a reboot. How to Remove a Board 1. When you select 5) remove a board from the main menu, the screen will ask you which board do you wish to remove and list the options. 2. Respond by entering the number of the board (the number corresponds to the order in which you added the board, starting from 1). Your response will remove board parameters directly and return you to the main menu. When you remove a board, the program will renumber the remaining boards starting from 1. For example, if there are 3 boards and you remove board 1, board 2 will be renumbered board 1 and board 3 will be renumbered board 2. Installing the new configuration When you are satisfied with your software value selections for every board, follow these steps: 1. Exit the configuration program by typing: q 2. The screen prompts: The ACL/Avanstar parameters file and the kernel configuration have been modified. You must relink, install and reboot the kernel to have the changes take effect. Do you want to relink the kernel? 3. Type: y 4. The screen prompts: Re-linking the kernel... Kernel with driver modifications is in /usr/sys/conf/xenix Do you want this kernel to boot by default? 5. Type: y 6. The screen prompts: The new kernel is installed in /xenix. Reboot your system to activate it. 7. To reboot your system, type after the # prompt: reboot 8. After the boot : prompt, type: 9. When the following prompt appears during the boot sequence: Type d to proceed with normal startup, (or give root password for system maintenance): Type: d 10. Respond to the XENIX boot prompts for the correct time and date. 11. Note the download messages. As the download program is executed for each board, the board and download file name and the result of the download will appear. Starting ACL/Avanstar download 12. A successful download will result in the message load successful An unsuccessful download will result in an error message, described in Chapter IV-Troubleshooting. Messages from the download program are also recorded in the file /usr/lib/acl/acl.log. If all ACL/Avanstar family boards have been successfully loaded, the installation of the modified ACL/Avanstar driver software is complete. III. HOW TO REMOVE THE ACL/AVANSTAR FAMILY DRIVER You can remove the driver completely from the system by following this procedure: 1. At the system console, boot the system and log in as root. 2. When the root # prompt appears, type: custom 3. When the custom menu appears, select: ACL/Avanstar for XENIX 4. When the options menu appears, select: Remove one or more packages 5. Enter the package(s) to remove by typing: ACL The screen will display these and other messages: Removing ACL/Avanstar driver... Updating system configuration... Re-linking the kernel... 6. When the screen prompts: Do you want this kernel to boot by default? (y/n) Type: y 7. When the screen prompts: The new kernel is installed in XENIX. Reboot your system to activate it. Exit custom by typing at the # prompt: q 8. Reboot your system by typing: reboot 9. When the boot : prompt is displayed, press: 10. When the screen prompts: Type d to proceed with normal startup, (or give root password for system maintenance): Exit the maintenance mode and resume the boot process by typing: d 11. Respond to the XENIX boot prompts, for the correct time and date. 12. At the XENIX login prompt, log in as root. 13. The entry for the ACL/Avanstar family device driver will remain in the custom menu although the package will not be installed. To remove the etc/ perms/acl file which supplies the ACL/Avanstar family device driver entry on the custom menu, type after the # prompt: rm /etc/perms/acl IV. WHAT TO DO IF YOU HAVE DIFFICULTY If you encounter a problem, it will likely be due to conflicts in the configuration of the software and/or hardware. This section describes the symptoms, causes and solutions for such problems. Download Problems Symptom: When going to multiuser mode you receive the message: /etc/rc.d/5/acl: /dev/acl: cannot open Cause: The kernel you have booted does not contain the ACL/Avanstar family driver, or the ACL/Avanstar family driver device node (/dev/acl) does not exist. The ACL/Avanstar boards will not be properly initialized, and no communications with any device attached to the ACL/Avanstar board will take place. Solution: Boot the proper kernel or reload the ACL/Avanstar package. Symptom: When going to multiuser mode, you do not receive a message indicating that download is being performed. There should be a message for each ACL/Avanstar board in the system, for example: /usr/lib/acl/load: load /usr/lib/acl/.cp Where is the board number and is the board type. NOTE The following shows the Control Programs for all the boards: Board Type Control Program Filename ACL ACL.CP ACL II(+) ACL2.CP ACL IIR(+) ACL2R.CP ACL 16(+) ACL16.CP ACL MC ACLMC.CP ACL MC+ ACLMCP.CP Avanstar 100e A100E.CP Avanstar 100m A100M.CP Avanstar 100i A100I.CP Cause: Usually this is because the hardware setup for an ISA board does not match the software configuration for one of these reasons: Board is not configured at all. For example, two boards are present but only one is configured. DIP switch settings which select I/O address do not match the value entered at installation time. For example, hardware switches are set for 300 but software is set for 700. You may have an I/O address decode PAL which does not match the value entered. For example, a PAL which recognizes 250, 350, 650, 750, but software is set for 200. Solution: Check the status of the ACL/Avanstar boards by running the ACL/Avanstar status program (/usr/lib/acl/stat). If the board which was not downloaded is marked Not Configured, then use the ACL/Avanstar configuration program (/usr/lib/acl/config) to add it to the software configuration and try again. If the ISA board is marked as Not Present, then the I/O address of the hardware does not match the software, and you need either to change the DIP switch settings or to use the ACL/Avanstar configuration program to change the software. If an EISA board is marked Not Present , then either rerun the configuration software using the EISA configuration utility and the Configuration diskette, or use /etc/acl/config. If a Micro Channel board is marked Not Present , then either rerun the configuration software using the Reference diskette and the Option diskette, or use /etc/acl/config. Symptom: When going to multiuser mode, you receive a message that a download is starting but receive a message other than: /usr/lib/acl/load: load successful Solution: Write down the message, use the Tech Support Checklist on page 40, and call Star Gate Tech Support (1-800-STAR GATE or 1-800-782-7428). ACL/Avanstar Port Usage Problems Symptom: No data comes out of an ACL/Avanstar port, and the process that writes data to the port does not complete. Cause: This happens when the driver is configured for interrupt operation, and the DIP switch setting for IRQ selection (for ACL family ISA boards) or the software configuration (for EISA or Micro Channel boards) does not match the IRQ set with the driver. Solution: Use the ACL/Avanstar status program (/usr/lib/acl/stat) to check the status of the board and the current software IRQ value. (See page 39 for information on the ACL/Avanstar status program.) A board which is configured correctly will have a status of: Present, Started, Interrupts on A board which is not configured correctly will have a status of: Present, Started If the board is not configured correctly, change whatever was set incorrectly: (1) Change the DIP switch setting if it's an ACL family ISA board. (See the board's hardware user's guide for instructions on configuring the board.) (2) Rerun the configuration software if it's an EISA or Micro Channel board. (See the board's hardware user's guide for instructions on configuring the board.) (3) Use the ACL/Avanstar Family configuration program (/etc/acl/config) to change the software. Symptom: No data comes out of an ACL/Avanstar port, but the process does complete. Cause 1: This happens because the software tty settings do not match the hardware (terminal, printer, etc. settings). Solution 1: Use the stty program (stty -a < /dev/ttyxx) to determine the current settings for ACL/Avanstar port xx. Check for baud rate, number of bits per character, number of stop bits, parity type, parity enabled and flow control. In the case of a port that has a getty running, you may need to change the contents of a gettydef entry or select a different entry (default gettydef entry at installation is m for all ACL/Avanstar ports). For a printer, you may need to modify the line printer interface program. For more information on adding serial devices, see the SCO System Administrators Guide. CAUSE 2: The cable attaching the ACL/Avanstar family board to the serial device is not wired with the correct pinouts. SOLUTION 2: Refer to the ACL/Avanstar family board user's guide and the serial device user's guide for the EIA-232 pinouts used on each Use a cable that matches these up correctly. How to Check the ACL/Avanstar Family Board Status Using /usr/lib/acl/sta t To check on the software configuration and board status, type: /usr/lib/acl/stat You will see a table giving the board parameters. For example: DP DP Board Type IRQ I/O address size Status bits 0 ACL2 5 200 d0000 64 62(Present,Started,Interrupts On) 1 ? 3 300 d0000 64 1(Not Present) 2 ? 0 0 0 0 0(Not Configured) 3 ? 0 0 0 0 0(Not Configured) The status bits can be interpreted as follows: 0 (Not Configured) -board may or may not be physically installed, but it is not driver configured. 1 (Not Present) -board is not physically installed, but it is driver configured. 22 (Present, Started) -board is present, but not configured correctly. 62 (Present, Started, Interrupts On) -board is present and in interrupt mode operation. A2 (Present, Started, Polling On) -board is present and in polled mode operation. TECHNICAL SUPPORT CHECKLIST If you are having installation or compatibility problems, please have the following information at hand when calling for Tech Support: 1. From your ACL/Avanstar family board: switch settings (if it's an ISA bus board) board type-ACL, ACL II, ACL II+, ACL IIR, ACL IIR+, ACL 16, ACL 16+, ACL MC, ACL MC+, Avanstar 100e, Avanstar 100i, or Avanstar 100m? If installing an ACL board, what is the part number of the PAL chip in location U-45 (just above the DIP switch)? If installing an EISA or Micro Channel bus board, what board parameters were chosen through the system's configuration utility? 2. From the ACL/Avanstar family device driver diskette label: Type and version of operating system and version of driver. Example: SCO XENIX System V (Version X.X) 3. From your ACL/Avanstar software driver installation: I/O address (if it's an ISA bus board) memory address dual port size polled or interrupt driven operation IRQ line (if interrupt driven) To get this information, run the ACL/Avanstar status program (/etc/acl/stat) described on the previous page, or run the modify configuration program (/etc/acl/config) to list parameters for all boards (see Section II). 4. From your sales or purchase order form: number of ports size of dual port memory 5. From your host PC and its installed hardware and software: type of system used type of graphics card CPU and bus speed of system Are you using memory caching? What is your operating system? Examples: AT&T Unix, ESIX, Intel Unix, Interactive Unix What is the version of the operating system? Example: SCO XENIX System V (Version X.X) What other devices do you have in your system? Examples: Tape backup, LAN card... If you have other devices installed, then for each device what is the: IRQ used I/O address range memory address range APPENDIX I For Users Replacing the XENIX Pre-Custom Driver Follow these steps to remove a pre-custom version of the ACL device driver and install the ACL/Avanstar Family XENIX device driver. 1. At the system console, boot the system and log in as root. 2. When the root # prompt appears, type: custom 3. At the custom menu, select: Add a Supported Product 4. When the screen prompts: Installing custom data files ... Insert distribution volume 1 and press or enter q to quit: Place the ACL/Avanstar Family XENIX Device Driver disk into drive 0, and press: 5. The screen prompts: ACL: A pre-custom version of the driver is already installed. The new driver cannot be installed without removing it. Do you want to remove it now (y/n)? 6. To install the driver, type: y 7. Custom then displays another menu. Select: Install one or more packages To continue installation, go to Section I-D and follow the instructions beginning with Step 7. APPENDIX II For Users Replacing the ACX/32 Follow these steps to remove the ACX/32 device driver and install the ACL/Avanstar Family XENIX device driver. 1. Boot the system. 2. At the prompt which appears during the boot sequence, enter the system maintenance mode by typing the root password. 3. When the root # prompt appears, type: custom 4. When the custom menu appears, select: Remove one or more packages 5. Enter package(s) to remove by typing: ACL The screen will display these and other messages: Removing ACL/Avanstar driver... Updating system configuration... Re-linking the kernel... 6. When the screen prompts: Do you want this kernel to boot by default? (y/n) Type: n 7. When the custom menu appears, exit custom by typing at the # prompt: q 8. The entry for the ACX/32 will remain in the custom menu although the package will not be installed. To remove the etc/perms/acl line which supplies the ACL entry on the custom menu, type after the # prompt: rm /etc/perms/acx Note: The ACL boards originally shipped with the ACX/32 driver have special PAL chips (part numbers ACX/16, 800204-01 or 900204-01) which offer these nonstandard I/O addresses: 250-253, 350-353, 650-653 and 750-753. Use these addresses when you set up the driver software for those ACL boards. APPENDIX III How to Change ACL II and ACL II+ EIA-232 Ports to DCE or DTE, using software (For owners of ACL II and ACL II+ boards with EIA-232 ports only) The ACL II and ACL II+ boards allow you to select DCE or DTE operation for each EIA-232 port through software. The default is DTE. To change a port to the DCE configuration, type at the root prompt: /usr/lib/acl/mkdce tty To change a port back to the DTE configuration, type: /usr/lib/acl/mkdte tty Example: To change direct connection port 1 on board 1 from DTE to DCE, type: /usr/lib/acl/mkdce tty5a Example: To change modem port 2 on board 2 from DCE back to DTE, type: /usr/lib/acl/mkdte tty6B Notes on ACL II and ACL II+ ports: Set up modem and direct connection ports separately. You need to make sure the proper one or both are set up correctly. Any changes will take effect the next time a port is opened. At powerup, all ports on the ACL II and ACL II+ are initially off. When a port is opened for use, the port is set up as DTE or DCE using its device name. When a port is closed, it remains as configured until it is reopened using its device name. APPENDIX IV How to use Extended Baud Rates (For owners of ACL II+, ACL IIR+, ACL 16+, ACL MC+, Avanstar 100e, Avanstar 100i, and Avanstar 100m boards ONLY) INTRODUCTION The ACL II+, ACL IIR+, ACL 16+, ACL MC+, Avanstar 100e, Avanstar 100i, and Avanstar 100m boards are capable of supporting baud rates up to 115.2 K baud. Since Xenix does not normally support these extended baud rates, support was added to the driver by redefining the standard baud rates less than 300 baud in the following manner: Standard Extended Baud Rate Baud Rate 50 57.6K 75 76.8K (Avanstar boards ONLY) 110 Reserved 134 115.2K 150 Reserved 200 Reserved NOTE If 57.6K baud is selected on a channel of an ACL PLUS family board, then 57.6K baud must also be selected on the adjacent channel. If 115.2K baud is selected on a channel of an ACL PLUS family board, then 115.2K baud must also be selected on the adjacent channel. SETTING EXTENDED BAUD RATES FROM THE COMMAND LINE The Xenix stty command is used to select extended baud rates from the command line, as in the following examples: To select 57.6 K baud on the current terminal, type: stty 50 To select 115.2K baud on /dev/tty5a, type: stty 134 #incllude int fd; struct termio t; . . . fd=open("/dev/tty5a", 0_RDWR | 0_NDELAY); ioctl(fd, TCGETA, &t); t.c_flag=(t.c_flag & CBAUD) |B50; ioctl(fd, TCSETAW, &t); close(fd); APPENDIX VHOW TO CHANGE THE INPUT BUFFER TRIGGER RATE You can now easily accommodate a mouse or any other peripheral requiring adjustments in packet size. You can change the value of the Input Buffer Trigger Rate (also called the Interrupt Rate) that the ACL/Avanstar Family Xenix Driver programs for each port by following the steps below. The Input Buffer Trigger Rate defines the number of characters that must be received before the host PC is alerted to a service request. This rate is a word in the Channel Control Block, Offset 000AH, of the ACL/Avanstar Family Control Program. A service request will also be indicated if any characters have been received and the most recent character was received more than four character times in the past. The maximum value is 32767. For more information, see the ACL Family Technical Reference Manual or the Avanstar Family Technical Reference Manual. The default value of the interrupt rate is 30. A typical mouse, however, requires an interrupt rate of less than 30. To change a value, follow these steps: 1. Log in as root. 2. At the root # prompt, type: cd /usr/lib/acl 3. Invoke the editor for the file called: ttyinit 4. Locate the line for the board and port connected to the peripheral needing a different interrupt rate by using this key for the numbers after each ttya: First Number: 5 = board 1 6 = board 2 7 = board 3 8 = board 4 Second Number: a = port 1 e = port 5 i = port 9 m = port 13 b = Port 2 f = port 6 j = port 10 n = port 14 c = port 3 g = port 7 k = port 11 o = port 15 d = port 4 h = port 8 l = port 12 p = port 16 Note: Ports 9 through 16 are for16 port boards only. Example: The line for port 3 on board 1 is: #/usr/lib/acl/irate /dev/tty5c 0 5. Remove the # sign from the beginning of the line you located. 6. Replace the last zero (0) in the line with the desired interrupt rate: Example: To decrease the interrupt rate from 30 to 29 for port 1 on board 2, edit this line: # /usr/lib/acl/irate /dev/tty6a 0 To become: /usr/lib/acl/irate /dev/tty6a 29 Note: Unchanged ports will continue to use 30. Setting a value of 0 (zero) also causes the interrupt rate to be 30. Setting a value bigger than the Input Buffer High Water Mark-a value which depends on dual port size-causes the value to be equal to the Input Buffer High Water Mark. (For details, see the ACL Family Technical Reference Manual or the Avanstar Family Technical Reference Manual.) 7. Write in the changes and exit the editor. 8. To utilize the peripheral(s), type at the prompt: /usr/lib/acl/ttyinit Note: This file will also be executed each time the kernel is booted. APPENDIX VI CHANGING THE INTERFACE TYPE ON THE AVANSTAR FAMILY CONFIGURABLE EXTERNAL CONNECTION PANELS Driver Implementation The following IOCTL commands are added to the driver: ACLGETEIA /* returns 422/232 mode */ ACLSET232 /* sets 232 mode */ ACLSET422 /* sets 422 mode */ By default the board powers up in 232 mode. To change the EIA mode, open the port with O_NONBLOCK set, make the appropriate IOCTL (ACLSET232 or ACLSET422) call and close the port. The port will remain in that EIA mode until another IOCTL (ACLSET232 or ACLSET422) call is made or the system is reset. Utilities The following utility is provided to configure the ports for EIA-232 or EIA-422: /usr/lib/acl/eia /dev/tty [232|422] Section G describes the device name numbering scheme in detail. Briefly, the board number code is a value between 5 and 8. (The first board has board number code 5). For a direct connection, the port number code is an alphabetic character between a and h for an 8-port board, and between a and p for a 16-port board. For a modem connection, the port number code is an alphabetic character between A and H for an 8-port board, and between A and P for a 16-port board. Use the [232|422] option to set the EIA mode to either EIA-232 or EIA-422. Not specifying 232 or 422 returns the EIA mode of the device. A shell script /usr/lib/acl/eiainit in the following format is also provided: #/usr/lib/acl/eia /dev/tty5a 422 #/usr/lib/acl/eia /dev/tty5b 422 . . . #/usr/lib/acl/eia /dev/tty8p 422 To configure the ports for EIA-232 or EIA-422, follow these steps: 1. Log in as root. 2. At the root # prompt, type: cd /usr/lib/acl 3. Invoke the editor for eiainit eiainit is invoked at boot time to configure all the ports. All of the lines are commented out so that all the ports remain in EIA-232 mode. Simply remove the # sign on any of the ports that you want configured to EIA-422. For example, the line for port 8 on board 1 is: #/usr/lib/acl/eia /dev/tty5h 422 4. Remove # from this line, save the changed file, and exit the editor. 5. To configure port 8 on board 1 to EIA-422, type at the prompt: /usr/lib/acl/eiainit This file will also be executed each time the kernel is booted. NOTE Pin assignments and supported signals for EIA-232 and EIA-422 compliance are described in each board's hardware user's guide. CUSTOMER ASSISTANCE For general assistance, please call 1-800-STAR GATE (1-800-782-7428) from 8:00 a.m. to 6 p.m., Eastern Standard Time. For your convenience, our Tech Support hours are from 7:30 a.m. to 7:00 p.m. If you still need technical assistance after reading this manual, call for technical support. Our specialists will try to provide solutions for you over the phone. If you have difficulties with installation, please collect the information listed in the Technical Support Checklist before calling. If you face a shipment or order processing difficulty, ask for Customer Service. An experienced Customer Service representative will be glad to assist you. If you have any comments, suggestions, or corrections regarding this manual, please make photo-copies of the affected pages, indicate your comments on the copies, and mail or FAX the copies to the address or FAX number below. FAX (216) 349-1978 Star Gate Technologies, Inc. Attn: Technical Documentation Dept. 29300 Aurora Road Solon, Ohio 44139 LICENSE AGREEMENT LICENSE: You have the nonexclusive right to use the enclosed device driver on one host computer, plus the terminals connected to it, at a time. You may transfer the device driver from one computer system to another, provided the device driver is used only on one computer system at a time. COPYRIGHT: The ACL/Avanstar Family SCO XENIX System V device driver and its documentation are owned by Star Gate Technologies, Inc., and are protected by United States copyright laws and international treaty provisions. You must treat this material like any other copyrighted materials, except that you may make one copy of the SOFTWARE solely for backup or archival purposes and transfer the SOFTWARE to a single hard disk. TERM: This license is effective until terminated. You may terminate it by destroying the program, its documentation and all copies. This license can be terminated by Star Gate Technologies, Inc., if you fail to comply with any term or condition of this agreement. AS IS: The program and its documentation are provided "AS IS" without warranty of any kind. The entire risk as to the results and performance of the device driver is assumed by you. Should the program prove to be defective, you (and not Star Gate Technologies, Inc., or its dealers) assume the entire cost of all necessary servicing, repairs or corrections. Further, Star Gate Technologies, Inc., does not warrant, guarantee or make any representations regarding the use of, or the results of the use of, the device driver in terms of correctness, accuracy, reliability, currentness or otherwise. You rely on the program and results solely at your own risk. NO WARRANTIES: Star Gate Technologies, Inc., disclaims all warranties, expressed or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose, with respect to the software, the accompanying written materials, and any accompanying hardware. NO LIABILITY OR CONSEQUENTIAL DAMAGES: Neither Star Gate Technologies, Inc., nor anyone else who has been involved in the creation, production or delivery of this program shall be liable for any direct, indirect, consequential or incidental damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use, the result of use, or the inability to use such product, even if Star Gate Technologies, Inc., has been advised of the possibility of such damages or claim. Because some states do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to you.