Ö· Ö· Ò Ö· ·Ö Ö· Ö· Ö· ÖÒ· Ö· Ö· Ƕ º º / Ƕ ºº Ƕ ºº Ó· º Ƕ ǽ ½Ó Ó½ ÓÄ ½Ó Ó/ ½Ó ½Ó Ó½ Ð ½Ó ½Ó Ö· Ö· Ö· ·Ö Ö· Ò ·Ö Ó· º ºº ºº ºº º Ó· Ó½ Ó½ Ó½ Ó½ ½Ó Ð ½Ó ACL /Avanstar Device Driver Version 2.XX for SCO UNIX System V Release 3.2 Software Installation Guide manual part number 650042-10 INTRODUCTION 2 I. HOW to Install and Use the ACL/Avanstar Package 3 BEFORE YOU DO THE SOFTWARE INSTALLATION A. Choose values for ACL/Avanstar parameters 3 B. Check for the Link Kit and install it if necessary 8 C. Make a backup copy of the ACL/Avanstar diskette 10 How to perform the software installation D. Load the package 11 E. Enter the parameters for the software driver 12 F. Reboot the system 17 After installation, how to set up ports for G. Serial device names and ACL II port setup 18 H. Log-in terminals, modems, line printers 19 I. Transparent print function 21 II. HOW to Reconfigure the ACL/Avanstar Driver 23 III. HOW to Remove the ACL/Avanstar Package 31 IV. TROUBLESHOOTING 33 APPENDICES I. How to change ACL II and ACL II+ Ports to DCE or DTE 41 II. How to change the Input Buffer Trigger Rate 42 III. Changing Configurable External Panel's Interface Type 44 IV. How to Use Extended Baud Rates 46 CUSTOMER Assistance 48 LICENSE Agreement 49 c 1994 by Star Gate Technologies, Inc. All rights reserved. First issued October 1989. All brand and product names are trademarks or registered trademarks of their respective companies. ACLTM/AVANSTARTM Family Unix Device Driver Description The ACL/Avanstar Family SCO UNIX Device Driver Diskette contains the ACL/Avanstar Family SCO UNIX Device Driver and support software for its configuration and use. The driver provides the interface between an ISA, EISA, or Micro Channel bus computer using the SCO UNIX System V Release 3.2 operating system, 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 UNIX kernel. Afterward, at power-up, the host PC automatically sets up the interface to the ACL/Avanstar family board(s). This driver supports serial ports for terminals, modems, line printers and the transparent print function. It also provides DTE/DCE selection through software for ACL II and ACL II+ EIA-232 ports. This driver provides for polling and shared interrupts, and it 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 guidelines for choosing values. Record your choices 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 ____ 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 system configuration for interrupt operation. Otherwise, set them up for polled operation. Also, check your application software for any guidelines. MULTIPLE BOARDS: You cannot mix modes. The boards must be either all interrupt driven or all polled. 2a. Choose an I/O address for each ISA bus board. Each 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. 200-207 for board ____ 300-307 for board ____ 600-607 for board ____ 700-707 for board ____ 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 ACL boards originally sold with the ACX/32 or ACX/16 driver (XENIX drivers sold before June 1989). 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 ____ 2b. Select a unique I/O address for each ACL MC+ board. The following addresses are available for ACL MC+ boards. 0800 for board ____ 0C00 for board ____ 1000 for board ____ 1400 for board ____ 1800 for board ____ 1C00 for board ____ 2000 for board ____ You will select these values when you set up the boards in step 6. However, you will not enter I/O address values during driver configuration for any Micro Channel boards. 2c. You may or may not need to select an I/O address when you set up an Avanstar 100m board (step 6). However, you will not enter an I/O address value during driver configuration for any Micro Channel board. 3. Note the dual port size: 8K bytes (ACL MC) ____ 16K bytes (some ACL, ACL II, ACL II+, ACL IIR, ACL IIR+ ; all ACL 16, ACL 16+, ACL MC+, Avanstar 100i, and Avanstar 100m) ____ 32K bytes (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. 4. Dual Port Memory Address Recommendations: We recommend a location of D0000 (hex), an area often-though not always-free of conflicts with system memory or with non-ACL/Avanstar family devices. For other recommendations, see the adapter's hardware installation guide and the following table. 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 GUIDELINES: The dual port for an ACL, ACL 16, ACL 16+, Avanstar 100i, or Avanstar 100m board must be installed within the first megabyte of the host computer's address space. The dual port for an ACL II, ACL II+, ACL IIR, ACL IIR+, ACL MC, ACL MC+, or Avanstar 100e must be placed between A0000 and F0000 in the first megabyte of the host computer's memory space. MULTIPLE BOARDS: The dual ports of ISA and EISA boards may occupy different ranges, or they may 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. ACL/Avanstar family boards for Micro Channel architecture can not share address space with each other or with non-ACL/Avanstar family boards. Therefore, each ACL MC, ACL MC+, or Avanstar 100m must have a different starting address for its dual port. Choose a memory address for the Dual Port. Board 1______________ Board 3______________ Board 2______________ Board 4______________ 5. If the driver is to be interrupt driven, choose an IRQ for each board installed, or choose one 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 all ACL/Avanstar family boards may share the same IRQ. However, if both EISA 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. The IRQ(s) must not be used by any other device in the system. We generally recommend IRQ 5, a setting relatively free of conflicts. The following list shows the IRQs supported by each board. Board IRQ choices ACL 3 4 5 6 7 9* ACL II/II+ 3 4 5 9 10 11 12 15 ACL IIR/IIR+ 3 4 5 9 10 11 12 15 ACL 16/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 *NOTE: Although the ACL board hardware offers IRQ 2, IRQ 2 is translated to IRQ 9 on ISA systems. If you use the IRQ 2 switch setting on an ACL board, select IRQ 9 during driver installation. 6. Now set up the board using the following guidelines. 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. (a) Before installing an ISA board, set the switches for the I/O address by following the guidelines in section A of this manual. For any ISA board except the Avanstar 100i, also set the switches for the IRQ (if used) you selected in section A. There are no switches for IRQ settings for the Avanstar 100i. (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. (Micro Channel adapters do not have any hardware settings.) Follow the guidelines in section A of this manual to select the dual port address and IRQ (if used) for each ACL MC, ACL MC+ and Avanstar 100m in the system. You will also need to select I/O addresses for all ACL MC+ and some Avanstar 100m boards at this time. However, no I/O address values will need to be entered during driver configuration for any Micro Channel boards. (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. (EISA bus adapters do not have any hardware settings.) Select the dual port address and IRQ (if used) for each Avanstar 100e in the system. For more detailed instructions, see the applicable hardware installation guide. Proceed to Section B of this manual to continue software installation. B. Check for the Link Kit and Install It If Necessary The Link Kit must be installed in the Unix operating system before the ACL/Avanstar Family driver can be installed. To check for the Link Kit, follow these steps. ATTENTION: If you attempt to install this device driver without the Link Kit present in the operating system, the installation will abort and you will see: The Link Kit is required for the installation of the ACL/Avanstar Driver Software Package. Please install it first and then try again. How to Check for the Link Kit Package 1. At the system console, boot your Unix system and log in as root. 2. Type: custom 3. Select: List 4. Select: The Operating System 5. Select: Packages 6. 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 Backup 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. When the custom menu appears, select: Install 3. From among the options, select: The Operating System 4. Select: Packages 5. Select: LINK 6. 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 Unix system and log in as root. 2. Type: sysadmsh 3. Select: media 4. Select: duplicate 5. Choose the appropriate 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 Unix device driver. 1. At the system console, boot the system and log in as root. 2. Type: custom 3. From the custom menu select: Install 4. Select: A New Product 5. Select: Entire Product 6. Place the ACL/Avanstar Family Unix Device Driver disk into the primary drive. 7. To continue, press: 8. After Custom executes the preparation script, you must "press any key to continue." 9. Following the screen prompt, confirm that the requested volume is still in the driver and press: 10. The screen should now display several messages, including: Installing ACL/Avanstar Device Driver - Version X.X E. How to Enter Parameters for the Software Driver To continue installation and enter the ACL/Avanstar Parameters, respond to the on- screen questions. 1. The screen prompts: Should the driver poll or be interrupted? (i or p) 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. NOTE In the polled mode, the software driver will ignore any IRQs selected by the hardware switches on ACL family ISA bus boards. 2. 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 add or remove board(s), use the configuration program described on page 23. If you have a Micro Channel board, go to Step 3b. 3a. Appears for ISA or EISA boards only: Adding board X. What board type is this board? 1. acl 2. acl2/2+ 3. acl2r/2r+ 4. acl16/16+ 5. Avanstar 100e 6. Avanstar 100i Select one (1 to 6, q to quit). Enter the appropriate choice: 1, 2, 3, 4, 5, or 6. 3b. Appears for Micro Channel boards only: Adding board X. What board type is this board? 1. aclmc/aclmc+ 2. Avanstar 100m Select one (1 or 2, q to quit). Enter 1 for either an ACL MC or an ACL MC+ board. 4a. Appears for an ACL family ISA board 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. 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). 4b. 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. 5. Appears for an 8-port ACL family ISA bus board only: What size is the dual port on board X? (16 or 64) Enter 16 if the board has a 16K byte dual port. Enter 64 if the board has 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. 6. Appears for ISA bus boards only: What memory address is board X to use? Enter the hexadecimal dual port boundary address, following the guidelines in Section A. If the value is not on the correct boundary, you will be reminded to choose a value on the correct boundary. 7. Appears if you had selected interrupt-driven operation: What IRQ is board X to use? For an ACL family ISA bus board, make sure your selection matches the IRQ switch settings. (There are no switches for IRQ settings for the Avanstar 100i.) For an EISA bus board or a Micro Channel bus board, make sure your selection matches the system configuration value. If you enter no selection or an unacceptable choice, you will be reminded of these acceptable choices: Board IRQ Choices ACL 3 4 5 6 7 9* ACL II/II+ 3 4 5 9 10 11 12 15 ACL IIR/IIR+ 3 4 5 9 10 11 12 15 ACL 16/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 *NOTE: Although the ACL board hardware offers IRQ 2, IRQ 2 is translated to IRQ 9 on ISA systems. If you used the IRQ 2 switch setting on an ACL board, select IRQ 9 now for the driver configuration. 8. The screen will now list the parameters you have entered and prompt: OK to add board X? (y or n) If you type y, the software will install the board and ask you to repeat Steps 3 through 8 for any additional boards you are adding. If you type n, the software will repeat the entire series of questions for board 1 (Steps 3 through 8). NOTE: If you later wish to change the driver parameters of the board(s) or add or remove board(s), you can easily do so using the menu-driven configuration program described in Chapter II. 9. The screen then indicates that the operating system is being rebuilt. When the rebuilding is complete the screen will display: ACL/Avanstar Device Driver Installation Complete. 10. Follow the screen prompt to: "press any key to continue." 11. After custom completes "checking file permissions..." you will be returned to the main custom menu. 12. Remove the ACL/Avanstar software driver diskette from the disk drive. NOTE: You can take this opportunity to install other software packages or go directly to the next step. 13. To exit custom, select: Quit 14. Then select: Yes F. How to Reboot the System 1. At the root prompt, type: reboot 2. The reboot will take a while. After the system enters multiuser mode, it will display the message: Starting ACL/Avanstar download 3. Check to make sure a load successful message appears for each board. 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+ aclmc3.cp Avanstar 100e a100e.cp Avanstar 100m a100m.cp Avanstar 100i a100i.cp 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. G. Serial Device Names How to Specify an ACL/Avanstar Family Device Name Device names are used to configure each port on the ACL/Avanstar Family boards for various applications. Be sure to pick the correct name format for each application. Use these guidelines: APPLICATION DEVICE NAME Terminals, printers, dial-out modems /dev/ttya Dial-in modems /dev/ttyA refers to the first number in the name 0 = board 1 1 = board 2 2 = board 3 3 = board 4 refers to the second number in the name 0 = port 1 4 = port 5 8 = port 9 c = port 13 1 = port 2 5 = port 6 9 = port 10 d = port 14 2 = port 3 6 = port 7 a = port 11 e = port 15 3 = port 4 7 = port 8 b = port 12 f = port 16 NOTE: Ports 9 through 16 apply to 16 port boards only. DEVICE NAME EXAMPLES Terminal, printer or dial-out modem for the second port on the first board: /dev/ttya01 Dial-in modem for the fifth port on the second board: /dev/ttyA14 ACL II and ACL II+ USERS ONLY: If you wish to select a DCE setup for an EIA- 232 port through software, please note the instructions in Appendix I. H. How to Set Up Serial Ports for a Log-In Terminal or Modem 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. At installation time, entries are created in inittab for each port. These entries in inittab specify the "m" entry in gettydefs. For details on the gettydefs file, refer to the SCO Unix System V System Administrator's Guide. 2. Check the etc/gettydefs file to make sure that the parity, number of bits per character and baud rate of each port match the settings of the device to be connected. 3. Invoke the editor and make any changes needed to the gettydefs file. 4. To create a terminal database entry for the port using sysadmsh, type: sysadmsh 5. Select: Accounts 6. Select: Terminal 7. Select: Create The correct value for the terminal device is: ttya for a log-in terminal ttyA for a dial-up modem For more information on Terminal Login Management, refer to the SCO Unix System V System Administrator's Guide. 8a. Enable the port by typing after the # prompt: enable ttya for a log-in terminal enable ttyA for a dial-in modem EXAMPLE: To enable direct connection port 8 on board 1, type: enable ttya07 EXAMPLE: To enable modem connection port 7 on board 2, type: enable ttyA16 8b. Or, to disable the port, type after the # prompt: disable ttya for a log-in terminal disable ttyA for a dial-up modem EXAMPLE: To disable log-in terminal port 4 on board 1, type: disable ttya03 9. The screen will respond with the messages: /etc/inittab updated /etc/conf/init.d/acl updated After a few seconds, the login prompt should appear on the terminal if the port was enabled. How to Use a Port for a Modem For detailed information on using a port for a modem, refer to the SCO Unix System V System Administrator's Guide. How to Use a Port for a Line Printer For detailed information on using a port for a printer, refer to the SCO Unix System V System Administrator's Guide. You can also use the System Administration shell to set up your printer. For information on the sysadmsh shell, refer to the SCO Unix System V System Administrator's Guide. I. How to Use a Port for the Transparent Print Function The transparent print function allows a printer that is plugged into the back of 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. Log in as root. 2. At the root # prompt, type: cd /etc/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 ttpa: 1st Number: 0 = board 1 1 = board 2 2 = board 3 3 = board 4 2nd Number: (Ports 9-16 for 16 port boards only.) 0 = port 1 4 = port 5 8 = port 9 c = port 13 1 = port 2 5 = port 6 9 = port 10 d = port 14 2 = port 3 6 = port 7 a = port 11 e = port 15 3 = port 4 7 = port 8 b = port 12 f = port 16 EXAMPLE: The line for port 2 on board 1 is: #/etc/acl/ttp /dev/ttpa01 -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 the 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 that 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 beginning of transparent print data f with the decimal value of the ASCII code for the OFF character(s) which your terminal recognizes as the end of transparent print data EXAMPLE: You plan to plug a terminal supporting transparent print into port 5 on board 2. The printer's speed is 120 characters per second; the terminal's transparent print ON string is or X (24 in decimal), and its OFF character is or T (20 in decimal). How do you configure the port for this task? Edit this line: #/etc/acl/ttp /dev/ttpa14 -s 0 -n 0 -f 0 To become: /etc/acl/ttp /dev/ttpa14 -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: /etc/acl/ttpinit NOTE: This file will also be executed each time the kernel is booted. II. How to Reconfigure the ACL/avanstar Family Unix Device Driver Software Earlier, you set up software parameters for the boards you installed. If 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, 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 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 (if an ISA bus board), 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 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 (if an ISA bus board), 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) Delete 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 run 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: /etc/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, 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. NOTE: You may wish to review Chapter 1, Section A, to pick the parameters of the boards you are adding. 1. At the main menu, select Add board by typing: 3 If you have a Micro Channel system, go to Step 2b. 2a. Appears for ISA and EISA boards only: Installing board X. What kind of board is this board? 1. acl 2. acl2/acl2+ 3. acl2r/acl2r+ 4. acl16/acl16+ 5. Avanstar 100e 6. Avanstar 100i Select one (1 to 6, q to quit). Enter one of the following choices, making sure your selection matches the type of adapter board you are adding: 1 2 3 4 5 or 6 2b. Appears for Micro Channel boards only: Installing board X. What kind of board is this board? 1. aclmc/aclmc+ 2. Avanstar 100m Select one (1 or 2, q to quit). Enter 1 for either an ACL MC or an ACL MC+ board. 3a. Appears for ACL family ISA 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: ACL boards with PAL devices at U45 (just above the 8-position DIP switch) labeled ACX/16, 800204-01 or 900204-01, must instead use I/O addresses 250, 350, 650 and 750. These ACLs were originally sold with the ACX/32 or ACX/16 driver (SCO XENIX drivers sold before June 1989). These values can be selected but are not displayed on the screen. 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. 4. Appears for 8-port ACL family ISA boards only: What size is the dual port on board X? (16 or 64) Enter 16 for a 16K byte dual port. Enter 64 for a 64K byte dual port. Make sure you match the hardware. 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 based on the selection criteria in Section A of Chapter I. 6. If you had selected interrupt-driven operation, the screen prompts: What IRQ is board X to use? (3-7, 9-12 or 15) Enter one of the following choices, making sure you match the IRQ selected by the ACL family ISA board switches or the configuration software for EISA or Micro Channel systems. (There are no switches for IRQ settings for the Avanstar 100i.) Board IRQ Choices ACL 3 4 5 6 7 9* ACL II/II+ 3 4 5 9 10 11 12 15 ACL IIR/IIR+ 3 4 5 9 10 11 12 15 ACL 16/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. If you used the IRQ 2 switch setting on an ACL board, select IRQ 9 now for the driver configuration. 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. When you are satisfied with the software configuration, turn to page 30. 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 25). 1. When you select 4) Modify 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: Lines 1 and 2 appear only for ISA bus boards. Line 3 appears only 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, turn to page 30. Follow the steps to install the new configuration and perform a reboot. How to Remove a Board 1. When you select 5) Delete board from the main menu, the screen will ask which board you wish to remove, and it will 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 the board parameters directly and return you to the main menu. NOTE: 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. To reboot your system, type after the # prompt: reboot 3. After the boot : prompt, type: 4. Respond as directed to the following prompt when it appears: Type d to proceed with normal startup, (or give root password for system maintenance): 5. Respond to the UNIX boot prompt for the correct time and date. 6. When UNIX enters multiuser mode, the system will display the message: Starting ACL/Avanstar download 7. Check to make sure that a load successful message appears for each ACL/Avanstar board. If all ACL/Avanstar family boards have been successfully loaded, the installation of the modified ACL/Avanstar driver software is complete. An unsuccessful download will result in an error message, described in Chapter IV. 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. Select: Remove 4. Select: ACL/Avanstar Device Driver 5. The screen prompts: Select package(s) to remove and press 6. Make sure that the ACL/Avanstar line is highlighted. 7. Press: 8. The screen prompts: Do you wish to continue? 9. Select: Yes 10. The screen displays a series of messages: Executing ACL/Avanstar Device Driver Removal Script Removing ACL/Avanstar Device Driver Version XX ACL/Avanstar Driver Components Removed The Unix Operating System will now be rebuilt. This will take a few minutes. Please wait.... The Unix Kernel has been rebuilt.... ACL/Avanstar Device Driver Removal Complete.... 11. Respond to the prompt: Press any key to continue. 12. The screen displays: Creating file list.... Removing files 13. To exit custom select: Quit 14. Select: Yes 15. To reboot a system kernel without the ACL/Avanstar driver, type at the root # prompt: reboot 16. At the boot : prompt, press: 17. Follow the on-screen prompts to complete a reboot. IV. Troubleshooting: 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. Installation Problems Symptom: You receive the message: WARNING: IRQ is already in use by . Board will be entered in the sdevice file, but it will be marked as "not installed". CAUSE: This message is from the ACL/Avanstar configuration program. It means that IRQ is already claimed by device . The configuration program will create an entry in the sdevice file for board but the configure field will be N, meaning that the board will not be included when the kernel is built. SOLUTION: Select an unused IRQ for the board with the conflict, if possible, or switch to polled operation. To do this, complete the installation, exit custom or sysadm (if used), and run the ACL/Avanstar configuration program (/etc/acl/config) to build a new kernel. Then adjust the hardware (ACL family ISA bus board only) or set up the EISA or Micro Channel board again with the configuration software if necessary and reboot to install the new kernel. (See Chapter II for help with the ACL/Avanstar configuration program.) Download Problems Symptom: When going to multiuser mode, you receive the message: /etc/idrc.d/acl: /dev/acl: cannot open CAUSE: The kernel you have booted does not contain the ACL/Avanstar driver, or the ACL/Avanstar driver device node (/dev/acl) does not exist. The ACL/Avanstar family board(s) will not be properly initialized, and no communications with any device attached to the ACL/Avanstar adapter board(s) 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 family board in the system. For example: /etc/acl/load: load /etc/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+ aclmc3.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 driver configuration for one of these reasons: For an ISA bus board, the DIP switch settings which select the I/O address do not match the value entered during the driver configuration. For example, the hardware switches are set for 300, but the driver is set for 700. An ACL board may have an I/O address decode PAL which does not match the I/O value entered. For example, the PAL might recognize 250, 350, 650, 750, but the driver is set for 200. Another possible cause might be that an ISA, EISA, or Micro Channel board is not configured at all. SOLUTION: Check the status of the ACL/Avanstar boards by running the ACL/Avanstar status program (/etc/acl/stat). If the board which was not downloaded is marked Not Configured, use the ACL/Avanstar configuration program (/etc/acl/config) to add it to the software configuration and try again. If an ISA board is marked Not Present, then the I/O address of the hardware does not match the driver configuration. You need either to change the DIP switch settings or to use the ACL/Avanstar configuration program to change the driver configuration. 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: /etc/acl/load: load successful SOLUTION: Write down the message, use the Tech Support Checklist on page 39, 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 selected during the driver configuration.. SOLUTION: Use the ACL/Avanstar status program (/etc/acl/stat) to check the status of the board and the current driver-configured IRQ value. (See page 38 for information on the ACL/Avanstar status program.) A board which is configured correctly will have a status of: 62 (Present, Started, Interrupts on) A board which is not configured correctly will have a status of: 22 (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 driver configuration. 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/ttyaxx) 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. When a port has a getty running, you may need to change the contents of a gettydef entry or select a different entry. The default gettydef entry at installation is 9600 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 your operating system manuals. 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 hardware installation 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 ACL/avanstar Family Board Status Using /etc/acl/stat To check on the software configuration and board status, type: /etc/acl/stat You will see a table giving information on each board (0-3). For example: Board Type IRQ DP address DP size Status bits 0 ACL 2 5 0xd0000 64 A2(Present,Started, Polling On) 1 ? 3 0xd0000 64 1(Not Present) 2 ? 0 0 0 0(Not Configured) 3 ? 0 0 0 0(Not Configured) Interpret the status bits as follows: 0 (Not Configured) board may or may not be installed in PC, and isn't driver-configured. 1 (Not Present) board is not physically installed, but 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:  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?  switch settings (if it's an ISA board)  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: Version X.XX 3. From your ACL/Avanstar software driver installation: I/O address (if it's an ISA bus board) memory address dual port size (if it's an 8-port ACL family ISA bus board) 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 page 38, 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 CPU and bus speed of system Are you using memory caching? What is your operating system? EXAMPLE: SCO Unix System V Release 3.2 v4.1 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 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 external connection panels ONLY) The ACL II and ACL II+ boards are designed so you can select DCE or DTE operation for each EIA-232 port through software. The default is DTE. Use this procedure to change a port to the DCE configuration. This option is not available with the other ACL/Avanstar Family boards. 1. Use the select program. Type at the root prompt: /etc/acl/select dce 2. The screen will display the ACL II and ACL II+ ports now set up as DTE. 3. Enter the name of the port you wish to change to DCE. EXAMPLE: To change the first port on the first installed ACL II or ACL II+ board to DCE, type: ttya00 4. Repeat Step 3 to change multiple ports. The change to DCE will take effect the next time a port is opened. Set modem and direct connect ports separately. You need to make sure the proper one or both are set correctly. To change a port back to DTE, type: /etc/acl/select dte for Step 1 then follow Steps 2 through 4. You do not have to re-enable converted ports - once enabled, they stay enabled. APPENDIX II HOW TO CHANGE THE INPUT BUFFER TRIGGER RATE You can now easily accommodate a mouse or any other peripheral requiring adjustments to the input buffer trigger rate. You can change the value of the Input Buffer Trigger Rate (also called the interrupt rate) that the ACL/Avanstar Family UNIX 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 /etc/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: 0 = board 1 1 = board 2 2 = board 3 3 = board 4 Second Number: 0 = port 1 4 = port 5 8 = port 9 c = port 13 1 = port 2 5 = port 6 9 = port 10 d = port 14 2 = port 3 6 = port 7 a = port 11 e = port 15 3 = port 4 7 = port 8 b = port 12 f = port 16 NOTE: Ports 9 through 16 are for 16 port boards only. EXAMPLE: The line for port 3 on board 1 is: #/etc/acl/irate /dev/ttya02 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: # /etc/acl/irate /dev/ttya10 0 To become: /etc/acl/irate /dev/ttya10 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, please refer to 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: /etc/acl/ttyinit NOTE: This file will also be executed each time the kernel is booted. APPENDIX III 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: /etc/acl/eia /dev/tty[a|A] [232|422] The device name /dev/ttya is for a direct connection. The device name /dev/ttyA is for a modem connection. Boards are numbered from 0 to 3, and ports are numbered from 0 to 7 for the first eight ports. On a 16- port board, ports are numbered from 0 to 9 (ports 1 to 10) and from a to f (ports 11 to 16). 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 /etc/acl/eiainit in the following format is also provided: #/etc/acl/eia /dev/ttya00 422 #/etc/acl/eia /dev/ttya01 422 . . . #/etc/acl/eia /dev/ttya3f 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 /etc/acl 3. Invoke the editor for eiainit /etc/idrc.d/acl calls eiainit 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: #/etc/acl/eia /dev/ttya07 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: /etc/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 installation guide. 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.2K baud. Since Unix 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 Unix stty is used to select extended baud rates from the command line, as in the following examples: To select 57.6K baud on the current terminal, type: stty 50 To select 115.2K baud on /dev/ttya00, type: stty 134 < /dev/ttya00 SETTING EXTENDED BAUD RATES FROM A PROGRAM To select the extended baud rates, you can also make an ioctl( ) function call in a program. See your Unix system manuals for termio information. An understanding of the ioctl( ) function and the termio structure are necessary to select the extended baud rates. EXAMPLE: The following "C" program selects 57.6K baud: #include #include int fd; struct termio t; . . . fd = open("/dev/ttya00", O_RDWR | O_NDELAY); ioctl(fd, TCGETA, &t); t.c_cflag = (t.c_cflag & ~CBAUD) | B50; ioctl(fd, TCSETAW, &t); close(fd); Customer Assistance For Customer Service or Sales, call 1-800-STAR GATE (1-800-782-7428) from 8 a.m. to 6 p.m., Eastern Standard Time. For your convenience, we have extended Tech Support hours from 7:30 a.m. to 7 p.m., E.S.T. If you still need technical assistance after reading this manual, please call and ask for Technical Support. Our specialists will try to provide solutions over the phone. If you face a shipment or order processing difficulty, please ask for Customer Service. An experienced Customer Service representative will be pleased 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 Unix 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.