Prev | Home | Next
Table of content |  | Images

# 1. Introduction

## 1.1 What's TiEmu

TiEmu is a program allowing a computer to emulate a hand-held: TI89, TI89 Titanium, TI92, TI92+, V200PLT.
At the time being, it works on Linux and Windows platforms.
It uses GTK+ (The GiMP ToolKit) for the GUI and for the display.
All link cables supported by the TiLP framework are available:
- home-made parallel cable,
- home-made serial cable,
- Black TI Graph Link,
- Gray TI Graph Link,
- and the SilverLink cable.
TiEmu was based on XTiger, the original TI emulator for Linux which uses the m68k emulation core from UAE (The Ultimate Amiga Emulator).
It also uses the TiLP framework (ti* libraries). See the AUTHORS file for more details.
TiEmu is provided with a default and free OS : PedroM.

## 1.2 Features and limitations

Features:

- support TI89, TI89 Titanium, TI92, TI92+ and V200PLT hand-helds
- full-featured graphical debugger (source, memory, breakpoints, traps, vectors, stack, trace, ...)
- debugger supports: run, step in, step over, step out, run to cursor
- ability to load/save the emulator state
- file linkport emulation (direct loading of files)
- works with 1/2/4 MB ROMs, 128 or 256 KB RAM
- emulate HW1, HW2, and HW3
- can run from ROM dumps or FLASH upgrades
- automatic ROM version/model detection
- contrast emulated (try [Alt] + [+] & [-])
- pretty fast emulation engine
- sreenshot of LCD and/or calculator in several images format (JPG/PNG/ICO)
- TI keyboard useable directly from PC keyboard or with the mouse on the skin
- archive memory support as well as ghost spaces
- full emulation of HW1/2/3 protection (stealth I/O)
- full emulation of HW2 & HW3 clock
- no buggy MC68000 SR & nbcd (TiEmu can't be detected as VTI: you have true emulation)
- 4-level and 7/8-level grayscale support (thx Kevin !) for both HW1 and HW2/3
- the letter keys are aliased to produce their respective letters. No need to press the Alpha key, just type (TI89).
- keyboard mapping and menu shortcuts are fully VTI-compatible
- keyboard mapping can be customized thru keymaps files

Limitations:

- linkport emulation has not been tested with USB cable yet
- no debugger while sending/receiving a file to/from the virtual calculator
- no linkport logging capabilities yet

## 1.3 System requirements

In order to run TiEmu, your computer must meet one of the following sets of requirements, depending on your operating system:

Linux:

- any personal computer (a 386 PC) or workstation (Sparc, Alpha, etc.) with any Linux distribution installed
- 25/30MB of RAM (most part is used by GTK)
- an X-Window system (Xfree is the most common)
- GTK+ 2.6 libraries
- [USB support (if you intend to use a SilverLink cable)]

Windows:

- a Pentium PC @450MHz or better with Microsoft Windows 95/98/Me or NT4/2000/XP
- 25/30MB of RAM (most part is used by GTK)
- GTK+ 2.6 libraries like 2.6.8 (it is recommended to use an NT-based version of Windows : NT4, 2000 or XP)
- [the SilverLink driver for Windows (if you intend to use a SilverLink cable)]

Mac OS-X:

- to test...

FreeBSD:

- same requirements as Linux.

All systems must have an available port that will support your cable (see section 3 below).

## 1.4 Installation

Linux:

- install the TiLP framework
- install TiEmu either by compiling sources, either by installing a package from your favorite distro

Windows:

- execute the InnoSetup installer