Software Installation and Operating Manual for DigiCHANNEL COM/Xi~ SCO UNIX System V/386 Releases 3.2.0 - 3.2.4 SCO XENIX 286 and 386 Releases 2.2.3 - 2.3.4 Software Installation SCO XENIX SCO Unix Installation of the device driver software for SCO XENIX and SCO Unix is a four-part procedure. In Part One, a new kernel is linked. In Part Two, new devices for the serial ports are made in the /dev directory, and these devices are added to /etc/ttys for SCO Xenix and /etc/initab for SCP Unix. In Part Three, a back-up copy of the current kernel is made and the new kernel is copied into the root directory. Finally in Part Four you boot the new kernel and enable the communications ports for use with a terminal. Step 1. Log onto the console as super-user (root). Step 2. Insert the DigiWARE diskette, and type: custom [Press ENTER] Step 3. The system will now display the Custom Menu. If the device driver has been previously installed, the Custom Menu lists DigiWARE. If not, select Option 4 to add a supported product. The system displays: Installing custom data files... Insert distribution volume 1 and press or enter q to quit: Step 4. Press and the system displays the following menu: 1. Install one or more packages 2. Remove one or more packages 3. List the available packages 4. List the files in a package 5. Install a single file 6. Select a new set to customize 7. Display current disk usage 8. Help Select an option or press q to quit: Select Option 1 to install DigiCHANNEL Software. The system displays: Name Inst Size DigiWARE for COM/Xi packages ------------------------------------------------------ COMXI NO 800 DigiCHANNEL COM/Xi async driver V4.4.0 (Note that the ~size~ in the above display can vary from release to release.) The system will then display: Enter the package(s) to install or enter q to return to the menu: Type: COMXI [Press ENTER] The system will then display: Insert DigiWARE package volume 1 and press or enter q to return to the menu: Volume 1 should still be in the disk drive. Press . The system will then display: Extracting files... Step 5. You must now answer a series of questions about the installation. In each case, options will be presented and/or examples will guide you in answering the questions. The driver may be installed by using one of four pre-configured versions, or may be installed in any other configuration. You will see the screen: The DigiCHANNEL COM/Xi driver may be installed using one of the four suggested configurations listed below, or you may choose to create your own custom configuration. 1) I/O Port=0x320, Memory Address=0x000D8000 2) I/O Port=0x300, Memory Address=0x000D0000 3) I/O Port=0x220, Memory Address=0x000C8000 4) I/O Port=0x120, Memory Address=0x000C0000 5) Custom or multiple board installation. 6) Exit installation procedure. Please enter selection (1-6)? When asked, select your con- figuration from the above list (1-6). Note that options 1 through 4 are for installing single boards only! If your are installing two, three, or four boards, or wish to set up one board with parameters different from those above, choose #5. For any of the versions selected, the corresponding jumpers on the COM/Xi board must be set to match the parameters listed in the con- figurations above. If you selected Option 5, the next prompts you will see will be for Custom Configuration Instructions. If you answered 1 through 4, skip to Step 11 on page 25. Step 6. The software displays: Each DigiCHANNEL COM/Xi board requires an I/O port address and a 32K block of memory. Please select these to avoid conflicts with other boards you may have installed in your system. How many DigiCHANNEL COM/Xi boards do you wish to install (1-4)? Type in the number of COM/Xi boards you are installing. Instructions 7, 8 and 9 are repeated for each of the boards you specified in Step 6. Step 7. You must select a Port Address for each board. The software displays the Port Address options. The I/O port address choices, in hexadecimal, are: 1) 1003) 1205) 2207) 320 2) 1104) 2006) 300 Please enter selection (1-7)? Enter your selection by typing in one of the numbers shown above. Step 8. The next item requires the selection of the host starting address of the board's dual-ported memory. Each board must have a unique Memory Address. The software lists the available Memory Address options. The memory address choices, in hexadecimal, are: 1) 0x00d8000 2) 0x00d0000 3) 0x00c8000 4) 0x00c0000 Please enter selection (1-4)? When asked, enter your selection (1-4). Step 9. The software asks: Please indicate number of ports on board (4 or 8)? Answer 4 or 8 as appropriate for the number of channels on the DigiCHANNEL board you are installing. Step 10. The software will now show you what you have chosen. (The following is an example screen; yours may be different.) You have selected the following configuration: Board I/O Address Memory Address Ports --------------------------------------------------- 1 0x320 0x000D8000 8 Is this configuration acceptable (y or n)? If the information is correct, answer ~y.~ Otherwise, answer ~n~ and the software will let you start over again with Step 5. Step 11. Finally, you need to select the Altpin setting. This allows alternate wiring of the RJ-45 modular connectors. The default for altpin is OFF, giving you the standard DigiBoard RJ-45 pinouts. Setting altpin to ON enables the alternate RJ-45 pinouts. (This is useful for 8-pin RJ- 45 connectors. See the main COM/Xi manual for more details, as well as page 58 of this manual.) The software asks: The default setting for altpin is off. Is this acceptable (y or n)? Answer y or n as appropriate. Step 12. Installing DigiScreen DigiScreen is DigiBoard's multiple screen utility that allows a single physical terminal to be connected to several virtual terminal sessions (screens) at one time. The software installation script gives you the option of installing it. If you have already installed DigiScreen with another DigiBoard product, there is no need to install it again, unless you wish to change the number of DigiScreen devices. DigiScreen is not available for the 286 XENIX operating system. The software asks: Do you wish to install DigiScreen (y or n)? If you answer "n," proceed to page 25, Device Nodes. Step 13. The software continues: Each session under DigiScreen requires a DigiScreen device. How many DigiScreen devices do you wish to have installed (max. is 256, default is 32): ? Answer with the number of DigiScreen devices you think will be adequate for all connected terminals. Note that the default value will change according to the number of previously created DigiScreen devices you may have. Step 14. At this point, the operating system asks: Do you wish to make new device nodes (y or n)? Most users will need to create the new devices at this time, and should answer ~y~ and proceed to Part Two, Creating New Devices. However, if you are an experienced XENIX user, you do have the option of skipping Part Two, the creation of new devices. If you answer ~n~ you will proceed to Part Three: Installing the New Kernel. Part Two: Creating New Devices This portion of the installation procedure creates devices in /dev and edits /etc/ttys, giving XENIX the information to use these additional ports. By default, these ports are installed with device names ttyi11 through ttyi18, ttyi21 through ttyi28, ttyi31 through ttyi38, and ttyi41 through ttyi48. The DigiCHANNEL driver will support up to four boards, for a maximum of 32 asynchronous ports. Step 1. The software displays: This script also installs the information needed by XENIX to use these additional ports. The DigiCHANNEL COM/Xi async driver will support up to four boards for a maximum of thirty-two asynchronous serial ports. By default, the ports are installed as ttyi11 through ttyi48. Ports with modem control are installed as ttyI11 through ttyI48. DigiPrint ports are installed as pri11 through pri48. DigiPrint ports with modem control are installed as prI11 through prI48. Is this acceptable (y or n)? ~Yes~ Answer ~y~ if the default device names listed above (and on your console screen) are acceptable. You may then proceed to Part Three: Installing the New Kernel, as the remainder of this step asks for new names for the nodes and the DigiPrint ports. ~No~ If you answered ~n~ to the preceding question, enter the name you wish when the systems responds: Device names will be a base name followed by an i for base tty ports, or I for modem control ports, with the board number (1-4) and the port number (1-8) appended. Please enter base name to use: The default printer names are pri11 through pri48. The installation program will now ask for an alternate name: Please enter DigiPrint name to use: Step 2. The software displays: Do you wish to update /etc/ttys and /etc/ttytype (y or n) ? For a new installation, answer ~y~ (yes). For updates, answer ~n~ to preserve the current setup. If you aren't sure, answer y.~ At this point, you may proceed to Part Three: Installing the New Kernel. Format used for port names: tty Base name. You may select a different one. (Another default that you may change is pr for DigiPrint ports.) The base name is followed by a lowercase ~i~ for ports without modem control, and by an uppercase ~I~ for ports with modem control. b Board number (1 through 4 possible, depending upon the number of boards installed.) p Port number on the individual board (1-8 for an eight-port COM/Xi board.) Example 1: If ~crt~ was the base name, Port 4 on the third eight port board would be crti34. Example 2: ttyI11 indicates that the first port on the first board has modem control enabled. Part Three: Installing the New Kernel The device driver software installation is now complete, and the new kernel must be installed. Step 1. You will see: The new kernel with driver modifications is in /usr/sys/conf/xenix. Do you want this kernel to boot by default (y or n)? If you type ~y~ you will see: The old kernel is installed in /xenix.old The new kernel is installed in /xenix Enter the following command to reboot your system and activate the new kernel: haltsys If you type ~n~ you will see: Changes will not be reflected unless /usr/sys/conf/xenix is copied to /xenix. Step 2. The system displays: 1. Install one or more packages 2. Remove one or more packages 3. List the available packages 4. List the files in a package 5. Install a single file 6. Select a new set to customize 7. Display current disk usage 8. Help Select an option or enter q to quit: Enter q. Step 3. If you choose to have the new kernel boot by default, enter the following command to boot the new kernel: shutdown 0 [Press ENTER] Step 4. When the computer reboots, you should see messages which indicate the board is functioning. Your screen might appear to look some- thing like this: device address vector dma comment ----------------------------------------------------- %comxi 0x3200 - - mem=0x000D8000 ports=8 COM/Xi V4.x.0 Part Four: Enabling the New Ports SCO Xenix Step 1. With the cables connected to the terminals (using a null modem, if necessary), test the connections to each terminal by typing in the following for each port added: date > /dev/ttyi11 (Assuming the terminal is connected to ttyi11.) (Please note that in the above, the ~date~ command is used as a simple test, to provide text output that can be redirected; there is no other significance to ~date~ in this test!) * If the date appears on the terminal's screen, the device is properly connected. * If the date does not appear on the terminal's screen, then that terminal is not receiving data; check the power, cables, connections, etc. * If nonsense characters are printed on the terminal's screen, check the baud rates, data bits, stop bits, and parity setting on your terminal. (XENIX default parameters are 9600 baud, 8 data bits, 1 stop bit, and no parity.) Once you can redirect output to a terminal with the test above, you can continue the following step to enable that port. Step 2. To activate a port for use with a terminal, type the following command: enable ttyi11 (If you've assigned a new base name, replace the ~tty~ above with the name you chose.) The above command will cause a login prompt to be sent to the terminal connected to ttyi11. To activate the other ports, repeat the enable command with the appropriate port name. Un-Installing the SCO XENIX Device Driver The DigiBoard DigiCHANNEL device driver software can be removed from the kernel by using the program custom. Again, the Development Kit is not required, although the link kit must be installed. Removing the driver from the kernel is a two-part process. First, the driver references are removed from the system configuration files. Secondly, a new kernel is linked, and copied to the root directory. Enter the following commands to un-install the device driver software: Step 1. Log onto the console as super-user (root), and enter the following command: custom [Press ENTER] Step 2. Enter the proper number for the DigiWARE for COM/XI device driver software. Step 3. The system displays: 1. Install one or more packages 2. Remove one or more packages 3. List the available packages 4. List the files in a package 5. Install a single file 6. Select a new set to customize 7. Display current disk usage 8. Help Select an option or enter q to quit: Select Option 2 to remove the driver. The system will display: Name Inst Size DigiWARE for COM/Xi Packages ------------------------------------------------------------ COM/Xi YES 800 DigiCHANNEL COM/Xi async driver V4.x.0 (Note that the ~size~ in the above display can vary from release to release.) Step 4. The system will then display: Enter the package(s) to remove or enter q to return to the menu: Type: COMXI [Press ENTER] Step 5. Next, the software asks: Do you wish to remove DigiScreen devices (y or n)? Removing DigiScreen devices will affect ALL DigiBoard Drivers. Step 6. You will see: The new kernel with driver modifications is in /usr/sys/conf/xenix. Do you want this kernel to boot by default (y or n)? If you type ~y~ you will see: The old kernel is installed in /xenix.old The new kernel is installed in /xenix Enter the following command to reboot your system and activate the new kernel: haltsys If you type ~n~ you will see: Changes will not be reflected unless /usr/sys/conf/xenix is copied to /xenix. Step 7. The system displays: 1. Install one or more packages 2. Remove one or more packages 3. List the available packages 4. List the files in a package 5. Install a single file 6. Select a new set to customize 7. Display current disk usage 8. Help Select an option or enter q to quit: Enter q to quit. Step 8. Remove the perms file: rm /etc/perms/comxi[press ENTER] Step 9. If you choose to have the new kernel boot by default, enter the following command to boot the new kernel: shutdown 0 [Press ENTER] Part Four: Enabling the New Ports SCO Unix Step 1. With the cables connected to the terminals (using a null modem, if necessary), test the connections to each terminal by typing in the following for each port added: date > /dev/ttyi11 (Assuming the terminal is connected to ttyi11.) (Please note that in the above, the ~date~ command is used as a simple test, to provide text output that can be redirected; there is no other significance to ~date~ in this test!) * If the date appears on the terminal's screen, the device is properly connected. * If the date does not appear on the terminal's screen, then that terminal is not receiving data; check the power, cables, connections, etc. * If nonsense characters are printed on the terminal's screen, check the baud rates, data bits, stop bits, and parity setting on your terminal. (Unix default parameters are 9600 baud, 8 data bits, 1 stop bit, and no parity.) Once you can redirect output to a terminal with the test above, you can continue the following step to enable that port. Step 2. The Terminal Control Database must be updated to include the new devices. Add the DigiCHANNEL device information using the fol- lowing SCO UNIX sysadmsh command sequence: AccountsTerminal:Create Fill in the required information on the form displayed. Step 3. To activate a port for use with a terminal, type the following command: enable ttyi11 (If you've assigned a new base name, replace the ~tty~ above with the name you chose.) The above command will cause a login prompt to be sent to the terminal connected to ttyi11. To activate the other ports, repeat the enable command with the appropriate port name. Un-Installing the SCO Unix Device Driver The DigiBoard DigiCHANNEL device driver software can be removed from the kernel by using the program custom. Again, the Development Kit is not required, although the link kit must be installed. Removing the driver from the kernel is a two-part process. First, the driver references are removed from the system configuration files. Secondly, a new kernel is linked, and copied to the root directory. Enter the following commands to un-install the device driver software: Step 1. Log onto the console as super-user (root), and enter the following command: custom [Press ENTER] Step 2. When the operating system menu asks, choose REMOVE. Step 3. Select DigiCHANNEL COM/Xi Software. The software will respond with: Removing DigiCHANNEL COM/Xi intelligent async serial driver. Step 4. Next, the software asks: Do you wish to remove DigiScreen devices (y or n)? Removing DigiScreen devices will affect ALL DigiBoard Drivers. Step 5. When asked if you wish to create a new kernel, answer ~y~ (yes). Step 6. You will see: Do you want this kernel to boot by default (y or n)? If you type ~y~ you will see: The old kernel is installed in /unix.old The new kernel is installed in /unix If you type ~n~ you will see: Changes will not be reflected unless /etc/conf/cf.d/unix is copied to /unix. Step 7. The system displays: Do you want the kernel environment rebuilt? Answer ~y~ (yes). You will see: The kernel has been successfully linked and installed. To activate it, reboot your system. Step 8. Remove the perms file: rm /etc/perms/comxi{Press ENTER] Step 9. Enter the following command to boot the new kernel: shutdown -y -g0 [Press ENTER]