Provided by: tiemu_3.04~git20110801-nogdb+dfsg1-2_amd64 
NAME
tiemu - a TI's hand-helds emulator (m68k-based)
SYNOPSYS
tiemu [-h] [-v] [--help] [--version] [--import] [-rom=] [-tib=] [-sav=] [filename]
DESCRIPTION
The TiEmu program allows you to emulate a Texas Instruments calculator such as TI89, TI89 Titanium, TI92,
TI92+ or V200PLT. The emulator has also a virtual link capability which allows to connect it to another
program (such as TiLP for instance).
OPTIONS
The command line options override the default options (startup options) and the config file options even.
The TiEmu program accepts the following options:
-h, --help
Display a list of all command line options.
-v, --version
Output the version info.
--import=
Import ROM or TIB into repository and exit. Can be used for creating images (as an example). This
flag must be set before -rom or -tib !
-rom= Convert and use the specified dump as image. Note that the image is added to the image repository.
Provided for compatibility.
-tib= Convert and use the specified tib/upgrade as image. Idem. Provided for compatibility.
-sav= Load the specified state file. Must be a valid state image and target for emulated calculator.
Provided for compatibility.
filename
Load a ROM/TIB/SAV file. ROM & TIB files are converted and added to images repository. Image
corresponding to SAV file is automatically loaded and state is load.
CONFIG FILE FORMAT
This section describes the format of the .tiemu config file which is in the home directory of the user
(Linux) or in the Program Files folder (Win32). A line preceded by the '#' symbol is a comment. Each
line has the following format: key=value. The config file must have the 'RC_END' string at end. Every
line can be put in any order. Take in mind that any comment added in the config file will be
overwritten. Below is described each option and the possible values:
calctype= Defines the calculator type for link parameter. Valid values are: ti89, ti89t, ti92, ti92+,
v200. Note: don't need to touch this setting, it's overridden by TiEmu. Kept for compatibility.
linktype= Define the link cable type. Choose one of the following value: none, parallel, serial,
TIGraphLink, virtual, TiEmulator, VTi, UsbGraphLink.
port= Define a link port to use. Can be: null, user, parallel port #1|2|3, serial port #1|2|3|4, virtual
port #1|2, USB port #1.
method= Define an I/O method to use. Possible values are: automatic, asm, api, driver, null.
adr_port= places the I/O address of the I/O port to use. It can be 0x3F8 for a serial port or 0x378 for a
parallel port for instance.
serial_device= places the character device name of the serial port to use with a Grey TIGL.
timeout= with the timeout value to use in tenth of seconds. Default value: 20.
delay= with the delay value to use in micro-seconds for home-made cables. Default value: 10
background= Define whether TiEmu display the whole frame (keyboard+LCD) or just the LCD screen. Set to 0
if you do not want to use the keyboard.
skin_file= Define the custom skin file to use. Must be a full path name.
keys_file= Define the keymap to use. Must be a full path name.
img_file= Define the TiEmu image to load at startup. Must be a full path name.
tib_file= Define the FLASH upgrade (tib or .9xu/.89u) to load after the image. Must be a full path name.
sav_file= Define the calculator state image to load at startup.
cpu_rate= Give the number of instructions executed by the M68000 per 30ms timeslice. Default value is -1
(50000 insts/30ms).
hw_rate= Give the OS2/OSC3 oscillator rate. Default value is -1 (427 on hw1 and 732 on hw2; OSC2 is
incremented every 6250 OSC1 cycles).
lcd_rate= Define the frame rate of LCD refresh. Default value is -1 (25ms => 40fps). Don't use a value
smaller than 10ms.
img_format= Defines the image format of the screenshots. Several formats are available: jpg, png and ico.
img_type= You can do B/W (bw) or colored (color) screenshots.
img_size= The size of the image that is to say you can shots only the LCD (lcd) or the entire window
(skin).
screen_file= Defines the base filename where the screenshot will be stored.
screen_counter= This allows you to save the current screenshot counter. In fact, the resulting filename
is computed as 'screenfile[screen_counter].[img_format]. Example: 'screenshot001.png'.
screen_shots= Number of frames to capture.
screen_skips= Number of frame to skip between 2 captures.
console= Available under Windows platform only. You can hide (no) or show (yes) the DOS console at
startup or even display it only during boot (boot).
kbd_dbg= Display key bindings in the console if set (yes). Else, do nothing (no).
fs_type= TiEmu supports several file selectors for better integration. The following options are
supported:
- native: native one (default): Win32 on Windows, KDE if built with KDE support and running under KDE,
GTK+ 2.x else,
- old: GTK 1.2 file selector,
- new: GTK 2.x file selector (advanced capabilities and can show hidden files),
- win32: deprecated (same as native),
- kde: KDE file selector (only available if TiEmu is built with KDE support).
bkpts_wnd=
code_wnd=
mem_wnd=
regs_wnd=
pclog_wnd=
stack_wnd=
heap_wnd= Set geometry hints for the different windows of the debugger. The format is (x,y,w,h,m,v) where
x&y are coordinates, w&h are the size, m is set if window is minimized and v is set if the window is
open.
dbg_font_type= Enable custom font if set to "custom"; use default font if set to "default".
dbg_font_name= Name of font to use. It must be a valid Pango description font name: a string
representation in the form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a comma separated
list of families optionally terminated by a comma, STYLE_OPTIONS is a whitespace separated list of words
where each WORD describes one of style, variant, weight, or stretch, and SIZE is an decimal number (size
in points). Any one of the options may be absent. If FAMILY-LIST is absent, then the family_name field of
the resulting font description will be initialized to NULL. If STYLE-OPTIONS is missing, then all style
options will be set to the default values. If SIZE is missing, the size in the resulting font description
will be set to 0.
Think to terminate your config script with the 'RC_END' word !!!
COPYRIGHT
Copyright (C) 2000-2001, Romain Lievin and Thomas Corvazier. Copyright (C) 2001-2003, Romain Lievin
Copyright (C) 2003, Julien Blache Copyright (C) 2004, Romain Lievin Copyright (C) 2005-2007, Romain
Lievin and Kevin Kofler
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and
without fee is hereby granted, provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in supporting documentation.
This program and its source code is distributed under the terms of the terms of the GNU General Public
License as published by the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write
to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
SUGGESTIONS AND BUG REPORTS
The canonical place to find TiEmu and some miscellenaous informations is at
<http://lpg.ticalc.org/prj_tiemu>. You can also take a look at <http://lpg.ticalc.org> and
<http://www.ticalc.org> for others TI related programs for Linux.
SEE ALSO
tilp(1) for the use of a linking program. TiEmu shares the same communication box for link settings.
SPECIAL THANKS
- Jonas Minnberg (Sasq) for Tiger
- UAE, the Universal Amiga Emulator
- Kevin Kofler <Kevin@tigcc.ticalc.org> for creating rpm packages (Fedora): he is the official maintainer
of this package.
- Julien Blache <jb@jblache.org> for creating deb packages (Debian): he is the official maintainer of
this package.
AUTHOR
Romain Lievin Kevin Kofler
March 28, 2007 TIEMU(1)