SCO(r) Hi-Res Keyboard Mouse Supplement Release and Installation Notes Version 1.0.0 15 December 1990 1. Preface The SCO Hi-Res Keyboard Mouse Supplement provides your Open Desktop(r) or UNIX(r) system with a device driver that enables your computer to use the full capabilities of the high-resolution keyboard mouse. 2. Configuration Requirements You need the following resources to install and use the SCO Hi-Res Keyboard Mouse Supplement: 15 December 1990/1.0.0 - 1 - The Santa Cruz Operation, Inc. Release Notes _____________________________________________ |COMPUTER | an industry-standard 386 or | | | 486 computer | |______________|_____________________________| |OPERATING | SCO UNIX System V/386 | |SYSTEM | Release 3.2 Version 2.0, | | | Open Desktop Release 1.0.0 | | | (with or without the UFE | | | Maintenance Supplement), or | | | Open Desktop Release 1.1.0 | | | (with or without Update F). | | | For either platform, be | | | sure that you have | | | installed the Extended | | | Utilities Package. | |______________|_____________________________| |DISK CAPACITY | no additional storage space | | | is needed for this supple- | | | ment | |______________|_____________________________| |RAM | no additional RAM is needed | | | for this supplement | |______________|_____________________________| |MOUSE | a high-resolution keyboard | | | mouse | |______________|_____________________________| 3. Supported Mouse Devices The SCO Hi-Res Keyboard Mouse Supplement has been tested on the fol- lowing mouse devices: o Microsoft(r) Serial-PS/2 Compatible Mouse o LogitechTM Model No. CA-93-6MD Other high resolution mice may work but are not tested or supported with this release. 4. Installing the SCO Hi-Res Keyboard Mouse Supplement Install the SCO Hi-Res Keyboard Mouse Supplement after you have installed Open Desktop or the UNIX system platform. If you have already configured a mouse on the system, first remove it with the mkdev mouse utility before you install the SCO Hi-Res Keyboard Mouse Supplement. Follow these steps to install the SCO Hi-Res Keyboard Mouse Supplement using the custom(ADM) utility: 1. Reboot the system and enter single-user mode. 2. Type custom and press . Select Install from the initial custom menu by pressing , and then press again to select A New Product from the next menu. Press to 15 December 1990/1.0.0 - 2 - The Santa Cruz Operation, Inc. SCO Hi-Res Keyboard Mouse Supplement choose the Entire Product option from the displayed list. You are prompted to insert Distribution Floppy Volume 1. 3. Insert the SCO Hi-Res Keyboard Mouse Supplement diskette into floppy drive 0 and press to continue. You see the mes- sages Installing custom data files... and Executing Product Prep Script. You also see messages describing where custom is saving backup copies of files before extracting new files. You are prompted to press any key to continue. 4. Press any key. The message Creating file lists... appears, and you are prompted to insert the SCO Hi-Res Keyboard Mouse Supple- ment Floppy Volume 1. 5. Check to make sure that the diskette is inserted properly and press to continue. You see the message Extracting files... and, after the volume is extracted, a restricted rights legend appears. The messages Installing SCO Hi-Res Keyboard Mouse Supplement and Updating System Configuration... also appear. 6. At this point in the installation, you are prompted if you want to configure the system to use a high-resolution keyboard mouse. The supplement cannot take effect until you configure the sys- tem. You can choose to do so now, or you can use the mkdev mouse utility later. Answer y or n. 7. If you answered n, skip to the step where you are prompted to relink the kernel. 8. If you answered y, you see Mouse Initialization Program and a numbered menu. 9. At the prompt, enter the number next to the menu option Add a mouse to the system. A list of supported mouse devices appears. 10. Select the High Resolution Keyboard Mouse from the list. You are prompted to enter all of the ttys that you want associated with the high-resolution keyboard mouse. 11. Enter multiscreen if you want to use multiuser mode. You are also asked if you want to use the high-resolution keyboard mouse on any other terminal. Answer appropriately. Please refer to ``Using a Mouse'' in the SCO UNIX System V/386 Operating System Administrator's Guide or to ``Using a Mouse'' in the Open Desk- top Administrator's Guide for more information about configuring a mouse. The message Updating system configuration... appears. You are prompted if you want to create a new kernel to effect the driver change. 12. Enter y. This message appears: --------------------------------------------- begin screen display --- 15 December 1990/1.0.0 - 3 - The Santa Cruz Operation, Inc. Release Notes The UNIX Operating System will now be rebuilt. This will take a few minutes. Please wait. Root for this system build is /. The UNIX Kernel has been rebuilt. --------------------------------------------- end screen display ----- 13. You are prompted to decide if you want the new kernel to boot by default. Enter y. 14. After the operating sytem is rebuilt, you are prompted to decide if you want the kernel environment rebuilt. Enter y. 15. You see the Mouse Initialization Program menu. Enter q to leave the program. This prompt appears: --------------------------------------------- begin screen display --- Did you successfully relink the kernel upon mouse configuration? (y/n) --------------------------------------------- end screen display ----- 16. If you were not successful, enter n. This message appears: --------------------------------------------- begin screen display --- If you did not successfully relink your kernel after making mouse configuration changes, make sure this problem is solved. Once this problem has been resolved, reinstall, and relink. --------------------------------------------- end screen display ----- You are prompted to press to continue. Press . The system is restored to its original state, as it was before you attempted to install the SCO Hi-Res Keyboard Mouse Supple- ment. You are returned to the operating system prompt. 17. If you successfully relinked the kernel, enter y and press to continue. The message Press any key to continue appears. 18. Press any key. You see the message Checking file permissions and the custom menu appears. 19. Select Quit to exit the custom menu and then choose Yes to leave custom. 20. Remove the distribution volume from the floppy drive. 21. Type reboot and press . 15 December 1990/1.0.0 - 4 - The Santa Cruz Operation, Inc. SCO Hi-Res Keyboard Mouse Supplement 5. Removing the SCO Hi-Res Keyboard Mouse Supplement To remove the SCO Hi-Res Keyboard Mouse Supplement, use the following procedure: 1. Log onto the system as root. 2. Enter custom. 3. Move the highlight or press r to select Remove from the initial custom menu. 4. Select SCO Hi-Res Keyboard Mouse Supplement in the lower right- hand menu by moving the highlight and pressing . 5. Press to choose the package labeled All, which is highlighted in the lower window. You are prompted to verify the removal of the All package. 6. Press to proceed with the removal. The message Execut- ing SCO Hi-Res Keyboard Mouse Supplement Removal Script appears. If you have not removed the mouse previously using mkdev mouse, a message appears informing you that the removal of the supple- ment also removes the high-resolution keyboard mouse from the system. 7. Press when prompted to do so. You see Removing the SCO Hi-Res Keyboard Mouse Supplement... and this message appears: --------------------------------------------- begin screen display --- The UNIX Operating System will now be rebuilt. This will take a few minutes. Please wait. Root for this system build is /. The UNIX kernel has been rebuilt. --------------------------------------------- end screen display ----- You are prompted to decide if the new kernel is to boot by default. 8. Enter y. After the operating system is rebuilt, you are prompted to decide if you want the kernel environment rebuilt. 9. Enter y, then press any key to return to custom. You see Creat- ing file list..., and then the initial custom menu appears. 10. Select Quit to leave the menu, and then choose Yes to leave cus- tom. 11. Enter the following command to shut down the system: /etc/shutdown 15 December 1990/1.0.0 - 5 - The Santa Cruz Operation, Inc. Release Notes 12. Reboot the system. 6. Changing the Mouse Resolution Setting The file /etc/conf/pack.d/kbmouse/space.c contains two parameters that affect the performance of the high resolution mouse, kbm_resolution and kbm_poll. You can use a text editor to edit the /etc/conf/pack.d/kbmouse/space.c file and change the kbm_resolution parameter to adjust the resolution setting. Refer to your platform documentation for information on using a text editor. The kbm_poll parameter, however, should only be changed automatically by the mkdev mouse utility under normal circumstances. See the section ``Solving Slow Mouse Response'' for more information about kbm_poll. The kbm_resolution parameter determines how many reports, or counts, are made from the mouse to the mouse driver each time that you move the mouse one millimeter. Increasing the number of counts per millim- eter increases the sensitivity of mouse performance. The allowable values for kbm_resolution are: High-Resolution Keyboard Mouse 15 December 1990/1.0.0 - 6 - The Santa Cruz Operation, Inc. SCO Hi-Res Keyboard Mouse Supplement ______________________________________ |Counts/millimeter Parameter | |_____________________________________| | 1 kbm_resolution=0 | | 3 kbm_resolution=1 | | 6 kbm_resolution=2 | | 12 kbm_resolution=3 | |_____________________________________| The kbm_resolution parameter is set to 1 by default (for 3 counts/millimeter) in etc/conf/pack.d/kbmouse/space.c. The parameters for a keyboard mouse do not correspond to the same counts/millimeter as parameters for a high-resolution keyboard mouse: Keyboard Mouse 15 December 1990/1.0.0 - 7 - The Santa Cruz Operation, Inc. Release Notes ______________________________________ |Counts/millimeter Parameter | |_____________________________________| | 1 kbm_resolution=0 | | 2 kbm_resolution=1 | | 4 kbm_resolution=2 | | 8 kbm_resolution=3 | |_____________________________________| The default kbm_resolution value for a keyboard mouse is 3, specifying 8 counts/millimeter. The same value specifies 12 counts/millimeter for a high-resolution keyboard mouse, which causes the high-resolution keyboard mouse to behave too sensitively. Therefore, you must use the mkdev mouse utility when you add or remove a high-resolution mouse. mkdev mouse changes the default parameters in etc/conf/pack.d/kbmouse/space.c to the appropriate values for the mouse that you are configuring. You must answer y when mkdev mouse prompts you if you want to relink the kernel if you want to effect the new parameter values. 7. Notes The following sections describe issues you should be aware of concern- ing the SCO Hi-Res Keyboard Mouse Supplement. 7.1 Reinstalling the Link Kit If you need to reinstall the Link Kit after you have installed the SCO Hi-Res Keyboard Mouse Supplement, you must reinstall the supplement and relink the kernel. 7.2 Removing the SCO Hi-Res Keyboard Mouse Supplement You must remove the high-resolution keyboard mouse from the system before you remove the supplement. Note that custom removes the high- resolution keyboard mouse for you when you remove the supplement. 7.3 Solving Slow Mouse Response If your mouse responds too slowly after you install the SCO Hi-Res Keyboard Mouse Supplement, use a text editor to edit the file /etc/conf/pack.d/kbmouse/space.c. Lower the kbm_poll value to improve mouse response. The minimum value is 0x5. For example, if the value 0xb0 produces very slow mouse response, try 0xa0, 0x90, 0x80, and so on in turn until you have satisfactory mouse performance. ********************************************************************* NOTE Some kbm_poll values lower than 0xb0 may cause your system to freeze. If this occurs, raise the kbm_poll value. ********************************************************************* After modifying parameters in /etc/conf/pack.d/kbmouse/space.c, you must relink the kernel. To do this, execute ./link_unix from the /etc/conf/cf.d directory and reboot the system. 15 December 1990/1.0.0 - 8 - The Santa Cruz Operation, Inc. 15 December 1990/1.0.0 - 9 - The Santa Cruz Operation, Inc. Release Notes SCO Hi-Res Keyboard Mouse Supplement Release and Installation Notes Version 1.0.0 1. Preface 1 2. Configuration Requirements 1 3. Supported Mouse Devices 2 4. Installing the SCO Hi-Res Keyboard Mouse Supplement 2 5. Removing the SCO Hi-Res Keyboard Mouse Supplement 5 6. Changing the Mouse Resolution Setting 6 7. Notes 8 7.1 Reinstalling the Link Kit 8 7.2 Removing the SCO Hi-Res Keyboard Mouse Supplement 8 7.3 Solving Slow Mouse Response 8 15 December 1990/1.0.0 - i - The Santa Cruz Operation, Inc.