VISUAL68K Readme.txt
====================

68000 Visual Simulator version 1.1.
----------------------------------
Thank you for your interest in "68000 Visual Simulator", a program
to let the user run 68000 Assembly language programs written and
assembled with the 68000 Integrated Development Environment in an
intuitive, visual way.

License agreement.
-----------------
This software is distributed as FREEWARE. You may give copies of the
program to others as long as no file is changed or omitted. You may
not sell or lease this program.

System requirements.
-------------------
VISUAL68K is a 32-bit application. It runs on Windows 95/98/ME and
is believed to run on Windows NT 4.0 and Windows 2000 although
it is not (yet) tested in these platforms.

Installation.
------------
To install this program on your system, run Setup.exe from the
installation diskette. This program performs the installation,
all program files are included on the diskette. To create another
setup disk, you can simply copy all files to the target diskette.

The program can be uninstalled by selecting "Add/Remove Programs"
from the "Control Panel" and selecting "Visual68k" from the listbox.

Installed files.
----------------
In addition to the files in \Program Files\Visual68k or whatever
directory you have installed the program, 68000 application programs
are also installed in directory \Program Files\Visual68k\Examples

These programs are included to see how 68000 Visual Simulator operates
and were used to test the program.

This directory contains the following files:

Add5.lst (Add5.asm)
--------
This program adds five numbers in memory and stores the result in
the next memory location.

Bsort.lst (Bsort.asm)
---------
This program sorts an array of five numbers in ascending order
using a simple bubblesort algorithm.

Mul2.lst (Mul2.asm)
--------
This program asks the user to enter two decimal numbers and displays
the product. Numbers are entered and the result is displayed in the
I/O window which is automatically activated.

Strupr.lst (Strupr.asm)
----------
This program asks the user to enter a string which is subsequently
displayed in upper-case characters. This program makes use of a
subroutine to convert characters to uppercase; the use of the stack
to store the return address is clearly visible in the memory window.

Switches.lst (Switches.asm)
------------
To run this program in the 68000 Visual Simulator, you must enable the
SWITCHES and LED's windows from the Peripherial menu.

Although this program can be run in Single-step and Run-slow mode, 
Run-fast mode is preferred. 

If you click the mouse on one of the switches, the corresponding LED 
will be turned on.

Analog.lst (Analog.asm)
----------
To run this program in the 68000 Visual Simulator, you must enable the
SLIDER, LED's and BARGRAPH windows from the Peripherial menu.

Although this program can be run in Single-step and Run-slow mode, 
Run-fast mode is preferred. 

If you click the mouse on the slider button and keep the mousebutton 
down, you can move the slider control up and down. The BARGRAPH will
display the slider position in analog form. The LED display indicates
the slider position in binary (0 - 255).

Help.lst (Help.asm)
--------
To run this program in the 68000 Visual Simulator, you must enable the
7-SEGMENT DISPLAY window from the Peripherial menu.

Although this program can be run in Single-step and Run-slow mode, 
Run-fast mode is preferred. 

When the program runs, flashing HELP is displayed on the 7-segment
display.

Pattern.lst (Pattern.asm)
-----------
To run this program in the 68000 Visual Simulator, you must enable the
DRAW PAD window from the Peripherial menu.

When the program runs, the 68000 draws a pattern of random lines on the 
drawing pad using randomly selected colors. After 100 lines drawn, the 
program waits for a few seconds, then erases the display with a
randomly selected background color and starts drawing lines again.

Quiz.lst (Quiz.asm)
---------
The user is asked to type the decimal value of the binary number in
the LED display in the I/O window.

If the value is correct, the program responds with "Very good" and 
presents a new random binary number.
If not correct, the 68000 says "What is this" and presents the same
binary number again.

The binary number is choosen at random intervals from the low byte
of the system timer which increments at 10 times per second 

Interrupt.lst (Interrupt.asm)
-------------
This program exercises the interrupt handling built into the 68000
Visual Simulator. The 68000 is made to run in USER mode with interrupt
levels 6 and 7 enabled. Pressing one of the buttons on the Toolbar
marked I6 or I7 generates the corresponding interrupt. 

Depending on the interrupt, the 68000 generates two different sound
signals (sounds must be enabled in Windows).

You can use the interrupt timer if you select INTERRUPT TIMER from
the peripherials menu and set interrupt level and interval time of the
timer.

Running the program in Run-fast mode is preferred unless you select
very long interval times.

DISCLAIMER.
----------
There are no warranties associated with this software. While I believe
this software product is reasonably bug free and well-behaved, I am in
no way responsible if this program does not work as expected, nor am I
in any way responsible for the correctness of the produced machinecode.

BUGS AND COMMENTS.
-----------------
If you have problems with this program, discover any bugs or just
want to give comments, please send E-mail to

   pfondse@mail.HZeeland.nl 

Suggestions and ideas for improvement of the program are also welcome.