==================================================================== Release Notes DR Multiuser DOS Device Driver Version 1.0.0 for IntelliPort II and IntelliPort II EX Products March 1, 1993 P/N 0-27160 ==================================================================== ------------ Introduction ------------ This Release Note describes how to install IntelliPort II hardware and software on a Digital Research DR Multiuser DOS (MU-DOS) Version 5.0 or higher host system. Before you begin, review Chapter 1 of the Product User Guide for an overview of product features and operation. We recommend that you install the IntelliPort II hardware before the IntelliPort II software. +--------------------------------------------------------------+ | Important! To avoid damage to hardware, always turn off the | | power to the system before you plug or unplug IntelliPort II | | cables or components. | +--------------------------------------------------------------+ Computone and IntelliPort are trademarks of Computone Corporation. All other company and product names are trademarks or registered trademarks of their respective companies. --------------------- Hardware Installation --------------------- This section provides a brief version of the IntelliPort II hardware installation procedures. For more information, see the Product User Guide for your IntelliPort II product. System Dependencies The MU-DOS driver imposes the following dependencies: - You can install one controller in a system. This limitation is imposed by the DR MU-DOS SETUP utility. - Each IntelliPort II EXpandable controller supports up to 64 serial ports (IntelliPort II standard controllers support 4, 8, or 16 ports as appropriate). - IntelliPort II controllers use only polled operation under DR MU-DOS (no interrupts). Installing in an ISA System To install an IntelliPort II controller in an ISA host, follow these steps: 1. Disconnect the power to the ISA host system and any connected peripheral devices. Remove the system cover and expansion slot cover. 2. Set the base I/O address DIP switches on the IntelliPort II controller, as described in Chapter 2 and Appendix B of the Product User Guide. This assigns a block of eight I/O addresses to the controller. Write down the selected base I/O addresses in the Hardware Reference Log in the Product User Guide. Note: You can install up to 4 IntelliPort II controllers in a host system. However, you must assign a unique base I/O address to each controller. 3. Secure the controller in a 16-bit expansion slot. Write down the slot number in the Hardware Reference Log in the Product User Guide. 4. Replace the system cover. 5. Connect external concentrators or expansion boxes to the IntelliPort II controller, if any. 6. Reconnect any other peripheral devices disconnected in step 1. 7. Power on the system and any attached devices. Proceed to the section "Software Installation" for instructions on installing the IntelliPort II software drivers. Installing in an EISA System This section describes how to install ISA or EISA IntelliPort II controllers in an EISA host system. Since EISA configuration steps vary slightly from one EISA system to another, consult your EISA system documentation if you require clarification or additional information. Installation in an EISA host is a two-part process: configuring the system and then installing the controller. Configuring the EISA System To configure the IntelliPort II controller into your EISA system, follow these steps: 1. Insert your working copy of the EISA Configuration Diskette in the floppy drive and power on the system. 2. When the EISA Configuration menu appears, select the "Manual Configuration" option. (Do not select "Automatic Configur- ation".) From the next menu, select the "Copy Files from a Configuration Diskette" (or similar) option. 3. When prompted to do so, insert the Computone Option/Config- uration Diskette. If you have the option to copy a single configuration (.CFG) file, copy the file shown in the fol- lowing table whose description matches the controller that you have installed. Otherwise, the program copies all the files. The available files, and their descriptions, are as follows: File Controller !CTN0204.CFG ISA 4-port !CTN0208.CFG ISA 8-port !CTN0263.CFG ISA 16-port or EXpandable, if configured for 8-bit I/O !CTN0264.CFG ISA 16-port or EXpandable, for normal 16-bit I/O operation !CTN0218.CFG EISA 8-port !CTN0281.CFG EISA 16-port or EXpandable 4. Remove the Computone Option/Configuration Diskette and insert the EISA Configuration Diskette. 5. Return to the EISA Configuration utility Main Menu and select the "Configure" (or similar) option, then select the "Advanced Configuration" (or similar) option. 6. If you are installing an ISA controller, do the following: - Select the "Add" option or "Add Board" option - For each ISA controller, select the appropriate Intelli- Port II product name and associate it with the expansion slot in which it resides - Save your selections. 7. Choose the IntelliPort II controller and its slot number from the list on the screen. The screen displays an IRQ assignment for the controller. If you are installing multiple IntelliPort II controllers in the system, they must share the same IRQ. You can change the IRQ if necessary. Write down the slot number and selected IRQ for the controller in the Hardware Reference Log in the Product User Guide. For ISA controllers, the screen should also display a unique base I/O address. Make sure the address matches the con- troller's DIP switch settings. If not, you need to either change displayed base I/O address or power down the system and set the DIP switches on the ISA controller as necessary. 8. Save the configuration, exit the EISA Configuration utility, and reboot the system. The new configuration remains in effect until you change it or until the system battery is removed or replaced. Installing the EISA or ISA Controller To install the IntelliPort II controller in your EISA system, follow these steps: 1. Disconnect the power to the EISA host system and directly-connected peripheral devices. If you are installing an EISA controller, proceed to step 3. 2. If you are installing an ISA controller in your EISA system, you must assign each controller its own unique I/O address by setting DIP switches as described in Chapter 2 and Appen- dix B of the Product User Guide. Write down the selected I/O addresses in the Hardware Reference Log in the Product User Guide. 3. Remove the system cover and secure the controller in an expansion slot. You can install up to four controllers in your system. Write down the slot number in the Hardware Reference Log in the Product User Guide. 4. Replace the system cover. 5. Connect external concentrators or expansion boxes to the IntelliPort II controller, if any. 6. Reconnect any other peripheral devices disconnected in step 1. 7. Power on the system and any attached devices. Proceed to the section "Software Installation" for instructions on installing the IntelliPort II software drivers. Installing in a Micro Channel System This section describes how to install IntelliPort II hardware in a Micro Channel host system. Since configuration steps vary slightly from one Micro Channel system to another, consult your Micro Channel system documentation if you require additional information. Installation in a Micro Channel host is a two-part process: installing the controller and configuring the system. Installing the Micro Channel Controller To install the IntelliPort II controller in your Micro Channel system, follow these steps: 1. Make a working copy of your system's Micro Channel Reference Diskette. Consult your system documentation for more information. 2. Disconnect the power to the Micro Channel system and any directly-connected peripheral devices. 3. Remove the system cover and/or expansion slot cover. 4. Insert the IntelliPort II controller in an expansion slot and secure it in place. You can install up to four controllers in one system. 5. Replace the system cover. 6. Connect external concentrators or expansion boxes to the IntelliPort II controller, if any. 7. Reconnect any other peripheral devices disconnected in step 1. 8. Power on the system and any attached devices. Configuring the Micro Channel System To configure the IntelliPort II controller into your Micro Channel system, follow these steps: 1. Insert the working copy of the Micro Channel Reference Diskette in the floppy drive and power on the system. The system should display the following (or similar) status message: Error Code = 00016500 This means that the system has detected a configuration change. 2. Follow the directions to access the Main Menu of the Micro Channel Configuration program. Select the "Copy an Option Diskette" option. Do not select the "Automatic Configuration" option. 3. When prompted for the Source Option diskette, remove the Micro Channel Reference Diskette, insert the Computone Option/Configuration Diskette, then press ENTER. The Configuration program copies the configuration files @61F2.ADF (for 8-port products) and @61F3.ADF (for 16-port and EXpandable products) onto the system. 4. When the copy operation completes, remove the Computone Option/Configuration Diskette and insert the Micro Channel Reference Diskette. 5. Return to the Main Menu and select the "Set a New Configuration or Change a Configuration" option, then use the cursor to select the IntelliPort II product that you have installed. For each IntelliPort II controller, the screen displays an interrupt request vector (IRQ) and I/O address. 6. Make sure each IntelliPort II controller has a unique I/O address. If the system detects an I/O address conflict, the screen displays an asterisk (*) next to the conflicting address. If this occurs, select another I/O address. Write down the selected I/O addresses in the Hardware Reference Log in the Product User Guide. 7. Make sure the assigned IRQ is used only by IntelliPort II controllers. If you are installing multiple IntelliPort II controllers in your system, they must all share the same IRQ. Write down the selected IRQ in the Hardware Reference Log in the Product User Guide. 8. Return to the Main Menu, save the configuration, exit the program, and reboot. The configuration remains in effect until you change it, or until the system battery is removed or replaced. Proceed to the section "Software Installation" for instructions on installing the IntelliPort II software drivers. --------------------- Software Installation --------------------- This section describes how to install the IntelliPort II software device drivers for Multiuser DOS. Before you begin, make sure that MU-DOS is installed and active on your system. About the SETUP Utility You use the standard DR MU-DOS configuration utility, SETUP, to configure the system for the IntelliPort II. When using SETUP, remember the following: - Use the up-arrow and down-arrow keys to move between selections in the SETUP screens. - To abort installation at any time, press F10, select "Exit to operating system," and press ENTER. This leaves your system in the same state as it was before you started the installation. Adding New Ports to the System 1. At the command line prompt, type SETUP and press ENTER. This starts the MU-DOS SETUP utility. Press ENTER again to move to the first Setup screen. 2. Press ENTER to accept the default system file to be modified (C:\IBMDOS.COM). On the next screen, select "Continue with system configuration" and press ENTER. You continue to the next screen, titled "Select the area to configure next." 3. Select "Serial Ports" and press ENTER. On the next screen, select "Change/add multiport card" and press ENTER. 4. The next screen prompts you to select the multiport card that you are installing. Select "Generic (own Driver)" and press ENTER. 5. The next screen prompts you to enter a number of ports. Move the cursor to the highlighted field and enter the number of ports currently attached to your IntelliPort II. Move the cursor to "Accept current settings and continue" and press ENTER to continue. 6. The next screen displays the current settings; this should read "Generic with X ports," where X is the number of ports currently attached to your IntelliPort II. If you need to change this, select "Change/add multiport card" and press ENTER; otherwise, select "Accept current settings and continue" and press ENTER. 7. Configure individual ports to meet your requirements. In general, you should configure terminals for 38,400 bps or slower data rates. 8. After you have configured your ports, you return to the "Select the area to configure next" screen. Select "Write configuration information to system file" and press ENTER. Press ENTER again to exit the SETUP utility. Installing the IntelliPort II Device Driver Insert the Computone device driver diskette in the A: drive and type the following command: a:\install When you run the Computone install.bat program, it stores device driver files in the directory c:\computon and then updates the DR Multiuser DOS configuration file cconfig.sys (the original cconfig.sys is backed up to cconfig.sav). When you run install.bat, the following line is added to the end of the cconfig.sys file: device=c:\computon\computon.sys /p308 /fc:\computon\ff.lod You may need to edit the cconfig.sys file to change this line as follows: - If you configured the IntelliPort II controller to use a base I/O address other than 308 hexadecimal, change the number following the /p parameter to reflect the configured base I/O address. - If you move or rename the ff.lod loadware file, change the path and file name following the /f parameter to reflect the new path and file name. Running Diagnostics The Computone diag.exe program lets you obtain diagnostic information and troubleshoot any IntelliPort II problems. To install diag.exe on your system, follow these steps: 1. Copy the diag.exe program from the Computone device driver diskette. Insert the diskette in the A: drive and type the following command: copy a:\diag.exe c:\dir Where dir is the directory where you want to keep the diag.exe program. 2. Protect the directory or diag.exe program as desired. Only system administrators should have access to this program. For more information, see the DR MU-DOS documentation. If you prefer, you can run diag.exe from the floppy drive rather than installing it on your system. The available diag.exe parameters are: /L Displays status information for the driver and the line state for each port. This parameter should NEVER be used when an IntelliPort II or IntelliPort II EX channel is transmitting data, since it bypasses certain operating system safeguards and may hang the channel that is running the diag.exe command. /xxx Instructs the driver to pause xxx seconds between screen updates, where xxx is a value from 1-255. This can be used to reduce system load if diag.exe is used for extended periods, and can be used to reduce the amount of transmitted data if diag.exe is run on a slow serial connection. /H Displays a brief list of the available options. If you run diag.exe with no parameters, it displays the driver status and continuously updates port status. Diagnostics: Driver Overview When you start diag.exe with no options or the /L option, it first displays the following screen: DIAG.EXE 03/15/92 Copyright (c) 1992 Computone Corp. ==================================================================== COMPUTON.SYS Overview Driver location.... 0CD5:0000 Driver end......... 0CD5:0B4C Driver revision.... 07-May-92 Supported ports.... 16 Board ports........ 16 Total boxes........ 1 Sysdat............. C800 Board port......... 308 FIFO size.......... 1024 Output FIFO room... 1024 Board type......... Expandable 16 bit............. Yes Download version... 1.4.1 ==================================================================== ESC = Exit, Any key = port info This screen contains basic information about the Computone driver. The fields are as follows: Driver location This is the starting location in system memory where the system loaded the computon.sys driver. Driver end This is the ending location in system memory where the system loaded the computon.sys driver. Driver revision This is the last revision date of the computon.sys driver. Supported ports This is the number of ports configured in the DR MU-DOS Setup utility. Board ports This is the number of ports available on the IntelliPort II hardware. Total boxes This is the number of expansion modules attached to an IntelliPort II EXpandable controller. If you have installed an IntelliPort II standard controller, this is always 1. Sysdat Internal use only. Board port This is the base I/O address of the IntelliPort II controller. FIFO size This is the current size of the FIFO within the IntelliPort II system for all ports. Output FIFO room This is the amount of room left in the FIFO. Board type This is either Expandable or Standard. 16 bit This is Yes if the controller is using 16-bit data transfers (almost always the case), No otherwise. Download version This is the current version of the computon.sys driver. Press ESC to quit the diagnostics program, or press any other key to display port information. Diagnostics: Port Status If you are in diag.exe and press any key (except ESC), the following screen appears: Computone Ports +---------------------------------------------------------------------+ | Port Trans Trans Recv Protocol Last Last Transmit | | Type Space Count Count CTS DSR XON Recv Sent Blocked | +---------------------------------------------------------------------+ | 0 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 1 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 2 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 3 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 4 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 5 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 6 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 7 0350 035E 0000 Yes No No 00 3E Yes CTS down | | 8 0350 035E 0000 Yes No No 00 3E Yes CTS down | +---------------------------------------------------------------------+ | ESC = Exit | +---------------------------------------------------------------------+ The columns in this screen are as follows: Port Type This is the port number for each port. Trans Space This is the amount of memory currently available in the port's transmit buffer. Trans Count This is the number of characters transmitted to the port, in hexadecimal. Recv Count This is the number of characters received from each port, in hexadecimal. Protocol This shows the flow control methods enabled for each port. Choices are Yes and No for each of CTS, DSR, and XON. Last Recv This is the last character received from the port, in hexadecimal. Last Sent This is the last character sent to the port, in hexadecimal. Transmit Blocked This indicates whether the device attached to the port has flow control active (blocking data coming from the system). If flow control is active, this column also shows which type of flow control that the device is using. Diagnostics: Line Status If you are in diag.exe using the /L option, and press any key (except ESC), the following screen appears: Computone Ports +----------------------------------------------------------------------+ | Port Trans Trans Recv Protocol Last Last Line State | | Type Space Count Count CTS DSR XON Recv Sent CTS DSR DCD | +----------------------------------------------------------------------+ | 0 0350 035E 0000 Yes No No 00 3E Down Down Down | | 1 0350 035E 0000 Yes No No 00 3E Down Down Down | | 2 0350 035E 0000 Yes No No 00 3E Down Down Down | | 3 0350 035E 0000 Yes No No 00 3E Down Down Down | | 4 0350 035E 0000 Yes No No 00 3E Down Down Down | | 5 0350 035E 0000 Yes No No 00 3E Down Down Down | | 6 0350 035E 0000 Yes No No 00 3E Down Down Down | | 7 0350 035E 0000 Yes No No 00 3E Down Down Down | | 8 0350 035E 0000 Yes No No 00 3E Down Down Down | +----------------------------------------------------------------------+ | ESC = Exit | +----------------------------------------------------------------------+ The columns in this screen are as follows: Port Type This is the port number for each port. Trans Space This is the amount of memory currently available in the port's transmit buffer. Trans Count This is the number of characters transmitted to the port, in hexadecimal. Recv Count This is the number of characters received from each port, in hexadecimal. Protocol This shows the flow control methods enabled for each port. Choices are Yes and No for each of CTS, DSR, and XON. Last Recv This is the last character received from the port, in hexadecimal. Last Sent This is the last character sent to the port, in hexadecimal. Line State This indicates the current state of the port's modem control signals (CTS, DSR, and DCD): Up if the signal is currently asserted, and Down if the signal is currently deasserted. ----------------------------------- How Installation Affects the System ----------------------------------- The install.bat utility creates a directory C:\COMPUTON and installs the following files in this directory: COMPUTON.SYS The IntelliPort II drivers for DR MU-DOS. DIAG.EXE The diagnostics program described in "Running Diagnostics." FF.LOD The IntelliPort II loadware file, downloaded into the IntelliPort II controller when the system boots.