Aleph One Windows Driver Release Notes
--------------------------------------

NOTE:- These are DOS files
--------------------------
This archive or disk contains the standard Windows Driver (ARMDRV.DRV), this 
text file (README), and a setup file (OEMSETUP.INF) which will allow Windows
to install the drivers for you. 

It is recommended that you install this driver from a DOS format
floppy disk. To do this you will have to copy these files onto a DOS disk.
NOTE: the OEMSETUP.INF file gets truncated to OEMSETUP/I by being archived or
by being on a RISCOS format floppy so you will have to rename it on the DOS
disk.


The Windows Drivers
-------------------
The enhanced Windows Driver provides a substantial increase in speed for many
common Microsoft Windows 3.0 and 3.1 drawing functions, by using the
Archimedes as a Graphics Co-processor. It supports 16, 256, 32 thousand and
16 million colours in any resolution that your system can display. It
replaces the standard VGA driver VGA.DRV. This is the first version of the
driver that gives full palette support, so everything should now have the
correct colours.

The Driver supplied is:
 ARMDRV.DRV:  (v1.80 1995.06.02) 
 To use this driver, you will need !PC486 or !PC version 1.78 or later.


The drivers can either be installed manually as detailed in the manual (and
below), or you can use Windows Setup to do the job. For most users we
recommend that you use Windows Setup, either during the initial installation,
or after windows is installed.

If you are an experienced Windows/DOS user then it is quicker to use the
manual method, but you must be sure that your existing installation is for
'VGA (Version 3.0)', otherwise you will have the wrong 386-grabber installed
and will get all sorts of display trouble with DOS boxes.

After installing the driver you need to use !PCconfig to specify the RISCOS
mode that the driver will use.

The OEMSETUP/INF file supplied with this version has to assume a particular
version of windows when prompting for floppies. This version assumes version
3.11 (of both Windows and Windows for Workgroups). If you have a different
version (3.1, or 3.0), or even a version supplied by a manufacturer other
than Microsoft then some of the files required may be on different floppies
(particularly vddvga30.386, which is on disk1 for v3.1, and disk2 for v3.11).
Just insert the disk containing the requested file (shown in the bottom right
of the setup screen), rather than the prompted disk if this is the case.
Setup will then proceed.

Using Setup when installing Windows:
------------------------------------ 

1. Copy the ARMDRV.DRV & OEMSETUP.INF files to a dos format floppy disk,
   as detailed above - henceforth referred to as the 'Aleph One Windows 
   Driver' floppy. 

2. Start to install Windows as described in the PC Card Manual, using the
   'Custom Installation' option. 

3. When you get to the screeen that displays your settings, do not choose the
   'VGA (version 3.0)' display option as described in the Manual, but go to
   the bottom of the list and select the 'Other display (Requires disk from
   OEM)...' option, at the bottom of the list.

4. Insert the Aleph One Windows Driver floppy into the drive, as prompted.

4. Press return to accept the default path of 'A:\' unless you have put the 
   files somewhere else.

5. Select the driver.
 
6. Continue with the installation, supplying disks as prompted.
   You may find that some files are not on the requested disk, but on a
   different one, as not all windows releases have all the files distributed
   in exactly the same way. If so, insert the disk containing the required
   file, rather than the specified disk.
 


Using Setup after Windows is installed:
-------------------------------------- 
You can change the display driver at any time by running Windows Setup either
from DOS (with your Windows directory as the current directory) or from
within Windows. You will also need to do this if you receive updated versions
of the Windows Drivers.

Select the 'Change System Settings...' menu item from the 'Options' menu, and
then proceed from step 3 above (although not forgetting step 1 first!).

You will have to restart windows for the changes to take effect.

 
Manual installation:
--------------------
Note that you must have installed Windows with the VGA (version 3.0) video
option before doing this, otherwise DOS boxes in Windows will not work.

To install the driver, first copy the driver file (ARMDRV.DRV) into your PC's
\WINDOWS\SYSTEM directory. Next, load the file SYSTEM.INI (in your PC's
\WINDOWS directory) into a text editor or SYSEDIT. Find the line in the
[boot] section which reads

   display.drv=vga.drv

and replace it with the line

   display.drv=armdrv.drv             

Don't worry if your SYSTEM.INI file has something other than 'vga.drv' after
the '=' sign. The new driver will be used the next time you start Windows. 

To change the description as well as the driver (not necessary, but
recommended) you also need to change the display.drv line in the
[boot.description] section of the SYSTEM.INI file to:

   display.drv=Configurable ARM Driver (4,8,16,32 bpp)


!PCconfig options:
-----------------
You need to specify the mode for the Windows Driver to use. This can be
either a decimal RISCOS mode number, or a RISC-PC style mode specifier of the
form x640y480c16 - Note that spaces aren't currently allowed, and neither are
the optional eigen and refresh values). Here are the
strings used to represent the different colour depths:

BitsPerPixel Palette   Colours    String
4            Fixed      16          c16
8            Fixed      256         c256
8          Definable    256         c256p
16           Fixed  32 thousand     c32K
32           Fixed  16 million      c16M

eg x640y480c16M for a 640x480 display in 16 million colours

Then you must allocate enough RAM for this mode. To find out how much memory
a mode uses change to it on the desktop and use the Task Manager to display
the 'Screen Memory' value. Note that we recommend allocating an extra 25-50%
if you can spare the RAM as this will improve performance.

Note that values below 256K are not valid, as at least this much must always
be allocated. Also note that the 'UseWindowFE' config option ('Allow desktop
operation' in !PCConfig) must be on, otherwise the windows driver cannot
claim this first 256K video area and thus cannot operate. You will get a
'Windows driver needs at least nnnK' error if UseWindowsFE is turned OFF, no
matter what value is given for 'VideoRAM'.

Some example modes:
Modes  Colours    Memory needed    Memory recommended
12	16		80K		105K (256K)
15	256		160K		210K (256K)
27	16		150K		200K (256K)
28	256		300K		400K
31	16		235K		300K
39	16		154K		200K
40	256		308K		400K

These options appear like this in the !PC.Config text file:

 WinDrvMode <mode string> 

 VideoRAM   nn 
