1                                TilEm
2                               -------
3
4TilEm is an emulator and debugger for Texas Instruments Z80-based
5graphing calculators.  It can emulate any of the following calculator
6models:
7
8    TI-73 / TI-73 Explorer
9    TI-76.fr
10    TI-81
11    TI-82
12    TI-82 STATS / TI-82 STATS.fr
13    TI-83
14    TI-83 Plus / TI-83 Plus Silver Edition / TI-83 Plus.fr
15    TI-84 Plus / TI-84 Plus Silver Edition / TI-84 pocket.fr
16    TI-85
17    TI-86
18
19TilEm fully supports all known versions of the above calculators (as
20of 2012), and attempts to reproduce the behavior of the original
21calculator hardware as faithfully as possible.
22
23In addition, TilEm can emulate the TI-Nspire's virtual TI-84 Plus
24mode.  This is currently experimental, and some programs may not work
25correctly.
26
27TilEm runs on the X Window System on GNU/Linux and other Unix-like
28platforms, as well as on Microsoft Windows, and any other platform
29supported by the GTK+ library.
30
31
32                             Installation
33                            --------------
34Packages for Microsoft Windows are available from the TilEm project
35website (http://lpg.ticalc.org/prj_tilem/).  For other platforms, you
36will need to compile TilEm from source; please see the file 'INSTALL'
37in the source package.
38
39
40                             Using TilEm
41                            -------------
42TilEm requires a copy of the operating system from the calculator
43model(s) you wish to emulate.  This file is called a "ROM image",
44since the calculator OS was traditionally stored in Read-Only Memory.
45ROM images are copyrighted by TI and may not be distributed without
46permission.  See the TilEm User's Manual for more information about
47how to create a ROM image.
48
49The main TilEm window shows an image of the calculator (if possible -
50we are still missing background images for a few models.)  Clicking
51with the left mouse button presses a key; clicking with the middle
52button presses a key and holds it down.  Clicking with the right
53button, or pressing Shift+F10, opens the menu.
54
55When you run TilEm for the first time, it will ask you to select a ROM
56image to use.  The file you select will be used by default the next
57time you run TilEm.  You can switch to a different ROM image by
58right-clicking and selecting "Open Calculator".
59
60The state of the emulated calculator is not saved by default; to save
61the state, right-click and select "Save Calculator".  The state is
62saved to a ".sav" file, stored in the same directory as the ROM image.
63
64You can send program and variable files to the emulated calculator,
65either by dragging and dropping them from your file manager, or by
66right-clicking and selecting "Send File".  To retrieve program or
67variable files from the calculator, select "Receive File".
68
69Other features of TilEm include:
70
71 - A debugger for assembly programs
72 - Capturing screenshots, both normal and animated
73 - Recording and replaying keystroke macros
74
75For more information, see the TilEm User's Manual:
76  http://lpg.ticalc.org/prj_tilem2/doc.html
77
78
79                          About this program
80                         --------------------
81Many people deserve credit for helping to make this program possible.
82See the file 'THANKS'.
83
84This program is free software, which means that you are allowed to
85modify it, and to distribute it (or your modified version) to others.
86When you received this program, you should also have been offered a
87complete copy of its source code.  For more information, see the file
88'COPYING'.
89
90You can contact the authors at <tilem-devel@lists.sourceforge.net>.
91Please let us know of any problems you encounter, or ideas for how we
92could make TilEm better.
93