Ö· ·Ö Ö· Ö· Ö· ÖÒ· Ö· Ö· Ƕ ºº Ƕ ºº Ó· º Ƕ ǽ ½Ó Ó/ ½Ó ½Ó Ó½ Ð ½Ó ½Ó ÖÒ· Ö· Ò· Ö· Ö· ºÐº Ó· ºº ºº Ó· ½ Ð Ó½ н Ó½ Ó½ Avanstar Family Device Driver for PC- or MS-DOS Software Installation Guide 650118-03 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. CONTENTS Chapter 1 Driver Installation.................... 1 1.1 Introduction................................... 1 1.2 Installation................................... 1 1.2.1 Installation on EISA Bus Systems....... 2 1.2.2 Installation on ISA Bus Systems........ 3 1.2.3 Installation on MCA Bus Systems........ 4 Chapter 2 Naming and Configuring Avanstar Ports.......... 5 2.1 Using AVXMODE to Configure a Port.............. 5 2.1.1 Line Settings.................................. 6 Flow Settings.................................. 7 Chapter 1 Driver Installation 1.1 Introduction The diskette that comes with this manual contains the AvanstarTM family DOS device driver and the support software for its configuration and use. This driver provides the interface between an ISA (Industry Standard Architecture), EISA (Extended Industry Standard Architecture), or Micro ChannelTM bus computer and up to four Avanstar family adapters. At this time, the driver supports the following Avanstar adapters: Avanstar Xe (100e) (EISA bus adapter) Avanstar Xi (100i) (ISA bus adapter) Avanstar Xm (100m) (Micro Channel adapter) 1.2 Installation Follow these steps to install the Avanstar DOS device driver: 1. Copy the files on the driver diskette to a directory on the system fixed disk drive. In the examples that follow, we will assume that the contents of the driver diskette were copied to the directory C:\AVX. 2. Edit the system CONFIG.SYS file to add the appropriate DEVICE= line. This line is specific to the type of installation being performed (EISA/ISA/MC). Refer to the appropriate section in this manual for the proper syntax of the DEVICE= line. 3. Reboot the system. You now have access to all installed Avanstar ports. 1.2.1 Installation on EISA Bus Systems 1. Install the Avanstar Xe (100e) board(s) by following the instructions in the Avanstar Family Hardware Installation Guide. 2. Configure the board with the EISA configuration utility and the CFG file on the Option Configuration diskette. Note that EISA boards do not have any hardware settings. The default driver installation will allow access to all ports on the first four Avanstar Xe (100e) boards that the driver encounters in the system. The driver finds the first four boards by searching each EISA system slot- starting with slot 1-until either four boards are found or the maximum of sixteen EISA system slots have been searched. In this default scenario, the first port on the first board will be named COM3, and each succeeding port on each succeeding board will have a COM name incremented by one. For instance, in a system with two installed Avanstar Xe (100e) boards-each connected to a 16-port panel- the first port on the first board will be named COM3, the first port on the second board will be named COM19, and so on. For a default installation, place the following line in the CONFIG.SYS file: DEVICE=C:\AVX\AVXE.SYS There is also the option of beginning the port naming with a name other than COM3. To do so use the following line in the CONFIG.SYS file instead of the line shown above: DEVICE=C:\AVX\AVXE.SYS /CN=x where x is a number between 1 and 5 inclusive. For example, if the number specified was 5, port naming would begin with COM5. 1.2.2 Installation on ISA Bus Systems Before installing an Avanstar Xi (100i) board, set the switches for the I/O address by following the instructions in the Avanstar Family Hardware Installation Guide. The default driver installation will allow access to all ports on the first four Avanstar Xi (100i) boards that the driver encounters on the system. The driver finds the first four boards by searching each possible I/O location that an Avanstar Xi (100i) board could have its I/O register located at until either four boards are found or the maximum of eight I/O addresses have been searched. In this default scenario, the first port on the first board will be named COM3, and each succeeding port on each succeeding board will have a COM name incremented by one. For instance, in a system with two installed Avanstar Xi (100i) boards-each connected to a 16-port panel- the first port on the first board will be named COM3, the first port on the second board will be named COM19, and so on. For a default installation, place the following line in the CONFIG.SYS file: DEVICE=C:\AVX\AVXI.SYS There are two options available to ISA installations. The first is the capability of beginning the port naming with a name other than COM3. The second is the ability to locate the installed board(s) dual port RAM at a location other than the default of D0000h. To do so, use the following line in the CONFIG.SYS file instead of the line shown above: DEVICE=C:\AVX\AVXI.SYS /CN=x,DP=y x can be any number between 1 and 5 inclusive. For example, if the number specified is 5, port naming would begin with COM5. y is a 5-digit hex number between A0000 and F0000 where you want the dual port RAM to be located. The dual ports of multiple Avanstar Xi (100i) boards may occupy 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. It is not necessary for both sets of parameters to be specified. If you want only to change the port naming, omit the DP=y from the line shown above, for instance. 1.2.3 Installation on MCA Bus Systems 1. Install the Avanstar Xm (100m) board(s) by following the instructions in the Avanstar Family Hardware Installation Guide. 2. Configure the board with the configuration utility on the Reference diskette and the ADF file on the Option Configuration diskette. Note that Micro Channel boards do not have any hardware settings. The default driver installation will allow access to all ports on the first four Avanstar Xm (100m) boards that the driver encounters on the system. The driver finds the first four boards by searching each MCA system slot- starting with slot 1-until either four boards are found or the maximum of eight MCA system slots have been searched. In the default scenario, the first port on the first board will be named COM3 and each succeeding port on each succeeding board will have a COM name incremented by one. For instance, in a system with two installed Avanstar Xm (100m) boards-each connected to a 16-port panel-the first port on the first board will be named COM3, the first port on the second board will be named COM19, and so on. For a default installation, place the following line in the CONFIG.SYS file: DEVICE=C:\AVX\AVXM.SYS There is also the option of beginning the port naming with a name other than COM3. To do so use the following line in the CONFIG.SYS file instead of the line shown above: DEVICE=C:\AVX\AVXM.SYS /CN=x where x is a number between 1 and 5 inclusive. For example, if the number specified was 5, port naming would begin with COM5. Chapter 2 Naming and Configuring Avanstar Ports 2.1 Using AVXMODE to Configure a Port The AVXMODE utility is used to change line and/or flow control settings for a specific Avanstar port. Configuration changes made with AVXMODE are valid until the next time the computer is booted or the configuration is changed again with AVXMODE. At system boot time, the port configuration reverts to its default state. The AVXMODE command line has the following form: AVXMODE port:baud,parity,databits,stopbits [,flow] where port is the name of the port to be configured. The positional parameters (baud, parity, data bits and stop bits) must be entered in the order specified above. The flow parameters may be entered in any order, separated by commas. To view the current settings for a port, simply omit all parameters from the command line. The following command line: AVXMODE COM3 displays the current line and flow settings for port COM3. To configure line settings, place the desired values in the proper parameter positions. This command line: AVXMODE COM7:9600,N,8,1 sets line settings for port COM7 to 9600 bits per second, no parity, 8 data bits, 1 stop bit. If any parameter is omitted, its current value is retained. For instance, in the following command line: AVXMODE COM7:,,8 the data bits configuration for port COM7 is set to 8, but all other line and flow settings remain the same. Flow parameters consist of a tag followed by an "=" and ended with a parameter value. In the command line: AVXMODE COM5:,,,,IXON=ON,DTR=OFF Automatic Transmit Flow Control is set to ON, while DTR Enable mode is set to OFF for port COM5. Note that the order in which flow parameters are specified on the command line is not significant. The command line below functions identically to the command line shown previously: AVXMODE COM5:,,,,DTR=OFF,IXON=ON Sections 2.1.1 and 2.1.2 describe possible line and flow settings that can be established with AVXMODE. 2.1.1 Line Settings baud Valid baud rate settings are dependent upon the particular type of Avanstar board that is installed. Most common baud rate settings are supported. See the Avanstar Family Technical Reference Manual for board-specific information of this type. The initial baud rate is 1200. parity Valid parity settings are N (none), O (odd), E (even), M (mark) or S (space). The initial parity setting is E (even parity). databits Valid data bit settings are 5, 6, 7 or 8. The initial number of data bits is 7. stopbits Valid number of stop bits is 1 or 2. The initial number of stop bits is 1. 2.1.2 Flow Settings DTR This specifies the DTR enable state. Valid values are ON and OFF. When DTR=ON, the DTR output will be asserted as long as the port is open. When DTR=OFF, the DTR output will always be in the negated state. The initial setting is OFF. OCTS This specifies output handshaking using CTS state. Valid values are ON and OFF. When OCTS=ON, the port will not transmit data unless the CTS input is asserted. When OCTS=OFF, the state of the CTS line has no effect on data transmission. The initial setting is OFF. RTS This specifies RTS enable state. Valid values are ON, OFF, HS, and TOG. When RTS=ON, the RTS output will be asserted as long as the port remains open. When RTS=OFF, the RTS output will always be in the negated state. When RTS=HS, the RTS output will be asserted when the port is ready to receive data and negated when the port is not ready to receive data for any reason. The initial setting is OFF. When RTS=TOG, the RTS output will be asserted as long as there is data in the transmit buffer. IXON This specifies transmit XON/XOFF handshaking. Valid values are ON and OFF. The initial value is OFF. When IXON=ON, the driver will transmit data until the XOFF character is received. Transmission continues upon reception of the XON character. When IXON=OFF, the driver does not respond to XON/XOFF characters when received. IXOFF This specifies receive XON/XOFF handshaking. Valid values are ON and OFF. The initial value is OFF. When IXOFF=ON, the driver will transmit an XOFF character when the receive buffer is full. When more data can be received, the driver will transmit an XON. RXTO This specifies the receive timeout state. When RXTO=ON, the driver uses the standard MS-DOS timeout of approximately 1 second and then returns if the request is not complete. When RXTO=NW (No-Wait), the driver returns immediately whether the request is completed or not. When RXTO=INF (Infinite), the driver will never return until the request has been completed. The initial setting is ON. (For systems with configurable external panels only) INT This specifies the communication interface type. When INT=232, the configurable external panel interface will be set to EIA-232 mode. When INT=422, the interface will be set to EIA-422 mode. The initial state is EIA- 232.