Ö· Ö· Ò Ç¶ º º ½Ó Ó½ ÓÄ Ö· ·Ö Ö· Ö· Ö· ÖÒ· Ö· Ö· Ƕ ºº Ƕ ºº Ó· º Ƕ ǽ ½Ó Ó/ ½Ó ½Ó Ó½ Ð ½Ó ½Ó Ò Ò· ÖÒ· Ö· Ò ·Ö º Ƕ ºÐº Ƕ º Ó· Рн ½ Ð ½Ó Ð ½Ó ACL/Avanstar Streams Device Driver Version 1.0 for AIX Version 4.1.X Software Installation Guide 650168-02 CONTENTS Chapter 1 Driver Installation................................. 1 1.1 Introduction........................................ 1 1.2 Choosing Hardware and Software Values............... 1 1.3 How to Load Software from the Diskette.............. 4 Using SMIT.......................................... 5 1.3.2 Using Install Manager......................... 5 1.4 Entering Software Driver Parameters................. 6 1.5 Serial Port Setup Information....................... 8 1.6 How to Set Up Log-in Terminals...................... 9 Chapter 2 How to Reconfigure the ACL/Avanstar Driver..........10 2.1 Introduction........................................10 2.2 Unconfiguring the Driver............................10 2.3 Reconfiguring the Driver for ISA Bus Boards.........11 Chapter 3 How to Remove the ACL/Avanstar Driver...............12 Chapter 4 Troubleshooting.....................................13 4.1 Introduction........................................13 4.2 digi_stat...........................................13 4.3 digi_test...........................................14 Appendix A How to Enable RTS and/or CTS Flow Controls..........15 A.1 Introduction........................................15 A.2 Setting RTS and CTS Flow Control from SMIT..........15 A.3 Setting RTS and CTS Flow Control from the Command Line........................................15 A.4 Setting RTS and CTS Flow Control from a Program.....16 Appendix B Changing the Interface Type on the Configurable External Panel......................................17 Appendix C How to Use Extended Baud Rates......................18 C.1 Introduction........................................18 C.2 Setting Extended Baud Rates from the Command Line...18 C.3 Setting Extended Baud Rates from a Program..........19 c Digi International, Inc. 1995 All Rights Reserved All brand and product names are trademarks or registered trademarks of their respective holders. Digi International Inc. 6400 Flying Cloud Drive Eden Prairie, MN 55344 Information in this document is subject to change without notice and does not represent a commitment on the part of Digi International, Inc. Digi International provides this document "as is", without warranty of any kind, either expressed or implied, including, but not limited to , the implied warranties of fitness or merchantability for a particular purpose. Digi International may make improvements and/or changes in this manual or in the product(s) and/or the program(s) described in this manual at any time. This product could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes may be incorporated in new editions of the publication. Chapter 1 Driver Installation 1.1 Introduction The ACL/Avanstar family AIX Streams device driver diskette contains the ACL/Avanstar family AIX Streams device driver and support software for its configuration and use. The driver provides the interface between an ISA or a Micro Channel bus computer and up to four ACL/Avanstar boards. During installation, you link the ACL/Avanstar device driver into the AIX kernel and set up ports. Afterward, at power-up, the host PC automatically sets up the interface to the ACL/Avanstar board(s). This driver supports serial ports for terminals, modems, and line printers. The Digi International ACL/Avanstar family of serial communication boards that are supported under AIX includes the ACL II+, ACL MC+, Avanstar Xm*, and the Avanstar Xi*. The ACL II+ EIA-232 ports are always DTE configured. 1.2 Choosing Hardware and Software Values This section is not applicable to Micro Channel bus boards because the driver sets them up automatically. If you have a Micro Channel bus board, go to section 1.3 to begin driver installation. Listed below are the ACL/Avanstar driver parameters and some guidelines for choosing values for ISA bus boards. Record your selections so you can:  make sure that your selections do not conflict with that of any other devices installed.  set ISA bus board hardware parameters to match the device driver software settings. * Note that the Avanstar family boards have been renamed. Any Avanstar board designed for a Micro Channel bus system is now an Avanstar Xm. Any Avanstar board designed for an ISA bus system is now an Avanstar Xi. The "X" in a product name denotes the number of serial ports (either 8 or 16) that are supported by the board, while the lower-case letter indicates the bus architecture that a board is designed for (m=Micro Channel, i=ISA). 1. I/O ADDRESS RECOMMENDATIONS Choose an I/O address for each ISA bus board. Each board must use a unique range-a range not used by any other device in the host computer. 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 __________ The following addresses are also available for the Avanstar Xi: 208-20F for board __________ 308-30F for board __________ 608-60F for board __________ 708-70F for board __________ 2. DUAL PORT SIZE The ACL II+ board is available with either a 16K or a 64K dual port. You can not change the dual port size of this board because it is set by hardware, but you must record what size you have in order to properly install the driver. 16K bytes (ACL II+, Avanstar Xi) ______ 64K bytes (ACL II+) ______ 3. DUAL PORT MEMORY ADDRESS RECOMMENDATIONS We recommend a location of 0x040000, an area often-though not always-free of conflicts with system memory or with non-ACL/Avanstar devices. For other locations, see your board's hardware installation guide and the following table:  The dual port must be installed within the first megabyte of the host computer's memory space.  ACL/Avanstar boards cannot share address space with each other or with non-ACL/Avanstar boards. Therefore, each ACL/Avanstar board must have a unique address range for its dual port. Choose a memory address for the dual port. Board 1 __________ Board 3 __________ Board 2 __________ Board 4 __________ 4. INTERRUPT ASSIGNMENT RECOMMENDATIONS Each ACL/Avanstar board must be assigned a unique IRQ to ensure proper operation. The IRQ(s) assigned to any ACL/Avanstar boards must not be used by any other device in the system. The following table lists what IRQs are supported by each board: Board IRQ Choices ACL II+ 3 4 5 9 10 11 12 15 Avanstar Xi 3 4 5 9 10 11 12 15 For ISA bus boards, we recommend IRQ 5, a setting relatively free of conflicts. Choose an IRQ for each board installed: Board 1 __________ Board 3 __________ Board 2 __________ Board 4 __________ 5. BOARD CONFIGURATION Before installing an ISA bus board, follow the instructions in the hardware installation guide to set the switches for the I/O address you selected in step 1. For an ACL II+ board, also set the switches for the IRQ you selected in step 4. (The Avanstar Xi does not use switches to set the IRQ level.) 6. Proceed to section 1.3 to begin driver installation. 1.3 How to Load Software from the Diskette CAUTION Before loading the device driver, make sure all other users are logged off your computer system. NOTES 1. If you are reinstalling the ACL/Avanstar AIX device driver, you must first remove the current device driver. Refer to Chapter 3 for instructions on removing the device driver. 2. Before loading the device driver, make sure the ACL/Avanstar board is installed and connected to an external panel. There are two device driver diskettes that are shipped with each controller. One diskette supports versions 4.1.1 and 4.1.2 of AIX, and the other diskette supports versions 4.1.3 and above of AIX. If you are unsure what version of AIX you are running, you can use the /usr/bin/oslevel command from the command line to find out, and then use the correct diskette when following the instruction in step 2 of section 1.3.1 or step 2 of section 1.3.2 of this manual. 1. Log in as root. 2. Use the Application Manager to select System_Admin. 3. To continue the installation process, use either SMIT (System Management Interface Tool) or the Install Manager. 1.3.1 Using SMIT 1. Double click on the SMIT icon. 2. Insert the AIX device driver diskette into the floppy drive. 3. Select "Software Installation and Maintenance". 4. Select "Install and Update Software". 5. Select "Install/Update Selectable Software (Custom Install)". 6. Select "Install Software Products at Latest Level". 7. Select "Install New Software Products at Latest Level". 8. Enter the floppy drive (e.g., "/dev/fd0") in the field "INPUT device/directory for software." 9. Click the "Do" button. 10. Click the "Do" button on the next screen also. 11. When a prompt to continue appears, select "OK". See section 1.4 for instructions on configuring the device driver. 1.3.2 Using Install Manager 1. Select the Install Manager. 2. Insert the AIX device driver diskette into the floppy drive. 3. In the "Which Software Source Would You Like to Choose?" box, select the floppy drive (e.g., "fd0 (Diskette 0)"). 4. After a couple of seconds you should see a listing for "digi" in the "Work Area." Select it by highlighting it. 5. In the "Actions" box, double click the "Install/Update" icon. The Install Manager will then prompt you if you wish to continue. 6. When the Install Manager has completed the installation, it willprompt you to either "View Log" or "OK". Select "View Log" to see if the device driver was successfully installed or not. 7. Select "OK" to run Install Manager and then exit. Double click on the "SMIT" icon in the System_Admin group, and see section 1.4 for instructions on configuring the device driver. 1.4 Entering Software Driver Parameters Once the driver is loaded, it must be configured. NOTES 1. To configure the driver for a Micro Channel board, all you need to do is to correctly power-down the system and then follow the instructions in section 1.5 to set up the serial ports. 2. To configure the driver for an ISA bus board, continue to use SMIT by following the instructions beginning with step 1 below. 1. Click once on the push button next to the "Devices" item. 2. Scroll down the list of items to find "ISA Devices" and click once on that item. 3. Click once on the "Add ISA Adapter" push button. 4. SMIT will display a list of ISA bus adapters that can be added. There should be two Digi entries: "isa Digi ACL II+" and "isa Digi Avanstar Xi". Click the type of board you wish to add. 5. SMIT will prompt you for a Parent Device. Select the ISA bus board as the Parent Device by clicking on it. 6. SMIT will display all of the parameters for the board. For the ACL II+, this includes: ISA Interrupt Level (IRQ) Bus I/O Address Dual Port Memory Address Dual Port Memory Size External Panel Type (EIA-232 or EIA-422) For the Avanstar Xi, this includes: ISA Interrupt Level (IRQ) Bus I/O Address Dual Port Memory Address Change the default values displayed to the ones that were chosen in section 1.2 of this chapter. To change an entry, you can either click on it and enter it manually, or you can click on the "List" push button next to it and select the item wanted. 7. Click the "Do" button to set up the board. If there is a problem in setting up the board, SMIT will display it. This will typically mean that there is an IRQ conflict or dual port conflict. Check your other devices in the system to confirm this, and then select a different value for the Interrupt level or dual port address and try again. 8. The message "digix Available" should appear to indicate a successful installation, where x in digix is the current number of Digi adapters installed minus one. Click on the Done button. Then click on the Cancel button. 9. If you wish to add other boards, repeat steps 3-8 as necessary. When you are done, follow the instructions in section 1.5 to set up the serial ports. 1.5 Serial Port Setup Information 1. Select "Cancel" from SMIT to get back to the "Devices" screen. Click on the "TTY" push button. 2. Click the "Add a TTY" button. 3. SMIT will display a box with several items. Click on either "tty rs- 232" or "tty rs-422" depending on what you would like to add. Depending upon the type of external panel attached to the board, both options may not be available. 4. SMIT will prompt you for a Parent Adapter. Choose the external panel associated with the Digi adapter you wish to add the port to. 5. SMIT will display a screen with all of the parameters that can be set up for that TTY. This includes things such as parity, stop bits, baud rate, and flow control. Be sure to set the parameters for the correct port number on the external panel. 6. Click on "Do." If the operation was successful, the message "TTYx now available" will appear. The x in TTYx is the number of the TTY. 7. Click on "Done" and then "Cancel" to get back to the TTY SMIT screen. 8. Repeat steps 2-7 to set up all of the TTYs you wish to use. Follow the instructions in section 1.6 if you wish to set up log-in terminals. 1.6 How to Set Up Log-In Terminals You can set up a TTY to be login-enabled in three ways: 1. When you add the TTY, there is a parameter called "enable LOGIN". By default it is set to "disable". Set it to "enable" when you add the TTY. 2. From the TTY's SMIT screen (Devices/TTY), click on "Change/Show Characteristics of a TTY." Click on the TTY you wish to change. SMIT will display the current parameters for that TTY. Change the "enable LOGIN" value to "enable." Click on "Do." 3. Use the Application Manager to locate the Device Manager. The Device Manager is in the same group (the System_Admin group) as the Install Manager and SMIT. Locate the TTY you wish to change. Use the right mouse button and select "Properties." This will put you directly into the SMIT screen as in step 2 above. Follow the same guidelines as in step 2. Chapter 2 How to Reconfigure the ACL/Avanstar Driver 2.1 Introduction The ACL/Avanstar driver can not be reconfigured for Micro Channel boards. For ISA bus boards, the driver must be unconfigured first before it can be reconfigured. 2.2 Unconfiguring the Driver 1. Use Device Manager, SMIT, or the troubleshooting utility digi_stat (described in Chapter 4) to determine whether the ACL/Avanstar board is in the Defined state or the Available state. If it is in the Available state, it must be unconfigured in order to change it to the Defined state. NOTE Unconfiguring the Digi adapter will also unconfigure the external panel that is attached to it. Each of the TTYs on the external panel will also be unconfigured as long as the TTY is login disabled prior to the unconfiguration process. 2. To unconfigure the board, activate the Device Manager. Then locate the board you wish to modify. Highlight it. Click on the "Off" (Black Light bulb) item in the "Action" box. Click on "Yes" to go on after a warning prompt. This should unconfigure the board, as well as the attached external panel and its TTYs. You will have to click an acknowledgement for each item that gets unconfigured. 2.3 Reconfiguring the Driver for ISA Bus Boards 1. Now that the Digi adapter is unconfigured, you can change its properties by using the right mouse button. Depress the right mouse button on the board's icon and hold it down. A menu dialog will offer a list of commands. Move the cursor, while still holding down the right mouse button, to the menu item "Properties" and then release the right mouse button. 2. A new dialog box should appear and list all of the current parameters that are set up for the board. Change the parameters you wish to change. Click on the "OK" button. 3. Configure the board by highlighting its icon and clicking on the "On" icon (lit light bulb) in the Actions box. If this action is unsuccessful, use the "view log" button to see what the problem is. If the message "Bus resources could not be resolved for a device" is in the error log, then the properties that you changed are in conflict with another device. Try another setting. Chapter 3 How to Remove the ACL/Avanstar Driver Before the ACL/Avanstar driver can be removed, all devices using the driver (the board and its ports) must be unconfigured. This can be done with the Device Manager as described in section 2.2 of Chapter 2. 1. After the board and its ports have been unconfigured, you can delete them with the Device Manager by depressing the right mouse button on the board's icon and holding the button down. Select "Delete" from the menu dialog and then release the right mouse button. A new dialog box should appear questioning whether you really want to delete the board and all of the devices attached to it. Select the "Yes" option to the dialog. The device and all of its children devices will then be deleted. Repeat the process until all of the Digi adapters are deleted. 2. Once all boards are deleted, run SMIT. Click on the push button "Software Installation and Maintenance." When a new screen appears, click on the push button next to "Maintain Installed Software." When another new screen appears, click on the "Remove Software Products" push button. 3. You should now be in the correct screen to remove the driver. To choose the Digi device driver to be removed, click on the "List" push button next to the "Software Name" line. A list of all the currently installed software products on your system should appear. Go down through the list until you locate "digi.tty.obj." Highlight it and select "OK." 4. On the "PREVIEW only?" line, use the up or down arrow to change it to "No." 5. On the "Remove dependent software?" line, use the up or down arrow to change it to "Yes." 6. Click on the "Do" push button to remove the driver from the system. If the attempt fails, this usually means that there is still a Digi adapter that has not been deleted from the system. Go back to the Device Manager to verify this. Chapter 4 Troubleshooting 4.1 Introduction If you are experiencing any problems with your ACL/Avanstar board, there are two utilities (digi_stat and digi_test) shipped with the driver to aid in problem determination. You must be logged in as "root" to run either program. 4.2 digi_stat The utility digi_stat will display two items: 1. what boards are supported by the driver 2. information about each supported board that the driver finds in the system. The following is a sample listing of what the output from digi_stat looks like: -------------------------------------------------------------------------------------------- Micro Channel ACL MC+ driver definitions supported. Micro Channel Avanstar Xm driver definitions supported. ISA ACL II+ driver definitions supported. ISA Avanstar Xi driver definitions supported. ------------------------------------------------------------------------------------------- Board Status IRQ DP Address DP Size I/O Address ------------------------------------------------------------------------------------------- ACL II+ Available 5 0x40000 0x4000 0x200 Avanstar Xi Available 11 0x44000 0x4000 0x208 -------------------------------------------------------------------------------------------- The Status field for a board displays the state of the board. If it is Defined, this means this board is not available to be used. This can happen two ways: 1. The board failed configuration at power-up. 2. The board was specifically unconfigured after a power up. If you believe that the status of the board should be Availablewhen it is Defined, this is usually the result of a conflict in IRQ, dual port, or I/O setting with another board in your system. digi_stat can be used to verify the hardware settings on an ISA bus board. Make sure that the hardware switch settings for an ISA bus board match what the software is set to. Refer to your hardware manual for specific information on setting these switches. digi_stat is placed in the /usr/sbin directory when the driver is installed. To execute it, you can type /usr/sbin/digi_stat from the command line or use the File Manager to locate it. 4.3 digi_test The utility digi_test will test a specific board or port without interfering with the other ports. It is placed in the /usr/sbin directory-along with digi_stat- when the driver is installed. digi_test will perform two tests: 1. The modem test will check the handshake lines on a port. 2. The crosstalk test checks a port's capability to transmit/receive characters. The port(s) being tested must not be in use. (It is suggested that you unconfigure the device attached to the port using the Device Manager prior to running any tests on the port.) In addition, a loop-back connector (Digi part number 799001-03) must be connected to the port(s). To execute digi_test, you can type /usr/sbin/digi_test from the command line or use the File Manager to locate it. Appendix A How to Enable RTS and/or CTS Flow Controls A.1 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 device driver to use these flow controls. With RTS flow control set, the host PC will lower the RTS line if the input buffer is nearly full. The serial device will then stop sending, and it will 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 set, the serial device asserts the CTS line when it is ready to receive data. If the CTS line goes low, the host PC will stop sending data until the CTS goes high again. A.2 Setting RTS and CTS Flow Control from SMIT See section 1.5 in Chapter 1 for information on how to do this. A.3 Setting RTS and CTS Flow Control from the Command Line The stty command can to be 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 the /dev/tty5, type: stty rtsxoff ctsxon < /dev/tty5  To disable RTS and CTS flow control on the /dev/tty3, type: stty -rtsxoff -ctsxon < /dev/tty3 A.4 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 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/tty4", O_RDWR | O_NDELAY); ioctl(fd, TCGETX, &x); x.x_hflag |= (RTSXOFF | CTSXON); ioctl(fd, TCSETXW, &x); . . . Appendix B Changing the Interface Type on the Configurable External Panel If you wish to change the interface type (EIA-232 or EIA-422) of a port on a configurable panel, you need to first delete the old TTY and then add a new TTY. This can be done either through SMIT or the Device Manager. Adding a TTY using SMIT is described in Chapter 1, section 1.5. Removing a TTY can be done through the same SMIT screen as adding a TTY, but you must select "Remove a TTY" instead of "Add a TTY." You use the Device Manager to delete a TTY in a fashion similar to deleting a Digi adapter: 1. Locate the TTY you wish to change and place the cursor on it. Depress the right mouse button and hold it down. 2. On the menu dialog that appears, select the Delete option and release the mouse button. Click on the Yes button on the confirmation dialog. The TTY will be deleted. You can add a TTY with the Device Manager using drag and drop techniques: 1. Make sure the icon for the external panel where the TTY you wish to change is located in the "Work Area" of the Device Manager. 2. In the "Template" area, click on the TTY Template Type icon, which looks like a video terminal. In the "Types" area of the "Templates" section, you can use the scroll bar on the right hand side to find "RS-232 Asynch Terminal on Digi Adapter" or "RS-422 Asynch Terminal on Digi Adapter." 3. Depress the middle mouse button on the icon of the terminal you want and hold it down. Drag the terminal icon to the external panel icon referred to in step 1 above and release the middle mouse button. You will then be prompted for more information similarly to the way SMIT sets up terminals. Appendix C How to Use Extended Baud Rates C.1 Introduction The ACL II+, Avanstar Xm, and the Avanstar Xi boards are capable of supporting baud rates up to 115.2K baud. (The ACL MC+ does not support extended baud rates.) Since AIX does not normally support these extended baud rates, support was added to the driver by redefining some standard baud rates less than 300 baud. NOTE If 57.6K baud is selected on a port of an ACL II+, then 57.6K baud must also be selected on the adjacent port. If 115.2K baud is selected on a port of an ACL II+, then 115.2K baud must also be selected on the adjacent port. C.2 Setting Extended Baud Rates from the Command Line The UNIX command stty can be 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 a /dev/tty3, type: stty 134 < /dev/tty3 C.3 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 AIX 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/tty3", O_RDWR | O_NDELAY); ioctl(fd, TCGETA, &t); t.c_cflag = (t.c_cflag & ~CBAUD) | B50; ioctl(fd, TCSETAW, &t); . . .