[4mTIEMU[24m(1)                    General Commands Manual                   [4mTIEMU[24m(1)

[1mNAME[0m
       tiemu - a TI's hand-helds emulator (m68k-based)

[1mSYNOPSYS[0m
       [1mtiemu [22m[-h] [-v] [--help] [--version] [--import] [-rom=] [-tib=] [-sav=]
       [filename]

[1mDESCRIPTION[0m
       The  [1mTiEmu [22mprogram 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).

[1mOPTIONS[0m
       The command line options override the default options (startup options)
       and the config file options even.  The [1mTiEmu [22mprogram accepts  the  fol-
       lowing options:

       [1m-h, --help[0m
              Display a list of all command line options.

       [1m-v, --version[0m
              Output the version info.

       [1m--import=[0m
              Import ROM or TIB into repository and exit. Can be used for cre-
              ating images (as an example).  This flag must be set before -rom
              or -tib !

       [1m-rom=  [22mConvert and use the specified dump as image. Note that the image
              is added to the image repository.  Provided for compatibility.

       [1m-tib=  [22mConvert  and use the specified tib/upgrade as image. Idem.  Pro-
              vided for compatibility.

       [1m-sav=  [22mLoad the specified state file. Must be a valid state  image  and
              target for emulated calculator.  Provided for compatibility.

       [1mfilename[0m
              Load a ROM/TIB/SAV file. ROM & TIB files are converted and added
              to  images  repository. Image corresponding to SAV file is auto-
              matically loaded and state is load.


[1mCONFIG FILE FORMAT[0m
       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:

       [1mcalctype= [22mDefines 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.

       [1mlinktype= [22mDefine the link cable  type.  Choose  one  of  the  following
       value:  none,  parallel, serial, TIGraphLink, virtual, TiEmulator, VTi,
       UsbGraphLink.

       [1mport= [22mDefine 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.

       [1mmethod=  [22mDefine  an  I/O method to use. Possible values are: automatic,
       asm, api, driver, null.

       [1madr_port= [22mplaces 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.

       [1mserial_device=  [22mplaces  the character device name of the serial port to
       use with a Grey TIGL.

       [1mtimeout= [22mwith the timeout value to use in  tenth  of  seconds.  Default
       value: 20.

       [1mdelay=  [22mwith  the delay value to use in micro-seconds for home-made ca-
       bles. Default value: 10

       [1mbackground= [22mDefine whether TiEmu display the whole frame (keyboard+LCD)
       or just the LCD screen. Set to 0 if you do not want  to  use  the  key-
       board.

       [1mskin_file=  [22mDefine  the  custom  skin  file to use. Must be a full path
       name.

       [1mkeys_file= [22mDefine the keymap to use. Must be a full path name.

       [1mimg_file= [22mDefine the TiEmu image to load at startup.  Must  be  a  full
       path name.

       [1mtib_file= [22mDefine the FLASH upgrade (tib or .9xu/.89u) to load after the
       image. Must be a full path name.

       [1msav_file= [22mDefine the calculator state image to load at startup.

       [1mcpu_rate=  [22mGive  the  number of instructions executed by the M68000 per
       30ms timeslice. Default value is -1 (50000 insts/30ms).

       [1mhw_rate= [22mGive the OS2/OSC3 oscillator rate. Default value is -1 (427 on
       hw1 and 732 on hw2; OSC2 is incremented every 6250 OSC1 cycles).

       [1mlcd_rate= [22mDefine the frame rate of LCD refresh.  Default  value  is  -1
       (25ms => 40fps). Don't use a value smaller than 10ms.

       [1mimg_format=  [22mDefines  the image format of the screenshots. Several for-
       mats are available: jpg, png and ico.

       [1mimg_type= [22mYou can do B/W (bw) or colored (color) screenshots.

       [1mimg_size= [22mThe size of the image that is to say you can shots  only  the
       LCD (lcd) or the entire window (skin).

       [1mscreen_file=  [22mDefines  the  base  filename where the screenshot will be
       stored.

       [1mscreen_counter= [22mThis allows you to save the current screenshot counter.
       In   fact,   the   resulting   filename   is   computed   as   'screen-
       file[screen_counter].[img_format]. Example: 'screenshot001.png'.

       [1mscreen_shots= [22mNumber of frames to capture.

       [1mscreen_skips= [22mNumber of frame to skip between 2 captures.

       [1mconsole=  [22mAvailable  under  Windows platform only. You can hide (no) or
       show (yes) the DOS console at startup or even display  it  only  during
       boot (boot).

       [1mkbd_dbg=  [22mDisplay  key  bindings  in the console if set (yes). Else, do
       nothing (no).

       [1mfs_type= [22mTiEmu 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).

       [1mbkpts_wnd=[0m
       [1mcode_wnd=[0m
       [1mmem_wnd=[0m
       [1mregs_wnd=[0m
       [1mpclog_wnd=[0m
       [1mstack_wnd=[0m
       [1mheap_wnd= [22mSet 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.
       [1mdbg_font_type= [22mEnable custom font if set to "custom"; use default  font
       if set to "default".
       [1mdbg_font_name=  [22mName  of font to use. It must be a valid Pango descrip-
       tion 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 white-
       space 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  ab-
       sent, then the family_name field of the resulting font description will
       be initialized to NULL. If STYLE-OPTIONS is missing, then all style op-
       tions  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 !!!


[1mCOPYRIGHT[0m
       Copyright (C) 2000-2001, Romain Lievin and Thomas Corvazier.  Copyright
       (C) 2001-2003, Romain Lievin Copyright (C) 2003,  Julien  Blache  Copy-
       right  (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, pro-
       vided that the above copyright notice appear in  all  copies  and  that
       both  that  copyright  notice and this permission notice appear in sup-
       porting 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 Soft-
       ware 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  MER-
       CHANTABILITY  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.


[1mSUGGESTIONS AND BUG REPORTS[0m
       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  re-
       lated programs for Linux.


[1mSEE ALSO[0m
       tilp(1)  for the use of a linking program. TiEmu shares the same commu-
       nication box for link settings.


[1mSPECIAL THANKS[0m
       - Jonas Minnberg (Sasq) for Tiger
       - UAE, the Universal Amiga Emulator
       - Kevin Kofler <Kevin@tigcc.ticalc.org> for creating rpm packages  (Fe-
       dora): 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.


[1mAUTHOR[0m
       Romain Lievin Kevin Kofler

                                March 28, 2007                        [4mTIEMU[24m(1)
