

                     TI-8X emulator v0.2        
		     by Randy Gluvna            
		     randman@home.com           
		     http://ti8xemu.home.ml.org 
		     
	             Acorn Port by David McEwen 
	             Port Version : 0.02 
	             
New In This Version
-------------------

	Everything!!!
	                          
Introduction
------------

This is a bit different!! It is an emulator of 4 different Texas Instruments calculators... These aren't your bog standard calculators though, they are high quality graphical ones.

It can save out RAM images and has an inbuilt debugger for the technically minded lot out there.

Saved Images
------------

The TI-8X emulator uses saved image files to save the current state of the
calculator.  You can specify a saved image file as a paramater.  Saved image
files have the extension: /XX where XX represents the calculator you are
emulating.  Alternatively, you can use a default saved image, by just typing
in the name of the calculator you want to emulate.  Default saved images are
saved as DEFAULT/XX on your disk.  Saved images made with one ROM version are
not compatible with those made with another.

eg. to use the TI-83 emulator using the default image

Run <TI8X$Dir>.ti8xemu 83

eg. to use the TI-86 emulator with a saved image called MYCALC/86

Run <TI8X$Dir>.ti8xemu MYCALC/86

Things'll become easier once I get round to adding a front end.

Debugger
--------

Press END to activate the debugger.  There are several commands you can use
in the debugger.  Here is a listing of them:

	? = help
	C = Clear screen
	D = Display registers
	E = Edit registers
	I = In
	O = Out
	Q = Quit to emulator
	R = Read memory
	S = Save image, then quit
	W = Write memory
	X = eXit debugger without saving


Key table
---------

* TI-82 and TI-83 key table *

Calc key                Acorn key
--------                ------
ON                      \
2nd                     Shift
ALPHA                   Ctrl
MODE                    Esc
x-VAR                   '
DEL                     Pad Insert or Pad Delete
Y=                      F1
WINDOW                  F2
ZOOM                    F3
TRACE                   F4
GRAPH                   F5
STAT                    F6
MATH                    F7
MATRX                   F8
PRGM                    F9
VARS                    F10
CLEAR                   Backspace
Cursor keys             Pad Cursor keys
A - Z                   A - Z
0 - 9                   0 - 9
+                       keypad +
-                       keypad -
*                       keypad *
/                       keypad /
^                       `
(-)                     -
STO>                    =
(                       [
)                       ]
,                       ,
.                       .

* TI-85 and TI-86 key table *

Calc key                Acorn key
--------                ------
ON                      \
2nd                     Shift
ALPHA                   Ctrl
EXIT                    Esc
MORE                    Tab
x-VAR                   '
DEL                     Pad Insert or Pad Delete
GRAPH                   F7
TABLE                   F8
PRGM                    F9
CUSTOM                  F10
CLEAR                   Backspace
Cursor keys             Pad Cursor keys
F1 - F5                 F1 - F5
A - Z                   A - Z
0 - 9                   0 - 9
+                       keypad +
-                       keypad -
*                       keypad *
/                       keypad /
^                       `
(-)                     -
STO>                    =
(                       [
)                       ]
,                       ,
.                       .

Special keys
------------

F11                     Quit emulator and save state
F12                     Quit emulator without saving state
PAGE UP                 Save state
PAGE DOWN               Load state
HOME                    Produce a BMP snapshot of the display
			NB This is a Windows bitmap
END                     Load the debugger


Bugs
----

If you find any bugs in the TI-8X emulator, please e-mail me at
randman@home.com
Any Acorn specific bugs then email : davidm@argonaut.com


Copyright and Disclaimer
------------------------

This emulator is copyright Randy Gluvna 1998, and the Acorn-specific
components are copyright David McEwen 1998. You may not attempt to pass off
any part of this work as your own, although you may distribute it freely as
long as you supply the complete archive (that is, all the files supplied to
you).

This software is supplied "as is". I make no claims about the reliability or
suitability for any purpose of this emulator, and any use of it is undertaken
at your own risk. No responsibility is taken for any failure of the software,
or for any loss or damage caused directly or indirectly by the software.

Whilst I will endeavour to help you if you have problems with this emulator,
no such support is guaranteed.

In the above "This emulator" refers to everything supplied within this
archive, which is specifically the !TI8X application and all the files
contained within it, and also the documentation files (including the one you
are reading now).


Thanks
------

Alex Macfarlane Smith for the idea, some testing & the icon


