TI-8X emulator v0.4                  |
by Randy Gluvna                      |
randy@gluvna.com                     |
http://www.gluvna.com/randy/ti8xemu/ |
-------------------------------------/

-----------
Description  
-----------
This program will emulate several Z80-Based Texas Instruments graphing
calculators, namely the TI-82, TI-83, TI-85, and TI-86.

---------
Compiling
---------
Read the file INSTALL for information on compiling.

------------
Installation
------------
Included is a binary for DOS.  Before running the program, you must have
a ROM dump for the calculator you wish to emulate.  ROM dumps have the
filename:  TIxx.ROM, where xx is the model number of the calculator.

------------
Saved Images
------------
The TI-8X emulator can save the current state into a saved image file.
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
IMAGE.XX on your disk.  Saved images made with one ROM version are not
compatible with another ROM version.

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

D:\TI8XEMU> ti8xemu 83

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

D:\TI8XEMU> ti8xemu MYCALC.86

-------
Linking
-------
You can connect your computer running the emulator to a TI-8X calculator with
a graphlink, parallel, or serial cable.  This will enable you to send/receive
programs and data from the emulator.  To enable this feature, use the -link
option from the command-line.

The syntax of this command is:  -link <Gx,Px,Sx,K>
G = graphlink
P = parallel
S = serial
K = speaker (default)

The communications port is represented by 'x'

For example, if we were to connect a graphlink cable on COM2 to a TI-85,
we would use:

D:\TI8XEMU> ti8xemu 85 -link G2

Note: TI-8X emulator is *not* compatible with the new black graphlink cable,
only the old grey-colored one.

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

-------------------------
TI-82 and TI-83 key table
-------------------------

Calc key                PC 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                PC 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
END                     Load the debugger

