-----------------------------------------------------------------------------
Emu-92                                                   version 0.1 (8/5/97)
Written by Neill Corlett - Copyright 1997
-----------------------------------------------------------------------------

Email contact:     corlett@elwha.nrrc.ncsu.edu
WWW contact:       http://www4.ncsu.edu/eos/users/n/nscorlet/emu92/


Introduction
------------

Emu-92 is an emulator for Texas Instruments' TI-92 graphing calculator, for
MS-DOS or Windows 95 based PCs.


Features
--------

* 256K of memory instead of the usual 128K
* Automatic state saving and loading
* Choice of four color schemes


Requirements
------------

* 486 or higher processor.
* Required RAM will vary, depending on the size of your ROM image(s).
* Any video card that can handle 320x200x16.

You will also need one or more ROM images from a real TI-92.  I can't include
these with Emu-92 for legal reasons.

At least one of the following ROM images are needed:

TI92MASK.BIN   - Masked ROM (address: 200000h)
TI92MOD.BIN    - Module ROM (address: 400000h)

The file(s) need to be exactly 1,048,576 or 2,097,152 bytes.

A program that dumps the ROM from your TI-92 is included with the Fargo
shell, which can be downloaded from "http://www.ticalc.org".

NOTE: Do not ask me to send you ROM images, for Emu-92 or any other emulator.


How to use Emu-92
-----------------

1. Make sure you are in the directory with EMU92.EXE and the ROM image(s).
2. Run EMU92.

Press Pause to quit.  The contents of RAM, and the state of the hardware,
will be saved in a file called EMU92.SAV.  This file will be loaded
automatically the next time you run Emu-92.


Command-Line Options
--------------------

debug          Enter debug mode instead of the usual calculator mode
nowait         Skip the "Press ENTER to continue" part.

color1         Choose color scheme #1 - the realistic color scheme (default)
color2         Choose color scheme #2 - the Tiger color scheme
color3         Choose color scheme #3 - the Martian color scheme
color4         Choose color scheme #4 - the Alternative color scheme

("colour" also works)


Keyboard Map
------------

TI-92 key                   PC key
----------------------------------------------
Hand                        `
F1-F8                       F1-F8

A thru Z                    A thru Z
Shift                       Shift
Theta                       \
ON                          F12
Diamond                     Alt
2nd                         Ctrl
STO                         Tab
Space                       Space
=                           =
Backspace                   Backspace
Enter (bottom left)         Enter

Directional keys            Arrow keys
Esc                         Esc
Mode                        F9
Clear                       F10
Ln                          F11
Apps                        Scroll Lock
Enter (top)                 End

Sin                         Insert
Cos                         Home
Tan                         Page Up
(                           [
)                           ]
,                           ,
^                           Num Lock
divide                      Keypad / or regular /
X                           Keypad *
-                           Keypad -
+                           Keypad +
0 thru 9                    0 thru 9 (top row or keypad)
.                           .
(-)                         - (top row)
Enter (bottom right)        Enter


Known Problems and Solutions
----------------------------

Problem:
  You get one of the following error messages:

  Out of usable memory
  No DPMI memory

Solution:
  1. Try running Emu-92 in plain MS-DOS (or "MS-DOS mode") without EMM386
     loaded.

  2. Windows 95 only: Go to the Properties window of your MS-DOS session.
     Click on the Memory tab, then increase the amount of "MS-DOS protected
     mode (DPMI) memory".  It should be at least 1 MB plus the total size of
     your ROM images.


Problem:
  Sometimes, if you hold down Left or Right for too long while tracing a 2D
  function, the calculator (not the emulator) freezes.

  Yes, this is a bug in the emulator.

Solution:
  To unfreeze it, you'll have to delete your EMU92.SAV file.


Misc. Notes
-----------

This emulator would not have been possible without David Ellsworth's TI-92
hardware documentation.

Emu-92 is powered by STARSCREAM - my own revolutionary 680x0 emulation core
also used in the Multi-Gauntlet Emulator, and Thierry Lescot's new System 16
arcade emulator.

Emu-92 was developed using DJGPP by DJ Delorie.  DJGPP can be obtained from
the Delorie Software web site (http://www.delorie.com).

Emu-92 may be distributed freely, as long as it is not modified.  It may not
be sold.  It may not be distributed on floppy disks, CDs, or BBSes.  It may
not be distributed along with any ROM images.

Anyone using Emu-92 does so at their own risk.  I will not be held liable for
any loss or damage arising from its use.


Special Thanks To
-----------------

 David Ellsworth    (davidell@ix.netcom.com)
