Introduction These Release and Installation Notes document the VESA and Mach64 Graphics Adapters Driver product. The software in this provides server support for additional graphics adapters. Contents: + one VESA and Mach64 Graphics Adapters diskette containing the drivers + these Release and Installation Notes Keep the floppy diskette until the next release of SCO(r) CMW+ You may need to install or reinstall the the diskette if you upgrade the software or hardware on your system. Software requirements This driver diskette can be installed on systems running: + SCO CMW+ 3.0 with the ITSEC evaluation SLS No serialization is required to install. _________________________________________________________________________ About these Release Notes The VESA and Mach64 Graphics Adapters Drivers Release and Installation Notes are divided into the following chapters: + Chapter 1, ``Installing the driver,'' describes how to install the soft- ware provided in the VESA and Mach64 Graphics Adapters driver. + Chapter 2, ``Release information,'' describes features and enhance- ments specific to this release. Chapter 1 Installing the driver When you install the diskette, new graphics drivers and supporting software are installed in the /usr/lib/X11 and /usr/lib/mkdev directories. Sub- directories containing graphics information (grafinfo) files are added to the /usr/lib/grafinfo directory. Additionally, new executables will be added to the system in /usr/bin and in /usr/lib/vidconf/AOF/bin. If you have customized one or more of your existing grafinfo files, back up the /usr/lib/grafinfo directory before installing. Then, after installing, you can merge portions of your grafinfo files into the new grafinfo files, and then re-configure the server for your graphics adapter. Installation procedure The following procedure installs the VESA and Mach64 Graphics Adapters driver: 1. Log in as root. 2. Bring the system to system maintenance mode after telling your users to log off. Refer to shutdown(ADM) for instructions. 3. Execute custom from the command line by typing custom and pressing , or from sysadmsh by making the following sysadmsh selec- tion: System->Software 4. Choose Install, A New Product, and Entire Product. When you are prompted to insert the requested volume, insert the disk, then select Continue. 5. When you are prompted again for the first floppy volume, select Con- tinue. It takes a few minutes for the files to be extracted. 6. Several messages indicate the installation's progress. 7. When prompted, select the appropriate adapter from the displayed list. 8. Select the Update option from the Video Configuration menu. 9. From the Update screen, use the arrow keys or the and keys to move the highlight through the list of supported graphics adapters. When you have highlighted the desired adapter, press . 10. Highlight the resolution at which you would like your graphics adapter to function and press . 11. Highlight the monitor that you are configuring and press . Choose IBM VGA if you are unsure of your monitor type. 12. Select Default or Specify to assign the graphics adapter to the con- sole multiscreens. If you select Specify, you must also use to indicate the desired console multiscreens from the pop-up list. When you are finished, select Accept. 13. Verify the new selections by selecting the View option from the Video Configuration menu. 14. When you are satisfied with your new choices, select Quit, then select one of the following: + Save to store your new graphics configuration choices + Exit to end your configuration session without saving your new configuration + Cancel to return to the Video Configuration menu Select Save to save your changes. 15. You are prompted to relink the kernel. 16. When prompted, press any key to continue. The custom menu returns. 17. Select Quit to exit custom. 18. When the system prompt returns, type init 6 to reboot your system, then press . 19. When the boot prompt appears, press . You are given the option of going into multiuser mode. 20. Press D to enter multiuser mode. The driver is now installed. Store the VESA and Mach64 Graphic Adapter distribution media in a safe place. If an accident or a hardware failure damages the VESA and Mach64 Graphic Adapter driver files on your hard disk, you will need the distribution media to re-install the VESA and Mach64 Graphics Adapters. Extracting single files from the distribution You can use custom to extract single files from the Advanced Graphics Adapters distribution. _________________________________________________________________________ NOTE Installing a package from this distribution is not supported. You must install either the entire product or single files. _________________________________________________________________________ 1. Log in as root. 2. Execute custom from the command line. 3. Choose Install, SCO VESA and Mach64 Graphics Adapters, and Files. Press to select ALL and use arrow keys to highlight the name of the file you want to extract. 4. Press to select the file. Note the directory in which it will be installed. 5. When you are prompted for the first floppy volume, make sure the disk is inserted, and select Continue. It may take a few minutes for the file to be extracted. 6. Exit Custom. 7. You must now uncompress the file. _________________________________________________________________________ NOTE All files are distributed in compressed format even though they are not named with the filename.Z format that is typical for compressed files. _________________________________________________________________________ Change to the directory in which the file was installed. 8. Type cat filename | uncompress > file.tmp 9. Then type mv file.tmp filename 10. Type cd / 11. Finally, type fixperm -d VESA /etc/perms/vesa Changing monitors and graphics adapters This section explains how to change monitors and video graphics adapter cards on your system after the VESA and Mach64 Graphics Adapters have been installed. To configure the server for a new graphics adapter or monitor, perform the following steps: 1. Log in as root. 2. At the system prompt, enter the following command: # mkdev graphics Then select the Update option from the Video Configuration menu. 3. From the Update screen, use the arrow keys or the and keys to move the highlight through the list of supported graphics adapters. When you have highlighted the desired adapter, press . 4. Highlight the resolution at which you would like your graphics adapter to function and press . 5. Highlight the monitor that you are configuring and press . 6. Select Default or Specify to assign the graphics adapter to the con- sole multiscreens. If you select Specify, you must also indicate the desired console multiscreens from the pop-up list. When you are finished, select Accept. 7. Verify the new selections by selecting the View option from the Video Configuration menu. 8. When you are satisfied with your new choices, select Quit to exit mkdev graphics, then select one of the following: + Save to store your new graphics configuration choices + Exit to end your mkdev graphics session without saving your new configuration + Cancel to return to the Video Configuration menu Select Save to save your changes. _________________________________________________________________________ NOTE You may be prompted to relink the kernel _________________________________________________________________________ When you have completed your mkdev graphics session, test your new con- figuration by running the X server. Removing the VESA and Mach64 Graphics Adapters Follow this procedure for removing the VESA and Mach64 Graphics Adapters: 1. Log in as root. 2. Bring the system to system maintenance mode after telling your users to log off. Refer to shutdown(ADM) for instructions. 3. Execute custom from the command line by typing custom and pressing , or from sysadmsh by making the following sysadmsh selec- tion: System->Software 4. Choose Remove, and select ``SCO VESA Driver Supplement.'' 5. Select ALL to remove the entire VESA and Mach64 Graphics Adapters. 6. Select Yes to confirm the removal. 7. When prompted, press any key to continue. The custom menu returns. 8. Select Quit to exit custom. Chapter 2 Release information Supported graphics adapters Cards based on ATI's Mach64 and RageII+ chiptsets as well as cards supporting VESA Bios Extension version 1.2 and 2.0. _________________________________________________________________________ NOTE Some ATI cards will not work properly with the VESA driver. Please use the native ATI drivers. _________________________________________________________________________ _________________________________________________________________________ NOTE Not every supported monitor may necessarily work properly with every supported adapter. _________________________________________________________________________ Grafinfo file modes at frequencies above 60 Hz may not work on your moni- tor. Please check your monitor specifications before trying these modes. Ensure that 640x480 16-color mode works properly on your monitor if you experience problems with higher resolutions or more colors. Known limitations The following are known limitations for this supplement. The VESA driver does not support modes with less than 256 colors. The VESA driver does not work for all available graphic adapters.