******************************************************************************
*            W E I T E K   U T I L I T I E S   V E R S I O N   3.0
******************************************************************************

This disk/directory contains diagnostics, demo files and macros provided by
Weitek to facilitate the use of the Abacus 1167, 3167 and 4167 numeric
coprocessors for Intel 80386 and i486 based personal computers.


******************************************************************************

The diagnostics are provided to check the operation of the Abacus coprocessor.  

Note that any Expanded Memory Manager (EMM) programs which you have installed
in your computer must be turned off prior to testing, as these tests run in
32 bit protected mode using the Phar Lap DOS extender.  This means that all
memory will be addressed directly rather than through Expanded Memory.

The following programs are USER diagnostics that check for the proper
operation of the Abacus coprocessor in your system:

    	67SETUP.COM    	Installs a DOS TSR that updates the system BIOS for
    			Abacus support.  This command can be installed in the
    			AUTOEXEC.BAT so that it automatically executes each
    			time the system is booted.  Once installed, the BIOS
    			will indicate the presence of an Abacus even if the
    			coprocessor is not present or malfunctioning.  This
    			program is not necessary for machines that already
                        recognize the presence of the Abacus.

	67TEST.EXE     	Checks the system BIOS (INT 11h) for Abacus presence
	       		indication.  Determines the revision level of the
	       		Abacus coprocessor.  Initializes the 1167 and 1167A. 
	            	Checks the addressability and operation of the Abacus.  

        67DIAG.EXE      This program performs extensive diagnostics on the
                        ABACUS coprocessor to determine if it is working 
                        normally.
									   			


The TEST1167.BAT, TEST3167 and TEST4167.BAT programs simply call each of
the above routines in order.

Note that any Expanded Memory Manager routines must be turned off prior to
testing as these tests run in Phar Lap protected mode.

*****************************************************************************





This diskette contains two types of demo programs which, when installed in
systems containing both an Abacus coprocessor as well as an 80387/486, can be
used to show the relative performance improvement using the Weitek Abacus.

One of these programs, called MANDEL.EXE performs mandelbrot calculations
using both the Weitek Abacus and the Intel coprocessors.  Both coprocessors 
must be installed to use this demo.  This demo works by alternating between 
the Abacus and the Intel using time slicing and performing the same set of
calculations on each coprocessor.  The relative performance boost using this
demo is not typical, but rather shows the type of improvement which may be
obtained in extremely math-intensive applications if hand coding is used to
optimize for the performance of the Weitek coprocessor.  MANDEL.EXE can run
on either EGA or VGA graphics adapters.  To start this demo, the file should
be loaded on the active disk drive.  Then type MANDEL and hit the return key.
to get out of this demo, hit the ESC key.

The second demo shows phong shading of a beach ball.  This program has four
different versions, one each for the Weitek Abacus and the Intel and for use
with EGA or VGA monitors.  The source code for the Weitek versions is the
same as for the Intel versions, the only difference is that a compiler switch
is turned on during compilation to generate Weitek code.  These programs show
the type of performance improvement which will typically be obtained with the
Weitek Abacus coprocessor when porting compiled code.  The VGA versions
are different from the EGA versions.  These files are as follows:

	67FONGV.EXE	phong shading using Weitek Abacus and VGA graphics

     	67FONGE.EXE	phong shading using Weitek Abacus and EGA graphics

      	87FONGV.EXE	phong shading using 80387/486 and VGA graphics

      	87FONGE.EXE	phong shading using 80387/486 and EGA graphics

To run each of these programs, simply type the name of the file (excluding
the .EXE suffix).  For example, to run phong shading on the Abacus and a VGA
adapter, type 67FONGV and hit the return key.  It will shade the beach ball
at 3 different lighting angles and time each pass.  The approriate coprocessor
and graphics adapter must be installed for each of these files to properly
function.

*****************************************************************************

This diskette also includes the Weitek instruction macros to facilitate the
development of assembly routines that utilize the Weitek vector operations.
These macros are compatible with most assemblers, including those from 
Microsoft and Phar Lap.  The file 67MACROS.EQU contains the assembly macros
that implement the Abacus instruction set.  If you do not intend to develop
programs for the Abacus using assembly language, then it is not necessary
for you to understand or use the Weitek instruction macros.  If you are
programming the Weitek Abacus in assembly language, you should read about the
instruction macros in the Weitek Abacus Software Designer's Guide for
complete information about using the instruction macros.  This is available
directly from Weitek.

*****************************************************************************

If you have any questions on these Demo or Diagnostics programs, please call
Technical Support at WEITEK, (800)HOT-3167.


