Ö· Ö· Ò Ö· ·Ö Ö· Ö· Ö· ÖÒ· Ö· Ö· Ƕ º º / Ƕ ºº Ƕ ºº Ó· º Ƕ ǽ ½Ó Ó½ ÓÄ ½Ó Ó/ ½Ó ½Ó Ó½ Ð ½Ó ½Ó ·Ö Ö· Ò ·Ö ºº ºº º Ó· Ó½ ½Ó Ð ½Ó ACL/Avanstar Streams Device Driver Version 2.04 for UNIX System V Release 4 Software Installation Guide Manual Part Number: 650089-06 CONTENTS DESCRIPTION 2 I. How to Install and Use the ACL/Avanstar Family Package 3 BEFORE YOU INSTALL THE SOFTWARE A. How to choose values for hardware and software 3 HOW TO INSTALL THE SOFTWARE B. How to load software from diskette 9 C. How to enter parameters for the software driver 11 D. How to reboot the system 16 AFTER INSTALLATION, HOW TO SET UP PORTS E. Serial device names and port setup information 17 F. How to set up log-in terminals 19 G. How to use a port for transparent print 22 II. How to reconfigure the ACL/Avanstar Family driver 24 III. How to remove the ACL/Avanstar Family driver 31 IV. Troubleshooting 32 APPENDIX I. How to change ACL II ports to DCE using software 40 II. How to enable RTS and/or CTS flow controls 41 III. How to change the input buffer trigger rate 43 IV. Changing Interface Type on Configurable External Panels 45 V. How to use extended baud rates 47 CUSTOMER ASSISTANCE 49 LICENSE AGREEMENT 50 c 1994 by Star Gate Technologies, Inc. All rights reserved. Original issue: August 1991. The names of products in this manual are trademarks or registered trademarks of their respective companies. ACLTM/AvanstarTM FAMILY UNIXTM DEVICE DRIVER DESCRIPTION The ACL/Avanstar Family UNIX Streams Device Driver Diskette contains the ACL/Avanstar Family UNIX Streams Device Driver and support software for its configuration and use. This Streams driver provides the interface between an ISA, EISA, or Micro Channel bus computer, and up to four ACL/Avanstar Family boards. It incorporates the new Streams technology of UNIX System V.4, replacing the older character style of device drivers. 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 Family device driver into the UNIX kernel and set up ports. 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 on ACL II and ACL II+ EIA-232 ports. I. HOW TO INSTALL AND USE THE ACL/Avanstar FAMILY PACKAGE A. How to Choose Values for Hardware and Software Listed below are the ACL/Avanstar Family 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 ____ GUIDELINES: Check your application software for specific guidelines. A general guideline is 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 up the board for polled operation. 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 adapter. Each adapter 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 adapter ____ 300-307 for adapter ____ 600-607 for adapter ____ 700-707 for adapter ____ 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. Assign I/O addresses for Micro Channel bus adapters. You must select an I/O address of 0000 for each ACL MC adapter. 0000 for board ____ 0000 for board ____ 0000 for board ____ 0000 for board ____ Select a unique I/O address for each ACL MC+ adapter. The following addresses are available for ACL MC+ adapters. 0800 for board ____ 0C00 for board ____ 1000 for board ____ 1400 for board ____ 1800 for board ____ 1C00 for board ____ 2000 for board ____ At this time, you will not be able to determine what I/O addresses to select for any Avanstar 100m adapters you may have. This will be determined in step 6. 3. Note the dual port size: 8K bytes (ACL MC) ____ 16K bytes (some ACL, ACL II, ACL II+, ACL IIR, ACLIIR+ ; all ACL 16, ACL 16+, ACLMC+, 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, an area often-though not always-free of conflicts with system memory or with non-ACL/ Avanstar family devices. For other locations, see your 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 memory space. The dual port for the 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 cannot share address space with each other or with non-ACL/Avanstar family adapters. 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 3 IRQ ____ Board 2 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 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. The IRQ(s) assigned to any ACL/Avanstar Family boards must not be used by any other device in the system. The following list shows the IRQs supported by each board. RECOMMENDATIONS: For ISA bus boards we recommend IRQ 5, a setting relatively free of conflicts. For Micro Channel boards (ACL MC, ACL MC+, and Avanstar 100m), IRQ 3 is relatively free of conflicts. 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 up the switches for the I/O address by following the guidelines in section A. 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 adapter, 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. Follow the guidelines in section A to select the dual port address and IRQ (if used) for each ACL MC, ACL MC+ and Avanstar 100m in the system. Also, select the I/O addresses for any ACL MC+ adapters in the system by following the guidelines in section A. (Micro Channel adapters do not have any hardware settings.) NOTE You may or may not be prompted to select an I/O address for an Avanstar 100m adapter. If you are required to select an I/O address for an Avanstar 100m, record your selection so that you will be able to enter it later during the driver configuration. If you are not required to select an I/O address for an Avanstar 100m, record the value 0000 to be entered later during the driver configuration. (c) After installing an EISA bus 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. (EISA bus adapters do not have any hardware settings.) For more detailed instructions, see the applicable hardware installation guide. Proceed to section B of this manual to begin driver installation. B. How to Load Software from Diskette ATTENTION: If you try to complete installation when the same IRQ is being used by both the ACL/Avanstar Family board and another device, the kernel will be built without the ACL/Avanstar Family driver. See section A for how to avoid conflicts. In the event that the kernel is built without the ACL/Avanstar Family driver, change the software settings (or the hardware settings on ISA bus adapters) to remove the conflict. Use the /etc/acl/config program described in Chapter II; then rebuild and reboot the new kernel. ATTENTION: If you are installing an upgrade of the ACL/Avanstar Family UNIX System V Release 4 Device Driver, first remove the previous version. For removal instructions, please see Chapter III. ATTENTION: Though not essential to driver installation, please make a backup copy of the ACL/Avanstar Family UNIX Diskette using the standard procedure for copying a diskette. Install the device driver software using this procedure: 1. Log in as root. 2. You can type: pkgadd -d /dev/dsk/f03ht for 3.5" disk in drive A pkgadd -d /dev/dsk/f13ht for 3.5" disk in drive B pkgadd -d /dev/dsk/f0q15dt for 5.25" disk in drive A pkgadd -d /dev/dsk/f1q15dt for 5.25" disk in drive B Or, if you have and prefer to use the sysadm program... Type: sysadm Select: software Then select: install Set the location to: diskette 1 for disk in drive A diskette 2 for disk in drive B Finally, save the form. 3. Follow the on-screen instructions to insert the ACL/Avanstar Family device driver diskette and press: g 4. The screen will display some messages about the installation and then prompt: The following packages are available: 1 acl ACL/Avanstar Device Driver 5. Continue installation by pressing: C. How to Enter Parameters for the Software Driver After some more messages, follow the prompts to enter the values you selected in Section A. 6. 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 driver will ignore any IRQs selected by the hardware switches on ACL Family ISA boards. 7. The screen prompts: How many boards will be installed? (1-4) Enter one of the following choices: 1, 2, 3 or 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 driver parameters or wish to add or remove board(s), use the configuration program described in Chapter II. If you have a Micro Channel system, go to Step 8b. 8a. Appears for ISA or EISA 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: 1, 2, 3, 4, 5, or 6. 8b. Appears for Micro Channel boards only: Adding board X. What board type is this board? 1. ACL MC 2. Avanstar 100m Select one (1 or 2, q to quit). Enter the appropriate choice: 1 or 2. Enter 1 for either an ACL MC or an ACL MC+ board. 9a. 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). 9b. 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 inappropriate selection, you'll be reminded of the acceptable choices. 9c. Appears for a Micro Channel board only: What I/O address is board X to use? (0000, 0800, 0C00, 1000, 1400, 1800, 1C00, 2000) If the board is an ACL MC, or if it is an Avanstar 100m which did not require an I/O address to be selected with the Reference diskette, you must enter 0000. Otherwise, enter the choice that matches the I/O address you configured with the Reference diskette. 10. 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. 11. Appears for all boards: What memory address is board X to use? Enter the hexadecimal dual port boundary address, following the guidelines in Section A. For an EISA bus board or a Micro Channel bus board, make sure you select the value you chose for the system configuration. If the value is not on the correct boundary, you will be reminded to choose a value on the correct boundary. 12. 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 7 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. 13. 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 8 through 13 for any additional boards you are adding. If you type n, the software will repeat the entire series of questions for board 1 (Steps 8 through 13). NOTE: If you later wish to change the driver parameters of the board(s) or wish to add or remove board(s), you can easily do so using the menu-driven configuration program described in Chapter II. 14. The screen then indicates that the operating system is being rebuilt. When the rebuilding is complete, the screen will display: Installation of was successful. If you are installing additional software now, you may do so. Otherwise, exit the installation by pressing q If you used sysadm to perform the installation, you may return to the main menu and select: machine shutdown Set the number of seconds to shutdown and save the form. D. How to Reboot the System 15. To complete installation, the system must be shut down. Type: shutdown -g0 -y 16. When the shutdown is complete, the screen will display: The system is down. Reboot the system now. 17. Remove the ACL/Avanstar Family UNIX Device Driver diskette from the disk drive. 18. Reboot the system by pressing simultaneously: . 19. Follow the on-screen instructions to complete the reboot. Software loading is now complete. Continue to the next section to set up ports for log-in terminals and other devices. NOTE: An unsuccessful download will result in an error message, described in Chapter IV-Troubleshooting. Messages are also stored in /etc/acl/acl.log. E. Serial Device Names and Port Setup Information HOW TO SPECIFY AN ACL/Avanstar FAMILY DEVICE NAME Device names are used to configure each port on the ACL/Avanstar Family of 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 Once you have chosen the proper device names, check for the setup instructions based on the application (see the next page). 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. LOG-IN TERMINAL - For details on how to set up a log-in terminal, please use the instructions in section F. The steps describe how to adjust baud rate, change the number of data bits and enable ports for log-in terminals. TRANSPARENT PRINT FUNCTION - For information on how to set up a port for a terminal with a printer attached, please follow the instructions in section G. MODEM - Set up an ACL/Avanstar Family board port for a modem as you would a COM port, but use an ACL/Avanstar Family board device name. For information on setting up a modem, see your operating system manuals. If you need information on setting up modems requiring RTS and CTS flow controls, see Appendix II. MOUSE - For information on setting up a mouse, see your operating system manuals. If you need to adjust the packet size to work with the mouse (or any other peripheral requiring adjustments), see Appendix III. PRINTER - Set up an ACL/Avanstar Family board port for a printer as you would a COM port, but use an ACL/Avanstar Family board device name. For details on setting up a printer, consult your operating system manuals. F. How to Set Up Log-in Terminals Before enabling a port for a log-in terminal, check the /etc/ttydefs file to make sure that the parity, number of bits per character and baud rate correspond to the settings of the terminal which will be connected. Invoke the editor and make any modifications necessary to the ttydefs file, as described below. EXAMPLE: How to Set Up Terminals for 8 Data Bits, 1 Stop Bit, No Parity As shipped, the /etc/ttydefs file is set up for: 7 data bits 1 stop bit even parity If you want to run your terminals at another common terminal setting-8 data bits, 1 stop bit and no parity-follow these steps: 1. Boot the system and log in as root. 2. Invoke the editor for the /etc/ttydefs file. 3. Locate the paragraphs starting with the baud rates you plan to use. To change from seven to eight data bits, edit the cs7 in each paragraph to: cs8 4. To invoke no parity, edit parenb in the same paragraphs to: -parenb EXAMPLE: Change the line for 9600 baud to (changes are in bold): 9600: b9600 opost onlcr tab3 ignpar ixon ixany -parenb istrip echo echoe echok icanon isig cs8 cread : b9600 opost sane onlcr tab3 brkint ignpar ixon ixany -parenb istrip echo echoe echok icanon isig cs8 cread ::4800 5. Now write the changes and exit the editor. Then enable the ports for your terminal using the steps that follow. Refer to the operating system manuals for more information. INTRODUCTION TO ACL/Avanstar FAMILY PORT FUNCTIONS Login access through ACL/Avanstar Family board ports is provided using the Service Access Facility. A ttymon type port monitor called acl is added and enabled when the driver is installed. The login port services axx are services for each port which are added and disabled when the driver is installed. If you have sysadm, you may use the functions provided under ports -- > port-monitors and ports --> port-services to manage these. Alternatively, you may use the functions provided with the ACL/Avanstar Family driver described below. HOW TO ENABLE A LOG-IN PORT FOR A LOG-IN TERMINAL 1. Boot the system and log in as root. 2. Execute the ACL/Avanstar Family enable program to enable a port. Type at the root prompt: /etc/acl/enable 3. The screen will display a listing of the ACL/Avanstar Family board ports that are currently disabled. 4. Enter the names of ports you wish to enable. Repeat this step to enable more ports. EXAMPLE: To enable the first port on the first ACL/Avanstar Family board installed, type: ttya00 Refer to the operating system manuals for more information. HOW TO CHANGE THE INITIAL BAUD RATE FOR A LOG-IN TERMINAL 1. Boot the system and log in as root. 2. Execute the ACL/Avanstar Family setspeed program to change the initial baud rate. Type: /etc/acl/setspeed 3. Enter the appropriate port and speed when prompted. HOW TO DISABLE A PORT FOR A LOG-IN TERMINAL 1. Boot the system and log in as root. 2. To disable a port, type at the root prompt: /etc/acl/disable 3. The screen will display a listing of the ports that are currently enabled. 4. Enter the names of ports you wish to disable. EXAMPLE: To disable Port 1 on the first ACL/Avanstar Family board installed, type: ttya00 5. Repeat Step 4 to disable more ports. For details on setting up ports for terminals, see your Operating System manuals. G. How to Use a Port for the 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. 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: 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 the 16 port boards only. EXAMPLE: The line for port 2 on the first board installed 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 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 DC4 or T (20 in decimal). 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 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) a. SWITCH TO INTERRUPT-DRIVEN OPERATION. (polled mode option) or b. SWITCH TO POLLED OPERATION. (interrupt mode option) 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 MCA or 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 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 MCA or 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) 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 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 FAMILY 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. ACL II/II+ 3. ACL IIR/IIR+ 4. ACL 16/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: Installing board X. What kind of board is the board? 1. ACL MC 2. Avanstar 100m Select one (1 or 2, q to quit). Enter 1 or 2, making sure your selection matches the type of adapter board you are adding. Enter 1 for either an ACL MC or an ACL MC+ board. 3a. 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. 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 (SCO 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 3b. Appears for an Avanstar 100i board only: What I/O address is board X to use? (200, 208, 300, 308,600,608, 700, 708) Enter the appropriate choice, making sure your selection matches the hardware setup selected by the switches. 3c. Appears for a Micro Channel board only: What I/O address is board X to use? (0000, 0800, 0C00, 1000, 1400, 1800,1C00, 2000) If the board is an ACL MC, or if it is an Avanstar 100m which did not require an I/O address to be selected with the Reference diskette, you must enter 0000. Otherwise, enter the choice that matches the I/O address you configured with the Reference diskette. 4. Appears for 8 port ACL family ISA 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 all boards: 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. For an EISA bus board or a Micro Channel bus board, make sure you select the value you chose for the system configuration. If the value is not on the correct boundary, you will be reminded to choose a value on the correct boundary. 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 Types IRQ Choices ACL 3 4 5 6 7 9* ACL II/II+ 3 4 5 7 9 10 11 12 15 ACL IIR/IIR+ 3 4 5 7 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 7 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 30), then add the new board (page 26). 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: Line 1 appears only for MCA and 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 selection and 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 driver configuration, see the section entitled "How to Rebuild and Reboot a New Kernel" below for instructions on installing the new configuration and performing a reboot. HOW TO REMOVE A BOARD 1. When you select 5) delete board from the main menu, the screen will ask you 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. HOW TO REBUILD AND REBOOT A NEW KERNEL When you are satisfied with your software value selections for every board, follow these steps: 1. Exit the configuration program by typing: q 2. When you exit the config program, changes are made to the kernel configuration and the kernel is rebuilt. The screen will display messages describing the status of the kernel. 3. Reboot the system by typing: cd / shutdown -g0 -y Follow the on-screen prompts to complete the procedure. Then see Sections E through G in Chapter I for information on setting up ports. An unsuccessful download will result in an error message (see Chapter IV- Troubleshooting). Such messages are also stored in /etc/acl/acl.log. III. How to Remove the ACL/Avanstar Family Driver You can completely remove the driver from the system by following the procedure on this page. NOTES: If you are installing an upgrade of the ACL/Avanstar Family System V Release 4 Device Driver, first follow these steps to remove the previous version. The removal process removes the following directories and their contents /etc/acl /sbin/acl /etc/conf/pack.d/acl 1. Type: pkgrm Or, if you have and prefer to use the sysadm program, type sysadm Select software Select remove Set package name(s) to be removed to: acl Save the form and follow the onscreen directions. 2. Select acl and follow the on-screen instructions to complete the removal and reboot the system. 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 Family 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 ACL/Avanstar Family 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 sysadm (if used), and run the ACL/Avanstar Family 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 bus board again with the configuration software if necessary and reboot to install the new kernel. (See Chapter II for help with the ACL/Avanstar Family 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 Family driver, or the ACL/Avanstar Family driver device node (/dev/acl) does not exist. The ACL/Avanstar Family boards will not be properly initialized, and no communications with any device attached to the ACL/Avanstar Family board will take place. SOLUTION: Boot the proper kernel or reload the ACL/Avanstar Family 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 or the software configuration for an ACL MC+ (or for an Avanstar 100m that requires I/O address selection) 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 driver installation. For example, the hardware switches are set for 300, but the driver is set for 700.  Your 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.  For an ACL MC+ board (or for an Avanstar 100m that requires I/O address selection), the I/O address selected with the Reference diskette does not match the value entered duringdriver installation. If the Avanstar 100m does not require I/O address selection with the Reference diskette, then 0000 must be entered for the I/O address selection during driver configuration. Another possible cause might be that the 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 driver 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 CAUSE: Can be any of a number of possible causes. SOLUTION: Write down the message, use the Tech Support Checklist on page 38, and call Star Gate Tech Support at 1-800-STAR GATE (1-800-782-7428). ACL/Avanstar FAMILY BOARD PORT USAGE PROBLEMS Symptom: No data comes out of an ACL/Avanstar Family board port, and the process that writes data to the port is not completed. 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 system configuration (for EISA or Micro Channel boards) does not match the IRQ selected during the driver configuration. SOLUTION: Use the ACL/Avanstar Family status program (/etc/acl/stat) to check the status of the board and the current driver-configured IRQ value. (See page 37 for information on the ACL/Avanstar Family 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 installation 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 Family board port, but the process is completed. 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 Family 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 ttydef entry or select a different entry (default ttydef entry at installation is 9600 for all ACL/Avanstar Family board ports). For a printer, you may need to alter the 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 64A2 (Present,Started,Interrupts On) 1 ? 3 0xd0000 64 1(Not Present) 2 ? 0 0 0 0(Not Configured) 3 ? 0 0 0 0(Not Configured) The status bits can be interpreted as follows: 0 (Not Configured) -board may or may not be installed, but it isn't driver-configured. 1 (Not Present) -board is not physically installed, but it is driver- configured. 22 (Present, Started) -board is present, but it is not configured correctly. 62 (Present, Started, Intr On) -board is present, and it is in interrupt mode. A2 (Present, Started, Poll On) -board is present, and it is in polled mode. 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 bus 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 Family driver installation:  I/O address (if it's a Micro Channel or 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 Family 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, Interactive UNIX  What is the version of the operating system? EXAMPLE: 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 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 ACL II or ACL II+ board installed 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 ENABLE RTS AND/OR CTS FLOW CONTROLS INTRODUCTION If you have a modem requiring the RTS and/or CTS handshaking signals of the EIA-232 interface, you must set up the ACL/Avanstar Family UNIX Device Driver to use these flow controls. With RTS flow control, if the host PC sees that its input buffer is nearly full, it will lower the RTS line. The serial device should then stop sending, and wait for the host to catch up. The host will raise the RTS line when it is ready for more data. With CTS flow control, the serial device asserts the CTS line when it is ready to receive data. If the CTS line goes low, then the host PC will stop sending data until CTS goes high again. SETTING RTS AND CTS FLOW CONTROL FROM THE COMMAND LINE The Unix stty command is used to enable and disable RTS and CTS flow control from the command line. For example: To enable RTS flow control on the current terminal, type: stty rtsxoff To enable RTS and CTS flow control on /dev/ttya00, type: stty rtsxoff ctsxon < /dev/ttya00 To disable RTS and CTS flow control on /dev/ttya12, type: stty -rtsxoff -ctsxon < /dev/ttya12 SETTING RTS AND CTS FLOW CONTROL FROM A PROGRAM To select RTS and CTS flow control, you can also make an ioctl() function call and use the termiox structure in a program. See your Unix system manuals for information on ioctl() and termiox. EXAMPLE: The following "C" program selects RTS and CTS flow control: #include #include #include int fd; struct termiox x; . . . fd = open ("/dev/ttya00", O_RDWR | O_NDELAY ); ioctl (fd, TCGETX, &x ); x.x_hflag |= (RTSXOFF | CTSXON ); ioctl (fd, TCSETXW, &x ); . . APPENDIX III 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-the value set by earlier versions of this driver. 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, 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: /etc/acl/ttyinit NOTE: This file will also be executed each time the kernel is booted. APPENDIX IV 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 V 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. For example: 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 #include int fd; struct termio t; . . . fd = open("/dev/ttya00", O_RDWR|O_NDELAY); ioctl(fd, TCGETA, &t); t.c_cflag = (t.c_flag & ~CBAUD) | B50; ioctl(fd, TCSETAW, &t); . . . 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 UNIX System V.4 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.