[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 following op-
     tions:

     [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 creating
            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.  Provided
            for compatibility.

     [1m-sav=  [22mLoad the specified state file. Must be a valid state image and  tar-
            get 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  automatically
            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  follow-
     ing  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 op-
     tion 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,   Usb-
     GraphLink.

     [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  cables.
     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 keyboard.

     [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 im-
     age. 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 formats
     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 sup-
     port).

     [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  description
     font  name:  a  string representation in the form "[FAMILY-LIST] [STYLE-OP-
     TIONS] [SIZE]", where FAMILY-LIST is a comma separated list of families op-
     tionally 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 op-
     tions 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-OP-
     TIONS 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 !!!


[1mCOPYRIGHT[0m
     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 docu-
     mentation  for any purpose and without fee is hereby granted, provided that
     the above copyright notice appear in all copies and that  both  that  copy-
     right 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  FIT-
     NESS 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 related
     programs for Linux.


[1mSEE ALSO[0m
     tilp(1) for the use of a linking program. TiEmu shares the same  communica-
     tion 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 (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.


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

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