IDE68K Readme.txt
==================

68000 Integrated Development Environment version 1.3.
-----------------------------------------------------
Thank you for your interest in "68000 Integrated Development
Environment", a program that integrates the entire process of
editing, compiling and/or assembling Assembly, C or Pascal
programs written for the 68000 microcomputer system and
running either on a built-in simulator or on an external 68000
microcomputer system connected to the PC through a serial port.
In addition, from version 1.3 onwards, you can run 68000 Visual 
Simulator directly from the IDE.

License agreement.
-----------------
This software is distributed as shareware. You are entitled to
use this software for evaluation purposes. If you want to continue
to use this software product after the evaluation period, you
are invited to register the software. 

You may give copies of the unregistered shareware version of this
software to others as long as no file is changed or omitted.
You may not sell, or lease this software.

If you are a registered user, you are entitled to use this software
product for your own use. Do not give away your personal registration
code.

For registration see the information from within the program, or
send mail to pfondse@mail.HZeeland.nl for additional details.

What has changed in version 1.3.
-------------------------------
- Line indication and goto line menu added (IDE)

- 68000 Visual Simulator ver. 1.1 can be called directly (IDE).

What has changed in version 1.2.
-------------------------------
- Online registration facility added (IDE).

- C++ style comment introduced as in " // comment " (C compiler).

What has changed in version 1.1.
-------------------------------
- Added menu-item "Project|New" (IDE).

- Improved KEYHIT-handling (simulator).

- Improved RS232 interface (terminal emulator).

- Added setjmp() and longjmp() functions and ANSI variable argument
  passing macros (standard C library).

- Improved handling of syntax errors (C compiler).
  Certain syntax errors introduced a NULL pointer in the parse tree.
  Subsequent reads from this pointer (e.g. to determine the type of the
  expression) caused an access violation which terminated not only the
  compiler but the IDE itself. Most (hopefully all) syntax errors are
  now properly handled.

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

IDE68K is best run with a monitor resolution of 800x600 or
better, the 80x25 character fixed-size window of the simulator/
terminal emulator is slightly too wide for the screen at 640x480
resolution.

Installation.
------------
If you have installed a previous version of IDE68K, please remove
the program from the system before running Setup.exe to make 
certain that the old version is indeed overwritten with the new
version.

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.

If you have installed 68000 Visual Simulator as a stand-alone program
on your system, you may uninstall this program after 68000 IDE 
installation because Visual68K is also installed together with
68000 IDE.

The program can be uninstalled by selecting "Add/Remove Programs"
from the "Control Panel" and selecting "IDE68K" from the listbox.
If you have used IDE68K, and doing so, added new files to the Examples
directory, uninstall will not be able to remove all files in this
directory. For a complete uninstall you have to remove the IDE68K
directory and its contents yourself.

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

This directory contains the following files:

\IDE68K\LIB
---------------
This directory contains library files for the assembler and includes
the start-up files for the C- and Pascal compiler (SIM68K version),
compiler-helper files and files for the standard C-library, both in
C- and Assembly version. Do not change these files unless you know
what you are doing!

\IDE68K\INCLUDE
----------------------
This directory contains the header files used by the C compiler.

\IDE68K\EXAMPLES
----------------
This directory contains example files written in 68000 Assembly,
C or Pascal and are intended to demonstrate what IDE68K and
its support programs can do. These files are also used to test
the system.

The following files are in this directory:

Programs to be run on the character oriented simulator:
======================================================

Bounce.asm
----------
This program shows a bouncing ball (actually the cursor) bouncing
across the screen. Pressing any key will terminated the program.
The main purpose of the program is to demonstrate cursor movement
functions by means of ANSI escape-codes.

Histogram.asm
-------------
This program lets the user enter a string and then prints a
histogram of the number of times a character appears in the string.

Tbi68k.asm
----------
This is a Tiny Basic interpreter written for the 68000 and adapted
to run on SIM68K. You can run 1975 BASIC programs on a Windows 2000
computer.
(Bill would love it!)

Encrypt.asm
-----------
This program encrypts a string by means of a 2nd string, the "key".
It demonstrates the use of macros with ASM68K.

Hello.c
-------
This program can be compiled by loading hello.prj in the
"Project|Open project" menu. It displays the well-known string
"Hello, world!".

Limits.c
--------
This program can be compiled by loading limits.prj in the
"Project|Open project" menu. Its main purpose is to test limits.h
and displays the maximimum values of char's, short's, int's and
long's both signed and unsigned.

Sieve.c
-------
This is a C language version of Eratosthenes' sieve to find prime
numbers. Its main purpose is to check the execution speed of the
simulator versus a real 68000 microcomputer board. As is turned
out, the simulator runs about two times faster than the real 68000
at 10 MHz.
(Well, that is, on a 450 MHz Pentium III PC).

Dhry.h, dhry_1.c and dhry_2.c
-----------------------------
These programs are the well-known dhrystone benchmark for compiler
and processor testing. They can be compiled by loading dhry.prj in
the "Project|Open project" menu. The program does nothing special,
it is just a mix of various C-language statements and expressions
with a distribution which represents an average C program. See also
dhry.h.
(The simulator runs at 1250 Dhrystones per second on a 450 MHz
Pentium III PC).

Vararg.c
--------
This is a C program to test passing of a variable number of 
arguments to a function using the ANSI-defined macros va_start,
va_list and va_end.

Testjmp.c
---------
This is a C program to test setjmp() and longjmp() functions.

Colors.c
--------
This is a C program to demonstrate ANSI Escape sequences for color
setting. The program runs forever and can only be terminated by
resetting the simulator (Ctrl+Break).

Bonjour.pas
-----------
This is a simple Pascal program, similar to Hello.c

Palindrome.pas
--------------
This is a Pascal program to find numbers whose squares are
palindromes, viz. numbers whose digits are identical from left to
right and vice versa. It is copied from an example in Jensen & Wirth,
PASCAL User manual and report. (3rd ed.).

Programs to be used with the Visual Simulator:
=============================================

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

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

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.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.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.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.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.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.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.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.

Timer.c
-------
This program can be compiled by loading timer.prj in the "Project|Open
project" menu. 

Be sure to select option "generate assembly listing" for every file in
the project, otherwise it cannot be run on the 68000 Visual Simulator.

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

The display indicates the time in seconds since the 68000 program has
started. Its main purpose is to show how 68000 I/O devices can be
programmed from a C-program (using pointers to the device).

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

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 you would
expect to work.

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 

